@bhushanpawar/sqldb 1.0.0

package/dist/best-practice-example.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Best Practice Example for MariaDB Cache
+ *
+ * Key Performance Tips:
+ * 1. Create pool once and reuse it (singleton pattern)
+ * 2. Use appropriate TTL based on your data update frequency
+ * 3. Set maxSize based on your query patterns
+ * 4. Enable debug in development, disable in production
+ * 5. Monitor cache hit rates and adjust settings
+ */
+declare class DatabaseService {
+    private static instance;
+    private pool;
+    private constructor();
+    static getInstance(): DatabaseService;
+    getUsers(limit?: number): Promise<any>;
+    getUserById(userId: number | string): Promise<any>;
+    searchUsers(username: string): Promise<any>;
+    updateUser(userId: number | string, data: any): Promise<any>;
+    getCachePerformance(): {
+        hitRate: string;
+        efficiency: string;
+        size: number;
+        maxSize: number;
+        ttl: number;
+        enabled: boolean;
+        hits?: number;
+        misses?: number;
+        evictions?: number;
+    };
+    resetStats(): void;
+    close(): Promise<void>;
+}
+export default DatabaseService;
+//# sourceMappingURL=best-practice-example.d.ts.map

package/dist/best-practice-example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"best-practice-example.d.ts","sourceRoot":"","sources":["../src/best-practice-example.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,cAAM,eAAe;IACjB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAkB;IACzC,OAAO,CAAC,IAAI,CAAe;IAE3B,OAAO;WAqBO,WAAW,IAAI,eAAe;IAQtC,QAAQ,CAAC,KAAK,GAAE,MAAW;IAK3B,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAKnC,WAAW,CAAC,QAAQ,EAAE,MAAM;IAQ5B,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,GAAG;IAWnD,mBAAmB;;;;;;;;;;;IAcnB,UAAU;IAKJ,KAAK;CAGd;AAoHD,eAAe,eAAe,CAAC"}

package/dist/best-practice-example.js

