@artilingo/artiframe-cli 1.0.0

package/assets/logo.svg

@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg id="katman_2" data-name="katman 2" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 144.49 94.09">
+  <defs>
+    <style>
+      .cls-1 {
+        fill: #099772;
+      }
+
+      .cls-2 {
+        fill: #0a9872;
+      }
+    </style>
+  </defs>
+  <g id="katman_1" data-name="katman 1">
+    <g>
+      <path class="cls-2" d="M131.15,38.06c.67-.18,1.4-.1,2.26.14.32-3.12,2.59-5.34,5.55-5.33s5.5,2.5,5.53,5.43-2.23,5.38-5.12,5.59c-3.09.22-5.71-2.08-5.9-5.29-34.52,2.36-67.93,12.42-97.08,31.26-5.61,3.7-11,7.44-16,11.83l-6.13,12.38-14.26-.02,13.95-27.62,7.14-14.06L47.82.06l21.37,41.64c-3.96,1.03-7.73,2.29-11.62,3.65l-9.74-19.89-2.9,5.99-14.53,29.82c25.42-14.09,52.79-21.29,81.35-23.22l5.69-.27,11.17.03c.86,0,1.58.49,2.52.24Z"/>
+      <polygon class="cls-2" points="64.24 58.84 75.54 54.2 90.45 83.55 112.61 83.52 112.61 44.51 122.99 43.06 122.99 94.08 81.55 94.09 72.23 75.24 64.24 58.84"/>
+      <path class="cls-1" d="M112.61,33.97V10.34s-53.64.02-53.64.02L54.05.7c.04-.06.09-.22.35-.22h68.33s0,33.6,0,33.6l-10.13-.11Z"/>
+      <path class="cls-2" d="M112.61,33.97l10.13.11V.48s-68.34,0-68.34,0c-.26,0-.31.16-.35.22-.3-.09-.39-.7.07-.7h68.84s0,34.31,0,34.31h-7.91c-.8.25-1.56.34-2.36.21-.07-.2-.1-.34-.1-.56Z"/>
+    </g>
+  </g>
+</svg>

package/bin/artiframe.js

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+
+/**
+ * ArtiFrame CLI — Node.js wrapper
+ *
+ * This file is the npm entry point. It checks that PHP is installed
+ * on the system, then delegates execution to the PHP CLI bootstrap.
+ */
+
+const { execFileSync, spawnSync } = require('child_process');
+const path = require('path');
+const fs   = require('fs');
+
+// ── 1. Verify PHP is available ──────────────────────────────────
+function findPhp() {
+    const candidates = ['php', 'php8', 'php81', 'php82', 'php83', 'php84'];
+    for (const bin of candidates) {
+        const result = spawnSync(bin, ['--version'], { encoding: 'utf8', shell: true });
+        if (result.status === 0) return bin;
+    }
+    return null;
+}
+
+const php = findPhp();
+
+if (!php) {
+    console.error('\n\x1b[1;31m[ArtiFrame] PHP Not Found!\x1b[0m');
+    console.error('\x1b[33mArtiFrame CLI requires PHP 8.1 or higher.\x1b[0m\n');
+    console.error('Install PHP:');
+    console.error('  Windows : https://windows.php.net/download/');
+    console.error('  macOS   : brew install php');
+    console.error('  Linux   : sudo apt install php8.2-cli\n');
+    process.exit(1);
+}
+
+// ── 2. Verify PHP version >= 8.1 ───────────────────────────────
+const versionResult = spawnSync(php, ['-r', 'echo PHP_MAJOR_VERSION . "." . PHP_MINOR_VERSION;'], {
+    encoding: 'utf8',
+    shell: true
+});
+
+const [major, minor] = (versionResult.stdout || '0.0').split('.').map(Number);
+if (major < 8 || (major === 8 && minor < 1)) {
+    console.error('\n\x1b[1;31m[ArtiFrame] PHP version too old!\x1b[0m');
+    console.error(`\x1b[33mFound PHP ${major}.${minor} — ArtiFrame requires PHP 8.1+\x1b[0m\n`);
+    process.exit(1);
+}
+
+// ── 3. Delegate to the PHP bootstrap ───────────────────────────
+const phpScript = path.join(__dirname, '..', 'bin', 'artiframe.php');
+
+const result = spawnSync(php, [phpScript, ...process.argv.slice(2)], {
+    stdio: 'inherit',
+    shell: false
+});
+
+process.exit(result.status ?? 1);

package/bin/artiframe.php

