@artilingo/artiframe-cli 2.0.4 → 2.0.5

package/core-stubs/bin/SQLMethod.php

@@ -0,0 +1,261 @@
+<?php
+/**
+ * ArtiFrame Database Mini-ORM & SQL Helpers
+ *
+ * @package     ArtiFrame
+ * @author      Artilingo
+ * @license     AGPLv3
+ */
+
+namespace Bin {
+
+class SQLMethod
+{
+    /**
+     * Güvenli ve hızlı bir PDO Prepare & Execute sarmalayıcısı.
+     */
+    public static function executeStmt(string $sql, array $params = []): \PDOStatement
+    {
+        // App\Database PSR-4 ile otomatik yüklenir. Sadece kullanıldığı yerde devreye girer.
+        $db = \App\Database::getInstance();
+        \App\Database::ping(); 
+        
+        $stmt = $db->prepare($sql);
+        $stmt->execute($params);
+        
+        return $stmt;
+    }
+
+    public static function dbInsert(string $table, array $data): string
+    {
+        if (empty($data)) {
+            throw new \InvalidArgumentException("Eklenecek veri (data) boş olamaz.");
+        }
+
+        // Tablo adını güvenlik için ters tırnak (backtick) ile saralım
+        $table = "`" . preg_replace('/[^a-zA-Z0-9_]/', '', $table) . "`";
+
+        $columns = [];
+        $placeholders = [];
+        $params = [];
+
+        foreach ($data as $key => $value) {
+            $columns[] = "`" . preg_replace('/[^a-zA-Z0-9_]/', '', $key) . "`";
+            $placeholders[] = "?";
+            $params[] = $value;
+        }
+
+        $sql = "INSERT INTO {$table} (" . implode(', ', $columns) . ") VALUES (" . implode(', ', $placeholders) . ")";
+        self::executeStmt($sql, $params);
+        
+        return \App\Database::getInstance()->lastInsertId();
+    }
+
+    public static function dbUpdate(string $table, array $data, array $where): int
+    {
+        if (empty($data)) {
+            throw new \InvalidArgumentException("Güncellenecek veri (data) boş olamaz.");
+        }
+        if (empty($where)) {
+            throw new \InvalidArgumentException("BOMBA RİSKİ: Neye göre güncelleneceği (where) boş olamaz! Tüm tabloyu güncelleyemezsiniz.");
+        }
+
+        $table = "`" . preg_replace('/[^a-zA-Z0-9_]/', '', $table) . "`";
+
+        $setParts = [];
+        $params = [];
+        foreach ($data as $key => $value) {
+            $setParts[] = "`" . preg_replace('/[^a-zA-Z0-9_]/', '', $key) . "` = ?";
+            $params[] = $value;
+        }
+
+        [$whereParts, $whereParams] = self::parseWhere($where);
+        $params = array_merge($params, $whereParams);
+
+        $sql = "UPDATE {$table} SET " . implode(', ', $setParts) . " WHERE " . implode(' AND ', $whereParts);
+        $stmt = self::executeStmt($sql, $params);
+        
+        return $stmt->rowCount();
+    }
+
+    public static function dbDelete(string $table, array $where): int
+    {
+        if (empty($where)) {
+            throw new \InvalidArgumentException("BOMBA RİSKİ: Neye göre silineceği (where) boş olamaz! Tüm tabloyu silemezsiniz.");
+        }
+
+        $table = "`" . preg_replace('/[^a-zA-Z0-9_]/', '', $table) . "`";
+
+        [$whereParts, $params] = self::parseWhere($where);
+
+        $sql = "DELETE FROM {$table} WHERE " . implode(' AND ', $whereParts);
+        $stmt = self::executeStmt($sql, $params);
+        
+        return $stmt->rowCount();
+    }
+
+    
+    /**
+     * WHERE dizisini güvenli SQL ve Parametrelere çevirir.
+     */
+    private static function parseWhere(array $where): array
+    {
+        $whereParts = [];
+        $params = [];
+        
+        foreach ($where as $key => $value) {
+            $key = trim($key);
+            // İçinde operatör varsa (Örn: "yas >" veya "isim LIKE")
+            if (preg_match('/^([a-zA-Z0-9_\.]+)\s*(>=|<=|!=|<>|>|<|LIKE|NOT LIKE)$/i', $key, $matches)) {
+                $column = $matches[1];
+                $operator = strtoupper($matches[2]);
+            } else {
+                $column = preg_replace('/[^a-zA-Z0-9_\.]/', '', $key);
+                $operator = '=';
+            }
+            
+            // Tabloadi.Sutun formatını güvenli backtick içine al: `tabloadi`.`sutun`
+            $colParts = explode('.', $column);
+            $safeCol = implode('.', array_map(fn($p) => "`$p`", $colParts));
+            
+            $whereParts[] = "{$safeCol} {$operator} ?";
+            $params[] = $value;
+        }
+        
+        return [$whereParts, $params];
+    }
+
+    public static function dbGet(string $table, array $where = [], string $orderBy = ''): mixed
+    {
+        $table = "`" . preg_replace('/[^a-zA-Z0-9_]/', '', $table) . "`";
+        
+        $sql = "SELECT * FROM {$table}";
+        $params = [];
+        
+        if (!empty($where)) {
+            [$whereParts, $params] = self::parseWhere($where);
+            $sql .= " WHERE " . implode(' AND ', $whereParts);
+        }
+        
+        if (!empty($orderBy)) {
+            // Sadece a-z, boşluk ve virgüle izin ver (Injection koruması)
+            $orderBy = preg_replace('/[^a-zA-Z0-9_ \.,]/', '', $orderBy);
+            $sql .= " ORDER BY {$orderBy}";
+        }
+        
+        $sql .= " LIMIT 1";
+        
+        return self::executeStmt($sql, $params)->fetch(\PDO::FETCH_ASSOC);
+    }
+
+    public static function dbList(string $table, array $where = [], string $orderBy = '', string|int $limit = ''): array
+    {
+        $table = "`" . preg_replace('/[^a-zA-Z0-9_]/', '', $table) . "`";
+        
+        $sql = "SELECT * FROM {$table}";
+        $params = [];
+        
+        if (!empty($where)) {
+            [$whereParts, $params] = self::parseWhere($where);
+            $sql .= " WHERE " . implode(' AND ', $whereParts);
+        }
+        
+        if (!empty($orderBy)) {
+            $orderBy = preg_replace('/[^a-zA-Z0-9_ \.,]/', '', $orderBy);
+            $sql .= " ORDER BY {$orderBy}";
+        }
+        
+        if (!empty($limit)) {
+            // Sadece rakam ve virgüle izin ver (Örn: "0, 20" veya "20")
+            $limit = preg_replace('/[^0-9, ]/', '', (string)$limit);
+            $sql .= " LIMIT {$limit}";
+        }
+        
+        return self::executeStmt($sql, $params)->fetchAll(\PDO::FETCH_ASSOC);
+    }
+
+    public static function dbCount(string $table, array $where = []): int
+    {
+        $table = "`" . preg_replace('/[^a-zA-Z0-9_]/', '', $table) . "`";
+        
+        $sql = "SELECT COUNT(*) FROM {$table}";
+        $params = [];
+        
+        if (!empty($where)) {
+            [$whereParts, $params] = self::parseWhere($where);
+            $sql .= " WHERE " . implode(' AND ', $whereParts);
+        }
+        
+        return (int) self::executeStmt($sql, $params)->fetchColumn(0);
+    }
+
+    public static function dbRow(string $sql, array $params = [], int $fetchStyle = \PDO::FETCH_ASSOC): mixed
+    {
+        return self::executeStmt($sql, $params)->fetch($fetchStyle);
+    }
+
+    public static function dbRows(string $sql, array $params = [], int $fetchStyle = \PDO::FETCH_ASSOC): array
+    {
+        return self::executeStmt($sql, $params)->fetchAll($fetchStyle);
+    }
+
+    public static function dbValue(string $sql, array $params = [], int $column = 0): mixed
+    {
+        return self::executeStmt($sql, $params)->fetchColumn($column);
+    }
+}
+}
+
+
+namespace {
+    if (!function_exists('dbExecute')) {
+        function dbExecute(string $sql, array $params = []): \PDOStatement {
+            return \Bin\SQLMethod::executeStmt($sql, $params);
+        }
+    }
+    if (!function_exists('dbInsert')) {
+        function dbInsert(string $table, array $data): string {
+            return \Bin\SQLMethod::dbInsert($table, $data);
+        }
+    }
+    if (!function_exists('dbUpdate')) {
+        function dbUpdate(string $table, array $data, array $where): int {
+            return \Bin\SQLMethod::dbUpdate($table, $data, $where);
+        }
+    }
+    if (!function_exists('dbDelete')) {
+        function dbDelete(string $table, array $where): int {
+            return \Bin\SQLMethod::dbDelete($table, $where);
+        }
+    }
+        if (!function_exists('dbGet')) {
+        function dbGet(string $table, array $where = [], string $orderBy = ''): mixed {
+            return \Bin\SQLMethod::dbGet($table, $where, $orderBy);
+        }
+    }
+    if (!function_exists('dbList')) {
+        function dbList(string $table, array $where = [], string $orderBy = '', string|int $limit = ''): array {
+            return \Bin\SQLMethod::dbList($table, $where, $orderBy, $limit);
+        }
+    }
+    if (!function_exists('dbCount')) {
+        function dbCount(string $table, array $where = []): int {
+            return \Bin\SQLMethod::dbCount($table, $where);
+        }
+    }
+    if (!function_exists('dbRow')) {
+        function dbRow(string $sql, array $params = [], int $fetchStyle = \PDO::FETCH_ASSOC): mixed {
+            return \Bin\SQLMethod::dbRow($sql, $params, $fetchStyle);
+        }
+    }
+    if (!function_exists('dbRows')) {
+        function dbRows(string $sql, array $params = [], int $fetchStyle = \PDO::FETCH_ASSOC): array {
+            return \Bin\SQLMethod::dbRows($sql, $params, $fetchStyle);
+        }
+    }
+    if (!function_exists('dbValue')) {
+        function dbValue(string $sql, array $params = [], int $column = 0): mixed {
+            return \Bin\SQLMethod::dbValue($sql, $params, $column);
+        }
+    }
+}