@@ -0,0 +1,171 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_1 = require("./index");
+/**
+ * Best Practice Example for MariaDB Cache
+ *
+ * Key Performance Tips:
+ * 1. Create pool once and reuse it (singleton pattern)
+ * 2. Use appropriate TTL based on your data update frequency
+ * 3. Set maxSize based on your query patterns
+ * 4. Enable debug in development, disable in production
+ * 5. Monitor cache hit rates and adjust settings
+ */
+class DatabaseService {
+    constructor() {
+        this.pool = (0, index_1.createPool)({
+            host: process.env.DB_HOST || 'localhost',
+            user: process.env.DB_USER || 'root',
+            password: process.env.DB_PASSWORD || 'password',
+            database: process.env.DB_NAME || 'mydb',
+            port: parseInt(process.env.DB_PORT || '3306'),
+            connectionLimit: 10,
+            // Performance optimizations
+            compress: true, // Enable compression for large result sets
+        }, {
+            // Cache configuration
+            ttl: 30000, // 30 seconds - adjust based on data freshness needs
+            maxSize: 100, // Cache up to 100 different queries
+            enabled: true, // Enable caching
+            debug: process.env.NODE_ENV === 'development', // Debug only in dev
+        });
+    }
+    // Singleton pattern - create pool once, reuse everywhere
+    static getInstance() {
+        if (!DatabaseService.instance) {
+            DatabaseService.instance = new DatabaseService();
+        }
+        return DatabaseService.instance;
+    }
+    // Get users - frequently accessed, good for caching
+    async getUsers(limit = 10) {
+        return this.pool.query('SELECT * FROM user LIMIT ?', [limit]);
+    }
+    // Get user by ID - perfect for caching (same query repeated often)
+    async getUserById(userId) {
+        return this.pool.query('SELECT * FROM users WHERE id = ?', [userId]);
+    }
+    // Search users - less predictable, but still cacheable
+    async searchUsers(username) {
+        return this.pool.query('SELECT * FROM users WHERE username LIKE ? LIMIT 20', [`%${username}%`]);
+    }
+    // Update user - mutations should NOT use cache
+    async updateUser(userId, data) {
+        // Clear related cache entries after mutation
+        this.pool.clearCache('SELECT * FROM users WHERE id');
+        return this.pool.query('UPDATE users SET updated_at = NOW() WHERE id = ?', [userId]);
+    }
+    // Get cache statistics - monitor performance
+    getCachePerformance() {
+        const stats = this.pool.getCacheStats();
+        const hitRate = stats.hits && stats.misses
+            ? ((stats.hits / (stats.hits + stats.misses)) * 100).toFixed(2)
+            : '0.00';
+        return {
+            ...stats,
+            hitRate: `${hitRate}%`,
+            efficiency: hitRate,
+        };
+    }
+    // Reset stats - useful for testing
+    resetStats() {
+        this.pool.resetStats();
+    }
+    // Graceful shutdown
+    async close() {
+        await this.pool.end();
+    }
+}
+// Example usage
+async function demonstratePerformance() {
+    const db = DatabaseService.getInstance();
+    console.log('\n=== Performance Demonstration ===\n');
+    // First query - CACHE MISS (will take ~2000ms for remote DB)
+    console.log('1. First query (Cache Miss - hits database):');
+    console.time('Query 1');
+    await db.getUserById('b5a0179c-556c-4884-9243-00293be5656f');
+    console.timeEnd('Query 1');
+    // Second query - CACHE HIT (will take <1ms)
+    console.log('\n2. Same query again (Cache Hit - returns instantly):');
+    console.time('Query 2');
+    await db.getUserById('b5a0179c-556c-4884-9243-00293be5656f');
+    console.timeEnd('Query 2');
+    // Third query - Different parameter (CACHE MISS)
+    console.log('\n3. Different user (Cache Miss - hits database):');
+    console.time('Query 3');
+    await db.getUserById('7fe2df00-0157-4c3f-a5ba-00360a60af97');
+    console.timeEnd('Query 3');
+    // Fourth query - Previous query (CACHE HIT)
+    console.log('\n4. Previous user again (Cache Hit - instant):');
+    console.time('Query 4');
+    await db.getUserById('7fe2df00-0157-4c3f-a5ba-00360a60af97');
+    console.timeEnd('Query 4');
+    // Get multiple users - demonstrate list queries
+    console.log('\n5. Get list of users (Cache Miss):');
+    console.time('Query 5');
+    await db.getUsers(5);
+    console.timeEnd('Query 5');
+    console.log('\n6. Same list again (Cache Hit):');
+    console.time('Query 6');
+    await db.getUsers(5);
+    console.timeEnd('Query 6');
+    // Performance stats
+    console.log('\n=== Cache Performance Stats ===');
+    const stats = db.getCachePerformance();
+    console.log(stats);
+    console.log(`\nHit Rate: ${stats.hitRate}`);
+    console.log(`Cache Size: ${stats.size}/${stats.maxSize}`);
+    console.log(`Total Queries: ${stats.hits + stats.misses}`);
+    console.log(`Database Hits Avoided: ${stats.hits}`);
+    // Calculate time saved (approximate)
+    const avgDbTime = 2000; // ms
+    const avgCacheTime = 0.5; // ms
+    const timeSaved = (stats.hits || 0) * (avgDbTime - avgCacheTime);
+    console.log(`\nEstimated Time Saved: ~${timeSaved.toFixed(0)}ms`);
+    await db.close();
+}
+// Best practices summary
+async function bestPracticesDemo() {
+    const db = DatabaseService.getInstance();
+    console.log('\n=== Best Practices ===\n');
+    // ✅ DO: Reuse the same pool instance
+    console.log('✅ DO: Use singleton pattern for pool');
+    console.log('   const db = DatabaseService.getInstance();');
+    // ✅ DO: Cache frequently accessed data
+    console.log('\n✅ DO: Cache read-heavy queries');
+    await db.getUserById('b5a0179c-556c-4884-9243-00293be5656f');
+    await db.getUserById('b5a0179c-556c-4884-9243-00293be5656f'); // Cached!
+    // ✅ DO: Clear cache after mutations
+    console.log('\n✅ DO: Clear cache after updates');
+    await db.updateUser('b5a0179c-556c-4884-9243-00293be5656f', {});
+    // ✅ DO: Monitor cache performance
+    console.log('\n✅ DO: Monitor cache hit rate');
+    const stats = db.getCachePerformance();
+    console.log(`   Hit Rate: ${stats.hitRate}`);
+    // ✅ DO: Set appropriate TTL
+    console.log('\n✅ DO: Set TTL based on data update frequency');
+    console.log('   - User profiles: 30-60s');
+    console.log('   - Static data: 5-10min');
+    console.log('   - Real-time data: 1-5s or disable cache');
+    // ❌ DON\'T: Create new pool for each request
+    console.log('\n❌ DON\'T: Create pool per request (very slow!)');
+    console.log('   // BAD: new MariaDBCache(...) on every request');
+    // ❌ DON\'T: Cache data that changes frequently
+    console.log('\n❌ DON\'T: Cache highly volatile data');
+    console.log('   - Real-time analytics');
+    console.log('   - Live counters');
+    console.log('   - Session data');
+    await db.close();
+}
+// Uncomment to run demonstrations
+if (require.main === module) {
+    demonstratePerformance()
+        .then(() => console.log('\n✓ Performance demo complete'))
+        .catch(console.error);
+    // Or run:
+    // bestPracticesDemo()
+    //     .then(() => console.log('\n✓ Best practices demo complete'))
+    //     .catch(console.error);
+}
+exports.default = DatabaseService;
+//# sourceMappingURL=best-practice-example.js.map

