@onurege3467/zerohelper 10.3.0 → 11.0.0

package/dist/database/IDatabase.d.ts

@@ -1,71 +0,0 @@
-export type HookType = 'beforeInsert' | 'afterInsert' | 'beforeUpdate' | 'afterUpdate' | 'beforeDelete' | 'afterDelete';
-export type HookFunction = (table: string, data: any) => Promise<void> | void;
-/**
- * Defines the common interface that all database adapters must implement.
- */
-export declare abstract class IDatabase {
-    protected hooks: Record<HookType, HookFunction[]>;
-    /**
-     * Registers a lifecycle hook.
-     */
-    on(hook: HookType, fn: HookFunction): void;
-    protected runHooks(hook: HookType, table: string, data: any): Promise<void>;
-    /**
-     * Returns performance metrics for the database and cache.
-     */
-    getMetrics(): {
-        database: {
-            totalOperations: number;
-            averageDuration: string;
-            slowestOperations: import("./telemetry").DatabaseMetrics[];
-            recentLogs: import("./telemetry").DatabaseMetrics[];
-        };
-        cache: {
-            ratio: string;
-            hits: number;
-            misses: number;
-        };
-    };
-    protected recordMetric(operation: string, table: string, duration: number): void;
-    /**
-     * Selects multiple records based on the specified conditions.
-     */
-    abstract select<T = any>(table: string, where?: Record<string, any> | null): Promise<T[]>;
-    /**
-     * Selects a single record based on the specified conditions.
-     */
-    abstract selectOne<T = any>(table: string, where?: Record<string, any> | null): Promise<T | null>;
-    /**
-     * Inserts a new record.
-     */
-    abstract insert(table: string, data: Record<string, any>): Promise<number | string | any>;
-    /**
-     * Updates records matching the specified conditions.
-     */
-    abstract update(table: string, data: Record<string, any>, where: Record<string, any>): Promise<number>;
-    /**
-     * Updates a record or inserts it as a new record if it doesn't exist (Upsert).
-     */
-    abstract set(table: string, data: Record<string, any>, where: Record<string, any>): Promise<any>;
-    /**
-     * Deletes records matching the specified conditions.
-     */
-    abstract delete(table: string, where: Record<string, any>): Promise<number>;
-    /**
-     * Inserts multiple records in bulk.
-     */
-    abstract bulkInsert(table: string, dataArray: Record<string, any>[]): Promise<number>;
-    /**
-     * Increments numeric fields.
-     */
-    abstract increment(table: string, increments: Record<string, number>, where: Record<string, any>): Promise<number>;
-    /**
-     * Decrements numeric fields.
-     */
-    abstract decrement(table: string, decrements: Record<string, number>, where: Record<string, any>): Promise<number>;
-    /**
-     * Safely closes the database connection.
-     */
-    abstract close(): Promise<void>;
-}
-export default IDatabase;

package/dist/database/IDatabase.js

@@ -1,48 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.IDatabase = void 0;
-const telemetry_1 = require("./telemetry");
-/**
- * Defines the common interface that all database adapters must implement.
- */
-class IDatabase {
-    constructor() {
-        this.hooks = {
-            beforeInsert: [],
-            afterInsert: [],
-            beforeUpdate: [],
-            afterUpdate: [],
-            beforeDelete: [],
-            afterDelete: [],
-        };
-    }
-    /**
-     * Registers a lifecycle hook.
-     */
-    on(hook, fn) {
-        if (this.hooks[hook]) {
-            this.hooks[hook].push(fn);
-        }
-    }
-    async runHooks(hook, table, data) {
-        for (const fn of this.hooks[hook]) {
-            await fn(table, data);
-        }
-    }
-    /**
-     * Returns performance metrics for the database and cache.
-     */
-    getMetrics() {
-        return telemetry_1.telemetry.getMetrics();
-    }
-    recordMetric(operation, table, duration) {
-        telemetry_1.telemetry.recordDb({
-            operation,
-            table,
-            duration,
-            timestamp: Date.now()
-        });
-    }
-}
-exports.IDatabase = IDatabase;
-exports.default = IDatabase;

package/dist/database/cacheWrapper.d.ts