@@ -0,0 +1,45 @@
+#!/usr/bin/env php
+<?php
+/**
+ * ArtiFrame CLI
+ * 
+ * @package     ArtiFrame
+ * @author      Artilingo
+ * @license     AGPLv3 (Attribution-ShareAlike Required)
+ * @link        https://artiframe.org
+ */
+
+// Define constants
+define('ARTIFRAME_CLI_ROOT', dirname(__DIR__));
+define('ARTIFRAME_VERSION', '1.0.0');
+
+// Register a simple autoloader for the CLI's own classes
+spl_autoload_register(function ($class) {
+    // Prefix for CLI classes
+    $prefix = 'ArtiFrame\\Cli\\';
+    $base_dir = ARTIFRAME_CLI_ROOT . '/src/';
+
+    // Does the class use the namespace prefix?
+    $len = strlen($prefix);
+    if (strncmp($prefix, $class, $len) !== 0) {
+        return; // no, move to the next registered autoloader
+    }
+
+    $relative_class = substr($class, $len);
+    $file = $base_dir . str_replace('\\', '/', $relative_class) . '.php';
+
+    if (file_exists($file)) {
+        require $file;
+    }
+});
+
+use ArtiFrame\Cli\App;
+
+// Bootstrap and run the application
+try {
+    $app = new App($argv);
+    $app->run();
+} catch (\Exception $e) {
+    echo "[ERROR] " . $e->getMessage() . PHP_EOL;
+    exit(1);
+}

package/core-stubs/app/ApiControl.php

@@ -0,0 +1,81 @@
+<?php
+/**
+ * ArtiFrame Core Engine
+ *
+ * @package     ArtiFrame
+ * @author      Artilingo
+ * @license     AGPLv3 (Attribution-ShareAlike Required)
+ */
+
+require_once __DIR__ . '/../vendor/autoload.php';
+
+// 1. Ortam değişkenlerini yükle (.env)
+\App\DotEnv::load(__DIR__ . '/../.env');
+
+// 2. Uygulama sabitlerini yükle (APP_ENV, APP_VERSION)
+require_once __DIR__ . '/../config/app-version.php';
+
+// 3. Sadece API'ye özgü metodları yükle
+require_once __DIR__ . '/../bin/SystemMethod.php';
+
+// 4. API Konfigürasyonları (JSON Response Header vs.)
+header('Content-Type: application/json; charset=utf-8');
+
+// 5. İzin Verilen HTTP Metodlarının Kontrolü
+// API uç noktalarında tanımlanan $allowedMethods dizisini baz alır. Tanımsızsa sadece POST kabul eder.
+$allowed = isset($allowedMethods) && is_array($allowedMethods) ? $allowedMethods : ['POST'];
+$requestMethod = $_SERVER['REQUEST_METHOD'] ?? 'UNKNOWN';
+
+// Preflight istekleri (OPTIONS) CORS için hayati öneme sahiptir, her halükarda 200 dönüp çıkış yapmasını sağlarız.
+if ($requestMethod === 'OPTIONS') {
+    http_response_code(200);
+    exit;
+}
+
+if (!in_array($requestMethod, $allowed)) {
+    http_response_code(405);
+    echo json_encode([
+        'status' => 'error', 
+        'message' => "Geçersiz istek metodu. Sadece " . implode(', ', $allowed) . " kabul edilir."
+    ]);
+    exit;
+}
+
+/* 
+// -------------------------------------------------------------------------
+// 6. CORS (Cross-Origin Resource Sharing) Kuralları
+// -------------------------------------------------------------------------
+// Başka domainlerden veya mobil uygulamalardan gelen API isteklerini kabul 
+// etmek isterseniz aşağıdaki satırları aktifleştirin. "*" yerine kendi 
+// domaininizi (örn: "https://artilingo.com") yazarak güvenliği artırabilirsiniz.
+
+header("Access-Control-Allow-Origin: *");
+header("Access-Control-Allow-Methods: GET, POST, OPTIONS, PUT, DELETE");
+header("Access-Control-Allow-Headers: Content-Type, Authorization, X-Requested-With");
+*/
+
+/*
+// -------------------------------------------------------------------------
+// 7. Rate Limiting (Basit IP Tabanlı Hız Sınırlandırma - Redis Örneği)
+// -------------------------------------------------------------------------
+// Kötü niyetli kişilerin veya botların API'nizi flood etmesini engeller.
+// Redis servisinizi aktif ettiyseniz bu bloğu kullanabilirsiniz.
+// Aşağıdaki örnekte, aynı IP adresinin 1 dakikada 60'tan fazla istek yapması engellenir.
+
+$ip = $_SERVER['REMOTE_ADDR'] ?? 'unknown';
+$rateKey = 'rate_limit:' . $ip;
+$limit = 60; // 1 dakikadaki maksimum istek sayısı
+$redis = \Src\Service\RedisService::getInstance();
+
+$currentCount = $redis->get($rateKey);
+if ($currentCount !== null && $currentCount >= $limit) {
+    http_response_code(429); // 429 Too Many Requests
+    echo json_encode(['status' => 'error', 'message' => 'Çok fazla istek gönderdiniz. Lütfen daha sonra tekrar deneyin.']);
+    exit;
+}
+
+$redis->incr($rateKey);
+if ($currentCount === null) {
+    $redis->expire($rateKey, 60); // Sayacı 60 saniye sonra sıfırla
+}
+*/

