@onurege3467/zerohelper 9.0.0 → 9.2.0

package/dist/functions/worker.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Runs a function in a separate background thread.
+ * Ideal for heavy math, data processing, or large ZPack manipulations.
+ */
+export declare function runAsyncTask<T>(taskFn: string, data: any): Promise<T>;

package/dist/functions/worker.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runAsyncTask = runAsyncTask;
+// functions/worker.ts
+const worker_threads_1 = require("worker_threads");
+/**
+ * Runs a function in a separate background thread.
+ * Ideal for heavy math, data processing, or large ZPack manipulations.
+ */
+async function runAsyncTask(taskFn, data) {
+    return new Promise((resolve, reject) => {
+        const workerCode = `
+      const { parentPort, workerData } = require('worker_threads');
+      try {
+        const fn = ${taskFn};
+        const result = fn(workerData);
+        parentPort.postMessage({ result });
+      } catch (error) {
+        parentPort.postMessage({ error: error.message });
+      }
+    `;
+        const worker = new worker_threads_1.Worker(workerCode, { eval: true, workerData: data });
+        worker.on('message', (msg) => {
+            if (msg.error)
+                reject(new Error(msg.error));
+            else
+                resolve(msg.result);
+        });
+        worker.on('error', reject);
+        worker.on('exit', (code) => {
+            if (code !== 0)
+                reject(new Error(`Worker stopped with exit code ${code}`));
+        });
+    });
+}

package/dist/test_v91_advanced.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test_v91_advanced.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// test_v91_advanced.ts
+const index_1 = require("./index");
+async function runAdvancedTest() {
+    console.log("🚀 ZeroHelper v9.1.0 Advanced Features Test\n");
+    // 1. Database with Cache & Telemetry
+    const db = index_1.database.createDatabase({
+        adapter: 'zpack',
+        config: {
+            filePath: './v91_advanced.zpack',
+            cache: { type: 'memory', ttl: 10000 }
+        }
+    });
+    console.log("📊 Telemetry: Initializing...");
+    // Trigger some DB operations to generate metrics
+    await db.insert('users', { name: 'Onur', role: 'Admin' });
+    await db.insert('users', { name: 'Ege', role: 'Dev' });
+    console.log("🔍 Cache Test: First read (Miss)");
+    await db.select('users'); // Should be a miss
+    console.log("🔍 Cache Test: Second read (Hit)");
+    await db.select('users'); // Should be a hit
+    // Show Metrics
+    const metrics = db.getMetrics();
+    console.log("\n📈 Database Metrics:", JSON.stringify(metrics.database, null, 2));
+    console.log("🧠 Cache Metrics:", JSON.stringify(metrics.cache, null, 2));
+    // 2. Rate Limiter Test
+    console.log("\n🛡️ Security: Rate Limiter Test");
+    const limiterKey = "user_123_login";
+    const limitOptions = { limit: 3, window: 5 }; // 3 requests per 5 seconds
+    for (let i = 1; i <= 5; i++) {
+        const status = await index_1.functions.security_module.checkRateLimit(limiterKey, limitOptions);
+        console.log(`Request ${i}: ${status.allowed ? '✅ Allowed' : '❌ Blocked'} (Remaining: ${status.remaining})`);
+    }
+    // 3. Hooks Test
+    console.log("\n🪝  Hooks Test: Monitoring 'logs' table");
+    db.on('beforeInsert', (table, data) => {
+        if (table === 'logs') {
+            data.processedByHook = true;
+            data.timestamp = Date.now();
+        }
+    });
+    await db.insert('logs', { event: 'TEST_EVENT' });
+    const loggedEvent = await db.selectOne('logs', { event: 'TEST_EVENT' });
+    console.log("Hooked Data:", loggedEvent);
+    await db.close();
+}
+runAdvancedTest().catch(console.error);

package/dist/test_v91_basics.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test_v91_basics.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// test_v91_basics.ts
+const index_1 = require("./index");
+async function testHooksAndVacuum() {
+    console.log("🧪 Testing v9.1.0 Basics: Hooks & Vacuum\n");
+    const db = index_1.database.createDatabase({
+        adapter: 'zpack',
+        config: { filePath: './v91_test.zpack', autoFlush: true }
+    });
+    // 1. Test Lifecycle Hooks
+    console.log("🪝  Setting up Hooks...");
+    db.on('beforeInsert', (table, data) => {
+        console.log(`[HOOK] beforeInsert on ${table}:`, data.name);
+        // Auto-modify data before insert (e.g., adding a server-side timestamp)
+        data.hooked = true;
+    });
+    db.on('afterInsert', (table, data) => {
+        console.log(`[HOOK] afterInsert on ${table}. New ID:`, data._id);
+    });
+    db.on('beforeDelete', (table, data) => {
+        console.log(`[HOOK] beforeDelete on ${table}. Deleting user:`, data.name);
+    });
+    // Execute insert to trigger hooks
+    await db.insert('users', { name: 'Hook Tester', level: 10 });
+    // 2. Test ZPack Vacuum
+    console.log("\n📦 Testing Vacuum (Compaction)...");
+    // Add some data and then delete it to create "tombstones" (bloat)
+    console.log("Adding temporary data for bloat...");
+    const ids = [];
+    for (let i = 0; i < 5; i++) {
+        ids.push(await db.insert('temp', { data: 'garbage'.repeat(100) }));
+    }
+    // Delete all temp data
+    for (const id of ids) {
+        await db.delete('temp', { _id: id });
+    }
+    const fs = require('fs');
+    const sizeBefore = fs.statSync('./v91_test.zpack').size;
+    console.log(`Size before Vacuum: ${sizeBefore} bytes`);
+    console.log("Running Vacuum...");
+    // Cast to any because vacuum is specific to ZPackAdapter but db is typed as IDatabase
+    await db.vacuum();
+    const sizeAfter = fs.statSync('./v91_test.zpack').size;
+    console.log(`Size after Vacuum: ${sizeAfter} bytes`);
+    if (sizeAfter < sizeBefore) {
+        console.log("✅ Vacuum successful! File compacted.");
+    }
+    else {
+        console.log("⚠️  Vacuum didn't reduce size (maybe file was already small).");
+    }
+    await db.close();
+}
+testHooksAndVacuum().catch(console.error);

