@artilingo/artiframe-cli 1.3.0 → 2.0.0

package/core-stubs/bin/SystemMethod.php

@@ -1,4 +1,5 @@
 <?php
+
 /**
  * ArtiFrame Core Engine
  *
@@ -12,632 +13,710 @@
  * and remain open-source under the AGPLv3 license.
  */
 
-namespace Bin;
-
-class SystemMethod
-{
-    /**
-     * E-posta adresinin format olarak geçerli olup olmadığını doğrular.
-     * 
-     * @param string $email Doğrulanacak E-Posta
-     * @return bool
-     */
-    public static function verifyEmail(string $email): bool
-    {
-        return filter_var($email, FILTER_VALIDATE_EMAIL) !== false;
-    }
+namespace Bin {
 
-    /**
-     * Gelen veriyi güvenli bir Integer (tam sayı) değerine dönüştürür.
-     * Harfleri siler ve sayısal karakter bırakır.
-     * 
-     * @param mixed $value
-     * @return int
-     */
-    public static function sanitizeInt($value): int
+    class SystemMethod
     {
-        return (int) filter_var($value, FILTER_SANITIZE_NUMBER_INT);
-    }
+        /**
+         * E-posta adresinin format olarak geçerli olup olmadığını doğrular.
+         * 
+         * @param string $email Doğrulanacak E-Posta
+         * @return bool
+         */
+        public static function verifyEmail(string $email): bool
+        {
+            return filter_var($email, FILTER_VALIDATE_EMAIL) !== false;
+        }
 
-    /**
-     * Gelen verideki HTML etiketlerini ve zararlı kodları temizler.
-     * Veritabanına String kaydetmeden önce mutlaka kullanılmalıdır.
-     * 
-     * @param string $value
-     * @return string
-     */
-    public static function sanitizeString(string $value): string
-    {
-        return strip_tags(trim($value));
-    }
+        /**
+         * Gelen veriyi güvenli bir Integer (tam sayı) değerine dönüştürür.
+         * Harfleri siler ve sayısal karakter bırakır.
+         * 
+         * @param mixed $value
+         * @return int
+         */
+        public static function sanitizeInt($value): int
+        {
+            return (int) filter_var($value, FILTER_SANITIZE_NUMBER_INT);
+        }
 
-    /**
-     * Sayfaya gelen isteğin bir form gönderimi (POST) olup olmadığını kontrol eder.
-     * 
-     * @return bool
-     */
-    public static function isPost(): bool
-    {
-        return $_SERVER['REQUEST_METHOD'] === 'POST';
-    }
+        /**
+         * Gelen verideki HTML etiketlerini ve zararlı kodları temizler.
+         * Veritabanına String kaydetmeden önce mutlaka kullanılmalıdır.
+         * 
+         * @param string $value
+         * @return string
+         */
+        public static function sanitizeString(string $value): string
+        {
+            return strip_tags(trim($value));
+        }
 
-    /**
-     * Oturum (Session) tabanlı CSRF (Cross-Site Request Forgery) güvenlik token'ı üretir.
-     */
-    public static function generateCsrf(): string
-    {
-        if (session_status() === PHP_SESSION_NONE) {
-            session_start();
+        /**
+         * Sayfaya gelen isteğin bir form gönderimi (POST) olup olmadığını kontrol eder.
+         * 
+         * @return bool
+         */
+        public static function isPost(): bool
+        {
+            return $_SERVER['REQUEST_METHOD'] === 'POST';
         }
-        if (empty($_SESSION['csrf_token'])) {
-            $_SESSION['csrf_token'] = bin2hex(random_bytes(32));
+
+        /**
+         * Oturum (Session) tabanlı CSRF (Cross-Site Request Forgery) güvenlik token'ı üretir.
+         */
+        public static function generateCsrf(): string
+        {
+            if (session_status() === PHP_SESSION_NONE) {
+                session_start();
+            }
+            if (empty($_SESSION['csrf_token'])) {
+                $_SESSION['csrf_token'] = bin2hex(random_bytes(32));
+            }
+            return $_SESSION['csrf_token'];
         }
-        return $_SESSION['csrf_token'];
-    }
 
-    /**
-     * Formdan gelen CSRF token'ın doğruluğunu onaylar. (Form güvenlik kalkanı)
-     */
-    public static function verifyCsrf(?string $token): bool
-    {
-        if (session_status() === PHP_SESSION_NONE) {
-            session_start();
+        /**
+         * Formdan gelen CSRF token'ın doğruluğunu onaylar. (Form güvenlik kalkanı)
+         */
+        public static function verifyCsrf(?string $token): bool
+        {
+            if (session_status() === PHP_SESSION_NONE) {
+                session_start();
+            }
+            if (empty($_SESSION['csrf_token']) || empty($token)) {
+                return false;
+            }
+            return hash_equals($_SESSION['csrf_token'], $token);
         }
-        if (empty($_SESSION['csrf_token']) || empty($token)) {
-            return false;
+
+        /**
+         * İsteğin AJAX üzerinden gelip gelmediğini kontrol eder. (Fetch / Axios destekli)
+         */
+        public static function isAjax(): bool
+        {
+            return !empty($_SERVER['HTTP_X_REQUESTED_WITH']) && strtolower($_SERVER['HTTP_X_REQUESTED_WITH']) === 'xmlhttprequest';
         }
-        return hash_equals($_SESSION['csrf_token'], $token);
-    }
 
-    /**
-     * İsteğin AJAX üzerinden gelip gelmediğini kontrol eder. (Fetch / Axios destekli)
-     */
-    public static function isAjax(): bool
-    {
-        return !empty($_SERVER['HTTP_X_REQUESTED_WITH']) && strtolower($_SERVER['HTTP_X_REQUESTED_WITH']) === 'xmlhttprequest';
-    }
+        /**
+         * API'ler için hızlı ve standart JSON yanıt (response) oluşturur.
+         * Kullanıldığı anda işlemi sonlandırır (exit).
+         * 
+         * @param array $data JSON'a çevrilecek dizi (array)
+         * @param int $statusCode HTTP Durum Kodu (200 OK, 404 Not Found vb.)
+         */
+        public static function jsonResponse(array $data, int $statusCode = 200): void
+        {
+            http_response_code($statusCode);
+            header('Content-Type: application/json; charset=utf-8');
+            echo json_encode($data, JSON_UNESCAPED_UNICODE);
+            exit;
+        }
 
-    /**
-     * API'ler için hızlı ve standart JSON yanıt (response) oluşturur.
-     * Kullanıldığı anda işlemi sonlandırır (exit).
-     * 
-     * @param array $data JSON'a çevrilecek dizi (array)
-     * @param int $statusCode HTTP Durum Kodu (200 OK, 404 Not Found vb.)
-     */
-    public static function jsonResponse(array $data, int $statusCode = 200): void
-    {
-        http_response_code($statusCode);
-        header('Content-Type: application/json; charset=utf-8');
-        echo json_encode($data, JSON_UNESCAPED_UNICODE);
-        exit;
-    }
+        /**
+         * Standart API yanıtı (JSON) oluşturur.
+         * APP_ENV = 1 (Debug) ise Exception detaylarını mesaja yazar.
+         * APP_ENV = 0 (Prod) ise kullanıcının girdiği temiz mesajı gösterir.
+         */
+        public static function apiResponse(string $status, string $message, array $data = [], \Throwable $exception = null): void
+        {
+            // Debug modundaysak ve bir exception geldiyse, mesajı ezip sistem hatasını basıyoruz
+            if (defined('APP_ENV') && APP_ENV === 1 && $exception !== null) {
+                $message = $exception->getMessage() . ' (Dosya: ' . $exception->getFile() . ' Satır: ' . $exception->getLine() . ')';
+            }
 
-    /**
-     * Standart API yanıtı (JSON) oluşturur.
-     * APP_ENV = 1 (Debug) ise Exception detaylarını mesaja yazar.
-     * APP_ENV = 0 (Prod) ise kullanıcının girdiği temiz mesajı gösterir.
-     */
-    public static function apiResponse(string $status, string $message, array $data = [], \Throwable $exception = null): void
-    {
-        // Debug modundaysak ve bir exception geldiyse, mesajı ezip sistem hatasını basıyoruz
-        if (defined('APP_ENV') && APP_ENV === 1 && $exception !== null) {
-            $message = $exception->getMessage() . ' (Dosya: ' . $exception->getFile() . ' Satır: ' . $exception->getLine() . ')';
+            $response = [
+                'status'  => $status,
+                'message' => $message,
+                'data'    => $data
+            ];
+
+            $statusCode = ($status === 'success') ? 200 : 400;
+            self::jsonResponse($response, $statusCode);
         }
 
-        $response = [
-            'status'  => $status,
-            'message' => $message,
-            'data'    => $data
-        ];
+        /**
+         * Sayfaya gelen isteğin GET olup olmadığını kontrol eder.
+         */
+        public static function isGet(): bool
+        {
+            return $_SERVER['REQUEST_METHOD'] === 'GET';
+        }
 
-        $statusCode = ($status === 'success') ? 200 : 400;
-        self::jsonResponse($response, $statusCode);
-    }
+        /**
+         * Sayfaya gelen isteğin PUT olup olmadığını kontrol eder.
+         */
+        public static function isPut(): bool
+        {
+            return $_SERVER['REQUEST_METHOD'] === 'PUT';
+        }
 
-    /**
-     * Sayfaya gelen isteğin GET olup olmadığını kontrol eder.
-     */
-    public static function isGet(): bool
-    {
-        return $_SERVER['REQUEST_METHOD'] === 'GET';
-    }
+        /**
+         * Sayfaya gelen isteğin DELETE olup olmadığını kontrol eder.
+         */
+        public static function isDelete(): bool
+        {
+            return $_SERVER['REQUEST_METHOD'] === 'DELETE';
+        }
 
-    /**
-     * Sayfaya gelen isteğin PUT olup olmadığını kontrol eder.
-     */
-    public static function isPut(): bool
-    {
-        return $_SERVER['REQUEST_METHOD'] === 'PUT';
-    }
+        /**
+         * Kullanıcının gerçek IP adresini tespit eder (Cloudflare ve Proxy destekli).
+         */
+        public static function getClientIp(): string
+        {
+            if (!empty($_SERVER['HTTP_CF_CONNECTING_IP'])) {
+                return $_SERVER['HTTP_CF_CONNECTING_IP'];
+            }
+            if (!empty($_SERVER['HTTP_CLIENT_IP'])) {
+                return $_SERVER['HTTP_CLIENT_IP'];
+            }
+            if (!empty($_SERVER['HTTP_X_FORWARDED_FOR'])) {
+                $ipList = explode(',', $_SERVER['HTTP_X_FORWARDED_FOR']);
+                return trim($ipList[0]);
+            }
+            return $_SERVER['REMOTE_ADDR'] ?? '0.0.0.0';
+        }
 
-    /**
-     * Sayfaya gelen isteğin DELETE olup olmadığını kontrol eder.
-     */
-    public static function isDelete(): bool
-    {
-        return $_SERVER['REQUEST_METHOD'] === 'DELETE';
-    }
+        /**
+         * İstenilen sayfaya yönlendirme yapar ve çalışmayı durdurur.
+         */
+        public static function redirect(string $url): void
+        {
+            header("Location: " . $url);
+            exit;
+        }
 
-    /**
-     * Kullanıcının gerçek IP adresini tespit eder (Cloudflare ve Proxy destekli).
-     */
-    public static function getClientIp(): string
-    {
-        if (!empty($_SERVER['HTTP_CF_CONNECTING_IP'])) {
-            return $_SERVER['HTTP_CF_CONNECTING_IP'];
+        /**
+         * Kriptografik olarak güvenli, rastgele bir token üretir (Örn: Parola sıfırlama, API Key).
+         */
+        public static function generateToken(int $length = 32): string
+        {
+            return bin2hex(random_bytes($length));
         }
-        if (!empty($_SERVER['HTTP_CLIENT_IP'])) {
-            return $_SERVER['HTTP_CLIENT_IP'];
+
+        /**
+         * Şifreyi bcrypt algoritmasıyla güvenli bir şekilde hash'ler.
+         * Boş veya null gelirse güvenliği sağlamak adına exception fırlatır.
+         */
+        public static function hashPassword(?string $password): string
+        {
+            if (empty($password)) {
+                throw new \Exception('Password cannot be empty or null.');
+            }
+            return password_hash($password, PASSWORD_BCRYPT);
         }
-        if (!empty($_SERVER['HTTP_X_FORWARDED_FOR'])) {
-            $ipList = explode(',', $_SERVER['HTTP_X_FORWARDED_FOR']);
-            return trim($ipList[0]);
+
+        /**
+         * Düz metin şifreyi veritabanındaki hash ile karşılaştırır.
+         * Herhangi biri null veya boşsa her zaman false döner.
+         */
+        public static function verifyPassword(?string $password, ?string $hash): bool
+        {
+            if (empty($password) || empty($hash)) {
+                return false;
+            }
+            return password_verify($password, $hash);
         }
-        return $_SERVER['REMOTE_ADDR'] ?? '0.0.0.0';
-    }
 
-    /**
-     * İstenilen sayfaya yönlendirme yapar ve çalışmayı durdurur.
-     */
-    public static function redirect(string $url): void
-    {
-        header("Location: " . $url);
-        exit;
-    }
 
-    /**
-     * Kriptografik olarak güvenli, rastgele bir token üretir (Örn: Parola sıfırlama, API Key).
-     */
-    public static function generateToken(int $length = 32): string
-    {
-        return bin2hex(random_bytes($length));
-    }
+        /**
+         * E-posta adresini zararlı karakterlerden temizler.
+         */
+        public static function sanitizeEmail(string $email): string
+        {
+            return filter_var($email, FILTER_SANITIZE_EMAIL);
+        }
 
-    /**
-     * Şifreyi bcrypt algoritmasıyla güvenli bir şekilde hash'ler.
-     * Boş veya null gelirse güvenliği sağlamak adına exception fırlatır.
-     */
-    public static function hashPassword(?string $password): string
-    {
-        if (empty($password)) {
-            throw new \Exception('Password cannot be empty or null.');
+        /**
+         * Gelen veriyi güvenli bir ondalıklı (float) sayıya dönüştürür.
+         * Fiyat ve oran hesaplamalarında kullanılır.
+         */
+        public static function sanitizeFloat($value): float
+        {
+            return (float) filter_var($value, FILTER_SANITIZE_NUMBER_FLOAT, FILTER_FLAG_ALLOW_FRACTION);
         }
-        return password_hash($password, PASSWORD_BCRYPT);
-    }
 
-    /**
-     * Düz metin şifreyi veritabanındaki hash ile karşılaştırır.
-     * Herhangi biri null veya boşsa her zaman false döner.
-     */
-    public static function verifyPassword(?string $password, ?string $hash): bool
-    {
-        if (empty($password) || empty($hash)) {
-            return false;
+        /**
+         * Bir diziden sadece belirtilen anahtarlara (keys) sahip olanları seçer.
+         * Güvenli mass-assignment (toplu atama) için kullanılır.
+         */
+        public static function arrayOnly(array $source, array $keys): array
+        {
+            return array_intersect_key($source, array_flip($keys));
         }
-        return password_verify($password, $hash);
-    }
 
+        /**
+         * Hızlı hata ayıklama aracı. (Dump & Die)
+         */
+        public static function dd(...$vars): void
+        {
+            echo '<pre style="background:#1d232a;color:#a6adbb;padding:16px;border-radius:8px;font-size:14px;overflow-x:auto;z-index:9999;position:relative;">';
+            foreach ($vars as $var) {
+                var_dump($var);
+            }
+            echo '</pre>';
+            exit;
+        }
 
-    /**
-     * E-posta adresini zararlı karakterlerden temizler.
-     */
-    public static function sanitizeEmail(string $email): string
-    {
-        return filter_var($email, FILTER_SANITIZE_EMAIL);
-    }
+        /**
+         * Metni URL dostu bir slug'a çevirir (Örn: "Utku", "Egemen" -> "utku-egemen")
+         * (SystemMethod için global kullanılabilir versiyon)
+         */
+        public static function slugify(string ...$texts): string
+        {
+            $text = implode('-', $texts);
+            $text = mb_strtolower($text, 'UTF-8');
+
+            $search = [
+                'ç',
+                'ğ',
+                'ı',
+                'ö',
+                'ş',
+                'ü', // TR
+                'ä',
+                'ß',                     // DE
+                'ñ',                          // ES
+                'é',
+                'è',
+                'ê',
+                'ë',
+                'à',
+                'á',
+                'â',
+                'î',
+                'ï',
+                'í',
+                'ô',
+                'ó',
+                'ú',
+                'û',
+                'ù',
+                'æ',
+                'œ' // FR & ES
+            ];
+            $replace = [
+                'c',
+                'g',
+                'i',
+                'o',
+                's',
+                'u',
+                'ae',
+                'ss',
+                'n',
+                'e',
+                'e',
+                'e',
+                'e',
+                'a',
+                'a',
+                'a',
+                'i',
+                'i',
+                'i',
+                'o',
+                'o',
+                'u',
+                'u',
+                'u',
+                'ae',
+                'oe'
+            ];
+
+            $text = str_replace($search, $replace, $text);
+            $text = preg_replace('/[^a-z0-9\-]/', '-', $text);
+            $text = preg_replace('/-+/', '-', $text);
+            return trim($text, '-');
+        }
 
-    /**
-     * Gelen veriyi güvenli bir ondalıklı (float) sayıya dönüştürür.
-     * Fiyat ve oran hesaplamalarında kullanılır.
-     */
-    public static function sanitizeFloat($value): float
-    {
-        return (float) filter_var($value, FILTER_SANITIZE_NUMBER_FLOAT, FILTER_FLAG_ALLOW_FRACTION);
-    }
+        /**
+         * Natively generates a raw 16-byte binary UUIDv7.
+         * Ideal for BINARY(16) database columns (High performance indexing).
+         *
+         * @return string 16-byte raw binary string
+         */
+        public static function byteId(): string
+        {
+            // Get current timestamp in milliseconds (48-bit)
+            $ts = (int)(microtime(true) * 1000);
+            $timeHex = str_pad(dechex($ts), 12, '0', STR_PAD_LEFT);
+            $timeBin = hex2bin($timeHex);
+
+            // Generate 10 bytes of randomness
+            $rand = random_bytes(10);
+
+            // Set UUID Version (7) -> 4 bits of the 7th byte
+            $rand[0] = chr((ord($rand[0]) & 0x0F) | 0x70);
+
+            // Set UUID Variant (10) -> 2 bits of the 9th byte
+            $rand[2] = chr((ord($rand[2]) & 0x3F) | 0x80);
+
+            // Return exactly 16 bytes (6 bytes time + 10 bytes rand)
+            return $timeBin . $rand;
+        }
 
-    /**
-     * Bir diziden sadece belirtilen anahtarlara (keys) sahip olanları seçer.
-     * Güvenli mass-assignment (toplu atama) için kullanılır.
-     */
-    public static function arrayOnly(array $source, array $keys): array
-    {
-        return array_intersect_key($source, array_flip($keys));
-    }
+        /**
+         * Bi-directional UUID formatter (String <-> Binary)
+         * 
+         * @param string $value 16-byte binary string OR 36-character UUID string
+         * @param string $to 'auto', 'binary', or 'string'
+         * @return string
+         */
+        public static function formatId(string $value, string $to = 'auto'): string
+        {
+            // Target: Binary conversion (String -> Binary)
+            if ($to === 'binary' || ($to === 'auto' && strlen($value) !== 16)) {
+                $cleanHex = str_replace('-', '', $value);
+
+                if (strlen($cleanHex) !== 32) {
+                    throw new \InvalidArgumentException("Invalid UUID string format.");
+                }
+
+                return hex2bin($cleanHex);
+            }
 
-    /**
-     * Hızlı hata ayıklama aracı. (Dump & Die)
-     */
-    public static function dd(...$vars): void
-    {
-        echo '<pre style="background:#1d232a;color:#a6adbb;padding:16px;border-radius:8px;font-size:14px;overflow-x:auto;z-index:9999;position:relative;">';
-        foreach ($vars as $var) {
-            var_dump($var);
+            // Target: String conversion (Binary -> String)
+            if (strlen($value) !== 16) {
+                throw new \InvalidArgumentException("Invalid binary UUID length. Expected 16 bytes.");
+            }
+
+            $hex = bin2hex($value);
+
+            return sprintf(
+                '%s-%s-%s-%s-%s',
+                substr($hex, 0, 8),
+                substr($hex, 8, 4),
+                substr($hex, 12, 4),
+                substr($hex, 16, 4),
+                substr($hex, 20, 12)
+            );
         }
-        echo '</pre>';
-        exit;
-    }
 
-    /**
-     * Metni URL dostu bir slug'a çevirir (Örn: "Utku", "Egemen" -> "utku-egemen")
-     * (SystemMethod için global kullanılabilir versiyon)
-     */
-    public static function slugify(string ...$texts): string
-    {
-        $text = implode('-', $texts);
-        $text = mb_strtolower($text, 'UTF-8');
-        
-        $search = [
-            'ç', 'ğ', 'ı', 'ö', 'ş', 'ü', // TR
-            'ä', 'ß',                     // DE
-            'ñ',                          // ES
-            'é', 'è', 'ê', 'ë', 'à', 'á', 'â', 'î', 'ï', 'í', 'ô', 'ó', 'ú', 'û', 'ù', 'æ', 'œ' // FR & ES
-        ];
-        $replace = [
-            'c', 'g', 'i', 'o', 's', 'u',
-            'ae', 'ss',
-            'n',
-            'e', 'e', 'e', 'e', 'a', 'a', 'a', 'i', 'i', 'i', 'o', 'o', 'u', 'u', 'u', 'ae', 'oe'
-        ];
-        
-        $text = str_replace($search, $replace, $text);
-        $text = preg_replace('/[^a-z0-9\-]/', '-', $text);
-        $text = preg_replace('/-+/', '-', $text);
-        return trim($text, '-');
-    }
+        /**
+         * Generates a standard formatted UUIDv7 string.
+         *
+         * @return string 36-character hyphenated UUID string
+         */
+        public static function makeId(): string
+        {
+            return self::formatId(self::byteId());
+        }
 
-    /**
-     * Natively generates a raw 16-byte binary UUIDv7.
-     * Ideal for BINARY(16) database columns (High performance indexing).
-     *
-     * @return string 16-byte raw binary string
-     */
-    public static function byteId(): string
-    {
-        // Get current timestamp in milliseconds (48-bit)
-        $ts = (int)(microtime(true) * 1000);
-        $timeHex = str_pad(dechex($ts), 12, '0', STR_PAD_LEFT);
-        $timeBin = hex2bin($timeHex);
-        
-        // Generate 10 bytes of randomness
-        $rand = random_bytes(10);
-        
-        // Set UUID Version (7) -> 4 bits of the 7th byte
-        $rand[0] = chr((ord($rand[0]) & 0x0F) | 0x70);
-        
-        // Set UUID Variant (10) -> 2 bits of the 9th byte
-        $rand[2] = chr((ord($rand[2]) & 0x3F) | 0x80);
-        
-        // Return exactly 16 bytes (6 bytes time + 10 bytes rand)
-        return $timeBin . $rand;
-    }
+        /**
+         * Rastgele Integer ID üretir. (Max 9 hane - MySQL INT sınırı)
+         */
+        public static function intId(int $length = 8): int
+        {
+            if ($length > 9) $length = 9;
+            if ($length < 1) $length = 1;
 
-    /**
-     * Bi-directional UUID formatter (String <-> Binary)
-     * 
-     * @param string $value 16-byte binary string OR 36-character UUID string
-     * @param string $to 'auto', 'binary', or 'string'
-     * @return string
-     */
-    public static function formatId(string $value, string $to = 'auto'): string
-    {
-        // Target: Binary conversion (String -> Binary)
-        if ($to === 'binary' || ($to === 'auto' && strlen($value) !== 16)) {
-            $cleanHex = str_replace('-', '', $value);
-            
-            if (strlen($cleanHex) !== 32) {
-                throw new \InvalidArgumentException("Invalid UUID string format.");
-            }
-            
-            return hex2bin($cleanHex);
-        }
-
-        // Target: String conversion (Binary -> String)
-        if (strlen($value) !== 16) {
-            throw new \InvalidArgumentException("Invalid binary UUID length. Expected 16 bytes.");
-        }
-        
-        $hex = bin2hex($value);
-        
-        return sprintf(
-            '%s-%s-%s-%s-%s',
-            substr($hex, 0, 8),
-            substr($hex, 8, 4),
-            substr($hex, 12, 4),
-            substr($hex, 16, 4),
-            substr($hex, 20, 12)
-        );
-    }
+            $min = (int) str_pad('1', $length, '0');
+            $max = (int) str_pad('9', $length, '9');
 
-    /**
-     * Generates a standard formatted UUIDv7 string.
-     *
-     * @return string 36-character hyphenated UUID string
-     */
-    public static function makeId(): string
-    {
-        return self::formatId(self::byteId());
-    }
+            return random_int($min, $max);
+        }
 
-    /**
-     * Rastgele Integer ID üretir. (Max 9 hane - MySQL INT sınırı)
-     */
-    public static function intId(int $length = 8): int
-    {
-        if ($length > 9) $length = 9;
-        if ($length < 1) $length = 1;
-        
-        $min = (int) str_pad('1', $length, '0');
-        $max = (int) str_pad('9', $length, '9');
-        
-        return random_int($min, $max);
-    }
+        /**
+         * Rastgele BigInt ID üretir.
+         * Javascript MAX_SAFE_INTEGER (15 hane) sınırını aşmamak için varsayılan 15'tir.
+         * 16-18 hane istenirse veri kaybını önlemek için asString = true önerilir.
+         */
+        public static function bigintId(int $length = 15, bool $asString = false)
+        {
+            if ($length > 18) $length = 18;
+            if ($length < 1) $length = 1;
 
-    /**
-     * Rastgele BigInt ID üretir.
-     * Javascript MAX_SAFE_INTEGER (15 hane) sınırını aşmamak için varsayılan 15'tir.
-     * 16-18 hane istenirse veri kaybını önlemek için asString = true önerilir.
-     */
-    public static function bigintId(int $length = 15, bool $asString = false)
-    {
-        if ($length > 18) $length = 18;
-        if ($length < 1) $length = 1;
+            $min = str_pad('1', $length, '0');
+            $max = str_pad('9', $length, '9');
 
-        $min = str_pad('1', $length, '0');
-        $max = str_pad('9', $length, '9');
+            $result = random_int((int)$min, (int)$max);
 
-        $result = random_int((int)$min, (int)$max);
+            return $asString ? (string) $result : $result;
+        }
 
-        return $asString ? (string) $result : $result;
-    }
+        /**
+         * Sadece sayılardan oluşan rastgele bir OTP (One-Time Password) kodu üretir.
+         * @param int $length Hanelerin sayısı (Varsayılan 6)
+         */
+        public static function otpInt(int $length = 6): int
+        {
+            if ($length < 1) $length = 1;
+            if ($length > 18) $length = 18; // PHP 64-bit safe max length
 
-    /**
-     * Sadece sayılardan oluşan rastgele bir OTP (One-Time Password) kodu üretir.
-     * @param int $length Hanelerin sayısı (Varsayılan 6)
-     */
-    public static function otpInt(int $length = 6): int
-    {
-        if ($length < 1) $length = 1;
-        if ($length > 18) $length = 18; // PHP 64-bit safe max length
-        
-        $min = (int) str_pad('1', $length, '0');
-        $max = (int) str_pad('9', $length, '9');
-        
-        return random_int($min, $max);
-    }
+            $min = (int) str_pad('1', $length, '0');
+            $max = (int) str_pad('9', $length, '9');
 
-    /**
-     * Sadece harflerden oluşan rastgele bir OTP kodu üretir.
-     * @param int $length Hanelerin sayısı (Varsayılan 6)
-     * @param string $case 'c': Sadece küçük, 'C': Sadece büyük, 'cC'/'Cc': Karışık
-     */
-    public static function otpStr(int $length = 6, string $case = 'C'): string
-    {
-        $lower = 'abcdefghijklmnopqrstuvwxyz';
-        $upper = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
-
-        $chars = match (strtolower($case)) {
-            'c'  => $lower,
-            'cc' => $lower . $upper,
-            default => $upper,
-        };
-        
-        $otp = '';
-        $maxIndex = strlen($chars) - 1;
-        for ($i = 0; $i < $length; $i++) {
-            $otp .= $chars[random_int(0, $maxIndex)];
-        }
-        
-        return $otp;
-    }
+            return random_int($min, $max);
+        }
 
-    /**
-     * Harf ve sayılardan (Alphanumeric) oluşan rastgele bir OTP kodu üretir.
-     * @param int $length Hanelerin sayısı (Varsayılan 6)
-     * @param string $case 'c': Küçük+Sayı, 'C': Büyük+Sayı, 'cC'/'Cc': Karışık+Sayı
-     */
-    public static function otpMix(int $length = 6, string $case = 'C'): string
-    {
-        $numbers = '0123456789';
-        $lower   = 'abcdefghijklmnopqrstuvwxyz';
-        $upper   = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
-
-        $chars = match (strtolower($case)) {
-            'c'  => $numbers . $lower,
-            'cc' => $numbers . $lower . $upper,
-            default => $numbers . $upper,
-        };
-        
-        $otp = '';
-        $maxIndex = strlen($chars) - 1;
-        for ($i = 0; $i < $length; $i++) {
-            $otp .= $chars[random_int(0, $maxIndex)];
-        }
-        
-        return $otp;
-    }
+        /**
+         * Sadece harflerden oluşan rastgele bir OTP kodu üretir.
+         * @param int $length Hanelerin sayısı (Varsayılan 6)
+         * @param string $case 'c': Sadece küçük, 'C': Sadece büyük, 'cC'/'Cc': Karışık
+         */
+        public static function otpStr(int $length = 6, string $case = 'C'): string
+        {
+            $lower = 'abcdefghijklmnopqrstuvwxyz';
+            $upper = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
+
+            $chars = match (strtolower($case)) {
+                'c'  => $lower,
+                'cc' => $lower . $upper,
+                default => $upper,
+            };
+
+            $otp = '';
+            $maxIndex = strlen($chars) - 1;
+            for ($i = 0; $i < $length; $i++) {
+                $otp .= $chars[random_int(0, $maxIndex)];
+            }
 
-    /**
-     * Gelen veriyi (özellikle BigInt ID'leri) güvenli bir şekilde string'e çevirir.
-     * Javascript'te 15 haneyi aşan sayılardaki veri kaybını engellemek için
-     * View dosyalarında data-id=<?= stringer($id) ?> şeklinde kullanılır.
-     */
-    public static function stringer($value): string
-    {
-        return (string) $value;
-    }
-}
+            return $otp;
+        }
+
+        /**
+         * Harf ve sayılardan (Alphanumeric) oluşan rastgele bir OTP kodu üretir.
+         * @param int $length Hanelerin sayısı (Varsayılan 6)
+         * @param string $case 'c': Küçük+Sayı, 'C': Büyük+Sayı, 'cC'/'Cc': Karışık+Sayı
+         */
+        public static function otpMix(int $length = 6, string $case = 'C'): string
+        {
+            $numbers = '0123456789';
+            $lower   = 'abcdefghijklmnopqrstuvwxyz';
+            $upper   = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
+
+            $chars = match (strtolower($case)) {
+                'c'  => $numbers . $lower,
+                'cc' => $numbers . $lower . $upper,
+                default => $numbers . $upper,
+            };
+
+            $otp = '';
+            $maxIndex = strlen($chars) - 1;
+            for ($i = 0; $i < $length; $i++) {
+                $otp .= $chars[random_int(0, $maxIndex)];
+            }
+
+            return $otp;
+        }
+
+        /**
+         * Gelen veriyi (özellikle BigInt ID'leri) güvenli bir şekilde string'e çevirir.
+         * Javascript'te 15 haneyi aşan sayılardaki veri kaybını engellemek için
+         * View dosyalarında data-id=<?= stringer($id) ?> şeklinde kullanılır.
+         */
+        public static function stringer($value): string
+        {
+            return (string) $value;
+        }
+    } // end class SystemMethod
+
+} // end namespace Bin
 
 // Global helper functions for backend methods
-if (!function_exists(__NAMESPACE__ . '\\verifyEmail')) {
-    function verifyEmail(string $email): bool {
-        return \Bin\SystemMethod::verifyEmail($email);
+namespace {
+
+    if (!function_exists('verifyEmail')) {
+        function verifyEmail(string $email): bool
+        {
+            return \Bin\SystemMethod::verifyEmail($email);
+        }
     }
-}
 
-if (!function_exists(__NAMESPACE__ . '\\sanitizeInt')) {
-    function sanitizeInt($value): int {
-        return \Bin\SystemMethod::sanitizeInt($value);
+    if (!function_exists('sanitizeInt')) {
+        function sanitizeInt($value): int
+        {
+            return \Bin\SystemMethod::sanitizeInt($value);
+        }
     }
-}
 
-if (!function_exists(__NAMESPACE__ . '\\sanitizeString')) {
-    function sanitizeString(string $value): string {
-        return \Bin\SystemMethod::sanitizeString($value);
+    if (!function_exists('sanitizeString')) {
+        function sanitizeString(string $value): string
+        {
+            return \Bin\SystemMethod::sanitizeString($value);
+        }
     }
-}
 
-if (!function_exists(__NAMESPACE__ . '\\isPost')) {
-    function isPost(): bool {
-        return \Bin\SystemMethod::isPost();
+    if (!function_exists('isPost')) {
+        function isPost(): bool
+        {
+            return \Bin\SystemMethod::isPost();
+        }
     }
-}
 
-if (!function_exists(__NAMESPACE__ . '\\jsonResponse')) {
-    function jsonResponse(array $data, int $statusCode = 200): void {
-        \Bin\SystemMethod::jsonResponse($data, $statusCode);
+    if (!function_exists('jsonResponse')) {
+        function jsonResponse(array $data, int $statusCode = 200): void
+        {
+            \Bin\SystemMethod::jsonResponse($data, $statusCode);
+        }
     }
-}
 
-if (!function_exists(__NAMESPACE__ . '\\apiResponse')) {
-    function apiResponse(string $status, string $message, array $data = [], \Throwable $exception = null): void {
-        \Bin\SystemMethod::apiResponse($status, $message, $data, $exception);
+    if (!function_exists('apiResponse')) {
+        function apiResponse(string $status, string $message, array $data = [], \Throwable $exception = null): void
+        {
+            \Bin\SystemMethod::apiResponse($status, $message, $data, $exception);
+        }
     }
-}
 
-if (!function_exists(__NAMESPACE__ . '\\generateCsrf')) {
-    function generateCsrf(): string {
-        return \Bin\SystemMethod::generateCsrf();
+    if (!function_exists('generateCsrf')) {
+        function generateCsrf(): string
+        {
+            return \Bin\SystemMethod::generateCsrf();
+        }
     }
-}
 
-if (!function_exists(__NAMESPACE__ . '\\verifyCsrf')) {
-    function verifyCsrf(?string $token): bool {
-        return \Bin\SystemMethod::verifyCsrf($token);
+    if (!function_exists('verifyCsrf')) {
+        function verifyCsrf(?string $token): bool
+        {
+            return \Bin\SystemMethod::verifyCsrf($token);
+        }
     }
-}
 
-if (!function_exists(__NAMESPACE__ . '\\isAjax')) {
-    function isAjax(): bool {
-        return \Bin\SystemMethod::isAjax();
+    if (!function_exists('isAjax')) {
+        function isAjax(): bool
+        {
+            return \Bin\SystemMethod::isAjax();
+        }
     }
-}
 
-if (!function_exists(__NAMESPACE__ . '\\isGet')) {
-    function isGet(): bool {
-        return \Bin\SystemMethod::isGet();
+    if (!function_exists('isGet')) {
+        function isGet(): bool
+        {
+            return \Bin\SystemMethod::isGet();
+        }
     }
-}
 
-if (!function_exists(__NAMESPACE__ . '\\isPut')) {
-    function isPut(): bool {
-        return \Bin\SystemMethod::isPut();
+    if (!function_exists('isPut')) {
+        function isPut(): bool
+        {
+            return \Bin\SystemMethod::isPut();
+        }
     }
-}
 
-if (!function_exists(__NAMESPACE__ . '\\isDelete')) {
-    function isDelete(): bool {
-        return \Bin\SystemMethod::isDelete();
+    if (!function_exists('isDelete')) {
+        function isDelete(): bool
+        {
+            return \Bin\SystemMethod::isDelete();
+        }
     }
-}
 
-if (!function_exists(__NAMESPACE__ . '\\getClientIp')) {
-    function getClientIp(): string {
-        return \Bin\SystemMethod::getClientIp();
+    if (!function_exists('getClientIp')) {
+        function getClientIp(): string
+        {
+            return \Bin\SystemMethod::getClientIp();
+        }
     }
-}
 
-if (!function_exists(__NAMESPACE__ . '\\redirect')) {
-    function redirect(string $url): void {
-        \Bin\SystemMethod::redirect($url);
+    if (!function_exists('redirect')) {
+        function redirect(string $url): void
+        {
+            \Bin\SystemMethod::redirect($url);
+        }
     }
-}
 
-if (!function_exists(__NAMESPACE__ . '\\generateToken')) {
-    function generateToken(int $length = 32): string {
-        return \Bin\SystemMethod::generateToken($length);
+    if (!function_exists('generateToken')) {
+        function generateToken(int $length = 32): string
+        {
+            return \Bin\SystemMethod::generateToken($length);
+        }
     }
-}
 
-if (!function_exists(__NAMESPACE__ . '\\sanitizeEmail')) {
-    function sanitizeEmail(string $email): string {
-        return \Bin\SystemMethod::sanitizeEmail($email);
+    if (!function_exists('sanitizeEmail')) {
+        function sanitizeEmail(string $email): string
+        {
+            return \Bin\SystemMethod::sanitizeEmail($email);
+        }
     }
-}
 
-if (!function_exists(__NAMESPACE__ . '\\sanitizeFloat')) {
-    function sanitizeFloat($value): float {
-        return \Bin\SystemMethod::sanitizeFloat($value);
+    if (!function_exists('sanitizeFloat')) {
+        function sanitizeFloat($value): float
+        {
+            return \Bin\SystemMethod::sanitizeFloat($value);
+        }
     }
-}
 
-if (!function_exists(__NAMESPACE__ . '\\arrayOnly')) {
-    function arrayOnly(array $source, array $keys): array {
-        return \Bin\SystemMethod::arrayOnly($source, $keys);
+    if (!function_exists('arrayOnly')) {
+        function arrayOnly(array $source, array $keys): array
+        {
+            return \Bin\SystemMethod::arrayOnly($source, $keys);
+        }
     }
-}
 
-if (!function_exists(__NAMESPACE__ . '\\dd')) {
-    function dd(...$vars): void {
-        \Bin\SystemMethod::dd(...$vars);
+    if (!function_exists('dd')) {
+        function dd(...$vars): void
+        {
+            \Bin\SystemMethod::dd(...$vars);
+        }
     }
-}
 
-if (!function_exists(__NAMESPACE__ . '\\slugify')) {
-    function slugify(string ...$texts): string {
-        return \Bin\SystemMethod::slugify(...$texts);
+    if (!function_exists('slugify')) {
+        function slugify(string ...$texts): string
+        {
+            return \Bin\SystemMethod::slugify(...$texts);
+        }
     }
-}
 
-if (!function_exists(__NAMESPACE__ . '\\byteId')) {
-    function byteId(): string {
-        return \Bin\SystemMethod::byteId();
+    if (!function_exists('byteId')) {
+        function byteId(): string
+        {
+            return \Bin\SystemMethod::byteId();
+        }
     }
-}
 
-if (!function_exists(__NAMESPACE__ . '\\formatId')) {
-    function formatId(string $value, string $to = 'auto'): string {
-        return \Bin\SystemMethod::formatId($value, $to);
+    if (!function_exists('formatId')) {
+        function formatId(string $value, string $to = 'auto'): string
+        {
+            return \Bin\SystemMethod::formatId($value, $to);
+        }
     }
-}
 
-if (!function_exists(__NAMESPACE__ . '\\makeId')) {
-    function makeId(): string {
-        return \Bin\SystemMethod::makeId();
+    if (!function_exists('makeId')) {
+        function makeId(): string
+        {
+            return \Bin\SystemMethod::makeId();
+        }
     }
-}
 
-if (!function_exists(__NAMESPACE__ . '\\intId')) {
-    function intId(int $length = 8): int {
-        return \Bin\SystemMethod::intId($length);
+    if (!function_exists('intId')) {
+        function intId(int $length = 8): int
+        {
+            return \Bin\SystemMethod::intId($length);
+        }
     }
-}
 
-if (!function_exists(__NAMESPACE__ . '\\bigintId')) {
-    function bigintId(int $length = 15, bool $asString = false) {
-        return \Bin\SystemMethod::bigintId($length, $asString);
+    if (!function_exists('bigintId')) {
+        function bigintId(int $length = 15, bool $asString = false)
+        {
+            return \Bin\SystemMethod::bigintId($length, $asString);
+        }
     }
-}
 
-if (!function_exists(__NAMESPACE__ . '\\stringer')) {
-    function stringer($value): string {
-        return \Bin\SystemMethod::stringer($value);
+    if (!function_exists('stringer')) {
+        function stringer($value): string
+        {
+            return \Bin\SystemMethod::stringer($value);
+        }
     }
-}
 
-if (!function_exists(__NAMESPACE__ . '\\otpInt')) {
-    function otpInt(int $length = 6): int {
-        return \Bin\SystemMethod::otpInt($length);
+    if (!function_exists('otpInt')) {
+        function otpInt(int $length = 6): int
+        {
+            return \Bin\SystemMethod::otpInt($length);
+        }
     }
-}
 
-if (!function_exists(__NAMESPACE__ . '\\otpStr')) {
-    function otpStr(int $length = 6, string $case = 'C'): string {
-        return \Bin\SystemMethod::otpStr($length, $case);
+    if (!function_exists('otpStr')) {
+        function otpStr(int $length = 6, string $case = 'C'): string
+        {
+            return \Bin\SystemMethod::otpStr($length, $case);
+        }
     }
-}
 
-if (!function_exists(__NAMESPACE__ . '\\otpMix')) {
-    function otpMix(int $length = 6, string $case = 'C'): string {
-        return \Bin\SystemMethod::otpMix($length, $case);
+    if (!function_exists('otpMix')) {
+        function otpMix(int $length = 6, string $case = 'C'): string
+        {
+            return \Bin\SystemMethod::otpMix($length, $case);
+        }
     }
 }