@onurege3467/zerohelper 7.1.0 → 8.0.0

package/database/index.js

@@ -1,10 +1,13 @@
+// database-factory.js
 const IDatabase = require('./IDatabase');
 const MySQLDatabase = require('./mysql');
 const SQLiteDatabase = require('./sqlite');
 const MongoDBDatabase = require('./mongodb');
 const JsonDatabase = require('./json');
 const PostgreSQLDatabase = require('./pg');
+const RedisDatabase = require('./redis'); // Yeni Redis adapter
 const CacheWrapper = require('./cacheWrapper');
+const MigrationManager = require('./migration');
 
 const adapters = {
   mysql: MySQLDatabase,
@@ -12,6 +15,7 @@ const adapters = {
   mongodb: MongoDBDatabase,
   postgres: PostgreSQLDatabase,
   json: JsonDatabase,
+  redis: RedisDatabase, // Redis adapter eklendi
 };
 
 /**
@@ -19,7 +23,7 @@ const adapters = {
  * Bu bir "Fabrika Fonksiyonu"dur.
  *
  * @param {object} options - Yapılandırma seçenekleri.
- * @param {keyof adapters} options.adapter - Kullanılacak adaptör ('mysql', 'sqlite', vb.).
+ * @param {keyof adapters} options.adapter - Kullanılacak adaptör ('mysql', 'sqlite', 'redis', vb.).
  * @param {object} options.config - Seçilen adaptöre özel yapılandırma.
  * @returns {IDatabase} - IDatabase arayüzünü uygulayan bir örnek döndürür.
  */
@@ -61,5 +65,8 @@ function createDatabase(options) {
 // Artık varsayılan olarak bu fonksiyonu export ediyoruz.
 module.exports = createDatabase;
 
+// Migration manager'ı da export ediyoruz
+module.exports.MigrationManager = MigrationManager;
+
 // Eğer hem fonksiyonu hem de tipleri export etmek isterseniz:
-// module.exports = { createDatabase };
+// module.exports = { createDatabase, MigrationManager };

package/database/json.js

@@ -106,6 +106,11 @@ class JsonDatabase extends IDatabase{
     return Object.keys(where).every(key => row[key] === where[key]);
   }
 
+  // Alias for consistency with cache wrapper
+  _matchesWhere(row, where) {
+    return this._matches(row, where);
+  }
+
   // --- GENEL (PUBLIC) API ---
 
   async ensureTable(table) {
@@ -214,6 +219,60 @@ class JsonDatabase extends IDatabase{
     });
   }
 
+  /**
+   * Numerik alanları artırır (increment).
+   * @param {string} table - Verinin güncelleneceği tablo adı.
+   * @param {object} increments - Artırılacak alanlar ve miktarları.
+   * @param {object} where - Güncelleme koşulları.
+   * @returns {Promise<number>} Etkilenen kayıt sayısı.
+   */
+  async increment(table, increments, where = {}) {
+    await this.ensureTable(table);
+    return this._queueRequest(() => {
+      let affectedCount = 0;
+      this.db[table].forEach(row => {
+        if (this._matchesWhere(row, where)) {
+          for (const [field, value] of Object.entries(increments)) {
+            if (typeof row[field] === 'number') {
+              row[field] += value;
+            } else {
+              row[field] = value; // Eğer field sayı değilse, yeni değeri ata
+            }
+          }
+          affectedCount++;
+        }
+      });
+      return affectedCount;
+    });
+  }
+
+  /**
+   * Numerik alanları azaltır (decrement).
+   * @param {string} table - Verinin güncelleneceği tablo adı.
+   * @param {object} decrements - Azaltılacak alanlar ve miktarları.
+   * @param {object} where - Güncelleme koşulları.
+   * @returns {Promise<number>} Etkilenen kayıt sayısı.
+   */
+  async decrement(table, decrements, where = {}) {
+    await this.ensureTable(table);
+    return this._queueRequest(() => {
+      let affectedCount = 0;
+      this.db[table].forEach(row => {
+        if (this._matchesWhere(row, where)) {
+          for (const [field, value] of Object.entries(decrements)) {
+            if (typeof row[field] === 'number') {
+              row[field] -= value;
+            } else {
+              row[field] = -value; // Eğer field sayı değilse, negatif değeri ata
+            }
+          }
+          affectedCount++;
+        }
+      });
+      return affectedCount;
+    });
+  }
+
   async close() {
     await this._saveNow();
   }

package/database/migration.js

@@ -0,0 +1,227 @@
+const fs = require('fs');
+const path = require('path');
+
+class MigrationManager {
+  constructor(database, options = {}) {
+    this.db = database;
+    this.migrationsDir = options.migrationsDir || './migrations';
+    this.migrationsTable = options.migrationsTable || 'migrations';
+    this.ensureMigrationsDir();
+  }
+
+  ensureMigrationsDir() {
+    if (!fs.existsSync(this.migrationsDir)) {
+      fs.mkdirSync(this.migrationsDir, { recursive: true });
+    }
+  }
+
+  async ensureMigrationsTable() {
+    try {
+      // Migrations tablosu var mı kontrol et
+      await this.db.selectOne(this.migrationsTable, {});
+    } catch (error) {
+      // Tablo yoksa oluştur
+      const createTableSQL = `
+        CREATE TABLE IF NOT EXISTS ${this.migrationsTable} (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          name VARCHAR(255) NOT NULL UNIQUE,
+          executed_at DATETIME DEFAULT CURRENT_TIMESTAMP
+        )
+      `;
+      
+      // SQLite, MySQL, PostgreSQL için farklı SQL'ler
+      if (this.db.constructor.name === 'MySQLDatabase') {
+        await this.db.query(createTableSQL.replace('AUTOINCREMENT', 'AUTO_INCREMENT'));
+      } else if (this.db.constructor.name === 'PostgreSQLDatabase') {
+        const pgSQL = `
+          CREATE TABLE IF NOT EXISTS ${this.migrationsTable} (
+            id SERIAL PRIMARY KEY,
+            name VARCHAR(255) NOT NULL UNIQUE,
+            executed_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+          )
+        `;
+        await this.db.query(pgSQL);
+      } else {
+        // SQLite
+        await this.db.query(createTableSQL);
+      }
+    }
+  }
+
+  createMigration(name, description = '') {
+    const timestamp = Date.now();
+    const filename = `${timestamp}_${name}.js`;
+    const filePath = path.join(this.migrationsDir, filename);
+    
+    const template = `// Migration: ${name}
+// Description: ${description}
+// Created: ${new Date().toISOString()}
+
+module.exports = {
+  async up(db) {
+    // Migration işlemlerini buraya yazın
+    // Örnek:
+    // await db.query(\`
+    //   CREATE TABLE users (
+    //     id INTEGER PRIMARY KEY AUTOINCREMENT,
+    //     name VARCHAR(255) NOT NULL,
+    //     email VARCHAR(255) UNIQUE NOT NULL
+    //   )
+    // \`);
+    
+    console.log('Migration ${name} executed (up)');
+  },
+
+  async down(db) {
+    // Rollback işlemlerini buraya yazın
+    // Örnek:
+    // await db.query('DROP TABLE IF EXISTS users');
+    
+    console.log('Migration ${name} rolled back (down)');
+  }
+};
+`;
+
+    fs.writeFileSync(filePath, template);
+    console.log(`Migration oluşturuldu: ${filename}`);
+    return filename;
+  }
+
+  getMigrationFiles() {
+    const files = fs.readdirSync(this.migrationsDir)
+      .filter(file => file.endsWith('.js'))
+      .sort();
+    
+    return files.map(file => ({
+      name: file,
+      path: path.join(this.migrationsDir, file)
+    }));
+  }
+
+  async getExecutedMigrations() {
+    await this.ensureMigrationsTable();
+    
+    try {
+      const executed = await this.db.select(this.migrationsTable, {});
+      return executed.map(row => row.name);
+    } catch (error) {
+      console.error('Executed migrations alınırken hata:', error);
+      return [];
+    }
+  }
+
+  async getPendingMigrations() {
+    const allMigrations = this.getMigrationFiles();
+    const executedMigrations = await this.getExecutedMigrations();
+    
+    return allMigrations.filter(migration => 
+      !executedMigrations.includes(migration.name)
+    );
+  }
+
+  async runMigration(migrationFile, direction = 'up') {
+    try {
+      delete require.cache[require.resolve(migrationFile.path)];
+      const migration = require(migrationFile.path);
+      
+      if (typeof migration[direction] !== 'function') {
+        throw new Error(`Migration ${migrationFile.name} has no ${direction} method`);
+      }
+
+      await migration[direction](this.db);
+
+      if (direction === 'up') {
+        await this.db.insert(this.migrationsTable, {
+          name: migrationFile.name
+        });
+      } else if (direction === 'down') {
+        await this.db.delete(this.migrationsTable, {
+          name: migrationFile.name
+        });
+      }
+
+      console.log(`✅ Migration ${migrationFile.name} (${direction}) başarılı`);
+      return true;
+    } catch (error) {
+      console.error(`❌ Migration ${migrationFile.name} (${direction}) hatası:`, error);
+      throw error;
+    }
+  }
+
+  async migrate() {
+    const pending = await this.getPendingMigrations();
+    
+    if (pending.length === 0) {
+      console.log('✅ Tüm migration\'lar güncel');
+      return;
+    }
+
+    console.log(`🔄 ${pending.length} migration çalıştırılacak...`);
+    
+    for (const migration of pending) {
+      await this.runMigration(migration, 'up');
+    }
+    
+    console.log('✅ Tüm migration\'lar tamamlandı');
+  }
+
+  async rollback(steps = 1) {
+    const executed = await this.getExecutedMigrations();
+    
+    if (executed.length === 0) {
+      console.log('❌ Rollback yapılacak migration yok');
+      return;
+    }
+
+    const allMigrations = this.getMigrationFiles();
+    const toRollback = executed
+      .slice(-steps)
+      .reverse()
+      .map(name => allMigrations.find(m => m.name === name))
+      .filter(Boolean);
+
+    console.log(`🔄 ${toRollback.length} migration rollback edilecek...`);
+    
+    for (const migration of toRollback) {
+      await this.runMigration(migration, 'down');
+    }
+    
+    console.log('✅ Rollback tamamlandı');
+  }
+
+  async status() {
+    const allMigrations = this.getMigrationFiles();
+    const executedMigrations = await this.getExecutedMigrations();
+    
+    console.log('\n📋 Migration Durumu:');
+    console.log('==================');
+    
+    if (allMigrations.length === 0) {
+      console.log('❌ Migration dosyası bulunamadı');
+      return;
+    }
+
+    allMigrations.forEach(migration => {
+      const status = executedMigrations.includes(migration.name) ? '✅ Executed' : '⏳ Pending';
+      console.log(`${status} ${migration.name}`);
+    });
+    
+    const pendingCount = allMigrations.length - executedMigrations.length;
+    console.log(`\n📊 Toplam: ${allMigrations.length}, Executed: ${executedMigrations.length}, Pending: ${pendingCount}`);
+  }
+
+  async reset() {
+    const executed = await this.getExecutedMigrations();
+    
+    if (executed.length === 0) {
+      console.log('❌ Reset edilecek migration yok');
+      return;
+    }
+
+    console.log(`🔄 ${executed.length} migration reset edilecek...`);
+    await this.rollback(executed.length);
+    console.log('✅ Tüm migration\'lar reset edildi');
+  }
+}
+
+module.exports = MigrationManager;

package/database/mongodb.js

@@ -150,6 +150,51 @@ class MongoDBDatabase extends IDatabase{
     });
   }
 
