@onurege3467/zerohelper 5.0.0 → 5.0.1

package/database/adapters/IDatabase.js

@@ -1,18 +1,74 @@
 /**
- * Tüm veritabanı adaptörlerinin uyması gereken ortak arayüz.
- * @typedef {object} IDatabase
- * @property {function(string, object=): Promise<Array<object>>} select - Belirtilen koşullara göre veri seçer.
- * @property {function(string, object=): Promise<object|null>} selectOne - Koşula uyan ilk veriyi seçer.
- * @property {function(string, object): Promise<number|string|object>} insert - Yeni bir veri ekler ve ID'sini döndürür.
- * @property {function(string, object, object): Promise<number>} update - Veriyi günceller ve etkilenen satır sayısını döndürür.
- * @property {function(string, object, object): Promise<number>} updateOne - Koşula uyan ilk veriyi günceller.
- * @property {function(string, object): Promise<number>} delete - Veriyi siler ve etkilenen satır sayısını döndürür.
- * @property {function(string, object): Promise<number>} deleteOne - Koşula uyan ilk veriyi siler.
- * @property {function(string, object, object): Promise<any>} set - Veri varsa günceller, yoksa ekler (upsert).
- * @property {function(string, Array<object>): Promise<number>} bulkInsert - Toplu veri ekler.
- * @property {function(string, object=): Promise<void>} ensureTable - Tablonun var olduğundan emin olur.
- * @property {function(): Promise<void>} close - Veritabanı bağlantısını kapatır.
+ * Tüm veritabanı adaptörlerinin uyması gereken ortak arayüzü tanımlar.
+ * @interface
  */
-
-// Bu satır, dosyanın bir modül olarak tanınması için gereklidir.
-module.exports = {};
+class IDatabase {
+    /**
+     * Belirtilen koşullara göre birden çok kayıt seçer.
+     * @param {string} table - Verinin seçileceği tablo veya koleksiyonun adı.
+     * @param {object} [where] - (Opsiyonel) Kayıtları filtrelemek için kullanılacak koşul nesnesi.
+     * @returns {Promise<Array<object>>} Koşullara uyan kayıtların bir dizisini içeren bir Promise.
+     */
+    select(table, where) {}
+  
+    /**
+     * Belirtilen koşullara göre tek bir kayıt seçer.
+     * @param {string} table - Verinin seçileceği tablo veya koleksiyonun adı.
+     * @param {object} [where] - (Opsiyonel) Kaydı filtrelemek için kullanılacak koşul nesnesi.
+     * @returns {Promise<object|null>} Koşula uyan ilk kaydı veya bulunamazsa `null` içeren bir Promise.
+     */
+    selectOne(table, where) {}
+  
+    /**
+     * Yeni bir kayıt ekler.
+     * @param {string} table - Verinin ekleneceği tablo veya koleksiyonun adı.
+     * @param {object} data - Eklenecek veriyi içeren nesne.
+     * @returns {Promise<number|string|object>} Eklenen yeni kaydın ID'sini içeren bir Promise.
+     */
+    insert(table, data) {}
+  
+    /**
+     * Belirtilen koşullara uyan kayıtları günceller.
+     * @param {string} table - Verinin güncelleneceği tablo veya koleksiyonun adı.
+     * @param {object} data - Güncellenecek yeni verileri içeren nesne.
+     * @param {object} where - Hangi kayıtların güncelleneceğini belirleyen koşul nesnesi.
+     * @returns {Promise<number>} Etkilenen (güncellenen) kayıt sayısını içeren bir Promise.
+     */
+    update(table, data, where) {}
+  
+    /**
+     * Bir kaydı günceller veya yoksa yeni bir kayıt olarak ekler (Upsert).
+     * @param {string} table - İşlem yapılacak tablo veya koleksiyonun adı.
+     * @param {object} data - Ayarlanacak veya güncellenecek veriyi içeren nesne.
+     * @param {object} where - Kaydın varlığını kontrol etmek ve güncellemek için kullanılacak koşul nesnesi.
+     * @returns {Promise<any>} Ekleme durumunda yeni ID'yi, güncelleme durumunda etkilenen satır sayısını içeren bir Promise.
+     */
+    set(table, data, where) {}
+  
+    /**
+     * Belirtilen koşullara uyan kayıtları siler.
+     * @param {string} table - Verinin silineceği tablo veya koleksiyonun adı.
+     * @param {object} where - Hangi kayıtların silineceğini belirleyen koşul nesnesi.
+     * @returns {Promise<number>} Silinen kayıt sayısını içeren bir Promise.
+     */
+    delete(table, where) {}
+  
+    /**
+     * Birden çok kaydı toplu olarak ekler.
+     * @param {string} table - Verilerin ekleneceği tablo veya koleksiyonun adı.
+     * @param {Array<object>} dataArray - Eklenecek kayıtları içeren bir dizi.
+     * @returns {Promise<number>} Eklenen kayıt sayısını içeren bir Promise.
+     */
+    bulkInsert(table, dataArray) {}
+  
+    /**
+     * Veritabanı bağlantısını güvenli bir şekilde sonlandırır.
+     * @returns {Promise<void>}
+     */
+    close() {}
+  
+    // Diğer metotları da buraya ekleyebilirsiniz (updateOne, deleteOne, ensureTable vb.)
+  }
+  
+  // Bu dosyanın bir modül olarak tanınması ve tipin export edilmesi için bu satır önemli.
+  module.exports = IDatabase;