package/core-stubs/app/Database.php

@@ -0,0 +1,69 @@
+<?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 App;
+
+use PDO;
+use PDOException;
+
+class Database
+{
+    private static ?PDO $instance = null;
+
+    private function __construct() {}
+    private function __clone() {}
+
+    public static function getInstance(): PDO
+    {
+        if (self::$instance === null) {
+
+            // .env henüz yüklenmediyse tam ve temiz yoldan otomatik yükle
+            if (empty($_ENV['DB_HOST'])) {
+                // src/ katmanından bir üst klasöre (htdocs köküne) direkt geçiş:
+                $envPath = dirname(__DIR__) . '/.env';
+                DotEnv::load($envPath);
+            }
+
+            $host   = $_ENV['DB_HOST'] ?? 'localhost';
+            $dbname = $_ENV['DB_NAME'] ?? 'portfobase';
+            $user   = $_ENV['DB_USER'] ?? 'root';
+            $pass   = $_ENV['DB_PASS'] ?? '';
+
+            $dsn = sprintf("mysql:host=%s;dbname=%s;charset=utf8mb4", $host, $dbname);
+
+            $options = [
+                PDO::ATTR_ERRMODE            => PDO::ERRMODE_EXCEPTION,
+                PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
+                PDO::ATTR_EMULATE_PREPARES   => false,
+            ];
+
+            try {
+                self::$instance = new PDO($dsn, $user, $pass, $options);
+            } catch (PDOException $e) {
+                $isDev = (defined('APP_ENV') && APP_ENV == 1);
+
+                $msg = !$isDev
+                    ? 'Veritabanı bağlantı hatası. Sistem yöneticisi ile görüşün.'
+                    : 'Veritabanı Hatası (Dev Mod): ' . $e->getMessage();
+
+                header('Content-Type: application/json; charset=utf-8');
+                http_response_code(500);
+                echo json_encode(['success' => false, 'message' => $msg]);
+                exit;
+            }
+        }
+
+        return self::$instance;
+    }
+}

package/core-stubs/app/DotEnv.php