+  /**
+   * Numerik alanları artırır (increment).
+   * @param {string} collection - Verinin güncelleneceği koleksiyon adı.
+   * @param {object} increments - Artırılacak alanlar ve miktarları.
+   * @param {object} where - Güncelleme koşulları.
+   * @returns {Promise<number>} Etkilenen belge sayısı.
+   */
+  async increment(collection, increments, where = {}) {
+    return this._queueRequest(async () => {
+      await this.ensureCollection(collection);
+      const db = await this._connectionPromise;
+      const incObject = {};
+      
+      for (const [field, value] of Object.entries(increments)) {
+        incObject[field] = value;
+      }
+      
+      const result = await db.collection(collection).updateMany(where, { $inc: incObject });
+      return result.modifiedCount;
+    });
+  }
+
+  /**
+   * Numerik alanları azaltır (decrement).
+   * @param {string} collection - Verinin güncelleneceği koleksiyon adı.
+   * @param {object} decrements - Azaltılacak alanlar ve miktarları.
+   * @param {object} where - Güncelleme koşulları.
+   * @returns {Promise<number>} Etkilenen belge sayısı.
+   */
+  async decrement(collection, decrements, where = {}) {
+    return this._queueRequest(async () => {
+      await this.ensureCollection(collection);
+      const db = await this._connectionPromise;
+      const incObject = {};
+      
+      // Decrement için negatif değerler kullanıyoruz
+      for (const [field, value] of Object.entries(decrements)) {
+        incObject[field] = -value;
+      }
+      
+      const result = await db.collection(collection).updateMany(where, { $inc: incObject });
+      return result.modifiedCount;
+    });
+  }
+
   async close() {
     await this.client.close();
   }

