@artilingo/artiframe-cli 1.0.9 → 1.1.1

package/README.md

@@ -1,11 +1,13 @@
 <div align="center">
 
-<img src="https://raw.githubusercontent.com/artilingo/artiframe/main/assets/logo.png" alt="ArtiFrame Logo" width="180" />
+<img src="https://raw.githubusercontent.com/utkuthecoder/artiframe-cli/refs/heads/main/assets/banner.jpg" alt="ArtiFrame - Open Sourced PHP Framework" width="100%" />
 
-# ArtiFrame
+<br />
 
 **Zero-dependency · Native PHP · Multilingual CLI**
 
+<br />
+
 [![npm version](https://img.shields.io/npm/v/@artilingo/artiframe-cli?color=00c88c&style=flat-square)](https://www.npmjs.com/package/@artilingo/artiframe-cli)
 [![npm downloads](https://img.shields.io/npm/dm/@artilingo/artiframe-cli?color=58a6ff&style=flat-square)](https://www.npmjs.com/package/@artilingo/artiframe-cli)
 [![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL--3.0-bc8cff?style=flat-square)](https://www.gnu.org/licenses/agpl-3.0)
@@ -230,7 +232,7 @@ artiframe> version upgrade minor
 
 <div align="center">
 
-**[artiframe.org](https://artiframe.org)** · **[npmjs.com/package/@artilingo/artiframe-cli](https://www.npmjs.com/package/@artilingo/artiframe-cli)** · **[GitHub](https://github.com/artilingo/artiframe)**
+**[artiframe.artilingo.com](https://artiframe.artilingo.com)** · **[npmjs.com/package/@artilingo/artiframe-cli](https://www.npmjs.com/package/@artilingo/artiframe-cli)** · **[GitHub](https://github.com/utkuthecoder/artiframe-cli)**
 
 © Artilingo — Licensed under [AGPLv3](https://www.gnu.org/licenses/agpl-3.0)
 

package/bin/artiframe.js

@@ -220,8 +220,9 @@ async function handleVersion() {
 
 // ── PHP availability check ──────────────────────────────────────
 function findPhp() {
-    for (const bin of ['php', 'php8', 'php81', 'php82', 'php83', 'php84']) {
-        const r = spawnSync(bin, ['--version'], { encoding: 'utf8', shell: true });
+    const bins = ['php', 'php8', 'php8.1', 'php8.2', 'php8.3', 'php8.4', 'php81', 'php82', 'php83', 'php84'];
+    for (const bin of bins) {
+        const r = spawnSync(bin, ['--version'], { encoding: 'utf8', shell: false });
         if (r.status === 0) return bin;
     }
     return null;

package/bin/artiframe.php

@@ -6,7 +6,7 @@
  * @package     ArtiFrame
  * @author      Artilingo
  * @license     AGPLv3 (Attribution-ShareAlike Required)
- * @link        https://artiframe.org
+ * @link        https://artiframe.artilingo.com
  */
 
 // Define constants

package/core-stubs/app/Database.php

@@ -5,7 +5,7 @@
  * @package     ArtiFrame
  * @author      Artilingo
  * @license     AGPLv3 (Attribution-ShareAlike Required)
- * @link        https://artiframe.org
+ * @link        https://artiframe.artilingo.com
  *
  * NOTICE: This file is part of the ArtiFrame ecosystem.
  * Any derivative works or patches MUST retain this original copyright notice

package/core-stubs/app/DotEnv.php

@@ -5,7 +5,7 @@
  * @package     ArtiFrame
  * @author      Artilingo
  * @license     AGPLv3 (Attribution-ShareAlike Required)
- * @link        https://artiframe.org
+ * @link        https://artiframe.artilingo.com
  *
  * NOTICE: This file is part of the ArtiFrame ecosystem.
  * Any derivative works or patches MUST retain this original copyright notice

package/core-stubs/app/R2Manager.php

@@ -5,7 +5,7 @@
  * @package     ArtiFrame
  * @author      Artilingo
  * @license     AGPLv3 (Attribution-ShareAlike Required)
- * @link        https://artiframe.org
+ * @link        https://artiframe.artilingo.com
  *
  * NOTICE: This file is part of the ArtiFrame ecosystem.
  * Any derivative works or patches MUST retain this original copyright notice

package/core-stubs/bin/SystemMethod.php

@@ -5,7 +5,7 @@
  * @package     ArtiFrame
  * @author      Artilingo
  * @license     AGPLv3 (Attribution-ShareAlike Required)
- * @link        https://artiframe.org
+ * @link        https://artiframe.artilingo.com
  *
  * NOTICE: This file is part of the ArtiFrame ecosystem.
  * Any derivative works or patches MUST retain this original copyright notice
@@ -111,6 +111,29 @@ class SystemMethod
         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() . ')';
+        }
+
+        $response = [
+            'status'  => $status,
+            'message' => $message,
+            'data'    => $data
+        ];
+
+        $statusCode = ($status === 'success') ? 200 : 400;
+        self::jsonResponse($response, $statusCode);
+    }
+
     /**
      * Sayfaya gelen isteğin GET olup olmadığını kontrol eder.
      */
@@ -170,6 +193,31 @@ class SystemMethod
         return bin2hex(random_bytes($length));
     }
 
+    /**
+     * Ş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);
+    }
+
+    /**
+     * 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);
+    }
+
+
     /**
      * E-posta adresini zararlı karakterlerden temizler.
      */
@@ -177,95 +225,323 @@ class SystemMethod
     {
         return filter_var($email, FILTER_SANITIZE_EMAIL);
     }
+
+    /**
+     * 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);
+    }
+
+    /**
+     * 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));
+    }
+
+    /**
+     * 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;
+    }
+
+    /**
+     * 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, '-');
+    }
+
+    /**
+     * 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;
+    }
+
+    /**
+     * Converts a raw 16-byte binary UUID into its standard string representation.
+     * (e.g. 0190ed84-3f12-7a91-8bc4-91823741abcd)
+     *
+     * @param string $binaryUuid 16-byte binary string
+     * @return string 36-character hyphenated UUID string
+     */
+    public static function formatId(string $binaryUuid): string
+    {
+        if (strlen($binaryUuid) !== 16) {
+            throw new \InvalidArgumentException("Invalid binary UUID length. Expected 16 bytes.");
+        }
+        
+        $hex = bin2hex($binaryUuid);
+        
+        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)
+        );
+    }
+
+    /**
+     * Generates a standard formatted UUIDv7 string.
+     *
+     * @return string 36-character hyphenated UUID string
+     */
+    public static function makeId(): string
+    {
+        return self::formatId(self::byteId());
+    }
+
+    /**
+     * 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;
+
+        $min = str_pad('1', $length, '0');
+        $max = str_pad('9', $length, '9');
+
+        $result = random_int((int)$min, (int)$max);
+
+        return $asString ? (string) $result : $result;
+    }
+
+    /**
+     * 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;
+    }
 }
 
 // Global helper functions for backend methods
-if (!function_exists('verifyEmail')) {
+if (!function_exists(__NAMESPACE__ . '\\verifyEmail')) {
     function verifyEmail(string $email): bool {
         return \Bin\SystemMethod::verifyEmail($email);
     }
 }
 
-if (!function_exists('sanitizeInt')) {
+if (!function_exists(__NAMESPACE__ . '\\sanitizeInt')) {
     function sanitizeInt($value): int {
         return \Bin\SystemMethod::sanitizeInt($value);
     }
 }
 
-if (!function_exists('sanitizeString')) {
+if (!function_exists(__NAMESPACE__ . '\\sanitizeString')) {
     function sanitizeString(string $value): string {
         return \Bin\SystemMethod::sanitizeString($value);
     }
 }
 
-if (!function_exists('isPost')) {
+if (!function_exists(__NAMESPACE__ . '\\isPost')) {
     function isPost(): bool {
         return \Bin\SystemMethod::isPost();
     }
 }
 
-if (!function_exists('jsonResponse')) {
+if (!function_exists(__NAMESPACE__ . '\\jsonResponse')) {
     function jsonResponse(array $data, int $statusCode = 200): void {
         \Bin\SystemMethod::jsonResponse($data, $statusCode);
     }
 }
 
-if (!function_exists('generateCsrf')) {
+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(__NAMESPACE__ . '\\generateCsrf')) {
     function generateCsrf(): string {
         return \Bin\SystemMethod::generateCsrf();
     }
 }
 
-if (!function_exists('verifyCsrf')) {
+if (!function_exists(__NAMESPACE__ . '\\verifyCsrf')) {
     function verifyCsrf(?string $token): bool {
         return \Bin\SystemMethod::verifyCsrf($token);
     }
 }
 
-if (!function_exists('isAjax')) {
+if (!function_exists(__NAMESPACE__ . '\\isAjax')) {
     function isAjax(): bool {
         return \Bin\SystemMethod::isAjax();
     }
 }
 
-if (!function_exists('isGet')) {
+if (!function_exists(__NAMESPACE__ . '\\isGet')) {
     function isGet(): bool {
         return \Bin\SystemMethod::isGet();
     }
 }
 
-if (!function_exists('isPut')) {
+if (!function_exists(__NAMESPACE__ . '\\isPut')) {
     function isPut(): bool {
         return \Bin\SystemMethod::isPut();
     }
 }
 
-if (!function_exists('isDelete')) {
+if (!function_exists(__NAMESPACE__ . '\\isDelete')) {
     function isDelete(): bool {
         return \Bin\SystemMethod::isDelete();
     }
 }
 
-if (!function_exists('getClientIp')) {
+if (!function_exists(__NAMESPACE__ . '\\getClientIp')) {
     function getClientIp(): string {
         return \Bin\SystemMethod::getClientIp();
     }
 }
 
-if (!function_exists('redirect')) {
+if (!function_exists(__NAMESPACE__ . '\\redirect')) {
     function redirect(string $url): void {
         \Bin\SystemMethod::redirect($url);
     }
 }
 
-if (!function_exists('generateToken')) {
+if (!function_exists(__NAMESPACE__ . '\\generateToken')) {
     function generateToken(int $length = 32): string {
         return \Bin\SystemMethod::generateToken($length);
     }
 }
 
-if (!function_exists('sanitizeEmail')) {
+if (!function_exists(__NAMESPACE__ . '\\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(__NAMESPACE__ . '\\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(__NAMESPACE__ . '\\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(__NAMESPACE__ . '\\formatId')) {
+    function formatId(string $binaryUuid): string {
+        return \Bin\SystemMethod::formatId($binaryUuid);
+    }
+}
+
+if (!function_exists(__NAMESPACE__ . '\\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(__NAMESPACE__ . '\\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);
+    }
+}