@bhushanpawar/sqldb 1.0.0

package/dist/smart-cache/connection/redis.d.ts

@@ -0,0 +1,20 @@
+import Redis from 'ioredis';
+import { RedisConfig } from '../types/config';
+export declare class RedisConnectionManager {
+    private client;
+    private config;
+    private isHealthy;
+    constructor(config: RedisConfig);
+    connect(): Promise<Redis>;
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, ttlSeconds?: number): Promise<void>;
+    del(key: string | string[]): Promise<number>;
+    exists(key: string): Promise<boolean>;
+    scan(pattern: string): Promise<string[]>;
+    deletePattern(pattern: string): Promise<number>;
+    healthCheck(): Promise<boolean>;
+    close(): Promise<void>;
+    isConnected(): boolean;
+    getClient(): Redis | null;
+}
+//# sourceMappingURL=redis.d.ts.map

package/dist/smart-cache/connection/redis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../../src/smart-cache/connection/redis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAuB,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,SAAS,CAAkB;gBAEvB,MAAM,EAAE,WAAW;IAIzB,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC;IAsDzB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAaxC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBnE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAc5C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAcrC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA4BxC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ/C,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAU/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B,WAAW,IAAI,OAAO;IAItB,SAAS,IAAI,KAAK,GAAG,IAAI;CAG1B"}

package/dist/smart-cache/connection/redis.js