package/dist/best-practice-example.js.map

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

package/dist/cache/cache-key-builder.d.ts

@@ -0,0 +1,17 @@
+export declare class CacheKeyBuilder {
+    private prefix;
+    constructor(prefix?: string);
+    buildKey(table: string, operation: string, params: any): string;
+    buildIdKey(table: string, id: string | number): string;
+    buildTablePattern(table: string): string;
+    buildOperationPattern(table: string, operation: string): string;
+    private generateHash;
+    private normalizeParams;
+    parseKey(key: string): {
+        table: string;
+        operation: string;
+        hash: string;
+    } | null;
+    matchesPattern(key: string, pattern: string): boolean;
+}
+//# sourceMappingURL=cache-key-builder.d.ts.map

package/dist/cache/cache-key-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-key-builder.d.ts","sourceRoot":"","sources":["../../src/cache/cache-key-builder.ts"],"names":[],"mappings":"AAEA,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,GAAE,MAAc;IAIlC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,MAAM;IAK/D,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM;IAItD,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIxC,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAI/D,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,eAAe;IAuBvB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAchF,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;CAItD"}

package/dist/cache/cache-key-builder.js

@@ -0,0 +1,100 @@
+"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.CacheKeyBuilder = void 0;
+const crypto = __importStar(require("crypto"));
+class CacheKeyBuilder {
+    constructor(prefix = 'sdc') {
+        this.prefix = prefix;
+    }
+    buildKey(table, operation, params) {
+        const hash = this.generateHash(params);
+        return `${this.prefix}:${table}:${operation}:${hash}`;
+    }
+    buildIdKey(table, id) {
+        return `${this.prefix}:${table}:id:${id}`;
+    }
+    buildTablePattern(table) {
+        return `${this.prefix}:${table}:*`;
+    }
+    buildOperationPattern(table, operation) {
+        return `${this.prefix}:${table}:${operation}:*`;
+    }
+    generateHash(params) {
+        // Normalize the params for consistent hashing
+        const normalized = this.normalizeParams(params);
+        const jsonString = JSON.stringify(normalized);
+        // For short strings, use the string directly
+        if (jsonString.length <= 50) {
+            return Buffer.from(jsonString).toString('base64url').substring(0, 20);
+        }
+        // For longer strings, use MD5 hash
+        return crypto.createHash('md5').update(jsonString).digest('hex').substring(0, 16);
+    }
+    normalizeParams(params) {
+        if (params === null || params === undefined) {
+            return null;
+        }
+        if (Array.isArray(params)) {
+            return params.map((item) => this.normalizeParams(item));
+        }
+        if (typeof params === 'object') {
+            const normalized = {};
+            const keys = Object.keys(params).sort();
+            for (const key of keys) {
+                normalized[key] = this.normalizeParams(params[key]);
+            }
+            return normalized;
+        }
+        return params;
+    }
+    parseKey(key) {
+        const parts = key.split(':');
+        if (parts.length < 4 || parts[0] !== this.prefix) {
+            return null;
+        }
+        return {
+            table: parts[1],
+            operation: parts[2],
+            hash: parts[3],
+        };
+    }
+    matchesPattern(key, pattern) {
+        const regex = new RegExp('^' + pattern.replace(/\*/g, '.*') + '$');
+        return regex.test(key);
+    }
+}
+exports.CacheKeyBuilder = CacheKeyBuilder;
+//# sourceMappingURL=cache-key-builder.js.map