@@ -1,34 +0,0 @@
-import { IDatabase, HookType, HookFunction } from './IDatabase';
-export declare class CacheWrapper extends IDatabase {
-    db: IDatabase;
-    private cacheType;
-    private tableCaches;
-    private redisClient;
-    private redisAvailable;
-    private ttl;
-    private keyPrefix;
-    private cache;
-    constructor(databaseInstance: IDatabase, options?: any);
-    /**
-     * Redirect hooks registration to the underlying database instance.
-     */
-    on(hook: HookType, fn: HookFunction): void;
-    private _initMemoryCache;
-    private _initRedisCache;
-    private _getCache;
-    private _generateKey;
-    private _getCacheValue;
-    private _setCacheValue;
-    private _clearCache;
-    select<T = any>(table: string, where?: Record<string, any> | null): Promise<T[]>;
-    selectOne<T = any>(table: string, where?: Record<string, any> | null): Promise<T | null>;
-    insert(table: string, data: Record<string, any>): Promise<any>;
-    update(table: string, data: Record<string, any>, where: Record<string, any>): Promise<number>;
-    set(table: string, data: Record<string, any>, where: Record<string, any>): Promise<any>;
-    delete(table: string, where: Record<string, any>): Promise<number>;
-    bulkInsert(table: string, dataArray: Record<string, any>[]): Promise<number>;
-    increment(table: string, increments: Record<string, number>, where?: Record<string, any>): Promise<number>;
-    decrement(table: string, decrements: Record<string, number>, where?: Record<string, any>): Promise<number>;
-    close(): Promise<void>;
-}
-export default CacheWrapper;

package/dist/database/cacheWrapper.js

