maflex-utils 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Maflex
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,8 @@
+# maflex-utils
+
+Backend geliştirenler için sık kullanılan yardımcı Node.js fonksiyonları içeren hafif bir yardımcı kütüphane.
+
+## Kurulum
+
+```bash
+npm install maflex-utils

package/index.js

@@ -0,0 +1,11 @@
+const math = require('./src/math')
+const asyncUtils = require('./src/async')
+const string = require('./src/string')
+const validation = require('./src/validation')
+
+module.exports = {
+  ...math,
+  ...asyncUtils,
+  ...string,
+  ...validation
+}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "maflex-utils",
+  "version": "1.0.0",
+  "description": "Lightweight utility helpers for Node.js backend development",
+  "main": "index.js",
+  "keywords": [
+    "nodejs",
+    "utils",
+    "helpers",
+    "backend",
+    "utility",
+    "validation",
+    "string",
+    "math",
+    "async"
+  ],
+  "author": "Maflex",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/USERNAME/maflex-utils.git"
+  },
+  "bugs": {
+    "url": "https://github.com/USERNAME/maflex-utils/issues"
+  },
+  "homepage": "https://github.com/USERNAME/maflex-utils#readme",
+  "engines": {
+    "node": ">=18"
+  }
+}

package/src/async.js

@@ -0,0 +1,21 @@
+'use strict';
+
+/**
+ * Belirtilen milisaniye kadar bekleyen Promise döndürür.
+ * @param {number} ms - Bekleme süresi (milisaniye)
+ * @returns {Promise<void>}
+ */
+function sleep(ms) {
+  if (typeof ms !== 'number' || !Number.isFinite(ms)) {
+    throw new TypeError('sleep: "ms" must be a finite number');
+  }
+  if (ms < 0) {
+    throw new RangeError('sleep: "ms" cannot be negative');
+  }
+
+  return new Promise(resolve => setTimeout(resolve, ms));
+}
+
+module.exports = {
+  sleep
+};

package/src/math.js

@@ -0,0 +1,42 @@
+'use strict';
+
+/**
+ * İki sayıyı toplar.
+ * @param {number} a - İlk sayı
+ * @param {number} b - İkinci sayı
+ * @returns {number}
+ */
+function sum(a, b) {
+  if (typeof a !== 'number' || !Number.isFinite(a)) {
+    throw new TypeError('sum: "a" must be a finite number');
+  }
+  if (typeof b !== 'number' || !Number.isFinite(b)) {
+    throw new TypeError('sum: "b" must be a finite number');
+  }
+  return a + b;
+}
+
+/**
+ * Belirtilen aralıkta rastgele tam sayı üretir (min ve max dahil).
+ * @param {number} min - Minimum tam sayı
+ * @param {number} max - Maksimum tam sayı
+ * @returns {number}
+ */
+function randomInt(min, max) {
+  if (!Number.isInteger(min)) {
+    throw new TypeError('randomInt: "min" must be an integer');
+  }
+  if (!Number.isInteger(max)) {
+    throw new new TypeError('randomInt: "max" must be an integer');
+  }
+  if (min > max) {
+    throw new RangeError('randomInt: "min" cannot be greater than "max"');
+  }
+
+  return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+
+module.exports = {
+  sum,
+  randomInt
+};

package/src/string.js

@@ -0,0 +1,33 @@
+'use strict';
+
+/**
+ * Metnin ilk harfini büyütür.
+ * @param {string} text - İşlenecek metin
+ * @returns {string}
+ */
+function capitalize(text) {
+  if (typeof text !== 'string') {
+    throw new TypeError('capitalize: "text" must be a string');
+  }
+  if (text.length === 0) return '';
+
+  return text.charAt(0).toUpperCase() + text.slice(1);
+}
+
+/**
+ * Metni ters çevirir.
+ * @param {string} text - İşlenecek metin
+ * @returns {string}
+ */
+function reverse(text) {
+  if (typeof text !== 'string') {
+    throw new TypeError('reverse: "text" must be a string');
+  }
+
+  return text.split('').reverse().join('');
+}
+
+module.exports = {
+  capitalize,
+  reverse
+};

package/src/validation.js

@@ -0,0 +1,43 @@
+'use strict';
+
+/**
+ * Değerin number olup olmadığını kontrol eder.
+ * @param {*} value - Kontrol edilecek değer
+ * @returns {boolean}
+ */
+function isNumber(value) {
+  if (arguments.length !== 1) {
+    throw new Error('isNumber: exactly one argument is required');
+  }
+  return typeof value === 'number' && Number.isFinite(value);
+}
+
+/**
+ * Değerin string olup olmadığını kontrol eder.
+ * @param {*} value - Kontrol edilecek değer
+ * @returns {boolean}
+ */
+function isString(value) {
+  if (arguments.length !== 1) {
+    throw new Error('isString: exactly one argument is required');
+  }
+  return typeof value === 'string';
+}
+
+/**
+ * Değerin dizi (array) olup olmadığını kontrol eder.
+ * @param {*} value - Kontrol edilecek değer
+ * @returns {boolean}
+ */
+function isArray(value) {
+  if (arguments.length !== 1) {
+    throw new Error('isArray: exactly one argument is required');
+  }
+  return Array.isArray(value);
+}
+
+module.exports = {
+  isNumber,
+  isString,
+  isArray
+};