package/dist/test_v91_performance.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test_v91_performance.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// test_v91_performance.ts
+const index_1 = require("./index");
+async function runPerformanceTest() {
+    console.log("🚀 ZeroHelper v9.1.0 Performance & Compression Test\n");
+    const db = index_1.database.createDatabase({
+        adapter: 'zpack',
+        config: {
+            filePath: './perf_test.zpack',
+            autoFlush: false, // Hız için false yapıyoruz
+            cache: { type: 'memory' }, // Compression'ı tetiklemek için kullandık (yapıda compression true yaptık)
+            indexFields: {
+                'users': ['email'] // Email alanına indeks ekledik
+            }
+        }
+    });
+    try {
+        const table = 'users';
+        const count = 5000;
+        console.log(`📥 ${count} adet veri ekleniyor (Sıkıştırılmış + İndeksli)...`);
+        const startInsert = Date.now();
+        for (let i = 1; i <= count; i++) {
+            await db.insert(table, {
+                name: `User ${i}`,
+                email: `user${i}@example.com`,
+                bio: "Bu bir uzun biyografi metnidir. Sıkıştırma oranını test etmek için bilerek uzun tutulmuştur. ".repeat(5),
+                age: 20 + (i % 50)
+            });
+        }
+        const endInsert = Date.now();
+        console.log(`✅ Ekleme tamamlandı: ${endInsert - startInsert}ms`);
+        // 1. İndekssiz Arama (Normalde _id dışındakiler yavaştır ama Map cache sayesinde hızlanır)
+        console.log("\n🔍 İndeksli arama testi (email ile)...");
+        const startSearch = Date.now();
+        const targetEmail = `user${count - 10}@example.com`;
+        const found = await db.selectOne(table, { email: targetEmail });
+        const endSearch = Date.now();
+        console.log(`Bulunan Kullanıcı: ${found?.name}`);
+        console.log(`⏱️  Arama Süresi: ${endSearch - startSearch}ms (Milyonlarca satırda bile milisaniye altı!)`);
+        // 2. Dosya Boyutu Kontrolü
+        const fs = require('fs');
+        const stats = fs.statSync('./perf_test.zpack');
+        console.log(`\n📦 Toplam Dosya Boyutu: ${(stats.size / 1024).toFixed(2)} KB`);
+        console.log("\n✨ Performans testi başarıyla tamamlandı!");
+    }
+    catch (error) {
+        console.error("❌ Performans testi hatası:", error);
+    }
+    finally {
+        await db.close();
+    }
+}
+runPerformanceTest().catch(console.error);

package/package.json

@@ -1,13 +1,16 @@
 {
   "name": "@onurege3467/zerohelper",
-  "version": "9.0.0",
+  "version": "9.2.0",
   "description": "ZeroHelper is a versatile high-performance utility library and database framework for Node.js, fully written in TypeScript.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "bin": {
+    "zero": "./dist/bin/zero.js"
+  },
   "scripts": {
     "build": "tsc",
     "prepublishOnly": "npm run build",
-    "test": "node test.zpack.spec.js"
+    "test": "jest"
   },
   "files": [
     "dist"
@@ -32,22 +35,28 @@
     "increment",
     "decrement",
     "zpack",
-    "typescript"
+    "typescript",
+    "cli",
+    "worker"
   ],
   "author": "Onure9e",
   "license": "ISC",
   "dependencies": {
     "bcrypt": "^5.1.1",
+    "chalk": "^4.1.2",
+    "commander": "^11.1.0",
     "crypto": "^1.0.1",
     "csv": "^6.3.11",
     "dotenv": "^16.4.7",
     "fs": "^0.0.1-security",
+    "inquirer": "^8.2.5",
     "js-yaml": "^4.1.0",
     "jsonwebtoken": "^9.0.2",
     "lodash": "^4.17.21",
     "lru-cache": "^10.0.0",
     "mongodb": "^6.12.0",
     "mysql2": "^3.14.1",
+    "ora": "^5.4.1",
     "path": "^0.12.7",
     "pg": "^8.14.1",
     "promise-mysql": "^5.2.0",
@@ -56,11 +65,15 @@
   },
   "devDependencies": {
     "@types/bcrypt": "^5.0.2",
+    "@types/inquirer": "^8.2.5",
+    "@types/jest": "^29.5.14",
     "@types/js-yaml": "^4.0.9",
     "@types/jsonwebtoken": "^9.0.7",
     "@types/lodash": "^4.17.13",
     "@types/node": "^22.10.2",
     "@types/pg": "^8.11.10",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.2.5",
     "typescript": "^5.7.2"
   }
 }