package/database/adapters/json.js

@@ -1,11 +1,12 @@
-/** @typedef {import('./IDatabase').IDatabase} IDatabase */
+const IDatabase = require('./IDatabase'); // Arayüzü import et
+
 /**
  * @implements {IDatabase}
  */
 const fs = require('fs').promises; // Asenkron dosya işlemleri için
 const path = require('path');
 
-class JsonDatabase {
+class JsonDatabase extends IDatabase{
   /**
    * @param {object} config - Yapılandırma nesnesi.
    * @param {string} config.filePath - JSON veritabanı dosyasının yolu.

package/database/adapters/mongodb.js

@@ -1,10 +1,11 @@
-/** @typedef {import('./IDatabase').IDatabase} IDatabase */
+const IDatabase = require('./IDatabase'); // Arayüzü import et
+
 /**
  * @implements {IDatabase}
  */
 const { MongoClient, ObjectId } = require("mongodb");
 
-class MongoDBDatabase {
+class MongoDBDatabase extends IDatabase{
   constructor(config) {
     this.config = config;
     this.client = new MongoClient(config.url, {

package/database/adapters/mysql.js

@@ -1,10 +1,11 @@
-/** @typedef {import('./IDatabase').IDatabase} IDatabase */
+const IDatabase = require('./IDatabase'); // Arayüzü import et
+
 /**
  * @implements {IDatabase}
  */
 const mysql = require("mysql2/promise");
 
-class MySQLDatabase {
+class MySQLDatabase extends IDatabase{
   constructor(config) {
     this.config = config;
     this.pool = null;

package/database/adapters/sqlite.js

@@ -1,13 +1,13 @@
-/** @typedef {import('./IDatabase').IDatabase} IDatabase */
+const IDatabase = require('./IDatabase'); // Arayüzü import et
+
 /**
  * @implements {IDatabase}
  */
-
 const Database = require('better-sqlite3');
 const fs = require('fs');
 const path = require('path');
 
-class SQLiteDatabase {
+class SQLiteDatabase extends IDatabase{
   /**
    * @param {object} config - Yapılandırma nesnesi.
    * @param {string} config.filePath - SQLite veritabanı dosyasının yolu.

package/database/index.js

@@ -1,11 +1,4 @@
-// database/index.js
-
-/**
- * Tüm veritabanı adaptörlerinin uyması gereken ortak arayüz.
- * Bu, projenin başka yerlerinden de import edilebilir.
- * @typedef {import('./adapters/IDatabase').IDatabase} IDatabase
- */
-
+const IDatabase = require('./adapters/IDatabase');
 const MySQLDatabase = require('./adapters/mysql');
 const SQLiteDatabase = require('./adapters/sqlite');
 const MongoDBDatabase = require('./adapters/mongodb');
@@ -25,7 +18,7 @@ const adapters = {
  * @param {object} options - Yapılandırma seçenekleri.
  * @param {keyof adapters} options.adapter - Kullanılacak adaptör ('mysql', 'sqlite', vb.).
  * @param {object} options.config - Seçilen adaptöre özel yapılandırma.
- * @returns {IDatabase} - Seçilen adaptör sınıfının bir örneğini döndürür.
+ * @returns {IDatabase} - IDatabase arayüzünü uygulayan bir örnek döndürür.
  */
 function createDatabase(options) {
   const { adapter, config } = options;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onurege3467/zerohelper",
-  "version": "5.0.0",
+  "version": "5.0.1",
   "main": "index.js",
   "scripts": {
     "test": "node test.js"