package/database/mysql.js

@@ -460,6 +460,67 @@ class MySQLDatabase extends IDatabase{
     }
     return value;
   }
+
+  /**
+   * WHERE clause oluşturur
+   * @param {object} where - WHERE koşulları
+   * @returns {object} - whereClause string ve values array
+   */
+  buildWhereClause(where = {}) {
+    const conditions = Object.keys(where);
+    if (conditions.length === 0) {
+      return { whereClause: '', values: [] };
+    }
+    
+    const whereClause = ' WHERE ' + conditions.map(key => `\`${key}\` = ?`).join(' AND ');
+    const values = Object.values(where).map(v => this._serializeValue(v));
+    
+    return { whereClause, values };
+  }
+
+  /**
+   * Numerik alanları artırır (increment).
+   * @param {string} table - Verinin güncelleneceği tablo adı.
+   * @param {object} increments - Artırılacak alanlar ve miktarları.
+   * @param {object} where - Güncelleme koşulları.
+   * @returns {Promise<number>} Etkilenen kayıt sayısı.
+   */
+  async increment(table, increments, where = {}) {
+    const incrementClauses = Object.keys(increments).map(field => 
+      `${field} = ${field} + ?`
+    ).join(', ');
+    
+    const incrementValues = Object.values(increments);
+    const { whereClause, values: whereValues } = this.buildWhereClause(where);
+    
+    const sql = `UPDATE ${table} SET ${incrementClauses}${whereClause}`;
+    const allValues = [...incrementValues, ...whereValues];
+    
+    const [result] = await this.connection.execute(sql, allValues);
+    return result.affectedRows;
+  }
+
+  /**
+   * Numerik alanları azaltır (decrement).
+   * @param {string} table - Verinin güncelleneceği tablo adı.
+   * @param {object} decrements - Azaltılacak alanlar ve miktarları.
+   * @param {object} where - Güncelleme koşulları.
+   * @returns {Promise<number>} Etkilenen kayıt sayısı.
+   */
+  async decrement(table, decrements, where = {}) {
+    const decrementClauses = Object.keys(decrements).map(field => 
+      `${field} = ${field} - ?`
+    ).join(', ');
+    
+    const decrementValues = Object.values(decrements);
+    const { whereClause, values: whereValues } = this.buildWhereClause(where);
+    
+    const sql = `UPDATE ${table} SET ${decrementClauses}${whereClause}`;
+    const allValues = [...decrementValues, ...whereValues];
+    
+    const [result] = await this.connection.execute(sql, allValues);
+    return result.affectedRows;
+  }
 }
 
 module.exports = MySQLDatabase;

