@onurege3467/zerohelper 7.1.0 → 8.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onurege3467/zerohelper",
-  "version": "7.1.0",
+  "version": "8.0.0",
   "main": "index.js",
   "scripts": {
     "test": "node test.js"
@@ -18,14 +18,18 @@
     "postgresql",
     "utility",
     "functions",
-    "nodejs"
+    "nodejs",
+    "validation",
+    "logger",
+    "migration",
+    "increment",
+    "decrement"
   ],
   "author": "Onure9e",
   "license": "ISC",
-  "description": "ZeroHelper is a versatile JavaScript library offering helper functions and database utilities for developers. It supports MongoDB, MySQL, SQLite, Redis, and PostgreSQL.",
+  "description": "ZeroHelper is a versatile JavaScript library offering helper functions, validation, logging, database utilities and migration system for developers. It supports MongoDB, MySQL, SQLite, Redis, and PostgreSQL with increment/decrement operations.",
   "dependencies": {
     "bcrypt": "^5.1.1",
-    
     "crypto": "^1.0.1",
     "csv": "^6.3.11",
     "dotenv": "^16.4.7",
@@ -33,13 +37,13 @@
     "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",
     "path": "^0.12.7",
     "pg": "^8.14.1",
     "promise-mysql": "^5.2.0",
-    "redis": "^4.7.0",
-    "sqlite3": "^5.1.7",
-    "lru-cache": "^10.0.0"
+    "redis": "^5.8.2",
+    "sqlite3": "^5.1.7"
   }
 }

package/.snapshots/config.json

@@ -1,151 +0,0 @@
-{
-    "excluded_patterns": [
-        ".git",
-        ".gitignore",
-        "gradle",
-        "gradlew",
-        "gradlew.*",
-        "node_modules",
-        ".snapshots",
-        ".idea",
-        ".vscode",
-        "*.log",
-        "*.tmp",
-        "target",
-        "dist",
-        "build",
-        ".DS_Store",
-        "*.bak",
-        "*.swp",
-        "*.swo",
-        "*.lock",
-        "*.iml",
-        "coverage",
-        "*.min.js",
-        "*.min.css",
-        "__pycache__",
-        ".marketing",
-        ".env",
-        ".env.*",
-        "*.jpg",
-        "*.jpeg",
-        "*.png",
-        "*.gif",
-        "*.bmp",
-        "*.tiff",
-        "*.ico",
-        "*.svg",
-        "*.webp",
-        "*.psd",
-        "*.ai",
-        "*.eps",
-        "*.indd",
-        "*.raw",
-        "*.cr2",
-        "*.nef",
-        "*.mp4",
-        "*.mov",
-        "*.avi",
-        "*.wmv",
-        "*.flv",
-        "*.mkv",
-        "*.webm",
-        "*.m4v",
-        "*.wfp",
-        "*.prproj",
-        "*.aep",
-        "*.psb",
-        "*.xcf",
-        "*.sketch",
-        "*.fig",
-        "*.xd",
-        "*.db",
-        "*.sqlite",
-        "*.sqlite3",
-        "*.mdb",
-        "*.accdb",
-        "*.frm",
-        "*.myd",
-        "*.myi",
-        "*.ibd",
-        "*.dbf",
-        "*.rdb",
-        "*.aof",
-        "*.pdb",
-        "*.sdb",
-        "*.s3db",
-        "*.ddb",
-        "*.db-shm",
-        "*.db-wal",
-        "*.sqlitedb",
-        "*.sql.gz",
-        "*.bak.sql",
-        "dump.sql",
-        "dump.rdb",
-        "*.vsix",
-        "*.jar",
-        "*.war",
-        "*.ear",
-        "*.zip",
-        "*.tar",
-        "*.tar.gz",
-        "*.tgz",
-        "*.rar",
-        "*.7z",
-        "*.exe",
-        "*.dll",
-        "*.so",
-        "*.dylib",
-        "*.app",
-        "*.dmg",
-        "*.iso",
-        "*.msi",
-        "*.deb",
-        "*.rpm",
-        "*.apk",
-        "*.aab",
-        "*.ipa",
-        "*.pkg",
-        "*.nupkg",
-        "*.snap",
-        "*.whl",
-        "*.gem",
-        "*.pyc",
-        "*.pyo",
-        "*.pyd",
-        "*.class",
-        "*.o",
-        "*.obj",
-        "*.lib",
-        "*.a",
-        "*.map",
-        ".npmrc"
-    ],
-    "default": {
-        "default_prompt": "Enter your prompt here",
-        "default_include_all_files": false,
-        "default_include_entire_project_structure": true
-    },
-    "included_patterns": [
-        "build.gradle",
-        "settings.gradle",
-        "gradle.properties",
-        "pom.xml",
-        "Makefile",
-        "CMakeLists.txt",
-        "package.json",
-        "requirements.txt",
-        "Pipfile",
-        "Gemfile",
-        "composer.json",
-        ".editorconfig",
-        ".eslintrc.json",
-        ".eslintrc.js",
-        ".prettierrc",
-        ".babelrc",
-        ".dockerignore",
-        ".gitattributes",
-        ".stylelintrc",
-        ".npmrc"
-    ]
-}