@@ -0,0 +1,63 @@
+<?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 App;
+
+class DotEnv
+{
+    /**
+     * Belirtilen dizindeki .env dosyasını okur ve çevresel değişkenlere ekler.
+     */
+    public static function load(string $path): void
+    {
+        // 1. Yol içindeki ".." ve bağıl (relative) katmanları temizle
+        $realPath = realpath($path);
+        $targetPath = $realPath !== false ? $realPath : $path;
+
+        // 2. Kontrolü temizlenmiş yol ($targetPath) üzerinden yap
+        if (!file_exists($targetPath) || !is_readable($targetPath)) {
+            return;
+        }
+
+        $lines = file($targetPath, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
+
+        foreach ($lines as $line) {
+            $line = trim($line);
+
+            // Yorum satırlarını es geç
+            if (str_starts_with($line, '#')) {
+                continue;
+            }
+
+            // Atama içermeyen satırları atla
+            if (!str_contains($line, '=')) {
+                continue;
+            }
+
+            list($name, $value) = explode('=', $line, 2);
+            $name = trim($name);
+            $value = trim($value);
+
+            // Tırnak işaretlerini temizle
+            $value = trim($value, '"\'');
+
+            // Zaten tanımlı değilse aktar
+            if (!array_key_exists($name, $_SERVER) && !array_key_exists($name, $_ENV)) {
+                putenv(sprintf('%s=%s', $name, $value));
+                $_ENV[$name] = $value;
+                $_SERVER[$name] = $value;
+            }
+        }
+    }
+}

package/core-stubs/app/R2Manager.php

@@ -0,0 +1,130 @@
+<?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 App;
+
+use Aws\S3\S3Client;
+use Aws\Exception\AwsException;
+
+class R2Manager
+{
+    private S3Client $client;
+    private string $bucketName;
+
+    public function __construct()
+    {
+        $accountId = $_ENV['R2_ACCOUNT_ID'] ?? '';
+        $accessKey = $_ENV['R2_ACCESS_KEY'] ?? '';
+        $secretKey = $_ENV['R2_SECRET_KEY'] ?? '';
+        $this->bucketName = $_ENV['R2_BUCKET_NAME'] ?? '';
+
+        $this->client = new S3Client([
+            'version' => 'latest',
+            'region'  => 'auto',
+            'endpoint' => "https://{$accountId}.r2.cloudflarestorage.com",
+            'credentials' => [
+                'key'    => $accessKey,
+                'secret' => $secretKey,
+            ],
+            // R2 için gerekli olabiliyor
+            'use_path_style_endpoint' => true,
+        ]);
+    }
+
+    /**
+     * R2 bucket'a dosya yükler.
+     *
+     * @param string $sourcePath Yerel dosya yolu (veya tmp_name)
+     * @param string $destinationKey Hedef R2 path/isim
+     * @param string $contentType MIME tipi
+     * @return string|false Yükleme başarılıysa dosyanın R2 adresi döner, aksi halde false.
+     */
+    public function upload(string $sourcePath, string $destinationKey, string $contentType = 'application/octet-stream')
+    {
+        try {
+            $result = $this->client->putObject([
+                'Bucket' => $this->bucketName,
+                'Key'    => $destinationKey,
+                'SourceFile' => $sourcePath,
+                'ContentType' => $contentType,
+                // Public okuma yetkisi vermek gerekirse ACL eklenebilir, ancak R2 genelde bucket policy kullanır.
+                // 'ACL'    => 'public-read',
+            ]);
+
+            // Cloudflare public dev.url veya bucket url döndürür. Projeye göre public URL yapılandırılır.
+            // Örnek public bucket path (Eğer R2'ye özel domain bağlıysa onu dönebilirsiniz)
+            // https://pub-xxxxxx.r2.dev/destinationKey gibi
+            return $destinationKey; 
+        } catch (AwsException $e) {
+            error_log("R2 Yükleme Hatası: " . $e->getMessage());
+            return false;
+        }
+    }
+
+    /**
+     * Base64 string'i bucket'a kaydeder.
+     *
+     * @param string $base64String
+     * @param string $destinationKey
+     * @param string $contentType
+     * @return string|false
+     */
+    public function uploadBase64(string $base64String, string $destinationKey, string $contentType = 'image/jpeg')
+    {
+        // Data URI şeması varsa temizle (data:image/png;base64,...)
+        if (strpos($base64String, ',') !== false) {
+            $parts = explode(',', $base64String);
+            $base64String = $parts[1];
+        }
+
+        $decodedData = base64_decode($base64String);
+        if ($decodedData === false) {
+            return false;
+        }
+
+        try {
+            $result = $this->client->putObject([
+                'Bucket' => $this->bucketName,
+                'Key'    => $destinationKey,
+                'Body'   => $decodedData,
+                'ContentType' => $contentType,
+            ]);
+
+            return $destinationKey;
+        } catch (AwsException $e) {
+            error_log("R2 Yükleme Hatası: " . $e->getMessage());
+            return false;
+        }
+    }
+
+    /**
+     * R2 bucket'tan dosya siler.
+     *
+     * @param string $key Silinecek dosyanın yolu/anahtarı (örn: avatars/123.jpg)
+     * @return bool Başarılıysa true, değilse false
+     */
+    public function delete(string $key)
+    {
+        try {
+            $this->client->deleteObject([
+                'Bucket' => $this->bucketName,
+                'Key'    => $key,
+            ]);
+            return true;
+        } catch (AwsException $e) {
+            error_log("R2 Silme Hatası: " . $e->getMessage());
+            return false;
+        }
+    }
+}

package/core-stubs/app/ViewControl.php

@@ -0,0 +1,24 @@
+<?php
+/**
+ * ArtiFrame Core Engine
+ *
+ * @package     ArtiFrame
+ * @author      Artilingo
+ * @license     AGPLv3 (Attribution-ShareAlike Required)
+ */
+
+require_once __DIR__ . '/../vendor/autoload.php';
+
+// 1. Ortam değişkenlerini yükle (.env)
+\App\DotEnv::load(__DIR__ . '/../.env');
+
+// 2. Uygulama sabitlerini yükle (APP_ENV, APP_VERSION)
+require_once __DIR__ . '/../config/app-version.php';
+
+// 3. Sadece View'a özgü metodları yükle
+require_once __DIR__ . '/../bin/ViewMethod.php';
+
+// 4. Oturum (Session) ve View Konfigürasyonları
+if (session_status() === PHP_SESSION_NONE) {
+    session_start();
+}