@artilingo/artiframe-cli 1.0.0

package/core-stubs/bin/SystemMethod.php

@@ -0,0 +1,271 @@
+<?php
+/**
+ * ArtiFrame Core Engine
+ *
+ * @package     ArtiFrame
+ * @author      Artilingo
+ * @license     AGPLv3 (Attribution-ShareAlike Required)
+ * @link        https://artiframe.org
+ *
+ * NOTICE: This file is part of the ArtiFrame ecosystem.
+ * Any derivative works or patches MUST retain this original copyright notice
+ * 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;
+    }
+
+    /**
+     * 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);
+    }
+
+    /**
+     * 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));
+    }
+
+    /**
+     * 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';
+    }
+
+    /**
+     * 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'];
+    }
+
+    /**
+     * 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);
+    }
+
+    /**
+     * İ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;
+    }
+    /**
+     * Sayfaya gelen isteğin GET olup olmadığını kontrol eder.
+     */
+    public static function isGet(): bool
+    {
+        return $_SERVER['REQUEST_METHOD'] === 'GET';
+    }
+
+    /**
+     * Sayfaya gelen isteğin PUT olup olmadığını kontrol eder.
+     */
+    public static function isPut(): bool
+    {
+        return $_SERVER['REQUEST_METHOD'] === 'PUT';
+    }
+
+    /**
+     * Sayfaya gelen isteğin DELETE olup olmadığını kontrol eder.
+     */
+    public static function isDelete(): bool
+    {
+        return $_SERVER['REQUEST_METHOD'] === 'DELETE';
+    }
+
+    /**
+     * 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';
+    }
+
+    /**
+     * İ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);
+    }
+}
+
+// Global helper functions for backend methods
+if (!function_exists('verifyEmail')) {
+    function verifyEmail(string $email): bool {
+        return \Bin\SystemMethod::verifyEmail($email);
+    }
+}
+
+if (!function_exists('sanitizeInt')) {
+    function sanitizeInt($value): int {
+        return \Bin\SystemMethod::sanitizeInt($value);
+    }
+}
+
+if (!function_exists('sanitizeString')) {
+    function sanitizeString(string $value): string {
+        return \Bin\SystemMethod::sanitizeString($value);
+    }
+}
+
+if (!function_exists('isPost')) {
+    function isPost(): bool {
+        return \Bin\SystemMethod::isPost();
+    }
+}
+
+if (!function_exists('jsonResponse')) {
+    function jsonResponse(array $data, int $statusCode = 200): void {
+        \Bin\SystemMethod::jsonResponse($data, $statusCode);
+    }
+}
+
+if (!function_exists('generateCsrf')) {
+    function generateCsrf(): string {
+        return \Bin\SystemMethod::generateCsrf();
+    }
+}
+
+if (!function_exists('verifyCsrf')) {
+    function verifyCsrf(?string $token): bool {
+        return \Bin\SystemMethod::verifyCsrf($token);
+    }
+}
+
+if (!function_exists('isAjax')) {
+    function isAjax(): bool {
+        return \Bin\SystemMethod::isAjax();
+    }
+}
+
+if (!function_exists('isGet')) {
+    function isGet(): bool {
+        return \Bin\SystemMethod::isGet();
+    }
+}
+
+if (!function_exists('isPut')) {
+    function isPut(): bool {
+        return \Bin\SystemMethod::isPut();
+    }
+}
+
+if (!function_exists('isDelete')) {
+    function isDelete(): bool {
+        return \Bin\SystemMethod::isDelete();
+    }
+}
+
+if (!function_exists('getClientIp')) {
+    function getClientIp(): string {
+        return \Bin\SystemMethod::getClientIp();
+    }
+}
+
+if (!function_exists('redirect')) {
+    function redirect(string $url): void {
+        \Bin\SystemMethod::redirect($url);
+    }
+}
+
+if (!function_exists('generateToken')) {
+    function generateToken(int $length = 32): string {
+        return \Bin\SystemMethod::generateToken($length);
+    }
+}
+
+if (!function_exists('sanitizeEmail')) {
+    function sanitizeEmail(string $email): string {
+        return \Bin\SystemMethod::sanitizeEmail($email);
+    }
+}

package/core-stubs/bin/ViewMethod.php

@@ -0,0 +1,354 @@
+<?php
+/**
+ * ArtiFrame Core Engine
+ *
+ * @package     ArtiFrame
+ * @author      Artilingo
+ * @license     AGPLv3 (Attribution-ShareAlike Required)
+ * @link        https://artiframe.org
+ *
+ * NOTICE: This file is part of the ArtiFrame ecosystem.
+ * Any derivative works or patches MUST retain this original copyright notice
+ * and remain open-source under the AGPLv3 license.
+ */
+
+namespace Bin;
+
+class ViewMethod
+{
+    /**
+     * Veriyi ekrana yazdırırken XSS saldırılarına karşı temizler (Sanitize).
+     * Null değerlerde patlamamak için varsayılan değer döndürür.
+     * 
+     * @param mixed $data Ekrana basılacak veri
+     * @param string $default Veri boşsa basılacak varsayılan değer (örn: '-')
+     * @return string Güvenli HTML string
+     */
+    public static function display($data, string $default = ''): string
+    {
+        if ($data === null || $data === '') {
+            return $default;
+        }
+        return htmlspecialchars((string)$data, ENT_QUOTES | ENT_HTML5, 'UTF-8');
+    }
+
+    /**
+     * URL'leri güvenli hale getirir, zararlı karakterleri temizler.
+     */
+    public static function escapeUrl(string $url): string
+    {
+        return filter_var($url, FILTER_SANITIZE_URL);
+    }
+
+    /**
+     * Tarih formatını (Veritabanındaki Y-m-d H:i:s formatını) kullanıcı dostu ve güvenli bir şekilde ekrana basar.
+     */
+    public static function formatDate(?string $date, string $format = 'd.m.Y H:i'): string
+    {
+        if (empty($date)) return '-';
+        $time = strtotime($date);
+        return $time ? date($format, $time) : '-';
+    }
+
+    /**
+     * Formlar için (XSS ve CSRF korumalı) gizli bir güvenlik token'ı (input) oluşturur.
+     */
+    public static function csrfField(): string
+    {
+        // Require SystemMethod implicitly if it exists in the same namespace context,
+        // or just call the global wrapper if it's available. We'll use the class method for purity.
+        $token = \Bin\SystemMethod::generateCsrf();
+        return '<input type="hidden" name="csrf_token" value="' . self::display($token) . '">';
+    }
+    // --- Tarih ve Zaman Fonksiyonları ---
+
+    /**
+     * Sadece Günü döndürür (Örn: 24)
+     */
+    public static function day($date): string
+    {
+        if (empty($date)) return '-';
+        return date('d', is_numeric($date) ? $date : strtotime($date));
+    }
+
+    /**
+     * Sadece Ayı rakamla döndürür (Örn: 07)
+     */
+    public static function month($date): string
+    {
+        if (empty($date)) return '-';
+        return date('m', is_numeric($date) ? $date : strtotime($date));
+    }
+
+    /**
+     * Yılı döndürür (Örn: 2026)
+     */
+    public static function year($date): string
+    {
+        if (empty($date)) return '-';
+        return date('Y', is_numeric($date) ? $date : strtotime($date));
+    }
+
+    /**
+     * Saati döndürür (Örn: 14:30)
+     */
+    public static function timeOnly($date): string
+    {
+        if (empty($date)) return '-';
+        return date('H:i', is_numeric($date) ? $date : strtotime($date));
+    }
+
+    /**
+     * Tarihi 24.07.2026 formatında döndürür
+     */
+    public static function fulldate($date): string
+    {
+        if (empty($date)) return '-';
+        return date('d.m.Y', is_numeric($date) ? $date : strtotime($date));
+    }
+
+    /**
+     * Ay isimlerini dile göre döndürür
+     */
+    public static function monthName($date, string $lang = 'tr'): string
+    {
+        if (empty($date)) return '-';
+        $m = (int)date('n', is_numeric($date) ? $date : strtotime($date));
+        $months = [
+            'tr' => ['', 'Ocak', 'Şubat', 'Mart', 'Nisan', 'Mayıs', 'Haziran', 'Temmuz', 'Ağustos', 'Eylül', 'Ekim', 'Kasım', 'Aralık'],
+            'en' => ['', 'January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'],
+            'de' => ['', 'Januar', 'Februar', 'März', 'April', 'Mai', 'Juni', 'Juli', 'August', 'September', 'Oktober', 'November', 'Dezember'],
+            'fr' => ['', 'Janvier', 'Février', 'Mars', 'Avril', 'Mai', 'Juin', 'Juillet', 'Août', 'Septembre', 'Octobre', 'Novembre', 'Décembre'],
+            'es' => ['', 'Enero', 'Febrero', 'Marzo', 'Abril', 'Mayo', 'Junio', 'Julio', 'Agosto', 'Septiembre', 'Octubre', 'Noviembre', 'Diciembre']
+        ];
+        $lang = strtolower($lang);
+        if (!isset($months[$lang])) $lang = 'en';
+        return $months[$lang][$m];
+    }
+
+    /**
+     * Tarihi yerelleştirilmiş ay ismiyle döndürür (Örn: 24 Temmuz 2026)
+     */
+    public static function fulldateName($date, string $lang = 'tr'): string
+    {
+        if (empty($date)) return '-';
+        $time = is_numeric($date) ? $date : strtotime($date);
+        $d = date('d', $time);
+        $y = date('Y', $time);
+        $mName = self::monthName($time, $lang);
+        
+        // İngilizce'de ay öne gelebilir (July 24, 2026) ama basitlik açısından formatı koruyabiliriz veya dile göre değiştirebiliriz.
+        if (strtolower($lang) === 'en') {
+            return "{$mName} {$d}, {$y}";
+        }
+        return "{$d} {$mName} {$y}";
+    }
+
+    /**
+     * Sosyal medya tarzı zaman gösterimi (Örn: 5 dakika önce)
+     */
+    public static function timeAgo($date, string $lang = 'tr'): string
+    {
+        if (empty($date)) return '-';
+        $time = is_numeric($date) ? $date : strtotime($date);
+        $diff = time() - $time;
+        if ($diff < 1) return ($lang === 'tr') ? 'şimdi' : 'just now';
+
+        $tokens = [
+            31536000 => 'year',
+            2592000 => 'month',
+            604800 => 'week',
+            86400 => 'day',
+            3600 => 'hour',
+            60 => 'minute',
+            1 => 'second'
+        ];
+
+        $lang = strtolower($lang);
+        $translations = [
+            'tr' => ['year'=>'yıl', 'month'=>'ay', 'week'=>'hafta', 'day'=>'gün', 'hour'=>'saat', 'minute'=>'dakika', 'second'=>'saniye', 'ago'=>'önce', 'format'=>'{value} {unit} {ago}'],
+            'en' => ['year'=>'year', 'month'=>'month', 'week'=>'week', 'day'=>'day', 'hour'=>'hour', 'minute'=>'minute', 'second'=>'second', 'ago'=>'ago', 'format'=>'{value} {unit}s {ago}'],
+            'de' => ['year'=>'Jahr', 'month'=>'Monat', 'week'=>'Woche', 'day'=>'Tag', 'hour'=>'Stunde', 'minute'=>'Minute', 'second'=>'Sekunde', 'ago'=>'vor', 'format'=>'{ago} {value} {unit}en'], // simplified
+            'fr' => ['year'=>'an', 'month'=>'mois', 'week'=>'semaine', 'day'=>'jour', 'hour'=>'heure', 'minute'=>'minute', 'second'=>'seconde', 'ago'=>'il y a', 'format'=>'{ago} {value} {unit}s'],
+            'es' => ['year'=>'año', 'month'=>'mes', 'week'=>'semana', 'day'=>'día', 'hour'=>'hora', 'minute'=>'minuto', 'second'=>'segundo', 'ago'=>'hace', 'format'=>'{ago} {value} {unit}s']
+        ];
+        if (!isset($translations[$lang])) $lang = 'en';
+
+        foreach ($tokens as $unit => $text) {
+            if ($diff < $unit) continue;
+            $numberOfUnits = floor($diff / $unit);
+            
+            // Pluralization logic is basic here, but functional for general use
+            $unitStr = $translations[$lang][$text];
+            if ($lang === 'en' && $numberOfUnits == 1) $translations['en']['format'] = '{value} {unit} {ago}';
+            
+            $formatted = str_replace(
+                ['{value}', '{unit}', '{ago}'], 
+                [$numberOfUnits, $unitStr, $translations[$lang]['ago']], 
+                $translations[$lang]['format']
+            );
+            
+            // Fix DE basic plurals roughly
+            if ($lang === 'de') {
+                $formatted = str_replace(['Jahren', 'Monaten', 'Wocheen', 'Tagen', 'Stundeen', 'Minuteen', 'Sekundeen'], ['Jahren', 'Monaten', 'Wochen', 'Tagen', 'Stunden', 'Minuten', 'Sekunden'], $formatted);
+            }
+            return $formatted;
+        }
+        return '-';
+    }
+
+    // --- Metin (String) İşleme Fonksiyonları ---
+
+    /**
+     * Uzun metinleri keser ve sonuna ... ekler
+     */
+    public static function truncate(string $text, int $length = 100, string $append = '...'): string
+    {
+        $text = strip_tags($text);
+        if (mb_strlen($text, 'UTF-8') <= $length) return $text;
+        
+        $truncated = mb_substr($text, 0, $length, 'UTF-8');
+        // Son kelimeyi bölmemek için son boşluğa kadar al
+        if (strpos($text, ' ') !== false) {
+            $lastSpace = mb_strrpos($truncated, ' ', 0, 'UTF-8');
+            if ($lastSpace !== false) {
+                $truncated = mb_substr($truncated, 0, $lastSpace, 'UTF-8');
+            }
+        }
+        return $truncated . $append;
+    }
+
+    // --- Para Birimi Formatlama ---
+
+    /**
+     * Tutar ve para birimi sembolü formatlama
+     */
+    public static function money(float $amount, string $currency = 'usd'): string
+    {
+        $currencies = [
+            'usd' => '$',   // US Dollar
+            'eur' => '€',   // Euro
+            'try' => '₺',   // Turkish Lira
+            'tl'  => '₺',   // Turkish Lira
+            'gbp' => '£',   // British Pound
+            'jpy' => '¥',   // Japanese Yen
+            'cny' => '¥',   // Chinese Yuan
+            'rub' => '₽',   // Russian Ruble
+            'inr' => '₹',   // Indian Rupee
+            'aud' => 'A$',  // Australian Dollar
+            'cad' => 'C$',  // Canadian Dollar
+            'chf' => 'CHF', // Swiss Franc
+            'krw' => '₩',   // South Korean Won
+            'brl' => 'R$',  // Brazilian Real
+            'zar' => 'R',   // South African Rand
+            'sek' => 'kr',  // Swedish Krona
+            'nok' => 'kr',  // Norwegian Krone
+            'mxn' => '$',   // Mexican Peso
+            'sgd' => 'S$',  // Singapore Dollar
+            'hkd' => 'HK$', // Hong Kong Dollar
+            'nzd' => 'NZ$', // New Zealand Dollar
+            'aed' => 'د.إ', // UAE Dirham
+            'sar' => '﷼',   // Saudi Riyal
+            'pln' => 'zł'   // Polish Zloty
+        ];
+        
+        $currency = strtolower($currency);
+        $symbol = $currencies[$currency] ?? strtoupper($currency) . ' ';
+        
+        // Sayıyı 1.250,50 veya 1,250.50 gibi formatlar. Genel standart olarak 1.250,50 (Avrupa/TR)
+        // İhtiyaca göre number_format değiştirilebilir. (TR formatı baz alındı)
+        $formattedAmount = number_format($amount, 2, ',', '.');
+        
+        // USD ve GBP gibi birimlerde sembol genelde başa gelir, TL veya EUR'da sona.
+        if (in_array($currency, ['usd', 'gbp', 'aud', 'cad', 'sgd', 'hkd', 'nzd', 'mxn', 'brl'])) {
+            return $symbol . $formattedAmount;
+        }
+        
+        return $formattedAmount . ' ' . $symbol;
+    }
+}
+
+// Geliştiriciler (Özellikle Juniorlar) için kullanımı en kolay global yardımcı fonksiyonlar
+if (!function_exists('display')) {
+    function display($data, string $default = ''): string {
+        return \Bin\ViewMethod::display($data, $default);
+    }
+}
+
+if (!function_exists('escapeUrl')) {
+    function escapeUrl(string $url): string {
+        return \Bin\ViewMethod::escapeUrl($url);
+    }
+}
+
+if (!function_exists('formatDate')) {
+    function formatDate(?string $date, string $format = 'd.m.Y H:i'): string {
+        return \Bin\ViewMethod::formatDate($date, $format);
+    }
+}
+
+if (!function_exists('csrfField')) {
+    function csrfField(): string {
+        return \Bin\ViewMethod::csrfField();
+    }
+}
+
+if (!function_exists('day')) {
+    function day($date): string {
+        return \Bin\ViewMethod::day($date);
+    }
+}
+
+if (!function_exists('month')) {
+    function month($date): string {
+        return \Bin\ViewMethod::month($date);
+    }
+}
+
+if (!function_exists('year')) {
+    function year($date): string {
+        return \Bin\ViewMethod::year($date);
+    }
+}
+
+if (!function_exists('timeOnly')) {
+    function timeOnly($date): string {
+        return \Bin\ViewMethod::timeOnly($date);
+    }
+}
+
+if (!function_exists('fulldate')) {
+    function fulldate($date): string {
+        return \Bin\ViewMethod::fulldate($date);
+    }
+}
+
+if (!function_exists('monthName')) {
+    function monthName($date, string $lang = 'tr'): string {
+        return \Bin\ViewMethod::monthName($date, $lang);
+    }
+}
+
+if (!function_exists('fulldateName')) {
+    function fulldateName($date, string $lang = 'tr'): string {
+        return \Bin\ViewMethod::fulldateName($date, $lang);
+    }
+}
+
+if (!function_exists('timeAgo')) {
+    function timeAgo($date, string $lang = 'tr'): string {
+        return \Bin\ViewMethod::timeAgo($date, $lang);
+    }
+}
+
+if (!function_exists('truncate')) {
+    function truncate(string $text, int $length = 100, string $append = '...'): string {
+        return \Bin\ViewMethod::truncate($text, $length, $append);
+    }
+}
+
+if (!function_exists('money')) {
+    function money(float $amount, string $currency = 'usd'): string {
+        return \Bin\ViewMethod::money($amount, $currency);
+    }
+}