package/.snapshots/readme.md

@@ -1,11 +0,0 @@
-# Snapshots Directory
-
-This directory contains snapshots of your code for AI interactions. Each snapshot is a markdown file that includes relevant code context and project structure information.
-
-## What's included in snapshots?
-- Selected code files and their contents
-- Project structure (if enabled)
-- Your prompt/question for the AI
-
-## Configuration
-You can customize snapshot behavior in `config.json`.

package/.snapshots/sponsors.md

@@ -1,44 +0,0 @@
-# Thank you for using Snapshots for AI
-
-Thanks for using Snapshots for AI. We hope this tool has helped you solve a problem or two. 
-
-If you would like to support our work, please help us by considering the following offers and requests:
-
-## Ways to Support
-
-### Join the GBTI Network!!! 🙏🙏🙏
-The GBTI Network is a community of developers who are passionate about open source and community-driven development. Members enjoy access to exclussive tools, resources, a private MineCraft server, a listing in our members directory, co-op opportunities and more.
-
-- Support our work by becoming a [GBTI Network member](https://gbti.network/membership/).
-
-### Try out BugHerd 🐛
-BugHerd is a visual feedback and bug-tracking tool designed to streamline website development by enabling users to pin feedback directly onto web pages. This approach facilitates clear communication among clients, designers, developers, and project managers.
-
-- Start your free trial with [BugHerd](https://partners.bugherd.com/55z6c8az8rvr) today.
-
-### Hire Developers from Codeable 👥
-Codeable connects you with top-tier professionals skilled in frameworks and technologies such as Laravel, React, Django, Node, Vue.js, Angular, Ruby on Rails, and Node.js. Don't let the WordPress focus discourage you. Codeable experts do it all.
-
-- Visit [Codeable](https://www.codeable.io/developers/?ref=z8h3e) to hire your next team member. 
-
-### Lead positive reviews on our marketplace listing ⭐⭐⭐⭐⭐
-- Rate us on [VSCode marketplace](https://marketplace.visualstudio.com/items?itemName=GBTI.snapshots-for-ai)
-- Review us on [Cursor marketplace](https://open-vsx.org/extension/GBTI/snapshots-for-ai)
-
-### Star Our GitHub Repository ⭐
-- Star and watch our [repository](https://github.com/gbti-network/vscode-snapshots-for-ai)
-
-### 📡 Stay Connected
-Follow us on your favorite platforms for updates, news, and community discussions:
-- **[Twitter/X](https://twitter.com/gbti_network)**
-- **[GitHub](https://github.com/gbti-network)**
-- **[YouTube](https://www.youtube.com/channel/UCh4FjB6r4oWQW-QFiwqv-UA)**
-- **[Dev.to](https://dev.to/gbti)**
-- **[Daily.dev](https://dly.to/zfCriM6JfRF)**
-- **[Hashnode](https://gbti.hashnode.dev/)**
-- **[Discord Community](https://gbti.network)**
-- **[Reddit Community](https://www.reddit.com/r/GBTI_network)**
-
----
-
-Thank you for supporting open source software! 🙏

package/1.json

@@ -1,15 +0,0 @@
-{
-    "compilerOptions": {
-      "module": "CommonJS",
-      "target": "ES2020",
-      "checkJs": true,
-      "resolveJsonModule": true
-    },
-    "include": [
-      "**/*"
-    ],
-    "exclude": [
-      "node_modules",
-      "**/node_modules/*"
-    ]
-  }

package/readme.md

@@ -1,418 +0,0 @@
-# ZeroHelper 🚀
-
-ZeroHelper is a versatile JavaScript package providing helper functions and database utilities for developers. It includes essential tools for manipulating data, generating random values, performing cryptographic operations, and interacting with various databases like MySQL, MongoDB, PostgreSQL, SQLite, and Redis.
-
----
-
-## 📑 Table of Contents
-
-1. [📦 Installation](#-installation)
-2. [✨ Helper Functions](#-helper-functions)
-   - [🎲 Random Functions](#random-functions-)
-   - [🔠 String Functions](#string-functions-)
-   - [📊 Array Functions](#array-functions-)
-   - [🔧 Object Functions](#object-functions-)
-   - [🔒 Crypto Functions](#crypto-functions-)
-   - [➗ Math Functions](#math-functions-)
-3. [💾 Database Utilities](#-database-utilities)
-   - [🏭 Using the Database Factory](#-using-the-database-factory)
-   - [📚 API Reference](#-api-reference)
-4. [🔄 Database Migration](#database-migration)
-
----
-
-## 🚀 Installing ZeroHelper
-
-To install ZeroHelper, use npm:
-
-```bash
-npm i @onurege3467/zerohelper
-```
-
-## 🛠️ Using ZeroHelper for helper functions
-
-# Random Functions 🎲
-
-```js
-const helpers = require("@onurege3467/zerohelper/functions");
-
-const id = helpers.random.makeUniqueId();
-console.log(id); // Example: "lzx8k9x8k9"
-
-const item = helpers.random.randomArray([1, 2, 3, 4, 5]);
-console.log(item); // Example: 3
-
-const text = helpers.random.randomText(10);
-console.log(text); // Example: "aBcDeFgHiJ"
-
-const number = helpers.random.randomNumber(1, 100);
-console.log(number); // Example: 42
-
-const emoji = helpers.random.randomEmoji();
-console.log(emoji); // Example: "😄"
-
-const hex = helpers.random.randomHex();
-console.log(hex); // Example: "#A1B2C3"
-
-const float = helpers.random.randomFloat(1.5, 5.5);
-console.log(float); // Example: 3.14
-```
-
-# String Functions 🔠
-
-```js
-const title = helpers.string.titleCase("hello world");
-console.log(title); // "Hello World"
-
-const randomString = helpers.string.generateRandomString(8);
-console.log(randomString); // Example: "AbCdEfGh"
-```
-
-# Array Functions 📊
-
-```js
-const shuffled = helpers.array.shuffleArray([1, 2, 3, 4, 5]);
-console.log(shuffled); // Example: [3, 1, 5, 4, 2]
-
-const flat = helpers.array.flattenArray([1, [2, [3, 4]], 5]);
-console.log(flat); // [1, 2, 3, 4, 5]
-
-const filtered = helpers.array.removeFalsyValues([0, 1, false, 2, "", 3]);
-console.log(filtered); // [1, 2, 3]
-
-const grouped = helpers.array.groupBy(
-  [
-    { category: "fruit", name: "apple" },
-    { category: "fruit", name: "banana" },
-    { category: "vegetable", name: "carrot" },
-  ],
-  "category"
-);
-console.log(grouped);
-// {
-//   fruit: [{ category: "fruit", name: "apple" }, { category: "fruit", name: "banana" }],
-//   vegetable: [{ category: "vegetable", name: "carrot" }]
-// }
-
-const names = helpers.array.pluck(
-  [{ name: "Alice" }, { name: "Bob" }, { name: "Charlie" }],
-  "name"
-);
-console.log(names); // ["Alice", "Bob", "Charlie"]
-
-const sorted = helpers.array.sortBy(
-  [{ age: 30 }, { age: 20 }, { age: 40 }],
-  "age"
-);
-console.log(sorted); // [{ age: 20 }, { age: 30 }, { age: 40 }]
-```
-
-# Object Functions 🔧
-
-```js
-const filtered = helpers.object.filterObjectByKey(
-  { name: "Alice", age: 25, city: "New York" },
-  ["name", "city"]
-);
-console.log(filtered); // { name: "Alice", city: "New York" }
-
-const merged = helpers.object.deepMerge(
-  { a: 1, b: { c: 2 } },
-  { b: { d: 3 }, e: 4 }
-);
-console.log(merged); // { a: 1, b: { c: 2, d: 3 }, e: 4 }
-```
-
-# Crypto Functions 🔒
-
-```js
-const secret = "mySecretKey";
-const encrypted = helpers.crypto.encryptText("Hello, World!", secret);
-console.log(encrypted); // Encrypted text
-
-const decrypted = helpers.crypto.decryptText(encrypted, secret);
-console.log(decrypted); // "Hello, World!"
-
-const hash = helpers.crypto.hashPassword("myPassword");
-console.log(hash); // Hashed password
-
-const isValid = helpers.crypto.verifyPassword("myPassword", hash);
-console.log(isValid); // true or false
-
-const token = helpers.crypto.generateJWT({ userId: 1 }, "mySecret");
-console.log(token); // JWT
-
-const payload = helpers.crypto.verifyJWT(token, "mySecret");
-console.log(payload); // { userId: 1, iat: ..., exp: ... }
-```
-
-# Math Functions ➗
-
-```js
-const avg = helpers.math.mean([1, 2, 3, 4, 5]);
-console.log(avg); // 3
-
-const prime = helpers.math.isPrime(7);
-console.log(prime); // true
-```
-
-## 💾 Using ZeroHelper as Database
-
-ZeroHelper provides multiple database utilities for seamless integration with various databases.
-
-## 💾 Using ZeroHelper as Database
-
-ZeroHelper provides a flexible database factory for seamless integration with various databases.
-
-### 🏭 Using the Database Factory
-
-ZeroHelper's database factory allows you to create database instances with various adapters. You can also enable and configure an LRU (Least Recently Used) cache for read operations to improve performance.
-
-#### Enabling and Configuring Cache
-
-To enable caching, pass a `cache` object within the `config` object when creating a database instance. The `cache` object can have the following properties:
-
-- `max`: (Number, optional) The maximum number of items to store in the cache. Defaults to `500`.
-- `ttl`: (Number, optional) The time to live for cache entries in milliseconds. Defaults to `300000` (5 minutes).
-- `updateAgeOnGet`: (Boolean, optional) If `true`, accessing an item refreshes its `ttl`. Defaults to `false`.
-
-**Example with Cache Enabled:**
-
-```javascript
-const path = require('path');
-const createDatabase = require('@onurege3467/zerohelper/database');
-
-const cachedSqliteDb = createDatabase({
-  adapter: 'sqlite',
-  config: {
-    filePath: path.join(__dirname, 'data', 'cached_development.sqlite'),
-    cache: {
-      max: 1000, // Cache up to 1000 items
-      ttl: 1000 * 60 * 10, // Cache items for 10 minutes
-      updateAgeOnGet: true // Refresh TTL on access
-    }
-  }
-});
-
-// Subsequent `select` or `selectOne` calls for the same query will hit the cache
-// Write operations (insert, update, delete, set, bulkInsert) will automatically invalidate the cache for the affected table.
-```
-
-**Basic Usage (without cache configuration shown):**
-
-```javascript
-const path = require('path');
-const createDatabase = require('@onurege3467/zerohelper/database'); // Adjust the path to your project structure
-
-// --- 1. Using SQLite (Fast and Lightweight) ---
-const sqliteDb = createDatabase({
-  adapter: 'sqlite',
-  config: {
-    filePath: path.join(__dirname, 'data', 'development.sqlite')
-  }
-});
-
-// --- 2. Using MySQL (For Production) ---
-const mysqlDb = createDatabase({
-  adapter: 'mysql',
-  config: {
-    host: 'localhost',
-    user: 'root',
-    password: 'your_password',
-    database: 'my_app_prod'
-  }
-});
-
-// --- 3. Using a JSON File (For Simple Prototyping) ---
-const jsonDb = createDatabase({
-  adapter: 'json',
-  config: {
-    filePath: path.join(__dirname, 'data', 'db.json')
-  }
-});
-
-// --- 4. Using MongoDB ---
-const mongoDb = createDatabase({
-    adapter: 'mongodb',
-    config: {
-        url: 'mongodb://localhost:27017',
-        database: 'my_app_mongo'
-    }
-});
-
-// --- 5. Using PG ---
-const mongoDb = createDatabase({
-    adapter: 'postgres',
-    config: {
-    host: 'localhost',
-    user: 'root',
-    password: 'your_password',
-    database: 'my_app_prod'
-  }
-});
-```
-
-### Basic Operations (CRUD)
-
-No matter which adapter you choose, you can use the following methods in exactly the same way.
-
-```javascript
-async function main() {
-  // Let's use sqliteDb for this example
-  const db = createDatabase({
-    adapter: 'sqlite',
-    config: { filePath: 'app.db' }
-  });
-
-  try {
-    // Insert Data
-    const newUserId = await db.insert('users', { name: 'John Doe', email: 'john@example.com', age: 30 });
-    console.log(`New user added with ID: ${newUserId}`);
-
-    // Select Data
-    const user = await db.selectOne('users', { name: 'John Doe' });
-    console.log('Found user:', user);
-
-    // Update Data
-    await db.update('users', { age: 31 }, { email: 'john@example.com' });
-    console.log('User updated.');
-
-    // Update if exists, or insert if not (Upsert)
-    await db.set('users', { city: 'New York' }, { name: 'John Doe' }); // Updates existing
-    await db.set('users', { name: 'Jane Doe', email: 'jane@example.com' }, { name: 'Jane Doe' }); // Inserts new
-
-    // Select All Data
-    const allUsers = await db.select('users');
-    console.log('All users:', allUsers);
-
-    // Delete Data
-    await db.delete('users', { name: 'John Doe' });
-    console.log('User deleted.');
-
-  } catch (error) {
-    console.error('An error occurred:', error);
-  } finally {
-    // Close the connection
-    await db.close();
-  }
-}
-
-main();
-```
-
-### 📚 API Reference
-
-All adapters implement the following common methods (the `IDatabase` interface):
-
-- `select(table, where)`: Returns an array of all rows matching the query.
-- `selectOne(table, where)`: Returns the first row matching the query as an object, or `null`.
-- `insert(table, data)`: Inserts a new row and returns its ID.
-- `update(table, data, where)`: Updates rows matching the query and returns the number of affected rows.
-- `delete(table, where)`: Deletes rows matching the query and returns the number of affected rows.
-- `set(table, data, where)`: Updates a record if it exists, otherwise inserts it as a new record.
-- `bulkInsert(table, dataArray)`: Inserts an array of objects in a single, optimized operation.
-- `close()`: Safely closes the database connection or file handle.
-
-## Database Migration
-
-```javascript
-const path = require('path');
-const createDatabase = require('@onurege3467/zerohelper/database'); // Adjust the path to your project structure
-
-// --- 1. Using SQLite (Fast and Lightweight) ---
-const sqliteDb = createDatabase({
-  adapter: 'sqlite',
-  config: {
-    filePath: path.join(__dirname, 'data', 'development.sqlite')
-  }
-});
-
-// --- 2. Using MySQL (For Production) ---
-const mysqlDb = createDatabase({
-  adapter: 'mysql',
-  config: {
-    host: 'localhost',
-    user: 'root',
-    password: 'your_password',
-    database: 'my_app_prod'
-  }
-});
-
-// --- 3. Using a JSON File (For Simple Prototyping) ---
-const jsonDb = createDatabase({
-  adapter: 'json',
-  config: {
-    filePath: path.join(__dirname, 'data', 'db.json')
-  }
-});
-
-// --- 4. Using MongoDB ---
-const mongoDb = createDatabase({
-    adapter: 'mongodb',
-    config: {
-        url: 'mongodb://localhost:27017',
-        database: 'my_app_mongo'
-    }
-});
-```
-
-### Basic Operations (CRUD)
-
-No matter which adapter you choose, you can use the following methods in exactly the same way.
-
-```javascript
-async function main() {
-  // Let's use sqliteDb for this example
-  const db = createDatabase({
-    adapter: 'sqlite',
-    config: { filePath: 'app.db' }
-  });
-
-  try {
-    // Insert Data
-    const newUserId = await db.insert('users', { name: 'John Doe', email: 'john@example.com', age: 30 });
-    console.log(`New user added with ID: ${newUserId}`);
-
-    // Select Data
-    const user = await db.selectOne('users', { name: 'John Doe' });
-    console.log('Found user:', user);
-
-    // Update Data
-    await db.update('users', { age: 31 }, { email: 'john@example.com' });
-    console.log('User updated.');
-
-    // Update if exists, or insert if not (Upsert)
-    await db.set('users', { city: 'New York' }, { name: 'John Doe' }); // Updates existing
-    await db.set('users', { name: 'Jane Doe', email: 'jane@example.com' }, { name: 'Jane Doe' }); // Inserts new
-
-    // Select All Data
-    const allUsers = await db.select('users');
-    console.log('All users:', allUsers);
-
-    // Delete Data
-    await db.delete('users', { name: 'John Doe' });
-    console.log('User deleted.');
-
-  } catch (error) {
-    console.error('An error occurred:', error);
-  } finally {
-    // Close the connection
-    await db.close();
-  }
-}
-
-main();
-```
-
-### 📚 API Reference
-
-All adapters implement the following common methods (the `IDatabase` interface):
-
-- `select(table, where)`: Returns an array of all rows matching the query.
-- `selectOne(table, where)`: Returns the first row matching the query as an object, or `null`.
-- `insert(table, data)`: Inserts a new row and returns its ID.
-- `update(table, data, where)`: Updates rows matching the query and returns the number of affected rows.
-- `delete(table, where)`: Deletes rows matching the query and returns the number of affected rows.
-- `set(table, data, where)`: Updates a record if it exists, otherwise inserts it as a new record.
-- `bulkInsert(table, dataArray)`: Inserts an array of objects in a single, optimized operation.
-- `close()`: Safely closes the database connection or file handle.