@@ -1,214 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CacheWrapper = void 0;
-const IDatabase_1 = require("./IDatabase");
-const lru_cache_1 = require("lru-cache");
-const redis_1 = require("redis");
-const telemetry_1 = require("./telemetry");
-class CacheWrapper extends IDatabase_1.IDatabase {
-    constructor(databaseInstance, options = {}) {
-        super();
-        this.tableCaches = {};
-        this.redisClient = null;
-        this.redisAvailable = false;
-        this.ttl = 300;
-        this.keyPrefix = 'db_cache:';
-        this.cache = null;
-        this.db = databaseInstance;
-        this.cacheType = options.type || 'memory';
-        if (this.cacheType === 'redis') {
-            this._initRedisCache(options);
-        }
-        else {
-            this._initMemoryCache(options);
-        }
-    }
-    /**
-     * Redirect hooks registration to the underlying database instance.
-     */
-    on(hook, fn) {
-        this.db.on(hook, fn);
-    }
-    _initMemoryCache(options) {
-        this.cache = new lru_cache_1.LRUCache({
-            max: options.max || 500,
-            ttl: options.ttl || 1000 * 60 * 5,
-        });
-        this.redisAvailable = false;
-    }
-    async _initRedisCache(options) {
-        const redisConfig = {
-            socket: {
-                host: options.host || '127.0.0.1',
-                port: options.port || 6379,
-                connectTimeout: options.connectTimeout || 5000,
-            },
-            password: options.password,
-            database: options.db || 0,
-        };
-        this.redisClient = (0, redis_1.createClient)(redisConfig);
-        this.ttl = (options.ttl || 300000) / 1000;
-        this.keyPrefix = options.keyPrefix || 'db_cache:';
-        this.redisClient.on('error', () => {
-            this.redisAvailable = false;
-        });
-        this.redisClient.on('ready', () => {
-            this.redisAvailable = true;
-        });
-        try {
-            await this.redisClient.connect();
-            this.redisAvailable = true;
-        }
-        catch (error) {
-            this._initMemoryCache(options);
-        }
-    }
-    _getCache(table) {
-        if (this.cacheType === 'redis' && this.redisAvailable && this.redisClient)
-            return this.redisClient;
-        if (!this.tableCaches[table]) {
-            this.tableCaches[table] = new lru_cache_1.LRUCache({
-                max: this.cache?.max || 500,
-                ttl: this.cache?.ttl || 300000,
-            });
-        }
-        return this.tableCaches[table];
-    }
-    _generateKey(table, where) {
-        const sortedWhere = where ? Object.keys(where).sort().reduce((acc, key) => {
-            acc[key] = where[key];
-            return acc;
-        }, {}) : {};
-        const key = `${table}:${JSON.stringify(sortedWhere)}`;
-        return this.cacheType === 'redis' ? `${this.keyPrefix}${key}` : key;
-    }
-    async _getCacheValue(cache, key, table) {
-        if (this.cacheType === 'redis' && this.redisAvailable && this.redisClient) {
-            try {
-                const value = await cache.get(key);
-                if (value) {
-                    telemetry_1.telemetry.recordCacheHit();
-                    return JSON.parse(value);
-                }
-            }
-            catch {
-                this.redisAvailable = false;
-            }
-        }
-        else if (cache instanceof lru_cache_1.LRUCache) {
-            const value = cache.get(key);
-            if (value) {
-                telemetry_1.telemetry.recordCacheHit();
-                return value;
-            }
-        }
-        telemetry_1.telemetry.recordCacheMiss();
-        return null;
-    }
-    async _setCacheValue(cache, key, value, table) {
-        if (this.cacheType === 'redis' && this.redisAvailable && this.redisClient) {
-            try {
-                await cache.setEx(key, Math.floor(this.ttl), JSON.stringify(value));
-            }
-            catch {
-                this.redisAvailable = false;
-                this._getCache(table).set(key, value);
-            }
-        }
-        else {
-            cache.set(key, value);
-        }
-    }
-    async _clearCache(table) {
-        if (this.cacheType === 'redis' && this.redisAvailable && this.redisClient) {
-            try {
-                const keys = await this.redisClient.keys(`${this.keyPrefix}${table}:*`);
-                if (keys.length)
-                    await this.redisClient.del(keys);
-            }
-            catch {
-                this.redisAvailable = false;
-            }
-        }
-        if (this.tableCaches[table])
-            this.tableCaches[table].clear();
-    }
-    async select(table, where = null) {
-        const cache = this._getCache(table);
-        const key = this._generateKey(table, where);
-        let data = await this._getCacheValue(cache, key, table);
-        if (data !== null && data !== undefined)
-            return data;
-        const start = Date.now();
-        data = await this.db.select(table, where);
-        this.db.recordMetric?.('select', table, Date.now() - start);
-        if (data !== null && data !== undefined)
-            await this._setCacheValue(cache, key, data, table);
-        return data;
-    }
-    async selectOne(table, where = null) {
-        const cache = this._getCache(table);
-        const key = this._generateKey(table + '_one', where);
-        let data = await this._getCacheValue(cache, key, table);
-        if (data !== null && data !== undefined)
-            return data;
-        const start = Date.now();
-        data = await this.db.selectOne(table, where);
-        this.db.recordMetric?.('selectOne', table, Date.now() - start);
-        if (data !== null && data !== undefined)
-            await this._setCacheValue(cache, key, data, table);
-        return data;
-    }
-    async insert(table, data) {
-        const start = Date.now();
-        const result = await this.db.insert(table, data);
-        this.db.recordMetric?.('insert', table, Date.now() - start);
-        await this._clearCache(table);
-        return result;
-    }
-    async update(table, data, where) {
-        const start = Date.now();
-        const result = await this.db.update(table, data, where);
-        this.db.recordMetric?.('update', table, Date.now() - start);
-        if (result > 0)
-            await this._clearCache(table);
-        return result;
-    }
-    async set(table, data, where) {
-        const result = await this.db.set(table, data, where);
-        await this._clearCache(table);
-        return result;
-    }
-    async delete(table, where) {
-        const start = Date.now();
-        const result = await this.db.delete(table, where);
-        this.db.recordMetric?.('delete', table, Date.now() - start);
-        if (result > 0)
-            await this._clearCache(table);
-        return result;
-    }
-    async bulkInsert(table, dataArray) {
-        const result = await this.db.bulkInsert(table, dataArray);
-        await this._clearCache(table);
-        return result;
-    }
-    async increment(table, increments, where = {}) {
-        const result = await this.db.increment(table, increments, where);
-        await this._clearCache(table);
-        return result;
-    }
-    async decrement(table, decrements, where = {}) {
-        const result = await this.db.decrement(table, decrements, where);
-        await this._clearCache(table);
-        return result;
-    }
-    async close() {
-        if (this.redisClient) {
-            await this.redisClient.quit();
-            this.redisClient = null;
-        }
-        await this.db.close();
-    }
-}
-exports.CacheWrapper = CacheWrapper;
-exports.default = CacheWrapper;

package/dist/database/index.d.ts

@@ -1,12 +0,0 @@
-import { IDatabase } from './IDatabase';
-import { DatabaseOptions } from './types';
-import MigrationManager from './migration';
-import ZPackAdapter, { ZPackDatabase } from './zpack';
-import ToonDatabase from './toon';
-import { DataSeeder } from './seeder';
-/**
- * Belirtilen adaptör tipine göre bir veritabanı örneği oluşturur ve döndürür.
- */
-export declare function createDatabase(options: DatabaseOptions): IDatabase;
-export { IDatabase, MigrationManager, ZPackDatabase, ZPackAdapter, DataSeeder, ToonDatabase };
-export default createDatabase;

package/dist/database/index.js