package/dist/cache/cache-key-builder.js.map

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

package/dist/cache/cache-manager.d.ts

@@ -0,0 +1,22 @@
+import { RedisConnectionManager } from '../connection/redis';
+import { CacheConfig } from '../types/config';
+import { CacheStats } from '../types/cache';
+import { CacheKeyBuilder } from './cache-key-builder';
+export declare class CacheManager {
+    private redis;
+    private config;
+    private keyBuilder;
+    private stats;
+    constructor(redis: RedisConnectionManager, config: Required<CacheConfig>, keyPrefix?: string);
+    get<T = any>(key: string): Promise<T | null>;
+    set(key: string, value: any, ttl?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    deletePattern(pattern: string): Promise<number>;
+    exists(key: string): Promise<boolean>;
+    getKeyBuilder(): CacheKeyBuilder;
+    getStats(): CacheStats;
+    resetStats(): void;
+    isEnabled(): boolean;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=cache-manager.d.ts.map

package/dist/cache/cache-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-manager.d.ts","sourceRoot":"","sources":["../../src/cache/cache-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,KAAK,CAIX;gBAGA,KAAK,EAAE,sBAAsB,EAC7B,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,EAC7B,SAAS,CAAC,EAAE,MAAM;IAOd,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAsB5C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAezD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYlC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAe/C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAa3C,aAAa,IAAI,eAAe;IAIhC,QAAQ,IAAI,UAAU;IAetB,UAAU,IAAI,IAAI;IAMlB,SAAS,IAAI,OAAO;IAId,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAa7B"}

package/dist/cache/cache-manager.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheManager = void 0;
+const cache_key_builder_1 = require("./cache-key-builder");
+class CacheManager {
+    constructor(redis, config, keyPrefix) {
+        this.stats = {
+            hits: 0,
+            misses: 0,
+            evictions: 0,
+        };
+        this.redis = redis;
+        this.config = config;
+        this.keyBuilder = new cache_key_builder_1.CacheKeyBuilder(keyPrefix);
+    }
+    async get(key) {
+        if (!this.config.enabled || !this.redis.isConnected()) {
+            return null;
+        }
+        try {
+            const cached = await this.redis.get(key);
+            if (cached === null) {
+                this.stats.misses++;
+                return null;
+            }
+            this.stats.hits++;
+            return JSON.parse(cached);
+        }
+        catch (error) {
+            console.error('[CacheManager] Get error:', error);
+            this.stats.misses++;
+            return null;
+        }
+    }
+    async set(key, value, ttl) {
+        if (!this.config.enabled || !this.redis.isConnected()) {
+            return;
+        }
+        try {
+            const serialized = JSON.stringify(value);
+            const ttlSeconds = ttl || this.config.defaultTTL;
+            await this.redis.set(key, serialized, ttlSeconds);
+        }
+        catch (error) {
+            console.error('[CacheManager] Set error:', error);
+        }
+    }
+    async delete(key) {
+        if (!this.redis.isConnected()) {
+            return;
+        }
+        try {
+            await this.redis.del(key);
+        }
+        catch (error) {
+            console.error('[CacheManager] Delete error:', error);
+        }
+    }
+    async deletePattern(pattern) {
+        if (!this.redis.isConnected()) {
+            return 0;
+        }
+        try {
+            const count = await this.redis.deletePattern(pattern);
+            this.stats.evictions += count;
+            return count;
+        }
+        catch (error) {
+            console.error('[CacheManager] DeletePattern error:', error);
+            return 0;
+        }
+    }
+    async exists(key) {
+        if (!this.redis.isConnected()) {
+            return false;
+        }
+        try {
+            return await this.redis.exists(key);
+        }
+        catch (error) {
+            console.error('[CacheManager] Exists error:', error);
+            return false;
+        }
+    }
+    getKeyBuilder() {
+        return this.keyBuilder;
+    }
+    getStats() {
+        const total = this.stats.hits + this.stats.misses;
+        const hitRate = total > 0
+            ? ((this.stats.hits / total) * 100).toFixed(2)
+            : '0.00';
+        return {
+            hits: this.stats.hits,
+            misses: this.stats.misses,
+            evictions: this.stats.evictions,
+            size: 0, // Redis doesn't provide easy size lookup
+            hitRate: `${hitRate}%`,
+        };
+    }
+    resetStats() {
+        this.stats.hits = 0;
+        this.stats.misses = 0;
+        this.stats.evictions = 0;
+    }
+    isEnabled() {
+        return this.config.enabled && this.redis.isConnected();
+    }
+    async clear() {
+        if (!this.redis.isConnected()) {
+            return;
+        }
+        try {
+            // Clear all keys with our prefix
+            const count = await this.redis.deletePattern('*');
+            this.stats.evictions += count;
+        }
+        catch (error) {
+            console.error('[CacheManager] Clear error:', error);
+        }
+    }
+}
+exports.CacheManager = CacheManager;
+//# sourceMappingURL=cache-manager.js.map

package/dist/cache/cache-manager.js.map

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

package/dist/cache/invalidation.d.ts

@@ -0,0 +1,15 @@
+import { CacheManager } from './cache-manager';
+import { DependencyGraph } from '../discovery/dependency-graph';
+import { InvalidationOptions } from '../types/cache';
+export declare class InvalidationManager {
+    private cacheManager;
+    private dependencyGraph;
+    constructor(cacheManager: CacheManager, dependencyGraph: DependencyGraph);
+    invalidateTable(table: string, options?: InvalidationOptions): Promise<void>;
+    private invalidateTableCache;
+    invalidatePattern(pattern: string): Promise<number>;
+    invalidateKey(key: string): Promise<void>;
+    invalidateMultipleTables(tables: string[], cascade?: boolean): Promise<void>;
+    invalidateAll(): Promise<void>;
+}
+//# sourceMappingURL=invalidation.d.ts.map

package/dist/cache/invalidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invalidation.d.ts","sourceRoot":"","sources":["../../src/cache/invalidation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAwB,MAAM,gBAAgB,CAAC;AAE3E,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,eAAe,CAAkB;gBAE7B,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe;IAKlE,eAAe,CACnB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,IAAI,CAAC;YA2BF,oBAAoB;IAK5B,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAInD,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,wBAAwB,CAC5B,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,GAAE,OAAc,GACtB,OAAO,CAAC,IAAI,CAAC;IAiBV,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;CAGrC"}

package/dist/cache/invalidation.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvalidationManager = void 0;
+const cache_1 = require("../types/cache");
+class InvalidationManager {
+    constructor(cacheManager, dependencyGraph) {
+        this.cacheManager = cacheManager;
+        this.dependencyGraph = dependencyGraph;
+    }
+    async invalidateTable(table, options = {}) {
+        const { cascade = true, strategy = cache_1.InvalidationStrategy.IMMEDIATE, } = options;
+        if (strategy === cache_1.InvalidationStrategy.TTL_ONLY) {
+            // Don't actively invalidate, rely on TTL
+            return;
+        }
+        const tablesToInvalidate = cascade
+            ? this.dependencyGraph.getInvalidationTargets(table)
+            : [table];
+        if (strategy === cache_1.InvalidationStrategy.LAZY) {
+            // Mark for invalidation but don't delete immediately
+            // This could be implemented with a flag or separate tracking
+            // For now, we'll do immediate invalidation
+        }
+        // Invalidate cache for all affected tables
+        for (const targetTable of tablesToInvalidate) {
+            await this.invalidateTableCache(targetTable);
+        }
+    }
+    async invalidateTableCache(table) {
+        const pattern = this.cacheManager.getKeyBuilder().buildTablePattern(table);
+        await this.cacheManager.deletePattern(pattern);
+    }
+    async invalidatePattern(pattern) {
+        return await this.cacheManager.deletePattern(pattern);
+    }
+    async invalidateKey(key) {
+        await this.cacheManager.delete(key);
+    }
+    async invalidateMultipleTables(tables, cascade = true) {
+        const allTables = new Set();
+        for (const table of tables) {
+            if (cascade) {
+                const targets = this.dependencyGraph.getInvalidationTargets(table);
+                targets.forEach((t) => allTables.add(t));
+            }
+            else {
+                allTables.add(table);
+            }
+        }
+        for (const table of allTables) {
+            await this.invalidateTableCache(table);
+        }
+    }
+    async invalidateAll() {
+        await this.cacheManager.clear();
+    }
+}
+exports.InvalidationManager = InvalidationManager;
+//# sourceMappingURL=invalidation.js.map

package/dist/cache/invalidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invalidation.js","sourceRoot":"","sources":["../../src/cache/invalidation.ts"],"names":[],"mappings":";;;AAEA,0CAA2E;AAE3E,MAAa,mBAAmB;IAI9B,YAAY,YAA0B,EAAE,eAAgC;QACtE,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,KAAa,EACb,UAA+B,EAAE;QAEjC,MAAM,EACJ,OAAO,GAAG,IAAI,EACd,QAAQ,GAAG,4BAAoB,CAAC,SAAS,GAC1C,GAAG,OAAO,CAAC;QAEZ,IAAI,QAAQ,KAAK,4BAAoB,CAAC,QAAQ,EAAE,CAAC;YAC/C,yCAAyC;YACzC,OAAO;QACT,CAAC;QAED,MAAM,kBAAkB,GAAG,OAAO;YAChC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,sBAAsB,CAAC,KAAK,CAAC;YACpD,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAEZ,IAAI,QAAQ,KAAK,4BAAoB,CAAC,IAAI,EAAE,CAAC;YAC3C,qDAAqD;YACrD,6DAA6D;YAC7D,2CAA2C;QAC7C,CAAC;QAED,2CAA2C;QAC3C,KAAK,MAAM,WAAW,IAAI,kBAAkB,EAAE,CAAC;YAC7C,MAAM,IAAI,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,oBAAoB,CAAC,KAAa;QAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC3E,MAAM,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,OAAe;QACrC,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,GAAW;QAC7B,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,wBAAwB,CAC5B,MAAgB,EAChB,UAAmB,IAAI;QAEvB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;QAEpC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;gBACnE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3C,CAAC;iBAAM,CAAC;gBACN,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;YAC9B,MAAM,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;IAClC,CAAC;CACF;AA3ED,kDA2EC"}

package/dist/client.d.ts

@@ -0,0 +1,40 @@
+import { SmartDBConfig } from './types/config';
+import { TableOperations, QueryMetadata } from './types/query';
+import { DependencyGraph } from './discovery/dependency-graph';
+import { CacheManager } from './cache/cache-manager';
+import { InvalidationManager } from './cache/invalidation';
+import { HooksManager } from './hooks/hooks-manager';
+import { InMemoryQueryTracker } from './query/query-tracker';
+export declare class SmartDBClient {
+    private config;
+    private dbManager;
+    private redisManager;
+    private cacheManager;
+    private invalidationManager;
+    private dependencyGraph;
+    private queryBuilder;
+    private tableProxyFactory;
+    hooks: HooksManager;
+    queryTracker: InMemoryQueryTracker;
+    private initialized;
+    private discoveredTables;
+    constructor(config: SmartDBConfig);
+    initialize(): Promise<void>;
+    private discoverSchema;
+    refreshSchema(): Promise<void>;
+    getTableOperations<T = any>(tableName: string): TableOperations<T>;
+    getCacheManager(): CacheManager;
+    getInvalidationManager(): InvalidationManager;
+    getDependencyGraph(): DependencyGraph;
+    getDiscoveredTables(): string[];
+    getQueries(correlationId?: string): QueryMetadata[];
+    clearQueries(correlationId?: string): void;
+    healthCheck(): Promise<{
+        mariadb: boolean;
+        redis: boolean;
+        overall: boolean;
+    }>;
+    close(): Promise<void>;
+    private log;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAId,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAK/D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAI3D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7D,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,eAAe,CAAmB;IAC1C,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,iBAAiB,CAAqB;IACvC,KAAK,EAAG,YAAY,CAAC;IACrB,YAAY,EAAE,oBAAoB,CAAC;IAE1C,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,gBAAgB,CAA0B;gBAEtC,MAAM,EAAE,aAAa;IAU3B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAsEnB,cAAc;IA4BtB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAWpC,kBAAkB,CAAC,CAAC,GAAG,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC;IAiBlE,eAAe,IAAI,YAAY;IAI/B,sBAAsB,IAAI,mBAAmB;IAI7C,kBAAkB,IAAI,eAAe;IAIrC,mBAAmB,IAAI,MAAM,EAAE;IAI/B,UAAU,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE;IAInD,YAAY,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI;IAIpC,WAAW,IAAI,OAAO,CAAC;QAC3B,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,EAAE,OAAO,CAAC;QACf,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC;IAWI,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAY5B,OAAO,CAAC,GAAG;CAKZ"}