package/core-stubs/bin/SystemMethod.php

@@ -47,7 +47,7 @@ namespace Bin {
          * @param string $value
          * @return string
          */
-        public static function sanitizeString(string $value): string
+        public static function stripHtml(string $value): string
         {
             return strip_tags(trim($value));
         }
@@ -98,6 +98,65 @@ namespace Bin {
             return !empty($_SERVER['HTTP_X_REQUESTED_WITH']) && strtolower($_SERVER['HTTP_X_REQUESTED_WITH']) === 'xmlhttprequest';
         }
 
+        /**
+         * Beni Hatırla: Güvenli Cookie Oluşturur (14 Gün)
+         */
+        public static function setRememberMeCookie(string $kullaniciIdHex): void
+        {
+            $expires = time() + (14 * 24 * 60 * 60); // 14 gün
+            $secret = $_ENV['DB_PASSWORD'] ?? 'SinavOrtagim2026';
+            $data = $kullaniciIdHex . '|' . $expires;
+            $hash = hash_hmac('sha256', $data, $secret);
+            $cookieValue = base64_encode($data . '|' . $hash);
+            
+            // HTTPOnly, Secure
+            setcookie('remember_me', $cookieValue, $expires, '/', '', true, true);
+        }
+
+        /**
+         * Beni Hatırla: Cookie'yi doğrular ve kullaniciId (hex) döner
+         */
+        public static function validateRememberMeCookie(): ?string
+        {
+            if (empty($_COOKIE['remember_me'])) {
+                return null;
+            }
+            
+            $cookieValue = base64_decode($_COOKIE['remember_me']);
+            if (!$cookieValue) return null;
+
+            $parts = explode('|', $cookieValue);
+            if (count($parts) !== 3) {
+                return null;
+            }
+            
+            [$kullaniciIdHex, $expires, $hash] = $parts;
+            
+            if (time() > (int)$expires) {
+                self::clearRememberMeCookie();
+                return null;
+            }
+            
+            $secret = $_ENV['DB_PASSWORD'] ?? 'SinavOrtagim2026';
+            $data = $kullaniciIdHex . '|' . $expires;
+            $expectedHash = hash_hmac('sha256', $data, $secret);
+            
+            if (!hash_equals($expectedHash, $hash)) {
+                return null; // Kurcalanmış
+            }
+            
+            return $kullaniciIdHex;
+        }
+
+        /**
+         * Beni Hatırla: Cookie'yi siler (Çıkış yaparken kullanılır)
+         */
+        public static function clearRememberMeCookie(): void
+        {
+            setcookie('remember_me', '', time() - 3600, '/', '', true, true);
+        }
+
+
         /**
          * API'ler için hızlı ve standart JSON yanıt (response) oluşturur.
          * Kullanıldığı anda işlemi sonlandırır (exit).
@@ -336,7 +395,7 @@ namespace Bin {
          *
          * @return string 16-byte raw binary string
          */
-        public static function byteId(): string
+        public static function generateBinaryId(): string
         {
             // Get current timestamp in milliseconds (48-bit)
             $ts = (int)(microtime(true) * 1000);
@@ -398,9 +457,9 @@ namespace Bin {
          *
          * @return string 36-character hyphenated UUID string
          */
-        public static function makeId(): string
+        public static function generateStringId(): string
         {
-            return self::formatId(self::byteId());
+            return self::formatId(self::generateBinaryId());
         }
 
         /**
@@ -435,61 +494,54 @@ namespace Bin {
             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
+        
 
-            $min = (int) str_pad('1', $length, '0');
-            $max = (int) str_pad('9', $length, '9');
+        
 
-            return random_int($min, $max);
-        }
+        
+
+        
 
         /**
-         * 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
+         * Hexadecimal string'i binary formata çevirir. Zaten binary ise dokunmaz.
+         * ID dönüşümlerinde kod tekrarını (DRY) engellemek için kullanılır.
          */
-        public static function otpStr(int $length = 6, string $case = 'C'): string
+        public static function convertToBinaryId(?string $id): ?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)];
+            if (empty($id)) return $id;
+            if (strlen($id) === 32 && ctype_xdigit($id)) {
+                return hex2bin($id);
             }
-
-            return $otp;
+            return $id;
         }