@@ -0,0 +1,168 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisConnectionManager = void 0;
+const ioredis_1 = __importDefault(require("ioredis"));
+class RedisConnectionManager {
+    constructor(config) {
+        this.client = null;
+        this.isHealthy = false;
+        this.config = config;
+    }
+    async connect() {
+        if (this.client && this.isHealthy) {
+            return this.client;
+        }
+        const options = {
+            host: this.config.host,
+            port: this.config.port || 6379,
+            password: this.config.password,
+            db: this.config.db || 0,
+            keyPrefix: this.config.keyPrefix || 'sdc:',
+            retryStrategy: (times) => {
+                const delay = Math.min(times * 50, 2000);
+                return delay;
+            },
+            ...this.config.options,
+        };
+        this.client = new ioredis_1.default(options);
+        this.client.on('connect', () => {
+            this.isHealthy = true;
+        });
+        this.client.on('error', (error) => {
+            this.isHealthy = false;
+            console.error('[Redis] Connection error:', error.message);
+        });
+        this.client.on('close', () => {
+            this.isHealthy = false;
+        });
+        // Wait for initial connection
+        await new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                reject(new Error('Redis connection timeout'));
+            }, 10000);
+            this.client.once('ready', () => {
+                clearTimeout(timeout);
+                this.isHealthy = true;
+                resolve();
+            });
+            this.client.once('error', (err) => {
+                clearTimeout(timeout);
+                reject(err);
+            });
+        });
+        return this.client;
+    }
+    async get(key) {
+        if (!this.isHealthy) {
+            return null;
+        }
+        try {
+            const client = await this.connect();
+            return await client.get(key);
+        }
+        catch (error) {
+            console.error('[Redis] Get error:', error);
+            return null;
+        }
+    }
+    async set(key, value, ttlSeconds) {
+        if (!this.isHealthy) {
+            return;
+        }
+        try {
+            const client = await this.connect();
+            if (ttlSeconds) {
+                await client.set(key, value, 'EX', ttlSeconds);
+            }
+            else {
+                await client.set(key, value);
+            }
+        }
+        catch (error) {
+            console.error('[Redis] Set error:', error);
+        }
+    }
+    async del(key) {
+        if (!this.isHealthy) {
+            return 0;
+        }
+        try {
+            const client = await this.connect();
+            const keys = Array.isArray(key) ? key : [key];
+            return await client.del(...keys);
+        }
+        catch (error) {
+            console.error('[Redis] Del error:', error);
+            return 0;
+        }
+    }
+    async exists(key) {
+        if (!this.isHealthy) {
+            return false;
+        }
+        try {
+            const client = await this.connect();
+            const result = await client.exists(key);
+            return result === 1;
+        }
+        catch (error) {
+            console.error('[Redis] Exists error:', error);
+            return false;
+        }
+    }
+    async scan(pattern) {
+        if (!this.isHealthy) {
+            return [];
+        }
+        try {
+            const client = await this.connect();
+            const keys = [];
+            let cursor = '0';
+            do {
+                const [nextCursor, matchedKeys] = await client.scan(cursor, 'MATCH', pattern, 'COUNT', 100);
+                cursor = nextCursor;
+                keys.push(...matchedKeys);
+            } while (cursor !== '0');
+            return keys;
+        }
+        catch (error) {
+            console.error('[Redis] Scan error:', error);
+            return [];
+        }
+    }
+    async deletePattern(pattern) {
+        const keys = await this.scan(pattern);
+        if (keys.length === 0) {
+            return 0;
+        }
+        return await this.del(keys);
+    }
+    async healthCheck() {
+        try {
+            const client = await this.connect();
+            const result = await client.ping();
+            return result === 'PONG';
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    async close() {
+        if (this.client) {
+            await this.client.quit();
+            this.client = null;
+            this.isHealthy = false;
+        }
+    }
+    isConnected() {
+        return this.client !== null && this.isHealthy;
+    }
+    getClient() {
+        return this.client;
+    }
+}
+exports.RedisConnectionManager = RedisConnectionManager;
+//# sourceMappingURL=redis.js.map

package/dist/smart-cache/connection/redis.js.map

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

package/dist/smart-cache/discovery/dependency-graph.d.ts

@@ -0,0 +1,20 @@
+import { TableRelationship } from '../types/schema';
+export declare class DependencyGraph {
+    private dependents;
+    private dependencies;
+    private maxDepth;
+    constructor(maxDepth?: number);
+    addRelationship(relationship: TableRelationship): void;
+    buildFromRelationships(relationships: TableRelationship[]): void;
+    getDependents(table: string): string[];
+    getDependencies(table: string): string[];
+    getInvalidationTargets(table: string): string[];
+    private bfsTraversal;
+    getAllTables(): string[];
+    clear(): void;
+    getGraphInfo(): {
+        tables: number;
+        relationships: number;
+    };
+}
+//# sourceMappingURL=dependency-graph.d.ts.map

package/dist/smart-cache/discovery/dependency-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-graph.d.ts","sourceRoot":"","sources":["../../../src/smart-cache/discovery/dependency-graph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,qBAAa,eAAe;IAE1B,OAAO,CAAC,UAAU,CAAuC;IAGzD,OAAO,CAAC,YAAY,CAAuC;IAE3D,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,GAAE,MAAU;IAIhC,eAAe,CAAC,YAAY,EAAE,iBAAiB,GAAG,IAAI;IAgBtD,sBAAsB,CAAC,aAAa,EAAE,iBAAiB,EAAE,GAAG,IAAI;IAMhE,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAItC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAIxC,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAS/C,OAAO,CAAC,YAAY;IA+BpB,YAAY,IAAI,MAAM,EAAE;IAcxB,KAAK,IAAI,IAAI;IAKb,YAAY,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE;CAa1D"}

package/dist/smart-cache/discovery/dependency-graph.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DependencyGraph = void 0;
+class DependencyGraph {
+    constructor(maxDepth = 3) {
+        // Adjacency list: table -> set of tables that depend on it (have FK to it)
+        this.dependents = new Map();
+        // Adjacency list: table -> set of tables it depends on (has FK to)
+        this.dependencies = new Map();
+        this.maxDepth = maxDepth;
+    }
+    addRelationship(relationship) {
+        const { fromTable, toTable } = relationship;
+        // fromTable depends on toTable (fromTable has FK to toTable)
+        if (!this.dependencies.has(fromTable)) {
+            this.dependencies.set(fromTable, new Set());
+        }
+        this.dependencies.get(fromTable).add(toTable);
+        // toTable has fromTable as dependent (fromTable references toTable)
+        if (!this.dependents.has(toTable)) {
+            this.dependents.set(toTable, new Set());
+        }
+        this.dependents.get(toTable).add(fromTable);
+    }
+    buildFromRelationships(relationships) {
+        for (const rel of relationships) {
+            this.addRelationship(rel);
+        }
+    }
+    getDependents(table) {
+        return Array.from(this.dependents.get(table) || []);
+    }
+    getDependencies(table) {
+        return Array.from(this.dependencies.get(table) || []);
+    }
+    getInvalidationTargets(table) {
+        const visited = new Set();
+        const targets = [];
+        this.bfsTraversal(table, visited, targets, 0);
+        return targets;
+    }
+    bfsTraversal(table, visited, targets, depth) {
+        if (visited.has(table) || depth > this.maxDepth) {
+            return;
+        }
+        visited.add(table);
+        targets.push(table);
+        // Get all tables that depend on this table
+        const dependents = this.getDependents(table);
+        for (const dependent of dependents) {
+            this.bfsTraversal(dependent, visited, targets, depth + 1);
+        }
+        // Optionally, also traverse dependencies (tables this table depends on)
+        // This is useful for bidirectional invalidation
+        const dependencies = this.getDependencies(table);
+        for (const dependency of dependencies) {
+            if (!visited.has(dependency) && depth < this.maxDepth) {
+                this.bfsTraversal(dependency, visited, targets, depth + 1);
+            }
+        }
+    }
+    getAllTables() {
+        const tables = new Set();
+        for (const table of this.dependents.keys()) {
+            tables.add(table);
+        }
+        for (const table of this.dependencies.keys()) {
+            tables.add(table);
+        }
+        return Array.from(tables);
+    }
+    clear() {
+        this.dependents.clear();
+        this.dependencies.clear();
+    }
+    getGraphInfo() {
+        const allTables = this.getAllTables();
+        let relationshipCount = 0;
+        for (const deps of this.dependencies.values()) {
+            relationshipCount += deps.size;
+        }
+        return {
+            tables: allTables.length,
+            relationships: relationshipCount,
+        };
+    }
+}
+exports.DependencyGraph = DependencyGraph;
+//# sourceMappingURL=dependency-graph.js.map

package/dist/smart-cache/discovery/dependency-graph.js.map

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

package/dist/smart-cache/discovery/relationship-parser.d.ts

@@ -0,0 +1,10 @@
+import { MariaDBConnectionManager } from '../connection/mariadb';
+import { TableRelationship } from '../types/schema';
+export declare class RelationshipParser {
+    private dbManager;
+    constructor(dbManager: MariaDBConnectionManager);
+    parseRelationships(): Promise<TableRelationship[]>;
+    private getCurrentDatabase;
+    private getForeignKeyRelationships;
+}
+//# sourceMappingURL=relationship-parser.d.ts.map

package/dist/smart-cache/discovery/relationship-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationship-parser.d.ts","sourceRoot":"","sources":["../../../src/smart-cache/discovery/relationship-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,SAAS,CAA2B;gBAEhC,SAAS,EAAE,wBAAwB;IAIzC,kBAAkB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;YAK1C,kBAAkB;YAKlB,0BAA0B;CA0BzC"}

package/dist/smart-cache/discovery/relationship-parser.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RelationshipParser = void 0;
+class RelationshipParser {
+    constructor(dbManager) {
+        this.dbManager = dbManager;
+    }
+    async parseRelationships() {
+        const database = await this.getCurrentDatabase();
+        return await this.getForeignKeyRelationships(database);
+    }
+    async getCurrentDatabase() {
+        const result = await this.dbManager.query('SELECT DATABASE() as db');
+        return result[0].db;
+    }
+    async getForeignKeyRelationships(database) {
+        const sql = `
+      SELECT
+        kcu.CONSTRAINT_NAME as constraintName,
+        kcu.TABLE_NAME as fromTable,
+        kcu.COLUMN_NAME as fromColumn,
+        kcu.REFERENCED_TABLE_NAME as toTable,
+        kcu.REFERENCED_COLUMN_NAME as toColumn
+      FROM INFORMATION_SCHEMA.KEY_COLUMN_USAGE kcu
+      WHERE kcu.TABLE_SCHEMA = ?
+      AND kcu.REFERENCED_TABLE_NAME IS NOT NULL
+      ORDER BY kcu.TABLE_NAME, kcu.CONSTRAINT_NAME
+    `;
+        const result = await this.dbManager.query(sql, [database]);
+        return result.map((row) => ({
+            constraintName: row.constraintName,
+            fromTable: row.fromTable,
+            fromColumn: row.fromColumn,
+            toTable: row.toTable,
+            toColumn: row.toColumn,
+        }));
+    }
+}
+exports.RelationshipParser = RelationshipParser;
+//# sourceMappingURL=relationship-parser.js.map

package/dist/smart-cache/discovery/relationship-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationship-parser.js","sourceRoot":"","sources":["../../../src/smart-cache/discovery/relationship-parser.ts"],"names":[],"mappings":";;;AAGA,MAAa,kBAAkB;IAG7B,YAAY,SAAmC;QAC7C,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,kBAAkB;QACtB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACjD,OAAO,MAAM,IAAI,CAAC,0BAA0B,CAAC,QAAQ,CAAC,CAAC;IACzD,CAAC;IAEO,KAAK,CAAC,kBAAkB;QAC9B,MAAM,MAAM,GAAQ,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC1E,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACtB,CAAC;IAEO,KAAK,CAAC,0BAA0B,CACtC,QAAgB;QAEhB,MAAM,GAAG,GAAG;;;;;;;;;;;KAWX,CAAC;QAEF,MAAM,MAAM,GAAQ,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;QAEhE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,GAAQ,EAAE,EAAE,CAAC,CAAC;YAC/B,cAAc,EAAE,GAAG,CAAC,cAAc;YAClC,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,QAAQ,EAAE,GAAG,CAAC,QAAQ;SACvB,CAAC,CAAC,CAAC;IACN,CAAC;CACF;AA3CD,gDA2CC"}

package/dist/smart-cache/discovery/schema-reader.d.ts

@@ -0,0 +1,15 @@
+import { MariaDBConnectionManager } from '../connection/mariadb';
+import { TableSchema } from '../types/schema';
+import { DiscoveryConfig } from '../types/config';
+export declare class SchemaReader {
+    private dbManager;
+    private config;
+    constructor(dbManager: MariaDBConnectionManager, config: DiscoveryConfig);
+    discoverTables(): Promise<TableSchema[]>;
+    private getCurrentDatabase;
+    private getTableNames;
+    private filterTables;
+    private getTableColumns;
+    private findPrimaryKey;
+}
+//# sourceMappingURL=schema-reader.d.ts.map

package/dist/smart-cache/discovery/schema-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-reader.d.ts","sourceRoot":"","sources":["../../../src/smart-cache/discovery/schema-reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,WAAW,EAAc,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,MAAM,CAAkB;gBAEpB,SAAS,EAAE,wBAAwB,EAAE,MAAM,EAAE,eAAe;IAKlE,cAAc,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YAqBhC,kBAAkB;YAKlB,aAAa;IAa3B,OAAO,CAAC,YAAY;YAoBN,eAAe;IA8B7B,OAAO,CAAC,cAAc;CAIvB"}

package/dist/smart-cache/discovery/schema-reader.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SchemaReader = void 0;
+class SchemaReader {
+    constructor(dbManager, config) {
+        this.dbManager = dbManager;
+        this.config = config;
+    }
+    async discoverTables() {
+        const database = await this.getCurrentDatabase();
+        const tables = await this.getTableNames(database);
+        const filteredTables = this.filterTables(tables);
+        const tableSchemas = [];
+        for (const tableName of filteredTables) {
+            const columns = await this.getTableColumns(database, tableName);
+            const primaryKey = this.findPrimaryKey(columns);
+            tableSchemas.push({
+                tableName,
+                columns,
+                primaryKey,
+            });
+        }
+        return tableSchemas;
+    }
+    async getCurrentDatabase() {
+        const result = await this.dbManager.query('SELECT DATABASE() as db');
+        return result[0].db;
+    }
+    async getTableNames(database) {
+        const sql = `
+      SELECT TABLE_NAME
+      FROM INFORMATION_SCHEMA.TABLES
+      WHERE TABLE_SCHEMA = ?
+      AND TABLE_TYPE = 'BASE TABLE'
+      ORDER BY TABLE_NAME
+    `;
+        const result = await this.dbManager.query(sql, [database]);
+        return result.map((row) => row.TABLE_NAME);
+    }
+    filterTables(tables) {
+        let filtered = tables;
+        // Apply include list
+        if (this.config.includeTables && this.config.includeTables.length > 0) {
+            filtered = filtered.filter((table) => this.config.includeTables.includes(table));
+        }
+        // Apply exclude list
+        if (this.config.excludeTables && this.config.excludeTables.length > 0) {
+            filtered = filtered.filter((table) => !this.config.excludeTables.includes(table));
+        }
+        return filtered;
+    }
+    async getTableColumns(database, tableName) {
+        const sql = `
+      SELECT
+        COLUMN_NAME as columnName,
+        DATA_TYPE as dataType,
+        IS_NULLABLE as isNullable,
+        COLUMN_KEY as columnKey,
+        COLUMN_DEFAULT as columnDefault,
+        EXTRA as extra
+      FROM INFORMATION_SCHEMA.COLUMNS
+      WHERE TABLE_SCHEMA = ?
+      AND TABLE_NAME = ?
+      ORDER BY ORDINAL_POSITION
+    `;
+        const result = await this.dbManager.query(sql, [database, tableName]);
+        return result.map((row) => ({
+            columnName: row.columnName,
+            dataType: row.dataType,
+            isNullable: row.isNullable === 'YES',
+            columnKey: row.columnKey || '',
+            columnDefault: row.columnDefault,
+            extra: row.extra || '',
+        }));
+    }
+    findPrimaryKey(columns) {
+        const pkColumn = columns.find((col) => col.columnKey === 'PRI');
+        return pkColumn?.columnName;
+    }
+}
+exports.SchemaReader = SchemaReader;
+//# sourceMappingURL=schema-reader.js.map

package/dist/smart-cache/discovery/schema-reader.js.map

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

package/dist/smart-cache/examples/basic-usage.d.ts

@@ -0,0 +1,3 @@
+declare function basicUsageExample(): Promise<void>;
+export { basicUsageExample };
+//# sourceMappingURL=basic-usage.d.ts.map

package/dist/smart-cache/examples/basic-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"basic-usage.d.ts","sourceRoot":"","sources":["../../../src/smart-cache/examples/basic-usage.ts"],"names":[],"mappings":"AAEA,iBAAe,iBAAiB,kBA+H/B;AAOD,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/smart-cache/examples/basic-usage.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.basicUsageExample = basicUsageExample;
+const index_1 = require("../index");
+async function basicUsageExample() {
+    // Initialize the smart cache client
+    const db = await (0, index_1.createSmartDB)({
+        mariadb: {
+            host: 'localhost',
+            user: 'root',
+            password: 'password',
+            database: 'mydb',
+        },
+        redis: {
+            host: 'localhost',
+            port: 6379,
+        },
+        cache: {
+            enabled: true,
+            defaultTTL: 60, // 60 seconds
+            maxKeys: 1000,
+            invalidateOnWrite: true,
+            cascadeInvalidation: true,
+        },
+        discovery: {
+            autoDiscover: true,
+            refreshInterval: 0, // manual refresh only
+        },
+        logging: {
+            level: 'info',
+        },
+    });
+    try {
+        // === READ OPERATIONS (Cache-first) ===
+        // Find one user
+        const user = await db.users.findOne({ email: 'john@example.com' });
+        console.log('User:', user);
+        // Find many users with options
+        const activeUsers = await db.users.findMany({ status: 'active' }, { limit: 10, orderBy: { column: 'created_at', direction: 'DESC' } });
+        console.log('Active users:', activeUsers.length);
+        // Find by ID (optimized cache key)
+        const userById = await db.users.findById(1);
+        console.log('User by ID:', userById);
+        // Count records
+        const userCount = await db.users.count({ status: 'active' });
+        console.log('Active user count:', userCount);
+        // === WRITE OPERATIONS (Auto-invalidates cache) ===
+        // Insert one record
+        const newUser = await db.users.insertOne({
+            name: 'Jane Doe',
+            email: 'jane@example.com',
+            status: 'active',
+        });
+        console.log('New user created:', newUser);
+        // Insert many records
+        const newUsers = await db.users.insertMany([
+            { name: 'Alice', email: 'alice@example.com', status: 'active' },
+            { name: 'Bob', email: 'bob@example.com', status: 'inactive' },
+        ]);
+        console.log('Created', newUsers.length, 'users');
+        // Update one record
+        const updated = await db.users.updateOne({ email: 'jane@example.com' }, { status: 'verified' });
+        console.log('Updated user:', updated);
+        // Update by ID
+        const updatedById = await db.users.updateById(1, {
+            last_login: new Date(),
+        });
+        console.log('Updated user by ID:', updatedById);
+        // Update many records
+        const updateCount = await db.users.updateMany({ status: 'inactive' }, { status: 'archived' });
+        console.log('Updated', updateCount, 'users');
+        // Delete one record
+        const deleted = await db.users.deleteOne({ email: 'test@example.com' });
+        console.log('Deleted:', deleted);
+        // Delete by ID
+        const deletedById = await db.users.deleteById(999);
+        console.log('Deleted by ID:', deletedById);
+        // === RAW SQL (Bypass cache) ===
+        const customQuery = await db.users.raw('SELECT COUNT(*) as total FROM users WHERE created_at > ?', [new Date('2024-01-01')]);
+        console.log('Custom query result:', customQuery);
+        // === CACHE MANAGEMENT ===
+        // Get cache statistics
+        const stats = db.getCacheManager().getStats();
+        console.log('Cache stats:', stats);
+        // Manually invalidate cache for a table
+        await db.users.invalidateCache();
+        // Warm cache (pre-populate for common queries)
+        await db.users.warmCache({ status: 'active' });
+        // === HEALTH CHECK ===
+        const health = await db.healthCheck();
+        console.log('Health:', health);
+        // === DISCOVERED TABLES ===
+        const tables = db.getDiscoveredTables();
+        console.log('Discovered tables:', tables);
+    }
+    finally {
+        // Close connections
+        await db.close();
+    }
+}
+// Run the example
+if (require.main === module) {
+    basicUsageExample().catch(console.error);
+}
+//# sourceMappingURL=basic-usage.js.map

package/dist/smart-cache/examples/basic-usage.js.map

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

package/dist/smart-cache/examples/hooks-example.d.ts

@@ -0,0 +1,3 @@
+declare function hooksExample(): Promise<void>;
+export { hooksExample };
+//# sourceMappingURL=hooks-example.d.ts.map

package/dist/smart-cache/examples/hooks-example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-example.d.ts","sourceRoot":"","sources":["../../../src/smart-cache/examples/hooks-example.ts"],"names":[],"mappings":"AAEA,iBAAe,YAAY,kBAgJ1B;AAOD,OAAO,EAAE,YAAY,EAAE,CAAC"}