@@ -1,100 +0,0 @@
-"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;
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ToonDatabase = exports.DataSeeder = exports.ZPackAdapter = exports.ZPackDatabase = exports.MigrationManager = exports.IDatabase = void 0;
-exports.createDatabase = createDatabase;
-const IDatabase_1 = require("./IDatabase");
-Object.defineProperty(exports, "IDatabase", { enumerable: true, get: function () { return IDatabase_1.IDatabase; } });
-const mysql_1 = __importDefault(require("./mysql"));
-const sqlite_1 = __importDefault(require("./sqlite"));
-const mongodb_1 = __importDefault(require("./mongodb"));
-const json_1 = __importDefault(require("./json"));
-const pg_1 = __importDefault(require("./pg"));
-const redis_1 = __importDefault(require("./redis"));
-const cacheWrapper_1 = __importDefault(require("./cacheWrapper"));
-const migration_1 = __importDefault(require("./migration"));
-exports.MigrationManager = migration_1.default;
-const zpack_1 = __importStar(require("./zpack"));
-exports.ZPackAdapter = zpack_1.default;
-Object.defineProperty(exports, "ZPackDatabase", { enumerable: true, get: function () { return zpack_1.ZPackDatabase; } });
-const toon_1 = __importDefault(require("./toon"));
-exports.ToonDatabase = toon_1.default;
-const seeder_1 = require("./seeder");
-Object.defineProperty(exports, "DataSeeder", { enumerable: true, get: function () { return seeder_1.DataSeeder; } });
-const adapters = {
-    mysql: mysql_1.default,
-    sqlite: sqlite_1.default,
-    mongodb: mongodb_1.default,
-    postgres: pg_1.default,
-    json: json_1.default,
-    redis: redis_1.default,
-    zpack: zpack_1.default,
-    toon: toon_1.default,
-};
-/**
- * Belirtilen adaptör tipine göre bir veritabanı örneği oluşturur ve döndürür.
- */
-function createDatabase(options) {
-    const { adapter, config } = options;
-    if (!adapter || !adapters[adapter]) {
-        throw new Error(`Geçersiz veya desteklenmeyen adaptör: ${adapter}. Desteklenenler: ${Object.keys(adapters).join(', ')}`);
-    }
-    if (!config) {
-        throw new Error(`'${adapter}' adaptörü için yapılandırma (config) gereklidir.`);
-    }
-    const DatabaseClass = adapters[adapter];
-    const dbInstance = new DatabaseClass(config);
-    if (config.cache) {
-        const wrapper = new cacheWrapper_1.default(dbInstance, config.cache);
-        return new Proxy(wrapper, {
-            get: (target, prop) => {
-                if (prop in target) {
-                    const val = target[prop];
-                    return typeof val === 'function' ? val.bind(target) : val;
-                }
-                if (prop in target.db) {
-                    const val = target.db[prop];
-                    return typeof val === 'function' ? val.bind(target.db) : val;
-                }
-                return undefined;
-            }
-        });
-    }
-    return dbInstance;
-}
-exports.default = createDatabase;

package/dist/database/json.d.ts

@@ -1,32 +0,0 @@
-import { IDatabase } from './IDatabase';
-import { JsonConfig } from './types';
-export declare class JsonDatabase extends IDatabase {
-    private filePath;
-    private db;
-    private isDirty;
-    private isWriting;
-    private writeQueue;
-    private saveDebounceTimeout;
-    private saveInterval;
-    private initPromise;
-    constructor(config: JsonConfig);
-    private _execute;
-    private _load;
-    private _queueRequest;
-    private _processQueue;
-    private _scheduleSave;
-    private _saveNow;
-    private flushSync;
-    ensureTable(table: string): Promise<void>;
-    insert(table: string, data: Record<string, any>): Promise<number>;
-    update(table: string, data: Record<string, any>, where: Record<string, any>): Promise<number>;
-    delete(table: string, where: Record<string, any>): Promise<number>;
-    select<T = any>(table: string, where?: Record<string, any> | null): Promise<T[]>;
-    selectOne<T = any>(table: string, where?: Record<string, any> | null): Promise<T | null>;
-    set(table: string, data: Record<string, any>, where: Record<string, any>): Promise<any>;
-    bulkInsert(table: string, dataArray: Record<string, any>[]): Promise<number>;
-    increment(table: string, incs: Record<string, number>, where?: Record<string, any>): Promise<number>;
-    decrement(table: string, decs: Record<string, number>, where?: Record<string, any>): Promise<number>;
-    close(): Promise<void>;
-}
-export default JsonDatabase;