-
         /**
-         * Harf ve sayılardan (Alphanumeric) oluşan rastgele bir OTP kodu üretir.
+         * Güvenli ve rastgele bir OTP (One Time Password) 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ı
+         * @param string $type 'numeric', 'alpha' veya 'alphanumeric'
+         * @param string $case 'lower', 'upper' veya 'mixed' (Sadece harf içeren durumlarda geçerli)
          */
-        public static function otpMix(int $length = 6, string $case = 'C'): string
+        public static function generateOTP(int $length = 6, string $type = 'numeric', string $case = 'upper'): string
         {
             $numbers = '0123456789';
             $lower   = 'abcdefghijklmnopqrstuvwxyz';
             $upper   = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
 
-            $chars = match (strtolower($case)) {
-                'c'  => $numbers . $lower,
-                'cc' => $numbers . $lower . $upper,
-                default => $numbers . $upper,
+            $chars = match ($type) {
+                'numeric' => $numbers,
+                'alpha' => match ($case) {
+                    'lower' => $lower,
+                    'upper' => $upper,
+                    'mixed' => $lower . $upper,
+                    default => $upper
+                },
+                'alphanumeric' => match ($case) {
+                    'lower' => $numbers . $lower,
+                    'upper' => $numbers . $upper,
+                    'mixed' => $numbers . $lower . $upper,
+                    default => $numbers . $upper
+                },
+                default => $numbers
             };
 
             $otp = '';
@@ -500,16 +552,6 @@ namespace Bin {
 
             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
@@ -532,9 +574,9 @@ namespace {
     }
 
     if (!function_exists('sanitizeString')) {
-        function sanitizeString(string $value): string
+        function stripHtml(string $value): string
         {
-            return \Bin\SystemMethod::sanitizeString($value);
+            return \Bin\SystemMethod::stripHtml($value);
         }
     }
 
@@ -658,9 +700,9 @@ namespace {
     }
 
     if (!function_exists('byteId')) {
-        function byteId(): string
+        function generateBinaryId(): string
         {
-            return \Bin\SystemMethod::byteId();
+            return \Bin\SystemMethod::generateBinaryId();
         }
     }
 
@@ -672,9 +714,9 @@ namespace {
     }
 
     if (!function_exists('makeId')) {
-        function makeId(): string
+        function generateStringId(): string
         {
-            return \Bin\SystemMethod::makeId();
+            return \Bin\SystemMethod::generateStringId();
         }
     }
 
@@ -692,31 +734,30 @@ namespace {
         }
     }
 
-    if (!function_exists('stringer')) {
-        function stringer($value): string
-        {
-            return \Bin\SystemMethod::stringer($value);
-        }
-    }
+    
+
+    
+
+    
 
-    if (!function_exists('otpInt')) {
-        function otpInt(int $length = 6): int
+        if (!function_exists('generateOTP')) {
+        function generateOTP(int $length = 6, string $type = 'numeric', string $case = 'upper'): string
         {
-            return \Bin\SystemMethod::otpInt($length);
+            return \Bin\SystemMethod::generateOTP($length, $type, $case);
         }
     }
 
-    if (!function_exists('otpStr')) {
-        function otpStr(int $length = 6, string $case = 'C'): string
+    if (!function_exists('toBin')) {
+        function convertToBinaryId(?string $id): ?string
         {
-            return \Bin\SystemMethod::otpStr($length, $case);
+            return \Bin\SystemMethod::convertToBinaryId($id);
         }
     }
 
-    if (!function_exists('otpMix')) {
-        function otpMix(int $length = 6, string $case = 'C'): string
+    if (!function_exists('generateOTP')) {
+        function generateOTP(int $length = 6, string $type = 'numeric', string $case = 'upper'): string
         {
-            return \Bin\SystemMethod::otpMix($length, $case);
+            return \Bin\SystemMethod::generateOTP($length, $type, $case);
         }
     }
 }

package/core-stubs/bin/ViewMethod.php

@@ -35,6 +35,16 @@ namespace Bin {
             return htmlspecialchars((string)$data, ENT_QUOTES | ENT_HTML5, 'UTF-8');
         }
 
+        /**
+         * Metin içindeki @kullaniciadi formatındaki etiketleri linklere dönüştürür.
+         * XSS koruması için metnin önce display() fonksiyonundan geçmiş olması önerilir.
+         */
+                public static function parseMentions(string $text): string
+        {
+            $text = self::display($text);
+            return preg_replace('/@([A-Za-z0-9_]{3,30})/', '<a href="/user/profil/" class="cm-mention-link">@</a>', $text);
+        }
+
         /**
          * URL'leri güvenli hale getirir, zararlı karakterleri temizler.
          */
@@ -156,7 +166,9 @@ namespace Bin {
             if (empty($date)) return '-';
             $time = is_numeric($date) ? $date : strtotime($date);
             $diff = time() - $time;
+            
             if ($diff < 1) return self::display(($lang === 'tr') ? 'şimdi' : 'just now');
+            if ($diff >= 604800) return self::display(date('d.m.Y', $time));
 
             $tokens = [
                 31536000 => 'year',
@@ -420,12 +432,7 @@ namespace Bin {
         public static function routeLink(?string $requestUri = null): void
         {
 
-            if (!defined('APP_MAINTENANCE')) {
-                $rawVal = $_ENV['APP_MAINTENANCE'] ?? false;
 
-                // filter_var("true", FILTER_VALIDATE_BOOLEAN) -> bool(true) üretir
-                define('APP_MAINTENANCE', filter_var($rawVal, FILTER_VALIDATE_BOOLEAN));
-            }
 
             // ------------------------------------------------------------------
             // 1. BAKIM MODU (MAINTENANCE GUARD)
@@ -640,6 +647,13 @@ namespace {
         }
     }
 
+    if (!function_exists('parseMentions')) {
+        function parseMentions(string $text): string
+        {
+            return \Bin\ViewMethod::parseMentions($text);
+        }
+    }
+
     if (!function_exists('formatSize')) {
         function formatSize(int $bytes): string
         {