package/database/pg.js

@@ -458,6 +458,70 @@ class PostgreSQLDatabase extends IDatabase {
     // No need for manual JSON parsing unlike MySQL
     return value;
   }
+
+  /**
+   * WHERE clause oluşturur (PostgreSQL $n syntax için)
+   * @param {object} where - WHERE koşulları
+   * @param {number} startIndex - Başlangıç parameter indeksi
+   * @returns {object} - whereClause string ve values array
+   */
+  buildWhereClause(where = {}, startIndex = 0) {
+    const conditions = Object.keys(where);
+    if (conditions.length === 0) {
+      return { whereClause: '', values: [] };
+    }
+    
+    const whereClause = ' WHERE ' + conditions.map((key, index) => 
+      `${key} = $${startIndex + index + 1}`
+    ).join(' AND ');
+    const values = Object.values(where).map(v => this._serializeValue(v));
+    
+    return { whereClause, values };
+  }
+
+  /**
+   * Numerik alanları artırır (increment).
+   * @param {string} table - Verinin güncelleneceği tablo adı.
+   * @param {object} increments - Artırılacak alanlar ve miktarları.
+   * @param {object} where - Güncelleme koşulları.
+   * @returns {Promise<number>} Etkilenen kayıt sayısı.
+   */
+  async increment(table, increments, where = {}) {
+    const incrementClauses = Object.keys(increments).map((field, index) => 
+      `${field} = ${field} + $${index + 1}`
+    ).join(', ');
+    
+    const incrementValues = Object.values(increments);
+    const { whereClause, values: whereValues } = this.buildWhereClause(where, incrementValues.length);
+    
+    const sql = `UPDATE ${table} SET ${incrementClauses}${whereClause}`;
+    const allValues = [...incrementValues, ...whereValues];
+    
+    const result = await this.pool.query(sql, allValues);
+    return result.rowCount;
+  }
+
+  /**
+   * Numerik alanları azaltır (decrement).
+   * @param {string} table - Verinin güncelleneceği tablo adı.
+   * @param {object} decrements - Azaltılacak alanlar ve miktarları.
+   * @param {object} where - Güncelleme koşulları.
+   * @returns {Promise<number>} Etkilenen kayıt sayısı.
+   */
+  async decrement(table, decrements, where = {}) {
+    const decrementClauses = Object.keys(decrements).map((field, index) => 
+      `${field} = ${field} - $${index + 1}`
+    ).join(', ');
+    
+    const decrementValues = Object.values(decrements);
+    const { whereClause, values: whereValues } = this.buildWhereClause(where, decrementValues.length);
+    
+    const sql = `UPDATE ${table} SET ${decrementClauses}${whereClause}`;
+    const allValues = [...decrementValues, ...whereValues];
+    
+    const result = await this.pool.query(sql, allValues);
+    return result.rowCount;
+  }
 }
 
 module.exports = PostgreSQLDatabase;