1

.editorconfig

@@ -0,0 +1,18 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_size = 4
+indent_style = space
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.{yml,yaml}]
+indent_size = 2
+
+[compose.yaml]
+indent_size = 4

.env.example

@@ -0,0 +1,65 @@
+APP_NAME=Laravel
+APP_ENV=local
+APP_KEY=
+APP_DEBUG=true
+APP_URL=http://localhost
+
+APP_LOCALE=en
+APP_FALLBACK_LOCALE=en
+APP_FAKER_LOCALE=en_US
+
+APP_MAINTENANCE_DRIVER=file
+# APP_MAINTENANCE_STORE=database
+
+# PHP_CLI_SERVER_WORKERS=4
+
+BCRYPT_ROUNDS=12
+
+LOG_CHANNEL=stack
+LOG_STACK=single
+LOG_DEPRECATIONS_CHANNEL=null
+LOG_LEVEL=debug
+
+DB_CONNECTION=sqlite
+# DB_HOST=127.0.0.1
+# DB_PORT=3306
+# DB_DATABASE=laravel
+# DB_USERNAME=root
+# DB_PASSWORD=
+
+SESSION_DRIVER=database
+SESSION_LIFETIME=120
+SESSION_ENCRYPT=false
+SESSION_PATH=/
+SESSION_DOMAIN=null
+
+BROADCAST_CONNECTION=log
+FILESYSTEM_DISK=local
+QUEUE_CONNECTION=database
+
+CACHE_STORE=database
+# CACHE_PREFIX=
+
+MEMCACHED_HOST=127.0.0.1
+
+REDIS_CLIENT=phpredis
+REDIS_HOST=127.0.0.1
+REDIS_PASSWORD=null
+REDIS_PORT=6379
+
+MAIL_MAILER=log
+MAIL_SCHEME=null
+MAIL_HOST=127.0.0.1
+MAIL_PORT=2525
+MAIL_USERNAME=null
+MAIL_PASSWORD=null
+MAIL_FROM_ADDRESS="hello@example.com"
+MAIL_FROM_NAME="${APP_NAME}"
+
+AWS_ACCESS_KEY_ID=
+AWS_SECRET_ACCESS_KEY=
+AWS_DEFAULT_REGION=us-east-1
+AWS_BUCKET=
+AWS_USE_PATH_STYLE_ENDPOINT=false
+
+VITE_APP_NAME="${APP_NAME}"

.gitattributes

@@ -0,0 +1,11 @@
+* text=auto eol=lf
+
+*.blade.php diff=html
+*.css diff=css
+*.html diff=html
+*.md diff=markdown
+*.php diff=php
+
+/.github export-ignore
+CHANGELOG.md export-ignore
+.styleci.yml export-ignore

.gitignore

@@ -0,0 +1,3 @@
+*.log
+.DS_Store
+.env

README.md

@@ -0,0 +1,59 @@
+<p align="center"><a href="https://laravel.com" target="_blank"><img src="https://raw.githubusercontent.com/laravel/art/master/logo-lockup/5%20SVG/2%20CMYK/1%20Full%20Color/laravel-logolockup-cmyk-red.svg" width="400" alt="Laravel Logo"></a></p>
+
+<p align="center">
+<a href="https://github.com/laravel/framework/actions"><img src="https://github.com/laravel/framework/workflows/tests/badge.svg" alt="Build Status"></a>
+<a href="https://packagist.org/packages/laravel/framework"><img src="https://img.shields.io/packagist/dt/laravel/framework" alt="Total Downloads"></a>
+<a href="https://packagist.org/packages/laravel/framework"><img src="https://img.shields.io/packagist/v/laravel/framework" alt="Latest Stable Version"></a>
+<a href="https://packagist.org/packages/laravel/framework"><img src="https://img.shields.io/packagist/l/laravel/framework" alt="License"></a>
+</p>
+
+## About Laravel
+
+Laravel is a web application framework with expressive, elegant syntax. We believe development must be an enjoyable and creative experience to be truly fulfilling. Laravel takes the pain out of development by easing common tasks used in many web projects, such as:
+
+- [Simple, fast routing engine](https://laravel.com/docs/routing).
+- [Powerful dependency injection container](https://laravel.com/docs/container).
+- Multiple back-ends for [session](https://laravel.com/docs/session) and [cache](https://laravel.com/docs/cache) storage.
+- Expressive, intuitive [database ORM](https://laravel.com/docs/eloquent).
+- Database agnostic [schema migrations](https://laravel.com/docs/migrations).
+- [Robust background job processing](https://laravel.com/docs/queues).
+- [Real-time event broadcasting](https://laravel.com/docs/broadcasting).
+
+Laravel is accessible, powerful, and provides tools required for large, robust applications.
+
+## Learning Laravel
+
+Laravel has the most extensive and thorough [documentation](https://laravel.com/docs) and video tutorial library of all modern web application frameworks, making it a breeze to get started with the framework. You can also check out [Laravel Learn](https://laravel.com/learn), where you will be guided through building a modern Laravel application.
+
+If you don't feel like reading, [Laracasts](https://laracasts.com) can help. Laracasts contains thousands of video tutorials on a range of topics including Laravel, modern PHP, unit testing, and JavaScript. Boost your skills by digging into our comprehensive video library.
+
+## Laravel Sponsors
+
+We would like to extend our thanks to the following sponsors for funding Laravel development. If you are interested in becoming a sponsor, please visit the [Laravel Partners program](https://partners.laravel.com).
+
+### Premium Partners
+
+- **[Vehikl](https://vehikl.com)**
+- **[Tighten Co.](https://tighten.co)**
+- **[Kirschbaum Development Group](https://kirschbaumdevelopment.com)**
+- **[64 Robots](https://64robots.com)**
+- **[Curotec](https://www.curotec.com/services/technologies/laravel)**
+- **[DevSquad](https://devsquad.com/hire-laravel-developers)**
+- **[Redberry](https://redberry.international/laravel-development)**
+- **[Active Logic](https://activelogic.com)**
+
+## Contributing
+
+Thank you for considering contributing to the Laravel framework! The contribution guide can be found in the [Laravel documentation](https://laravel.com/docs/contributions).
+
+## Code of Conduct
+
+In order to ensure that the Laravel community is welcoming to all, please review and abide by the [Code of Conduct](https://laravel.com/docs/contributions#code-of-conduct).
+
+## Security Vulnerabilities
+
+If you discover a security vulnerability within Laravel, please send an e-mail to Taylor Otwell via [taylor@laravel.com](mailto:taylor@laravel.com). All security vulnerabilities will be promptly addressed.
+
+## License
+
+The Laravel framework is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).

app/Http/Controllers/Api/v1/FreenodeController.php

@@ -0,0 +1,85 @@
+<?php
+
+namespace App\Http\Controllers\Api\v1;
+
+use Illuminate\Http\Request;
+use App\Http\Controllers\Controller;
+use App\Services\TomTool\Flow;
+use App\Services\TomTool\Telegram\Slave as TeleSlave;
+use Illuminate\Support\Str;
+use Illuminate\Support\Facades\File;
+
+class FreenodeController extends Controller
+{
+    public function filePut(Request $oRequest)
+    {
+
+        $sObjName = "freenode:filePub";
+        $oFlow = Flow::make($sObjName);
+
+        $aData = $oRequest->all();
+        
+        $sSubSiteCodeShort = $aData["site_code_short"];
+        $aRaw = $aData["raw"];
+        
+        $sDate   = date('Ymd');
+        $sSuffix = "nodes";
+        $sRawKey = $sDate . $sSuffix;
+        $sUniqueToken = hash_hmac('sha256', $sRawKey, 'wocaonide');
+        $sShortToken = Str::substr($sUniqueToken, 0, 16);
+
+        $aResult = [];
+        foreach ($aRaw as $sClient => $sContent) {
+            
+            if (!$sContent) {
+                $sMsg = "\n {$sObjName}来空？";
+                echo $sMsg;
+                TeleSlave::warn()->send($sMsg);
+                continue;
+            }
+            
+            $sExtension = '.txt';
+            if ($sClient == "v2ray") {
+                $sExtension = ".txt";
+            } else if ($sClient == "clash") {
+                $sExtension = ".yaml";
+            }
+            
+            $sFileSavePath = $sSubSiteCodeShort."/".$sShortToken;
+            $sFileSaveName = date("Ymd")."-".$sClient.$sExtension;
+            $sFilePathFull = $sFileSavePath."/".$sFileSaveName;
+            
+            if (!File::isDirectory($sFileSavePath)) {
+                File::makeDirectory($sFileSavePath, 0755, true);
+            }
+            
+            $xSaveLenth = File::put($sFilePathFull, $sContent);
+            chmod($sFilePathFull, 0644);
+//            chmod($sFilePathFull, 0777);
+
+            if (!$xSaveLenth) {
+                $sMsg = "\n {$sObjName}保存file失败？";
+                echo $sMsg;
+                TeleSlave::warn()->send($sMsg);
+                continue;
+            }
+            
+            $sFileUrl = config("app.url")."/".$sFilePathFull;
+            
+            if (config("app.is_loc") == false) {
+                $oFlow = TeleSlave::log()
+                            ->enableDetail(false)
+                            ->setFileUrl($sFileUrl, "更新ok的".config("app.site_code_short")."的{$sSubSiteCodeShort}的{$sClient}的长{$xSaveLenth}")
+                            ->send();
+
+                if ($oFlow->isFail()) {
+                    var_dump($oFlow->getResult());
+                    exit;
+                }
+            }
+            
+        }
+        
+        return response()->json($oFlow->done());
+    }
+}

app/Http/Controllers/Api/v1/Telegram/HookController.php

@@ -0,0 +1,197 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers\Api\v1\Telegram;
+
+//use App\Models\Article;
+use App\Services\TomTool\Http;
+use App\Services\Tg\Http as TGHttp;
+use App\Models\Hook as ModelHook;
+use App\Services\TomTool\ThrowableHandler;
+//use App\Services\TomTool\TelegramVdb;
+use App\Services\TomTool\Telegram\Slave as TelegramSlave;
+
+final class HookController
+{
+    private $sCustomText = '';
+    
+    public function cache_tg($sGroupCode)
+    {
+        try {
+            
+            $sUpdate = file_get_contents("php://input");
+            $aUpdate = json_decode($sUpdate, true);
+            $sText = $aUpdate["message"]["text"] ?? "没有text";
+            if (!str_starts_with($sText, '/')) {
+                $this->sCustomText = "/cacheTg#add__{$sGroupCode}"." ".$sUpdate;
+            }
+            
+            $this->cmd();
+            
+        } catch (\Throwable $e) {
+            
+            $aDataTg = ThrowableHandler::make($e)->enableTrace()->fetch();
+            TelegramSlave::fail()->enableSlaveQueue(false)->setMsgA([
+                                                                    "msg"   => $aDataTg,
+                                                                    "data"  => $sUpdate,
+                                                                    ])->send();
+            
+            $aDataCmd = $aDataTg;
+            $sDataCmd = json_encode($aDataCmd, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
+            $sDataCmd = str_replace("\\n", "<br>", $sDataCmd);
+            echo $sDataCmd;
+            exit;
+        }
+    }
+    
+    public function cmd_ffq_article()
+    {
+        try {
+            
+            $sUpdate = file_get_contents("php://input");
+            $aUpdate = json_decode($sUpdate, true);
+            $sText = $aUpdate["message"]["text"] ?? "没有text";
+            if (!str_starts_with($sText, '/')) {
+    //            $this->sCustomCmd = "article";
+    //            $this->sCustomFunc = "cache";
+    //            $this->aCustomOption[1] = "ffq";
+                $this->sCustomText = "/article#cacheAdd__ffq_tg_a"." ".$sUpdate;
+            }
+            
+            $this->cmd();
+            
+        } catch (\Throwable $e) {
+            
+            $aDataTg = ThrowableHandler::make($e)->enableTrace()->fetch();
+            TelegramSlave::fail()->enableSlaveQueue(false)->setMsgA([
+                                                                    "msg"   => $aDataTg,
+                                                                    "data"  => $sUpdate,
+                                                                    ])->send();
+            
+            $aDataCmd = $aDataTg;
+            $sDataCmd = json_encode($aDataCmd, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
+            $sDataCmd = str_replace("\\n", "<br>", $sDataCmd);
+            echo $sDataCmd;
+            exit;
+        }
+    }
+    
+    public function cmd()
+    {
+        
+        try {
+                
+            $oTGHttp = new TGHttp();
+            
+            $oTGHttp->sApiToken = env('telegram_token');
+            $oTGHttp->sApiChatId = env('telegram_chatid');
+            
+            $sUpdate = file_get_contents("php://input");
+            
+            $aUpdate = json_decode($sUpdate, true);
+//            @file_put_contents('/www/_tg/bot_log.txt', json_encode($aUpdate, JSON_PRETTY_PRINT));
+        
+            $aData['chatId'] = (string) $aUpdate["message"]["chat"]["id"];
+            $aData['fromId'] = (string) $aUpdate["message"]["from"]["id"];
+            
+            if ($this->sCustomText) {
+                $aUpdate["message"]["text"] = $this->sCustomText;
+            }
+            
+            if (!isset($aUpdate["message"]["text"])) {
+                throw new \Exception(json_encode($aUpdate));
+            }
+            
+            $sText = $aUpdate["message"]["text"];
+            
+            // hook优先
+            // 非is_hook，并且，首字符非/
+            if ((!isset($aUpdate["is_hook"]) || $aUpdate["is_hook"] == false) && substr($sText, 0, 1) !== "/") {
+                
+                $sHookKey = ModelHook::where("tg_user_id", $aData["fromId"])->first()?->key;
+                
+                if ($sHookKey) {
+                    if ($sText == "run") {
+                        $sText = $sHookKey;
+                    } else {
+                        $sText = $sHookKey.$sText;
+                    }
+                    $aUpdate["is_hook"] = true;
+                }
+                
+            }
+
+            @$aArg = explode(" ", $sText) ?? [];
+            @$aOption = explode("__", $aArg[0]) ?? [];
+            
+            $sCmd = $this->cleanCmd($aOption[0]);
+            
+            // 大于3个说明是hook或dove之类
+            $aCmd = explode("#", $sCmd);
+//            if (count($aCmd) >= 3) {
+//                $sHook = $aCmd[0];
+//                $sClass = $sHook;
+//                $sFunc = "go";
+//            } else {
+                $sClass = $aCmd[0] ?? false;
+                $sFunc = $aCmd[1] ?? false;
+//            }
+            
+            if (strpos($sClass, "dove$") !== false) {
+                $sClass = "dove";
+                $sFunc = "go";
+            }
+                
+            $sUClass = ucfirst($sClass);
+            $sUFunc = ucfirst($sFunc);
+        
+            unset($aOption[0]);
+            unset($aArg[0]);
+            
+            $aParams = [];
+            $aParams['aOption'] = $aOption;
+            $aParams['aArg'] = $aArg;
+            
+            $sClassPath = "App\\Services\\Tg\\Hook\\Mod\\".$sClass;
+            $sUClassPath = "App\\Services\\Tg\\Hook\\Mod\\".$sUClass;
+        
+            $oInstans = new $sUClassPath($aUpdate);
+            $r = $oInstans->$sFunc($aParams, $aUpdate);
+            
+            $oTGHttp->send($r, $aUpdate);
+
+            echo $r;
+            
+        } catch (\Throwable $e) {
+            
+            $aDataTg = ThrowableHandler::make($e)->enableTrace()->fetch();
+            TelegramSlave::fail()->enableSlaveQueue(false)->setMsgA($aDataTg)->send();
+            
+            $aDataCmd = $aDataTg;
+            $aDataCmd["_update"] = $aUpdate;
+            $sDataCmd = json_encode($aDataCmd, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
+            $sDataCmd = str_replace("\\n", "<br>", $sDataCmd);
+            echo $sDataCmd;
+            exit;
+            
+            // old
+//            $sMessage = "错误（文件: " . $e->getFile() . "，行: " . $e->getLine() . "）: " . $e->getMessage();
+//            $oTGHttp->send($sMessage, $sUpdate);
+//            //Http::response(200, 'error'); 注释的
+            // old end
+            
+
+        }
+    }
+    
+    private function cleanCmd($input) {
+        
+        $input = str_replace('\\', '', $input);
+        $input = str_replace('/', '', $input);
+        
+        return $input;
+    }
+    
+}
+

app/Http/Controllers/Controller.php

@@ -0,0 +1,8 @@
+<?php
+
+namespace App\Http\Controllers;
+
+abstract class Controller
+{
+    //
+}

app/Models/User.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace App\Models;
+
+// use Illuminate\Contracts\Auth\MustVerifyEmail;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Foundation\Auth\User as Authenticatable;
+use Illuminate\Notifications\Notifiable;
+
+class User extends Authenticatable
+{
+    /** @use HasFactory<\Database\Factories\UserFactory> */
+    use HasFactory, Notifiable;
+
+    /**
+     * The attributes that are mass assignable.
+     *
+     * @var list<string>
+     */
+    protected $fillable = [
+        'name',
+        'email',
+        'password',
+    ];
+
+    /**
+     * The attributes that should be hidden for serialization.
+     *
+     * @var list<string>
+     */
+    protected $hidden = [
+        'password',
+        'remember_token',
+    ];
+
+    /**
+     * Get the attributes that should be cast.
+     *
+     * @return array<string, string>
+     */
+    protected function casts(): array
+    {
+        return [
+            'email_verified_at' => 'datetime',
+            'password' => 'hashed',
+        ];
+    }
+}

app/Providers/AppServiceProvider.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace App\Providers;
+
+use Illuminate\Support\ServiceProvider;
+
+class AppServiceProvider extends ServiceProvider
+{
+    /**
+     * Register any application services.
+     */
+    public function register(): void
+    {
+        //
+    }
+
+    /**
+     * Bootstrap any application services.
+     */
+    public function boot(): void
+    {
+        //
+    }
+}

app/Services/Tg/Hook/Mod/Base.php

@@ -0,0 +1,57 @@
+<?php
+
+namespace App\Services\Tg\Hook\Mod;
+//use App\Services\TomTool\Http;
+//use App\Models\Article as ModelArticle;
+use App\Services\TomTool\Http;
+use App\Services\Tg\Http as TGHttp;
+
+class Base {
+    
+    public function __construct() {
+        $this->oHttp = new Http();
+        $this->oTGHttp = new TGHttp();
+//        $this->oTGHttp->sApiToken = env("telegram_token");
+//        $this->oTGHttp->sApiChatId = env("telegram_chatid");
+    }
+    
+    public function toJson($aData)
+    {
+        return json_encode($aData, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
+    }
+    
+    public function eachSendTg($aData)
+    {
+        foreach ($aData as $row) {
+            $this->oTGHttp->sendToTG(json_encode($row, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT));
+        }
+        
+        $this->oHttp::response(200, 'ok');
+    }
+    
+//    protected function cmdGood($sCmd) {
+//        
+//        $sCmdNew = "";
+//        switch ($sCmd) {
+//            case "user":
+//                $sCmdNew = "user_name";
+//                break;
+//            case "project":
+//                $sCmdNew = "project_name";
+//                break;
+//            case "code":
+//                $sCmdNew = "sale_code";
+//                break;
+//            case "condition":
+//                $sCmdNew = "cron_condition";
+//                break;
+//            default:
+//                $sCmdNew = $sCmd;
+//                break;
+//        }
+//        
+//        return $sCmdNew;
+//        
+//    }
+    
+}

app/Services/Tg/Hook/Mod/Console.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace App\Services\Tg\Hook\Mod;
+use App\Models\Option as ModelOption;
+use App\Services\Tg\Hook\Dog;
+use Illuminate\Support\Facades\Artisan;
+
+class Console extends Base {
+    
+    private $oDog;
+
+    public function __construct($aUpdate = [])
+    {
+        $this->oDog = new Dog(new ModelOption());
+//        $this->oDog->_setPrimaryKey("k"); // 可选，默认id
+        $this->oDog->_setDogName("console"); // 必须
+    }
+    
+    public function __call($sName, $aArg)
+    {
+        return $this->oDog->$sName($aArg[0]);
+    }
+    
+    public function call($aParam)
+    {
+        $sName = $aParam["aArg"][1] ?? '';
+        
+        if ($sName == "?") {
+            return "call [sName] 案例：stat:tags-count";
+        }
+        
+        if (!$sName) {
+            return "需要name";
+        }
+        
+        $iExitCode = Artisan::call($sName);
+        $sOutput = Artisan::output();
+
+        return $sOutput;
+    }
+    
+    public function t()
+    {
+        echo 11;
+        exit;
+    }
+    
+}

app/Services/Tg/Hook/Mod/Option.php

@@ -0,0 +1,49 @@
+<?php
+
+namespace App\Services\Tg\Hook\Mod;
+use App\Models\Option as ModelOption;
+use App\Services\Tg\Hook\Dog;
+
+class Option extends Base {
+    
+    private $oDog;
+
+    public function __construct($aUpdate = [])
+    {
+        $this->oDog = new Dog(new ModelOption());
+        $this->oDog->_setPrimaryKey("k"); // 可选，默认id
+        $this->oDog->_setDogName("option"); // 必须
+    }
+    
+    public function __call($sName, $aArg)
+    {
+        return $this->oDog->$sName($aArg[0]);
+    }
+    
+//    public function Pause($aParam)
+//    {
+//        $v = $aParam['aArg'][1];
+//        
+//        // 获取第一个匹配的选项
+//        $oOption = ModelOption::where("type", "pause")->first();
+//        
+//        // 检查是否找到了选项
+//        if ($oOption) {
+//            $oOption->value = $v;
+//            
+//            // 保存并返回结果
+//            return json_encode($oOption->save());
+//        }
+//        
+//        // 如果没有找到选项，返回一个错误信息
+//        return json_encode(['error' => 'Option not found']);
+//    }
+//    
+//    public function List()
+//    {
+//        $aOptionList = ModelOption::all()->toArray();
+//        
+//        return json_encode($aOptionList, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
+//    }
+    
+}

app/Services/Tg/Http.php

@@ -0,0 +1,108 @@
+<?php
+
+namespace App\Services\Tg;
+use App\Services\TomTool\Http as TomHttp;
+
+class Http {
+    
+    public $sApiToken;
+    public $sApiChatId;
+    
+    function __construct()
+    {
+        $this->sApiToken = env('telegram_token');
+        $this->sApiChatId = env('telegram_chatid');
+    }
+    
+    public function send($sMsg = "msg空", $aUpdate = [])
+    {
+        
+        $bSendTg = true;
+        
+        $sShell = $aUpdate["shell"] ?? false;
+        $bIsDove = $aUpdate["is_dove"] ?? false;
+        
+        if ($sShell == "cmd") {
+            $bSendTg = false;
+        }
+        
+        if ($bIsDove == true) {
+            $bSendTg = false;
+        }
+        
+        if (env("is_loc") == true) {
+            $bSendTg = false;
+        }
+        
+        if (is_array($sMsg)) {
+            if ($bSendTg) {
+                foreach ($sMsg as $sMsgRow) {
+                    $this->sendTg($sMsgRow);
+                }
+            } else {
+                echo json_encode($sMsg, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
+            }
+        } else {
+            if ($bSendTg) {
+                $this->sendTg($sMsg);
+            } else {
+                echo $sMsg;
+            }
+        }
+        
+        if ($bSendTg) {
+            TomHttp::response(200);
+        } else {
+            exit;
+        }
+        
+    }
+    
+    private function sendTg($sMsg)
+    {
+        $oHttp = new TomHttp();
+        $oHttp->sMethod = "post";
+        $oHttp->sToUrl = "https://api.telegram.org/bot$this->sApiToken/sendMessage";
+//            $oHttp->bIsJson = true;
+        $oHttp->aData = [
+            "chat_id"   => $this->sApiChatId,
+            "text"      => $sMsg
+        ];
+        
+        $oHttp->send();
+    }
+    
+    public function sendToTG($sMsg, $aUpdate = [])
+    {
+        
+        if (isset($aUpdate["shell"]) && $aUpdate["shell"] == "cmd") {
+            
+            echo $sMsg;
+            
+        } else if (isset($aUpdate["is_dove"]) && $aUpdate["is_dove"] == true) {
+            
+            echo $sMsg;
+            
+        } else {
+            
+            if (env("is_loc") == true) {
+                echo $sMsg;
+            } else {
+                $oHttp = new TomHttp();
+                $oHttp->sMethod = "post";
+                $oHttp->sToUrl = "https://api.telegram.org/bot$this->sApiToken/sendMessage";
+    //            $oHttp->bIsJson = true;
+                $oHttp->aData = [
+                    "chat_id"   => $this->sApiChatId,
+                    "text"      => $sMsg
+                ];
+                
+                $oHttp->send();
+            }
+            
+        }
+        
+    }
+    
+    
+}

app/Services/TomTool/Flow.php

@@ -0,0 +1,425 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Services\TomTool;
+
+use App\Services\TomTool\TelegramVdb;
+
+/**
+ 
+ 默认：
+    name:none
+    isDone:false
+ 
+ new:
+    $oResult = Flow::make("name");
+
+ 快速：
+    Flow::make("name")->fail("kkkkkkk");
+ 
+ 进阶：
+    Flow::make("name")->noDone()->msg("哟哟哟哟哟哟")->sendTg()->fetch();
+ 
+ 业务：
+    step()
+    msg()
+    data()
+    aData()
+    jData()
+    sData()
+    code()
+    put()
+    merge()
+    toDone()
+    noDone()
+    step("start")
+ 
+ action:
+    reset()
+    done(?$msg)
+    fail(?$msg, ?$aParentResult)
+    sendTg() 伪action
+    fetch() or get()
+    fetchAll() or geAll()
+ 
+ set：
+    enableTg();
+    parent($aParentResult);
+ 
+ with:
+    withTraceId();
+    withTimestamp();
+    withStep();
+ 
+ 判断：
+    ::isDone($aResult);
+    ::isFail($aResult);
+ 
+ */
+
+class Flow
+{
+    protected array $aStep = [];
+    protected array $aParent = [];
+    protected bool $isToTg = false;
+    protected bool $isToTgOne = false;
+    protected array $aResult = [
+        'isDone' => false,
+    ];
+    protected string $sName;
+    private bool $isChain = false;
+
+    public function __construct(string $name = 'none')
+    {
+        $this->sName = $name;
+        $this->aStep[] = "{$this->sName}::start";
+    }
+
+    // new
+    public static function make(string $name = 'none'): self
+    {
+        return new self($name);
+    }
+
+    // new
+    public static function start($sName = 'none')
+    {
+        $oInstance = new self($sName);
+        $oInstance->isChain = true;
+        return $oInstance;
+    }
+    
+    // option
+    public function enableTg(bool $flag = true): self
+    {
+        $this->isToTg = $flag;
+        return $this;
+    }
+
+    // option
+    public function enableTgOne(bool $flag = true): self
+    {
+        $this->enableTg(true);
+        $this->isToTgOne = $flag;
+        return $this;
+    }
+
+    // option
+    public function parent(array $aParentResult): self
+    {
+        $this->aParent = $aParentResult;
+        return $this;
+    }
+
+    // data
+    public function step(string $step): self
+    {
+        $this->aStep[] = "{$this->sName}::{$step}";
+        return $this;
+    }
+
+    // data
+    public function msg($msg = "msg未设置"): self
+    {
+        if (is_array($msg)) {
+            $msg = json_encode($msg);
+        }
+        $this->put('sMsg', $msg);
+        return $this;
+    }
+
+    // data
+    public function aData(array $data): self
+    {
+        $this->put('aData', $data);
+        return $this;
+    }
+
+    // data
+    public function aDataPut($k, $v)
+    {
+        $this->aResult["aData"][$k] = $v;
+        return $this;
+    }
+
+    // data
+    public function sData(string $data): self
+    {
+        $this->put('sData', $data);
+        return $this;
+    }
+
+    // data
+    public function code(string $code): self
+    {
+        $this->put('sCode', $code);
+        return $this;
+    }
+
+    // data
+    public function put(string $key, mixed $value, $sDataKey = ''): self
+    {
+        if ($sDataKey) {
+            $this->aResult[$sDataKey][$key] = $value;
+        } else {
+            $this->aResult[$key] = $value;
+        }
+
+        return $this;
+    }
+
+    // data
+    public function merge(array $data): self
+    {
+        foreach ($data as $k => $v) {
+            $this->put($k, $v);
+        }
+        return $this;
+    }
+
+    // data
+    public function setDone(bool $b = true): self
+    {
+        $this->aResult['isDone'] = $b;
+        return $this;
+    }
+
+    // data
+    public function setFail(string $step = ''): self
+    {
+        if ($step) {
+            $this->step($step);
+        }
+        $this->aResult['isDone'] = false;
+        return $this;
+    }
+
+    // with
+    public function withTraceId(string $id = null): self
+    {
+        $this->aResult['sTraceId'] = $id ?? uniqid('trace_', true);
+        return $this;
+    }
+
+    // with
+    public function withTimestamp(): self
+    {
+        $this->aResult['sTimestamp'] = (new \DateTime())->format(\DateTime::ATOM);
+        return $this;
+    }
+
+    // with
+    public function withStep(bool $flag = true): self
+    {
+        if ($flag) {
+            $this->withParentStep();
+            $this->aResult['aStep'] = $this->aStep;
+        } else {
+            unset($this->aResult['aStep']);
+        }
+        return $this;
+    }
+
+    // action
+    public function reset(): self
+    {
+        $this->aStep = [$this->sName . '::start'];
+        $this->aParent = [];
+        $this->isToTg = false;
+        $this->isToTgOne = false;
+        $this->aResult = ['isDone' => false];
+        return $this;
+    }
+
+    // action
+    public function done(mixed $msg = null)
+    {
+        $this->setDone();
+        if ($msg) {
+            $this->msg($msg);
+        }
+        return $this->get();
+    }
+
+    // action
+    public function fail(mixed $msg = null, array $aParentResult = [])
+    {
+        $this->setFail('fail');
+        if ($aParentResult) {
+            $this->aParent = $aParentResult;
+        }
+        if ($msg) {
+            $this->msg($msg);
+        }
+        return $this->getFull();
+    }
+
+    // action
+//    public function sendTg() // 伪装成非set
+//    {
+//        $this->enableTgOne();
+//        return $this;
+//    }
+    
+    // action
+    public function sendTg($sBotCode = 'base', $sChatCode = 'base')
+    {
+        
+    }
+    
+    public function getDataA()
+    {
+        return $this->aResult["aData"] ?? [];
+    }
+    
+    public function getDataS()
+    {
+        return (string) $this->aResult["sData"] ?? '';
+    }
+    
+    public function getDataI()
+    {
+        return (int) $this->aResult["iData"] ?? 0;
+    }
+    
+    public function getDataB()
+    {
+        return (bool) $this->aResult["bData"] ?? false;
+    }
+    
+    public function getDataX()
+    {
+        return $this->aResult["xData"] ?? '';
+    }
+    
+    public function setDataA(array $aData): self
+    {
+        $this->aData($aData);
+        return $this;
+    }
+    
+    public function setDataB(bool $bData): self
+    {
+        $this->aResult["bData"] = $bData;
+        return $this;
+    }
+    
+    public function setDataS(string $sData): self
+    {
+        $this->aResult["sData"] = $sData;
+        return $this;
+    }
+    
+    public function setDataI(int $iData): self
+    {
+        $this->aResult["iData"] = $iData;
+        return $this;
+    }
+    
+    public function setDataX($xData): self
+    {
+        $this->aResult["xData"] = $xData;
+        return $this;
+    }
+    
+    public function getResult(): array
+    {
+        return $this->aResult;
+    }
+    
+    // action
+    public function get()
+    {
+        if ($this->isToTg) {
+            $this->_sendTg();
+        }
+
+        if ($this->isToTgOne) {
+            $this->isToTg = false;
+            $this->isToTgOne = false;
+        }
+
+        if ($this->isChain) {
+            return $this;
+        }
+
+        return $this->aResult;
+    }
+
+    // action
+    public function getFull()
+    {
+        $this->withStep();
+        return $this->get();
+    }
+
+    // action
+    public function toArray()
+    {
+        return $this->aResult;
+    }
+    
+    // action
+    public function toJson($bFormat = true)
+    {
+        if ($bFormat === true) {
+            return json_encode($this->aResult, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
+        } else {
+            return json_encode($this->aResult);
+        }
+    }
+
+    // helper
+    public function isDone()
+    {
+        return $this->aResult["isDone"] ?? false;
+    }
+
+    // helper
+    public function isFail()
+    {
+        return !$this->isDone();
+    }
+    
+    // helper
+    public static function isDoneResult(array $aResult): bool
+    {
+        return $aResult['isDone'] ?? false;
+    }
+
+    // helper
+    public static function isFailResult(array $aResult): bool
+    {
+        return !self::isDoneResult($aResult);
+    }
+
+    // shell
+    public function fetch()
+    {
+        return $this->get();
+    }
+
+    // shell
+    public function fetchAll()
+    {
+        return $this->getFull();
+    }
+
+    private function _sendTg()
+    {
+        TelegramVdb::make()->dataArr($this->aResult)->save();
+    }
+
+    protected function addStepParent(): void
+    {
+        $this->aStep[] = $this->aParent;
+    }
+
+    protected function withParentStep(): void
+    {
+        if ($this->aParent) {
+            $this->addStepParent();
+        }
+    }
+}

app/Services/TomTool/Http.php

@@ -0,0 +1,93 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Services\TomTool;
+
+class Http
+{
+    public $sMethod = 'get';
+    public $aData = [];
+    public $sToUrl; // 必须
+    public $bIsJson = false;
+
+    public function send($sUrl = false): string
+    {
+        // 两种传递方式
+        if ($sUrl) {
+            $this->sToUrl = $sUrl;
+        }
+        
+        // 初始化 cURL 会话
+        $ch = curl_init();
+        
+        // 设置请求 URL
+        curl_setopt($ch, CURLOPT_URL, $this->sToUrl);
+        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // 返回响应而不是输出
+
+        // 根据请求方法设置 cURL 选项
+        switch (strtolower($this->sMethod)) {
+            case 'post':
+                curl_setopt($ch, CURLOPT_POST, true); // 设置为 POST 请求
+                if ($this->bIsJson) {
+                    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($this->aData)); // 设置 POST 数据为 JSON
+                    curl_setopt($ch, CURLOPT_HTTPHEADER, [
+                        'Content-Type: application/json', // 设置内容类型为 JSON
+                        'Content-Length: ' . strlen(json_encode($this->aData)) // 设置内容长度
+                    ]);
+                } else {
+                    curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($this->aData)); // 设置 POST 数据为普通表单格式
+                }
+                break;
+
+            case 'put':
+                curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PUT'); // 设置为 PUT 请求
+                if ($this->bIsJson) {
+                    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($this->aData)); // 设置 PUT 数据为 JSON
+                    curl_setopt($ch, CURLOPT_HTTPHEADER, [
+                        'Content-Type: application/json', // 设置内容类型为 JSON
+                        'Content-Length: ' . strlen(json_encode($this->aData)) // 设置内容长度
+                    ]);
+                } else {
+                    curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($this->aData)); // 设置 PUT 数据为普通表单格式
+                }
+                break;
+
+            case 'get':
+                // 默认使用 GET 请求
+                curl_setopt($ch, CURLOPT_HTTPGET, true); // 设置为 GET 请求
+                curl_setopt($ch, CURLOPT_URL, $this->sToUrl . '?' . http_build_query($this->aData)); // 设置请求 URL
+                if ($this->bIsJson) {
+                    curl_setopt($ch, CURLOPT_HTTPHEADER, [
+                        'Accept: application/json' // 设置接受的内容类型为 JSON
+                    ]);
+                }
+                break;
+        }
+
+        // 禁用 SSL 验证
+        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // 不验证对等证书
+        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false); // 不验证主机名
+
+        // 执行 cURL 请求
+        $response = curl_exec($ch);
+
+        // 检查是否有错误
+        if (curl_errno($ch)) {
+            return 'Error: ' . curl_error($ch);
+        }
+
+        // 关闭 cURL 会话
+        curl_close($ch);
+
+        // 返回响应
+        return $response;
+    }
+    
+    public static function response($iCode, $sMsg = '')
+    {
+        http_response_code($iCode);
+        echo $sMsg;
+        exit;
+    }
+}

app/Services/TomTool/HttpV2.php

@@ -0,0 +1,261 @@
+<?php
+
+// 版本：25-12-12
+
+declare(strict_types=1);
+
+namespace App\Services\TomTool;
+
+use App\Services\TomTool\Flow;
+use Exception;
+
+/**
+ 
+ 默认：
+    method:post
+ 
+ new:
+    HttpV2::make($url)
+ 
+ 基本：
+    HttpV2::make($url)->send()
+ 
+ 进阶：
+    HttpV2::make($url, "get")->setDataA($aData)->enableJsonAs()->enableAsync()->optMethod("get")->send();
+ 
+ action:
+    send()
+ 
+ data:
+    xData()
+    sData()
+    jData()
+    sData()
+ 
+ set:
+    optMethod()
+    enableJsonAs()
+    enableJsonSend()
+    enableJsonReturn()
+ 
+ @note:
+    默认关闭 SSL 验证（适用于开发环境），生产环境建议开启
+    异步模式下不会返回响应内容，仅快速触发请求
+ 
+ */
+
+
+class HttpV2
+{
+    protected string $method;
+    protected $data = [];
+    protected string $url;
+    protected bool $sendJson = false;
+    protected bool $returnJson = false;
+    protected bool $async = false;
+//    private bool $isChain = false;
+//    private array $aResult = [
+//        "isDone" = false
+//    ];
+
+    public static function make(string $url, string $method = 'post'): self
+    {
+        $instance = new self();
+        $instance->url = $url;
+        $instance->optMethod($method);
+        return $instance;
+    }
+    
+//    public static function start(string $sUrl, string $sMethod = 'post'): self
+//    {
+//        $oInstance = new self();
+//        $oInstance->url = $sUrl;
+//        $oInstance->method = $sMethod;
+//        $oInstance->isChain = true;
+//        return $oInstance;
+//    }
+//    
+//    public function isDone()
+//    {
+//        return $this->aResult["isDone"] ?? false;
+//    }
+//    
+//    public function isFail()
+//    {
+//        return !$this->isDone();
+//    }
+    
+//    public function getResult()
+//    {
+//        return $this->aResult;
+//    }
+    
+    public function optMethod(string $method): self
+    {
+        $this->method = strtolower($method);
+        return $this;
+    }
+    
+    public function setDataX($xData)
+    {
+        $this->setData($xData);
+        return $this;
+    }
+    
+    public function setDataA($aData)
+    {
+        $this->setData($aData);
+        return $this;
+    }
+    
+    public function setDataS($sData)
+    {
+        $this->setData($sData);
+        return $this;
+    }
+    
+    public function setData($xData)
+    {
+//        if (is_array($xData)) {
+//            json_encode($xData)
+//        }
+        $this->data = $xData;
+        return $this;
+    }
+
+//    public function aData($aData = [])
+//    {
+//        $this->data($aData);
+//        return $this;
+//    }
+//    
+//    public function sData($sData = '')
+//    {
+//        $this->data($sData);
+//        return $this;
+//    }
+//    
+//    public function jData($jData = '')
+//    {
+//        $this->data($jData);
+//        return $this;
+//    }
+//    
+//    public function xData($xData = '')
+//    {
+//        $this->data($xData);
+//        return $this;
+//    }
+//    
+//    public function data($data = ''): self
+//    {
+//        $this->data = $data;
+//        return $this;
+//    }
+
+    public function enableJsonSend(bool $flag = true): self
+    {
+        $this->sendJson = $flag;
+        return $this;
+    }
+
+    public function enableJsonReturn(bool $flag = true): self
+    {
+        $this->returnJson = $flag;
+        return $this;
+    }
+    
+    public function enableJsonAs(): self
+    {
+        $this->sendJson = true;
+        $this->returnJson = true;
+        return $this;
+    }
+
+    public function enableAsync(bool $flag = true): self
+    {
+        $this->async = $flag;
+        return $this;
+    }
+
+    public function send(): string
+    {
+        $oFlow = Flow::make("HttpV2::send");
+        
+        $ch = curl_init();
+        $headers = [];
+
+        // 构建 URL 和请求体
+        if ($this->method === 'get') {
+            $url = $this->url . '?' . http_build_query($this->data);
+            curl_setopt($ch, CURLOPT_URL, $url);
+            curl_setopt($ch, CURLOPT_HTTPGET, true);
+        } else {
+            curl_setopt($ch, CURLOPT_URL, $this->url);
+            $payload = $this->sendJson ? json_encode($this->data) : http_build_query($this->data);
+            curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
+
+            if ($this->method === 'post') {
+                curl_setopt($ch, CURLOPT_POST, true);
+            } else {
+                curl_setopt($ch, CURLOPT_CUSTOMREQUEST, strtoupper($this->method));
+            }
+
+            if ($this->sendJson) {
+                $headers[] = 'Content-Type: application/json';
+                $headers[] = 'Content-Length: ' . strlen($payload);
+            }
+        }
+
+        if ($this->returnJson) {
+            $headers[] = 'Accept: application/json';
+        }
+
+        if (!empty($headers)) {
+            curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
+        }
+
+        // SSL 设置
+        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
+        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
+
+        // 异步发送
+        if ($this->async) {
+            curl_setopt($ch, CURLOPT_TIMEOUT_MS, 200);
+            curl_setopt($ch, CURLOPT_CONNECTTIMEOUT_MS, 200);
+            curl_setopt($ch, CURLOPT_NOSIGNAL, true);
+            curl_setopt($ch, CURLOPT_RETURNTRANSFER, false);
+            curl_exec($ch);
+            curl_close($ch);
+            return 'sent';
+        }
+
+        // 阻塞执行
+        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
+        $response = curl_exec($ch);
+
+        if (curl_errno($ch)) {
+            $error = curl_error($ch);
+            curl_close($ch);
+            throw new Exception("cURL Error: {$error}");
+        }
+
+        curl_close($ch);
+        
+        return $response;
+//        $this->aResult = $oFlow->sData($response)->done();
+//        
+//        if ($this->isChain) {
+//            return $this;
+//        }
+//        
+//        return $this->aResult;
+    }
+
+//    public static function response(int $code, string $message = ''): void
+//    {
+//        http_response_code($code);
+//        echo $message;
+//        exit;
+//    }
+}

app/Services/TomTool/Map.php

@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Services\TomTool;
+
+class Map
+{
+    public static function fnClientToSfx($sClient)
+    {
+        $sfx = "";
+        
+        switch ($sClient) {
+            case "clash":
+                $sfx = "yaml";
+                break;
+            case "v2ray":
+                $sfx = "txt";
+                break;
+            default:
+                break;
+        }
+        
+        return $sfx;
+    }
+}

app/Services/TomTool/Telegram/Master.php

@@ -0,0 +1,177 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Services\TomTool\Telegram;
+
+use App\Services\HttpQueue as ServiceHttpQueue;
+use App\Services\TomTool\Flow;
+use App\Services\TomTool\Telegram\Sdk as ServiceTelegramSdk;
+use App\Models\TelegramKey as ModelTelegramKey;
+
+/**
+ 
+ 注意是master服务器端专用的，这里会对code找map，slave不会。
+ 
+ new:
+    start(?$sBodeCode, ?$sChatCode)
+ 
+ set:
+    setBotCode()
+    setChatCode()
+    setBotToken()
+    setChatId()
+    setMsgS()
+
+ action:
+    send()
+ 
+ */
+
+final class Master
+{
+    public string $sBotCode = "base";
+    public string $sChatCode = "base";
+    public string $sBotToken = '';
+    public int $iChatId = 0;
+    
+    public string $sMsg = '';
+    public string $sPhotoUrl = '';
+    public int $iPhotoWidth = 0;
+    public int $iPhotoHeight = 0;
+    
+    public string $sFileUrl = '';
+    public string $sFileName = '';
+    
+    public string $sType = '';
+    
+    public bool $enableQueue = false; // 应该用不到了
+    
+    public bool $bKeyBegin = false;
+    
+    public static function start($sBotCode = 'base', $sChatCode = 'base'): self
+    {
+        $oInstance = new self();
+        $oInstance->sBotCode = $sBotCode;
+        $oInstance->sChatCode = $sChatCode;
+        return $oInstance;
+    }
+    
+    public function setBotCode(string $sBotCode): self
+    {
+        $this->sBotCode = $sBotCode;
+        return $this;
+    }
+    
+    public function setChatCode(string $sChatCode): self
+    {
+        $this->sChatCode = $sChatCode;
+        return $this;
+    }
+    
+    public function setBotToken(string $sBotToken): self
+    {
+        $this->sBotToken = $sBotToken;
+        return $this;
+    }
+    
+    public function setChatId(int $iChatId): self
+    {
+        $this->iChatId = $iChatId;
+        return $this;
+    }
+    
+    public function setMsgS(string $sMsg): self
+    {
+        $this->sMsg = $sMsg;
+        return $this;
+    }
+    
+    public function setPhotoUrl(string $sPhotoUrl, int $iPhotoWidth = 0, int $iPhotoHeight = 0): self
+    {
+        $this->sPhotoUrl = $sPhotoUrl;
+        $this->iPhotoWidth = $iPhotoWidth;
+        $this->iPhotoHeight = $iPhotoHeight;
+        return $this;
+    }
+    
+    public function setType(string $sType): self
+    {
+        $this->sType = $sType;
+        return $this;
+    }
+    
+    public function setFileUrl(string $sFileUrl = '', string $sFileName = ''): self
+    {
+        $this->sFileUrl = $sFileUrl;
+        $this->sFileName = $sFileName;
+        return $this;
+    }
+    
+    public function send($sMsg = ''): Flow
+    {
+        if ($sMsg) {
+            $this->sMsg = $sMsg;
+        }
+        
+        if (!$this->sMsg) {
+//            throw new \Exception("未设置msg");
+        }
+
+        $this->keyBegin();
+        
+        if ($this->enableQueue) {
+            $aData = $this->buildDataTom();
+            $oFlow = ServiceHttpQueue::start("telegram_local")->arg($aData)->save();
+        } else {
+            $oFlow = ServiceTelegramSdk::start()
+                        ->setBotToken($this->sBotToken)
+                        ->setChatId($this->iChatId)
+                        ->setMsgS($this->sMsg)
+                        ->setPhotoUrl($this->sPhotoUrl, $this->iPhotoWidth, $this->iPhotoHeight)
+                        ->setFileUrl($this->sFileUrl, $this->sFileName)
+                        ->setType($this->sType)
+                        ->send();
+        }
+
+        return $oFlow;
+    }
+    
+    private function keyBegin()
+    {
+        if (!$this->bKeyBegin) {
+            if (!$this->sBotToken) {
+                $this->sBotToken = ModelTelegramKey::botTokenByCode($this->sBotCode);
+            }
+
+            if (!$this->iChatId) {
+                $this->iChatId = ModelTelegramKey::chatIdByCode($this->sChatCode);
+            }
+
+            if (!$this->sBotToken || !$this->iChatId) {
+                throw new \RuntimeException("botToken或chatId没找到，botCode={$this->sBotCode}，chatCode={$this->sChatCode}");
+            }
+
+            $this->bKeyBegin = true;
+        }
+    }
+    
+    private function buildDataTom(): array
+    {
+        return [
+            "sBotCode"  => $this->sBotCode ?? '',
+            "sChatCode" => $this->sChatCode ?? '',
+            "sBotToken" => $this->sBotToken ?? '',
+            "iChatId"   => $this->iChatId ?? '',
+            "sPhotoUrl" => $this->sPhotoUrl ?? '',
+            "iPhotoWidth" => $this->iPhotoWidth,
+            "iPhotoHeight" => $this->iPhotoHeight,
+            "sFileUrl"  => $this->sFileUrl,
+            "sFileName" => $this->sFileName,
+            "sMsg"      => $this->sMsg ?? '',
+            "sType"     => $this->sType ?? '',
+        ];
+    }
+    
+    
+}

app/Services/TomTool/Telegram/Sdk.php

@@ -0,0 +1,215 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Services\TomTool\Telegram;
+use Telegram\Bot\Api;
+use Telegram\Bot\FileUpload\InputFile;
+use Telegram\Bot\Exceptions\TelegramSDKException;
+use App\Services\TomTool\Flow;
+//use Intervention\Image\Laravel\Facades\Image;
+use Intervention\Image\ImageManager;
+use Intervention\Image\Drivers\Gd\Driver;
+use App\Services\TomTool\HttpV2;
+
+class Sdk
+{
+    public $sMsgFormat = [];
+    public $sMsgFormatType = 'none';
+    public $sBotToken = '';
+    public $iChatId = 0;
+    public $sPhotoUrl = '';
+    public $iPhotoWidth = 0;
+    public $iPhotoHeight = 0;
+    public $sFileUrl = '';
+    public $sFileName = '';
+    public $sMsg;
+    public $oApi;
+
+    private const ALLOWED_FORMATS = ['none', 'html', 'markdown', 'markdownV2'];
+    
+    public static function start()
+    {
+        $oInstance = new self();
+        return $oInstance;
+    }
+    
+    public function setBotToken($sBotToken)
+    {
+        $this->oApi = new Api($sBotToken);
+        $this->sBotToken = $sBotToken;
+        return $this;
+    }
+    
+    public function setChatId($iChatId)
+    {
+        $this->iChatId = $iChatId;
+        return $this;
+    }
+    
+    public function setMsgS($sMsg = '')
+    {
+        $this->sMsg = $sMsg;
+        return $this;
+    }
+    
+    public function setPhotoUrl($sUrl = '', $iPhotoWidth = 0, $iPhotoHeight = 0)
+    {
+        $this->sPhotoUrl = $sUrl;
+        $this->iPhotoWidth = $iPhotoWidth;
+        $this->iPhotoHeight = $iPhotoHeight;
+        return $this;
+    }
+    
+    public function setFileUrl($sFileUrl = '', $sFileName = '')
+    {
+        $this->sFileUrl = $sFileUrl;
+        $this->sFileName = $sFileName;
+        return $this;
+    }
+    
+    public function setType($sType)
+    {
+        if ($sType) {
+            $this->sMsgFormatType = $sType;
+        }
+        
+        return $this;
+    }
+    
+    public function send()
+    {
+        $oFlow = Flow::start("tg_sdk_send");
+        
+        $this->msgFormat();
+
+//        try {
+
+            if ($this->sPhotoUrl) {
+                $r = $this->oApi->sendPhoto($this->sMsgFormat);
+            } else if ($this->sFileUrl) {
+                $r = $this->oApi->sendDocument($this->sMsgFormat);
+            } else {
+                $r = $this->oApi->sendMessage($this->sMsgFormat);
+            }
+
+            if (!($r && $r->getMessageId())) {
+                return $oFlow->fail($r);
+            }
+//        } catch (TelegramSDKException $e) {
+//            return $oFlow->fail(['error' => $e->getMessage()]);
+//        }
+
+        return $oFlow->done();
+    }
+    
+    public function getMsgFormat()
+    {
+        $this->msgFormat();
+        
+        return $this->sMsgFormat;
+    }
+    
+    public function msgFormat()
+    {
+        if (!in_array($this->sMsgFormatType, self::ALLOWED_FORMATS, true)) {
+            throw new \RuntimeException("不支持的格式类型: {$this->sMsgFormatType}");
+        }
+
+        $method = 'msgFormat_' . $this->sMsgFormatType;
+        $this->sMsgFormat = $this->$method();
+        
+        if ($this->sPhotoUrl) {
+
+            $oManager = new ImageManager(new Driver());
+            
+            $sTempPath = $_ENV['dir_base'].'public/upload';
+            $sTempPath .= "/tg_output.png";
+            
+            $sImg = file_get_contents($this->sPhotoUrl);
+            $oImage = $oManager->read($sImg);
+
+            if ($this->iPhotoWidth && $this->iPhotoHeight) {
+                $oImage = $oImage->cover($this->iPhotoWidth, $this->iPhotoHeight);
+            }
+
+            $oImage->toJpg(80)->save($sTempPath);
+            
+            $photo = InputFile::create($sTempPath, date("Y-m-d").'.jpg');
+            
+            $this->sMsgFormat["photo"] = $photo;
+            
+            $this->sMsgFormat["caption"] = $this->sMsgFormat["text"];
+            unset($this->sMsgFormat["text"]);
+            
+        } else if ($this->sFileUrl) {
+            
+            if (!$this->sFileName) {
+                $sFileName = date("Y-m-d H:i:s").'.txt';
+            } else {
+                $sFileName = $this->sFileName;
+            }
+            
+            $sFile = InputFile::create($this->sFileUrl, $sFileName);
+            
+            $this->sMsgFormat["document"] = $sFile;
+            $this->sMsgFormat["caption"] = $this->sMsgFormat["text"];
+            unset($this->sMsgFormat["text"]);
+            
+        }
+
+        return $this;
+    }
+
+    private function msgFormat_none()
+    {
+        return [
+            'chat_id' => $this->iChatId,
+            'text' => $this->sMsg,
+            'parse_mode' => '',
+            'disable_web_page_preview' => false,
+            'reply_to_message_id' => null,
+            'reply_markup' => null,
+        ];
+    }
+
+    private function msgFormat_html()
+    {
+        return [
+            'chat_id' => $this->iChatId,
+            'text' => strip_tags($this->sMsg, [
+                'b', 'strong', 'i', 'em', 'u', 'ins', 's', 'strike', 'del', 'span', 'tg-spoiler', 'a', 'tg-emoji',
+                'code', 'pre',
+            ]),
+            'parse_mode' => 'HTML',
+            'disable_web_page_preview' => false,
+            'reply_to_message_id' => null,
+            'reply_markup' => null,
+        ];
+    }
+
+    private function msgFormat_markdown()
+    {
+        return [
+            'chat_id' => $this->iChatId,
+            'text' => $this->sMsg,
+            'parse_mode' => 'Markdown',
+            'disable_web_page_preview' => false,
+            'reply_to_message_id' => null,
+            'reply_markup' => null,
+        ];
+    }
+
+    private function msgFormat_markdownV2()
+    {
+        return [
+            'chat_id' => $this->iChatId,
+            'text' => $this->sMsg,
+            'parse_mode' => 'MarkdownV2',
+            'disable_web_page_preview' => false,
+            'reply_to_message_id' => null,
+            'reply_markup' => null,
+        ];
+    }
+    
+}

app/Services/TomTool/Telegram/Slave.php

@@ -0,0 +1,361 @@
+<?php
+
+// 版本 25/12/12
+
+declare(strict_types=1);
+
+namespace App\Services\TomTool\Telegram;
+
+use App\Services\TomTool\HttpV2;
+use App\Services\TomTool\Telegram\Sdk as ServiceTelegramSdk;
+use App\Services\TomTool\Flow;
+use App\Services\HttpQueue as ServiceHttpQueue;
+
+/**
+ 
+ 提醒：
+    master自身已经没有队列了，收到slave消息直接转发
+ 
+ 默认：
+    走本地队列，发送到master
+    走异步
+ 
+ new:
+    start()
+    log()
+    warn()
+    fail()
+    notify()
+    
+ opt:
+    enableMaster(:true)
+    enableMasterQueue(:true)
+    enableSlaveQueue(:true)
+    enableDetail(:true)
+ 
+ set:
+    setMsgS()
+    setMsgA()
+    setBotCode()
+    setChatCode()
+    setBotToken()
+    setChatId()
+    
+ action:
+    send()
+    sendMaster()
+    sendLocal()
+ 
+ */
+
+class Slave
+{
+    public string $sBotCode;
+    public string $sChatCode;
+    
+    public string $sBotToken = '';
+    public int $iChatId = 0;
+    
+    public string $sMsg = '';
+    public string $sPhotoUrl = '';
+    public int $iPhotoWidth = 0;
+    public int $iPhotoHeight = 0;
+    
+    public string $sFileUrl = '';
+    public string $sFileName = '';
+    
+    public string $sType = '';
+    
+    public bool $enableMaster = true;
+    public bool $enableMasterQueue = false; // 这里之前想错了，不会有master队列，只在slave有，master转发就行了
+    public bool $enableSlaveQueue = false;
+    
+    public bool $enableDetail = true;
+    
+    public bool $enableAsync = false;
+    
+    private bool $enableSend = true;
+    
+    // new
+    public static function start(string $sBotCode = 'base', string $sChatCode = 'base'): self
+    {
+        $oInstance = new self;
+        $oInstance->sBotCode = $sBotCode;
+        $oInstance->sChatCode = $sChatCode;
+        $oInstance->enableSend = filter_var($_ENV["tg_send_enable"] ?? true, FILTER_VALIDATE_BOOLEAN);
+        return $oInstance;
+    }
+    
+    // new
+    public static function log(string $sChatCode = 'admin'): self
+    {
+        return self::start("log", $sChatCode);
+    }
+    
+    // new
+    public static function warn(string $sChatCode = 'admin'): self
+    {
+        return self::start("warn", $sChatCode);
+    }
+    
+    // new
+    public static function fail(string $sChatCode = 'admin'): self
+    {
+        return self::start("fail", $sChatCode);
+    }
+    
+    // new
+    public static function notify(string $sChatCode = 'admin'): self
+    {
+        return self::start("fail", $sChatCode);
+    }
+    
+    
+    // opt
+    public function enableAsync(bool $b = true): self
+    {
+        $this->enableAsync = $b;
+        return $this;
+    }
+    
+    // opt
+    public function enableDetail(bool $b = true): self
+    {
+        $this->enableDetail = $b;
+        return $this;
+    }
+    
+    // opt
+    public function enableSlaveQueue(bool $b = true): self
+    {
+        $this->enableSlaveQueue = $b;
+        return $this;
+    }
+    
+    // opt
+    public function enableMaster(bool $b = true): self
+    {
+        $this->enableMaster = $b;
+        return $this;
+    }
+    
+    // opt
+    public function enableMasterQueue(bool $b = true): self
+    {
+        $this->enableMasterQueue = $b;
+        return $this;
+    }
+    
+    // set
+    public function setPhotoUrl(string $sPhotoUrl, int $iWidth = 0, int $iHeight = 0): self
+    {
+        $this->sPhotoUrl = $sPhotoUrl;
+        $this->iPhotoWidth = $iWidth;
+        $this->iPhotoHeight = $iHeight;
+        return $this;
+    }
+    
+    // set
+    public function setFileUrl(string $sFileUrl, string $sFileName = ''): self
+    {
+        $this->sFileUrl = $sFileUrl;
+        $this->sFileName = $sFileName;
+        return $this;
+    }
+    
+    // set
+    public function setType(string $sType): self
+    {
+        $this->sType = $sType;
+        return $this;
+    }
+    
+    // set
+    public function setMsgS(string $sMsg = ''): self
+    {
+        if ($this->enableDetail) {
+            $sMsg = "[ ".$this->getEnvSiteCode()." | ".date("d:H:i:s")." ] ".$sMsg;
+        }
+        
+        $this->sMsg = $sMsg;
+        
+        return $this;
+    }
+    
+    // set
+    public function setMsgA(array $aMsg = []): self
+    {
+        $aMsgNew = $aMsg;
+        
+        if ($this->enableDetail) {
+            $aMsgNew = [];
+            $aMsgNew["site_code"] = $this->getEnvSiteCode();
+            $aMsgNew["date"] = date("Y-m-d H:i:s");
+            $aMsgNew["data"] = $aMsg;
+        }
+        
+        $this->sMsg = json_encode($aMsgNew, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
+        
+        return $this;
+    }
+    
+    // set
+    public function setBotCode(string $sBotCode): self
+    {
+        $this->sBotCode = $sBotCode;
+        return $this;
+    }
+    
+    // set
+    public function setChatCode(string $sChatCode): self
+    {
+        $this->sChatCode = $sChatCode;
+        return $this;
+    }
+    
+    // set
+    public function setBotToken(string $sBotToken): self
+    {
+        $this->sBotToken = $sBotToken;
+        return $this;
+    }
+    
+    // set
+    public function setChatId(int $iChatId): self
+    {
+        $this->iChatId = $iChatId;
+        return $this;
+    }
+    
+    // action
+    public function send($xMsg = ''): Flow
+    {
+        if ($this->enableSend == false) {
+            $oFlow = Flow::start();
+            return $oFlow->done("不发送");
+        }
+        
+        if ($xMsg) {
+            if (is_array($xMsg)) {
+                $this->setMsgA($xMsg);
+            } else {
+                $this->setMsgS($xMsg);
+            }
+        }
+        
+        if (!$this->sMsg) {
+//            throw new \Exception("未设置msg");
+        }
+        
+        if ($this->enableMaster) {
+            $oFlow = $this->_send_master();
+        } else {
+            $oFlow = $this->_send_local();
+        }
+        
+        return $oFlow;
+    }
+    
+    // action
+    public function sendMaster($xMsg = ''): Flow
+    {
+        $this->enableMaster(true);
+        return $this->send($xMsg);
+    }
+    
+    // action
+    public function sendLocal($xMsg = ''): Flow
+    {
+        $this->enableMaster(false);
+        return $this->send($xMsg);
+    }
+    
+    private function _send_master(): Flow
+    {
+        $aData = $this->buildDataTom();
+        
+        if ($this->enableSlaveQueue) {
+            $oFlow = ServiceHttpQueue::start("telegram_master")->arg($aData)->save();
+        } else {
+            
+            $oFlow = Flow::start("_send_master");
+            $sUrlMaSterBase = $_ENV["url_master_base"] ?? "";
+            
+            if (!$sUrlMaSterBase) {
+                throw new \Exception("未设置env的url_master_base");
+            }
+            
+            $sUrlMasterPost = "https://".$sUrlMaSterBase."/api/telegram/post";
+
+            try {
+                
+                $oHttpV2 = HttpV2::make($sUrlMasterPost);
+                
+                if ($this->enableAsync) {
+                    $oHttpV2 = $oHttpV2->enableAsync();
+                }
+                
+                $r = $oHttpV2->enableJsonAs()->setData($aData)->send();
+
+                if ($this->enableAsync) {
+                    return $oFlow->sData("async")->done("async");
+                } else {
+                    $a = json_decode($r, true);
+                    $isDone = $a["isDone"] ?? false;
+                    
+                    if ($isDone) {
+                        return $oFlow->done();
+                    } else {
+                        return $oFlow->fail($r);
+                    }
+                    
+                }
+                
+            } catch (\Throwable $e) {
+                $oFlow = $oFlow->fail($e->getMessage());
+            }
+        }
+        
+        return $oFlow;
+    }
+    
+    // 直接从本地发到tg，几乎用不上，都走master了
+    private function _send_local(): Flow
+    {
+        if ($this->enableSlaveQueue) {
+            $aData = $this->buildDataTom();
+            $oFlow = ServiceHttpQueue::start("telegram_local")->arg($aData)->save();
+        } else {
+            $oFlow = ServiceTelegramSdk::start($this->sBotToken, $this->iChatId)->setMsgS($this->sMsg)->send();
+        }
+        
+        return $oFlow;
+    }
+    
+    private function buildDataTom(): array
+    {
+        return [
+            "sBotCode"  => $this->sBotCode ?? '',
+            "sChatCode" => $this->sChatCode ?? '',
+            "sBotToken" => $this->sBotToken ?? '',
+            "iChatId"   => $this->iChatId ?? '',
+            "enableMasterQueue"  => $this->enableMasterQueue ?? '',
+            "enableMaster" => $this->enableMaster,
+            "sMsg"    => $this->sMsg ?? '',
+            "sPhotoUrl" => $this->sPhotoUrl ?? '',
+            "iPhotoWidth"   => $this->iPhotoWidth ?? 0,
+            "iPhotoHeight"  => $this->iPhotoHeight ?? 0,
+            "sType" => $this->sType ?? '',
+            "sFileUrl"  => $this->sFileUrl ?? '',
+            "sFileName" => $this->sFileName ?? '',
+        ];
+    }
+    
+    private function getEnvSiteCode(): string
+    {
+        $sEnvSiteCode = $_ENV["site_code"] ?? "未设置env的site_code";
+        
+        return $sEnvSiteCode;
+    }
+    
+}

app/Services/TomTool/TelegramV2.php

@@ -0,0 +1,121 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Services\IM;
+
+use App\Models\Config;
+use Telegram\Bot\Api;
+use Telegram\Bot\Exceptions\TelegramSDKException;
+use function strip_tags;
+
+// 没有必须，默认使用base配置
+final class TelegramV2
+{
+    private Api $bot;
+    public $iTo;
+    public $sToken;
+    public $sMsgType = false;
+    
+    public function __construct($sToken = "base", $sTo = "base")
+    {
+        $this->setToken($sToken);
+        
+        $this->setTo($sTo);
+        
+//        $this->bot = new Api($this->sToken);
+    }
+    
+    public function setMsgType($sMsgType)
+    {
+        $this->sMsgType = $sMsgType;
+    }
+    
+    public function setTo($xTo, $sType = "code")
+    {
+        $iChatId = $xTo;
+        
+        if ($sType == "code") {
+//            $sEnvKey = "tgChat_".$xTo;
+            $iChatId = $_ENV['tgChat'][$iChatId];
+        }
+        
+        $this->iTo = $iChatId;
+    }
+    
+    public function setToken($xToken, $sType = "code")
+    {
+        $sToken = $xToken;
+        
+        if ($sType == "code") {
+//            $sEnvKey = "tgToken_".$xToken;
+            $sToken = $_ENV['tgToken'][$sToken];
+        }
+        
+        $this->sToken = $sToken;
+        
+        $this->bot = new Api($this->sToken);
+    }
+    
+    public function send($sMsg, $sMsgType = 'str')
+    {
+        if ($sMsgType == "arr") {
+            $sMsg = json_encode($sMsg, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
+        }
+        
+        if ($this->sMsgType === false) {
+            $sendMessage = [
+                'chat_id' => $this->iTo,
+                'text' => $sMsg,
+                'parse_mode' => '',
+                'disable_web_page_preview' => false,
+                'reply_to_message_id' => null,
+                'reply_markup' => null,
+            ];
+        } else if ($this->sMsgType === "html") {
+            $sendMessage = [
+                'chat_id' => $this->iTo,
+                'text' => strip_tags(
+                 $sMsg,
+                    ['b', 'strong', 'i', 'em', 'u', 'ins', 's', 'strike','del', 'span','tg-spoiler', 'a', 'tg-emoji',
+                        'code', 'pre',
+                    ]
+                ),
+                'parse_mode' => 'HTML',
+                'disable_web_page_preview' => false,
+                'reply_to_message_id' => null,
+                'reply_markup' => null,
+            ];
+        } else if ($this->sMsgType === "markdown") {
+            $sendMessage = [
+                'chat_id' => $this->iTo,
+                'text' => $sMsg,
+                'parse_mode' => 'Markdown',
+                'disable_web_page_preview' => false,
+                'reply_to_message_id' => null,
+                'reply_markup' => null,
+            ];
+        } else if ($this->sMsgType === "markdownV2") {
+            $sendMessage = [
+                'chat_id' => $this->iTo,
+                'text' => $sMsg,
+                'parse_mode' => 'MarkdownV2',
+                'disable_web_page_preview' => false,
+                'reply_to_message_id' => null,
+                'reply_markup' => null,
+            ];
+        } else {
+            $sendMessage = [
+                'chat_id' => $this->iTo,
+                'text' => $sMsg,
+                'parse_mode' => '',
+                'disable_web_page_preview' => false,
+                'reply_to_message_id' => null,
+                'reply_markup' => null,
+            ];
+        }
+
+        return $this->bot->sendMessage($sendMessage);
+    }
+    
+}

app/Services/TomTool/TelegramVdb_rengle.php

@@ -0,0 +1,362 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Services\TomTool;
+
+use App\Services\HttpQueue as ServiceHttpQueue;
+use App\Services\TomTool\Flow;
+use App\Models\TelegramKey as ModelTelegramKey;
+use Telegram\Bot\Api;
+use Telegram\Bot\Exceptions\TelegramSDKException;
+use function strip_tags;
+
+/**
+ 
+ 更新：
+    data会save清空，不再属于set
+ 
+ new:
+    TelegramVdb::make(?$botCode, ?$chatCode)
+ 
+ 快速：
+    TelegramVdb::make()->save($sData)
+ 
+ 进阶：
+    TelegramVdb::make()->dataArr($aData)->setFormat("html")->save();
+    TelegramVdb::make()->setFormat()->data($xData)->toJson()->save();
+ 
+ data：
+    data[Arr/Str/Json]($data)
+    data($aData)->toJson()
+ 
+ action:
+    save()
+ 
+ set:
+    setChatCode($code)
+    setBotCode($code)
+    setChatId($id) 覆盖code
+    setBotToken($token) 覆盖code
+    setFormat($type)
+    enableDate()
+ 
+ */
+
+final class TelegramVdb
+{
+    public $sBotCode;
+    public $sChatCode;
+    public $sBotToken = null;
+    public $iChatId = null;
+    public $sMsg = '';
+    public $sMsgFormat = '';
+    public $sMsgFormatType = 'none';
+    public $bEnableDate = false;
+    private $bKeyBegin = false;
+    public $sClient = "master";
+
+    private const ALLOWED_FORMATS = ['none', 'html', 'markdown', 'markdownV2'];
+    
+    public static function log()
+    {
+        return self::make("log", "admin");
+    }
+    
+    public static function warn()
+    {
+        return self::make("warn", "admin");
+    }
+    
+    public static function fail()
+    {
+        return self::make("fail", "admin");
+    }
+
+    public static function notify()
+    {
+        return self::make("notify", "admin");
+    }
+    
+    public static function make($sBotCode = "base", $sChatCode = "base")
+    {
+        $oInstance = new self();
+        $oInstance->sBotCode = $sBotCode;
+        $oInstance->sChatCode = $sChatCode;
+        return $oInstance;
+    }
+    
+    public function send($sMsg = '')
+    {
+        return $this->_ok($sMsg, true);
+    }
+    
+    public function save($sMsg = '')
+    {
+        return $this->_ok($sMsg);
+    }
+    
+    private function sendNow()
+    {
+        $oResult = Flow::make("send");
+        $oBot = new Api($this->sBotToken);
+        
+        $r = $oBot->sendMessage($this->sMsgFormat);
+        
+        if ($r->isOk()){
+            return $oResult->done();
+        } else {
+            return $oResult->fail("send失败");
+        }
+    }
+    
+    private function HttpQueueSave()
+    {
+        $aTelegramArg = [
+            "bot_token" => $this->sBotToken,
+            "chat_id"   => $this->iChatId,
+            "msg"       => $this->sMsgFormat,
+        ];
+
+        $aReturn = ServiceHttpQueue::start("telegram")->arg($aTelegramArg)->save()->getResult();
+        
+        return $aReturn;
+    }
+    
+    public function _ok($sMsg = '', $bSendNow = false)
+    {
+        $bTgSendEnable = $_ENV["tg_send_enable"] ?? false;
+        if (!$bTgSendEnable) {
+            return false;
+        }
+        
+        $oResult = Flow::make("save");
+
+        $this->keyBegin();
+
+        if ($sMsg) {
+            if (is_array($sMsg)) {
+                $this->aData($sMsg);
+            } else {
+                $this->sData($sMsg);
+            }
+        }
+        
+        $this->msgFormat();
+                
+        if ($bSendNow) {
+            $aReturn = $this->sendNow();
+        } else {
+            $aReturn = $this->HttpQueueSave();
+        }
+        
+        $this->sMsg = '';
+
+        return $aReturn;
+    }
+    
+    public function enableDate($b = true)
+    {
+        $this->bEnableDate = $b;
+        return $this;
+    }
+    
+    public function data($xData)
+    {
+        $this->sMsg = $xData;
+        return $this;
+    }
+    
+    public function jData($sMsg = '')
+    {
+        $this->dataJson($sMsg);
+        return $this;
+    }
+    
+    public function aData($sMsg = [])
+    {
+        $this->dataArr($sMsg);
+        return $this;
+    }
+    
+    public function sData($sMsg = '')
+    {
+        $this->dataStr($sMsg);
+        return $this;
+    }
+    
+    public function toJson()
+    {
+        $this->withDateArr();
+        $this->sMsg = json_encode($this->sMsg, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
+        return $this;
+    }
+
+    public function dataStr($sMsg = '')
+    {
+        $this->withDateStr();
+        $this->sMsg = $sMsg;
+        return $this;
+    }
+    
+    public function dataArr($sMsg = [])
+    {
+        $this->withDateArr();
+        $this->sMsg = json_encode($sMsg, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
+        return $this;
+    }
+    
+    public function dataJson($sMsg = '')
+    {
+        $this->dataStr($sMsg);
+        return $this;
+    }
+    
+    private function withDateArr()
+    {
+        if ($this->bEnableDate) {
+            $this->sMsg["date"] = date("Y-m-d H:i:s");
+        }
+    }
+    
+    private function withDateStr()
+    {
+        if ($this->bEnableDate) {
+            $this->sMsg = '['.date("Y-m-d H:i:s").'] '.$this->sMsg;
+        }
+    }
+    
+    public function setFormat($sMsgFormatType = "none")
+    {
+        $this->sMsgFormatType = $sMsgFormatType;
+        return $this;
+    }
+
+    public function setBotCode($sBotCode)
+    {
+        $this->sBotCode = $sBotCode;
+        $this->bKeyBegin = false;
+        return $this;
+    }
+
+    public function setChatCode($sChatCode)
+    {
+        $this->sChatCode = $sChatCode;
+        $this->bKeyBegin = false;
+        return $this;
+    }
+
+    public function setBotToken($sBotToken)
+    {
+        $this->sBotToken = $sBotToken;
+        return $this;
+    }
+
+    public function setChatId($iChatId)
+    {
+        $this->iChatId = $iChatId;
+        return $this;
+    }
+
+    private function keyBegin()
+    {
+        if (!$this->bKeyBegin) {
+            if (!$this->sBotToken) {
+                $this->sBotToken = $this->botTokenByCode();
+            }
+
+            if (!$this->iChatId) {
+                $this->iChatId = $this->chatIdByCode();
+            }
+
+            if (!$this->sBotToken || !$this->iChatId) {
+                throw new \RuntimeException("botToken或chatId没找到，botCode={$this->sBotCode}，chatCode={$this->sChatCode}");
+            }
+
+            $this->bKeyBegin = true;
+        }
+
+        return $this;
+    }
+
+    private function msgFormat()
+    {
+        if (!in_array($this->sMsgFormatType, self::ALLOWED_FORMATS, true)) {
+            throw new \RuntimeException("不支持的格式类型: {$this->sMsgFormatType}");
+        }
+
+        $method = 'msgFormat_' . $this->sMsgFormatType;
+        $this->$method();
+
+        return $this;
+    }
+
+    private function botTokenByCode()
+    {
+        return ModelTelegramKey::botTokenByCode($this->sBotCode);
+    }
+
+    private function chatIdByCode()
+    {
+        return ModelTelegramKey::chatIdByCode($this->sChatCode);
+    }
+
+    private function msgFormat_none()
+    {
+        $this->sMsgFormat = [
+            'chat_id' => $this->iChatId,
+            'text' => $this->sMsg,
+            'parse_mode' => '',
+            'disable_web_page_preview' => false,
+            'reply_to_message_id' => null,
+            'reply_markup' => null,
+        ];
+
+        return $this;
+    }
+
+    private function msgFormat_html()
+    {
+        $this->sMsgFormat = [
+            'chat_id' => $this->iChatId,
+            'text' => strip_tags($this->sMsg, [
+                'b', 'strong', 'i', 'em', 'u', 'ins', 's', 'strike', 'del', 'span', 'tg-spoiler', 'a', 'tg-emoji',
+                'code', 'pre',
+            ]),
+            'parse_mode' => 'HTML',
+            'disable_web_page_preview' => false,
+            'reply_to_message_id' => null,
+            'reply_markup' => null,
+        ];
+
+        return $this;
+    }
+
+    private function msgFormat_markdown()
+    {
+        $this->sMsgFormat = [
+            'chat_id' => $this->iChatId,
+            'text' => $this->sMsg,
+            'parse_mode' => 'Markdown',
+            'disable_web_page_preview' => false,
+            'reply_to_message_id' => null,
+            'reply_markup' => null,
+        ];
+
+        return $this;
+    }
+
+    private function msgFormat_markdownV2()
+    {
+        $this->sMsgFormat = [
+            'chat_id' => $this->iChatId,
+            'text' => $this->sMsg,
+            'parse_mode' => 'MarkdownV2',
+            'disable_web_page_preview' => false,
+            'reply_to_message_id' => null,
+            'reply_markup' => null,
+        ];
+
+        return $this;
+    }
+}

app/Services/TomTool/ThrowableHandler.php

@@ -0,0 +1,130 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Services\TomTool;
+
+use Throwable as ThrowableBase;
+use Illuminate\Database\QueryException;
+use App\Services\TomTool\TelegramVdb;
+
+/**
+ 
+ new:
+    $oThrowableHandler = ThrowableHandler::make($e);
+ 
+ 快速：
+    $aResult = ThrowableHandler::make($e)->toArr();
+ 
+ action：
+    fetch() or get()
+ 
+ set:
+    enableTg()
+    enableTrace()
+    setMaxDepth()
+ 
+ */
+
+class ThrowableHandler
+{
+    protected bool $tgEnable = false;
+    protected bool $showTrace = false;
+    protected int $maxDepth = 3;
+    protected ThrowableBase $e;
+
+    public static function make(ThrowableBase $e): self
+    {
+        $oInstance = new self();
+        $oInstance->e = $e;
+        return $oInstance;
+    }
+    
+    public function fetch()
+    {
+        return $this->get();
+    }
+    
+    public function get(): array
+    {
+        $data = $this->buildExceptionData($this->e, 0);
+
+        if ($this->tgEnable) {
+            $this->sendTelegram($data);
+        }
+
+        return $data;
+    }
+    
+    public function toArr(): array
+    {
+        return $this->get();
+    }
+
+    public function toJson(): string
+    {
+        return json_encode($this->get(), JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
+    }
+
+    public function enableTg(bool $enable = true): self
+    {
+        $this->tgEnable = $enable;
+        return $this;
+    }
+
+    public function enableTrace(bool $enable = true): self
+    {
+        $this->showTrace = $enable;
+        return $this;
+    }
+
+    public function setMaxDepth(int $depth): self
+    {
+        $this->maxDepth = max(1, $depth);
+        return $this;
+    }
+
+    protected function buildExceptionData(ThrowableBase $e, int $depth): array
+    {
+        $data = [
+            'message' => $e->getMessage(),
+            'file'    => $e->getFile(),
+            'line'    => $e->getLine(),
+        ];
+
+        $code = $e->getCode();
+        if ($code !== null && $code !== 0) {
+            $data['code'] = $code;
+        }
+
+        if ($this->showTrace) {
+            $filteredTrace = array_filter($e->getTrace(), function ($frame) {
+                return empty($frame['file']) || !str_contains($frame['file'], '/vendor/');
+            });
+
+            $traceLines = [];
+            foreach ($filteredTrace as $frame) {
+                $file = $frame['file'] ?? '[internal]';
+                $line = $frame['line'] ?? '';
+                $func = isset($frame['class'], $frame['function'])
+                    ? "{$frame['class']}{$frame['type']}{$frame['function']}"
+                    : ($frame['function'] ?? '[unknown]');
+                $traceLines[] = "{$file}:{$line} {$func}()";
+            }
+
+            $data['trace'] = implode("\n", $traceLines);
+        }
+
+        if ($depth < $this->maxDepth && $e->getPrevious() instanceof ThrowableBase) {
+            $data['previous'] = $this->buildExceptionData($e->getPrevious(), $depth + 1);
+        }
+
+        return $data;
+    }
+
+    protected function sendTelegram(array $data): void
+    {
+        TelegramVdb::make()->aData($data)->save();
+    }
+}
+

app/Services/TomTool/Tom.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Services\TomTool;
+
+class Tom
+{
+    public static function toJson($aData)
+    {
+        return json_encode($aData, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
+    }
+    
+    public static function toJsonBr($aData)
+    {
+        $sData = self::toJson($aData);
+        $sData = str_replace("\\n", "<br>", $sData);
+        
+        return $sData;
+    }
+}

artisan

@@ -0,0 +1,18 @@
+#!/usr/bin/env php
+<?php
+
+use Illuminate\Foundation\Application;
+use Symfony\Component\Console\Input\ArgvInput;
+
+define('LARAVEL_START', microtime(true));
+
+// Register the Composer autoloader...
+require __DIR__.'/vendor/autoload.php';
+
+// Bootstrap Laravel and handle the command...
+/** @var Application $app */
+$app = require_once __DIR__.'/bootstrap/app.php';
+
+$status = $app->handleCommand(new ArgvInput);
+
+exit($status);

bootstrap/app.php

@@ -0,0 +1,20 @@
+<?php
+
+use Illuminate\Foundation\Application;
+use Illuminate\Foundation\Configuration\Exceptions;
+use Illuminate\Foundation\Configuration\Middleware;
+
+return Application::configure(basePath: dirname(__DIR__))
+    ->withRouting(
+        web: __DIR__.'/../routes/web.php',
+        commands: __DIR__.'/../routes/console.php',
+        health: '/up',
+    )
+    ->withMiddleware(function (Middleware $middleware): void {
+         $middleware->validateCsrfTokens(except: [
+             'api/*',
+         ]);
+    })
+    ->withExceptions(function (Exceptions $exceptions): void {
+        //
+    })->create();

bootstrap/cache/.gitignore

@@ -0,0 +1,2 @@
+*
+!.gitignore

bootstrap/providers.php

@@ -0,0 +1,5 @@
+<?php
+
+return [
+    App\Providers\AppServiceProvider::class,
+];

composer.json

@@ -0,0 +1,86 @@
+{
+    "$schema": "https://getcomposer.org/schema.json",
+    "name": "laravel/laravel",
+    "type": "project",
+    "description": "The skeleton application for the Laravel framework.",
+    "keywords": ["laravel", "framework"],
+    "license": "MIT",
+    "require": {
+        "php": "^8.2",
+        "laravel/framework": "^12.0",
+        "laravel/tinker": "^2.10.1"
+    },
+    "require-dev": {
+        "fakerphp/faker": "^1.23",
+        "laravel/pail": "^1.2.2",
+        "laravel/pint": "^1.24",
+        "laravel/sail": "^1.41",
+        "mockery/mockery": "^1.6",
+        "nunomaduro/collision": "^8.6",
+        "phpunit/phpunit": "^11.5.3"
+    },
+    "autoload": {
+        "psr-4": {
+            "App\\": "app/",
+            "Database\\Factories\\": "database/factories/",
+            "Database\\Seeders\\": "database/seeders/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "Tests\\": "tests/"
+        }
+    },
+    "scripts": {
+        "setup": [
+            "composer install",
+            "@php -r \"file_exists('.env') || copy('.env.example', '.env');\"",
+            "@php artisan key:generate",
+            "@php artisan migrate --force",
+            "npm install",
+            "npm run build"
+        ],
+        "dev": [
+            "Composer\\Config::disableProcessTimeout",
+            "npx concurrently -c \"#93c5fd,#c4b5fd,#fb7185,#fdba74\" \"php artisan serve\" \"php artisan queue:listen --tries=1 --timeout=0\" \"php artisan pail --timeout=0\" \"npm run dev\" --names=server,queue,logs,vite --kill-others"
+        ],
+        "test": [
+            "@php artisan config:clear --ansi",
+            "@php artisan test"
+        ],
+        "post-autoload-dump": [
+            "Illuminate\\Foundation\\ComposerScripts::postAutoloadDump",
+            "@php artisan package:discover --ansi"
+        ],
+        "post-update-cmd": [
+            "@php artisan vendor:publish --tag=laravel-assets --ansi --force"
+        ],
+        "post-root-package-install": [
+            "@php -r \"file_exists('.env') || copy('.env.example', '.env');\""
+        ],
+        "post-create-project-cmd": [
+            "@php artisan key:generate --ansi",
+            "@php -r \"file_exists('database/database.sqlite') || touch('database/database.sqlite');\"",
+            "@php artisan migrate --graceful --ansi"
+        ],
+        "pre-package-uninstall": [
+            "Illuminate\\Foundation\\ComposerScripts::prePackageUninstall"
+        ]
+    },
+    "extra": {
+        "laravel": {
+            "dont-discover": []
+        }
+    },
+    "config": {
+        "optimize-autoloader": true,
+        "preferred-install": "dist",
+        "sort-packages": true,
+        "allow-plugins": {
+            "pestphp/pest-plugin": true,
+            "php-http/discovery": true
+        }
+    },
+    "minimum-stability": "stable",
+    "prefer-stable": true
+}

config/app.php

@@ -0,0 +1,128 @@
+<?php
+
+return [
+
+    /*
+    |--------------------------------------------------------------------------
+    | Application Name
+    |--------------------------------------------------------------------------
+    |
+    | This value is the name of your application, which will be used when the
+    | framework needs to place the application's name in a notification or
+    | other UI elements where an application name needs to be displayed.
+    |
+    */
+
+    'is_loc' => env('is_loc', false),
+
+    'name' => env('APP_NAME', 'Laravel'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Application Environment
+    |--------------------------------------------------------------------------
+    |
+    | This value determines the "environment" your application is currently
+    | running in. This may determine how you prefer to configure various
+    | services the application utilizes. Set this in your ".env" file.
+    |
+    */
+
+    'env' => env('APP_ENV', 'production'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Application Debug Mode
+    |--------------------------------------------------------------------------
+    |
+    | When your application is in debug mode, detailed error messages with
+    | stack traces will be shown on every error that occurs within your
+    | application. If disabled, a simple generic error page is shown.
+    |
+    */
+
+    'debug' => (bool) env('APP_DEBUG', false),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Application URL
+    |--------------------------------------------------------------------------
+    |
+    | This URL is used by the console to properly generate URLs when using
+    | the Artisan command line tool. You should set this to the root of
+    | the application so that it's available within Artisan commands.
+    |
+    */
+
+    'url' => env('APP_URL', 'http://localhost'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Application Timezone
+    |--------------------------------------------------------------------------
+    |
+    | Here you may specify the default timezone for your application, which
+    | will be used by the PHP date and date-time functions. The timezone
+    | is set to "UTC" by default as it is suitable for most use cases.
+    |
+    */
+
+    'timezone' => 'UTC',
+
+    /*
+    |--------------------------------------------------------------------------
+    | Application Locale Configuration
+    |--------------------------------------------------------------------------
+    |
+    | The application locale determines the default locale that will be used
+    | by Laravel's translation / localization methods. This option can be
+    | set to any locale for which you plan to have translation strings.
+    |
+    */
+
+    'locale' => env('APP_LOCALE', 'en'),
+
+    'fallback_locale' => env('APP_FALLBACK_LOCALE', 'en'),
+
+    'faker_locale' => env('APP_FAKER_LOCALE', 'en_US'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Encryption Key
+    |--------------------------------------------------------------------------
+    |
+    | This key is utilized by Laravel's encryption services and should be set
+    | to a random, 32 character string to ensure that all encrypted values
+    | are secure. You should do this prior to deploying the application.
+    |
+    */
+
+    'cipher' => 'AES-256-CBC',
+
+    'key' => env('APP_KEY'),
+
+    'previous_keys' => [
+        ...array_filter(
+            explode(',', (string) env('APP_PREVIOUS_KEYS', ''))
+        ),
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Maintenance Mode Driver
+    |--------------------------------------------------------------------------
+    |
+    | These configuration options determine the driver used to determine and
+    | manage Laravel's "maintenance mode" status. The "cache" driver will
+    | allow maintenance mode to be controlled across multiple machines.
+    |
+    | Supported drivers: "file", "cache"
+    |
+    */
+
+    'maintenance' => [
+        'driver' => env('APP_MAINTENANCE_DRIVER', 'file'),
+        'store' => env('APP_MAINTENANCE_STORE', 'database'),
+    ],
+
+];

config/auth.php

@@ -0,0 +1,115 @@
+<?php
+
+return [
+
+    /*
+    |--------------------------------------------------------------------------
+    | Authentication Defaults
+    |--------------------------------------------------------------------------
+    |
+    | This option defines the default authentication "guard" and password
+    | reset "broker" for your application. You may change these values
+    | as required, but they're a perfect start for most applications.
+    |
+    */
+
+    'defaults' => [
+        'guard' => env('AUTH_GUARD', 'web'),
+        'passwords' => env('AUTH_PASSWORD_BROKER', 'users'),
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Authentication Guards
+    |--------------------------------------------------------------------------
+    |
+    | Next, you may define every authentication guard for your application.
+    | Of course, a great default configuration has been defined for you
+    | which utilizes session storage plus the Eloquent user provider.
+    |
+    | All authentication guards have a user provider, which defines how the
+    | users are actually retrieved out of your database or other storage
+    | system used by the application. Typically, Eloquent is utilized.
+    |
+    | Supported: "session"
+    |
+    */
+
+    'guards' => [
+        'web' => [
+            'driver' => 'session',
+            'provider' => 'users',
+        ],
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | User Providers
+    |--------------------------------------------------------------------------
+    |
+    | All authentication guards have a user provider, which defines how the
+    | users are actually retrieved out of your database or other storage
+    | system used by the application. Typically, Eloquent is utilized.
+    |
+    | If you have multiple user tables or models you may configure multiple
+    | providers to represent the model / table. These providers may then
+    | be assigned to any extra authentication guards you have defined.
+    |
+    | Supported: "database", "eloquent"
+    |
+    */
+
+    'providers' => [
+        'users' => [
+            'driver' => 'eloquent',
+            'model' => env('AUTH_MODEL', App\Models\User::class),
+        ],
+
+        // 'users' => [
+        //     'driver' => 'database',
+        //     'table' => 'users',
+        // ],
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Resetting Passwords
+    |--------------------------------------------------------------------------
+    |
+    | These configuration options specify the behavior of Laravel's password
+    | reset functionality, including the table utilized for token storage
+    | and the user provider that is invoked to actually retrieve users.
+    |
+    | The expiry time is the number of minutes that each reset token will be
+    | considered valid. This security feature keeps tokens short-lived so
+    | they have less time to be guessed. You may change this as needed.
+    |
+    | The throttle setting is the number of seconds a user must wait before
+    | generating more password reset tokens. This prevents the user from
+    | quickly generating a very large amount of password reset tokens.
+    |
+    */
+
+    'passwords' => [
+        'users' => [
+            'provider' => 'users',
+            'table' => env('AUTH_PASSWORD_RESET_TOKEN_TABLE', 'password_reset_tokens'),
+            'expire' => 60,
+            'throttle' => 60,
+        ],
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Password Confirmation Timeout
+    |--------------------------------------------------------------------------
+    |
+    | Here you may define the number of seconds before a password confirmation
+    | window expires and users are asked to re-enter their password via the
+    | confirmation screen. By default, the timeout lasts for three hours.
+    |
+    */
+
+    'password_timeout' => env('AUTH_PASSWORD_TIMEOUT', 10800),
+
+];

config/cache.php

@@ -0,0 +1,117 @@
+<?php
+
+use Illuminate\Support\Str;
+
+return [
+
+    /*
+    |--------------------------------------------------------------------------
+    | Default Cache Store
+    |--------------------------------------------------------------------------
+    |
+    | This option controls the default cache store that will be used by the
+    | framework. This connection is utilized if another isn't explicitly
+    | specified when running a cache operation inside the application.
+    |
+    */
+
+    'default' => env('CACHE_STORE', 'database'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Cache Stores
+    |--------------------------------------------------------------------------
+    |
+    | Here you may define all of the cache "stores" for your application as
+    | well as their drivers. You may even define multiple stores for the
+    | same cache driver to group types of items stored in your caches.
+    |
+    | Supported drivers: "array", "database", "file", "memcached",
+    |                    "redis", "dynamodb", "octane",
+    |                    "failover", "null"
+    |
+    */
+
+    'stores' => [
+
+        'array' => [
+            'driver' => 'array',
+            'serialize' => false,
+        ],
+
+        'database' => [
+            'driver' => 'database',
+            'connection' => env('DB_CACHE_CONNECTION'),
+            'table' => env('DB_CACHE_TABLE', 'cache'),
+            'lock_connection' => env('DB_CACHE_LOCK_CONNECTION'),
+            'lock_table' => env('DB_CACHE_LOCK_TABLE'),
+        ],
+
+        'file' => [
+            'driver' => 'file',
+            'path' => storage_path('framework/cache/data'),
+            'lock_path' => storage_path('framework/cache/data'),
+        ],
+
+        'memcached' => [
+            'driver' => 'memcached',
+            'persistent_id' => env('MEMCACHED_PERSISTENT_ID'),
+            'sasl' => [
+                env('MEMCACHED_USERNAME'),
+                env('MEMCACHED_PASSWORD'),
+            ],
+            'options' => [
+                // Memcached::OPT_CONNECT_TIMEOUT => 2000,
+            ],
+            'servers' => [
+                [
+                    'host' => env('MEMCACHED_HOST', '127.0.0.1'),
+                    'port' => env('MEMCACHED_PORT', 11211),
+                    'weight' => 100,
+                ],
+            ],
+        ],
+
+        'redis' => [
+            'driver' => 'redis',
+            'connection' => env('REDIS_CACHE_CONNECTION', 'cache'),
+            'lock_connection' => env('REDIS_CACHE_LOCK_CONNECTION', 'default'),
+        ],
+
+        'dynamodb' => [
+            'driver' => 'dynamodb',
+            'key' => env('AWS_ACCESS_KEY_ID'),
+            'secret' => env('AWS_SECRET_ACCESS_KEY'),
+            'region' => env('AWS_DEFAULT_REGION', 'us-east-1'),
+            'table' => env('DYNAMODB_CACHE_TABLE', 'cache'),
+            'endpoint' => env('DYNAMODB_ENDPOINT'),
+        ],
+
+        'octane' => [
+            'driver' => 'octane',
+        ],
+
+        'failover' => [
+            'driver' => 'failover',
+            'stores' => [
+                'database',
+                'array',
+            ],
+        ],
+
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Cache Key Prefix
+    |--------------------------------------------------------------------------
+    |
+    | When utilizing the APC, database, memcached, Redis, and DynamoDB cache
+    | stores, there might be other applications using the same cache. For
+    | that reason, you may prefix every cache key to avoid collisions.
+    |
+    */
+
+    'prefix' => env('CACHE_PREFIX', Str::slug((string) env('APP_NAME', 'laravel')).'-cache-'),
+
+];

config/database.php

@@ -0,0 +1,183 @@
+<?php
+
+use Illuminate\Support\Str;
+
+return [
+
+    /*
+    |--------------------------------------------------------------------------
+    | Default Database Connection Name
+    |--------------------------------------------------------------------------
+    |
+    | Here you may specify which of the database connections below you wish
+    | to use as your default connection for database operations. This is
+    | the connection which will be utilized unless another connection
+    | is explicitly specified when you execute a query / statement.
+    |
+    */
+
+    'default' => env('DB_CONNECTION', 'sqlite'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Database Connections
+    |--------------------------------------------------------------------------
+    |
+    | Below are all of the database connections defined for your application.
+    | An example configuration is provided for each database system which
+    | is supported by Laravel. You're free to add / remove connections.
+    |
+    */
+
+    'connections' => [
+
+        'sqlite' => [
+            'driver' => 'sqlite',
+            'url' => env('DB_URL'),
+            'database' => env('DB_DATABASE', database_path('database.sqlite')),
+            'prefix' => '',
+            'foreign_key_constraints' => env('DB_FOREIGN_KEYS', true),
+            'busy_timeout' => null,
+            'journal_mode' => null,
+            'synchronous' => null,
+            'transaction_mode' => 'DEFERRED',
+        ],
+
+        'mysql' => [
+            'driver' => 'mysql',
+            'url' => env('DB_URL'),
+            'host' => env('DB_HOST', '127.0.0.1'),
+            'port' => env('DB_PORT', '3306'),
+            'database' => env('DB_DATABASE', 'laravel'),
+            'username' => env('DB_USERNAME', 'root'),
+            'password' => env('DB_PASSWORD', ''),
+            'unix_socket' => env('DB_SOCKET', ''),
+            'charset' => env('DB_CHARSET', 'utf8mb4'),
+            'collation' => env('DB_COLLATION', 'utf8mb4_unicode_ci'),
+            'prefix' => '',
+            'prefix_indexes' => true,
+            'strict' => true,
+            'engine' => null,
+            'options' => extension_loaded('pdo_mysql') ? array_filter([
+                (PHP_VERSION_ID >= 80500 ? \Pdo\Mysql::ATTR_SSL_CA : \PDO::MYSQL_ATTR_SSL_CA) => env('MYSQL_ATTR_SSL_CA'),
+            ]) : [],
+        ],
+
+        'mariadb' => [
+            'driver' => 'mariadb',
+            'url' => env('DB_URL'),
+            'host' => env('DB_HOST', '127.0.0.1'),
+            'port' => env('DB_PORT', '3306'),
+            'database' => env('DB_DATABASE', 'laravel'),
+            'username' => env('DB_USERNAME', 'root'),
+            'password' => env('DB_PASSWORD', ''),
+            'unix_socket' => env('DB_SOCKET', ''),
+            'charset' => env('DB_CHARSET', 'utf8mb4'),
+            'collation' => env('DB_COLLATION', 'utf8mb4_unicode_ci'),
+            'prefix' => '',
+            'prefix_indexes' => true,
+            'strict' => true,
+            'engine' => null,
+            'options' => extension_loaded('pdo_mysql') ? array_filter([
+                (PHP_VERSION_ID >= 80500 ? \Pdo\Mysql::ATTR_SSL_CA : \PDO::MYSQL_ATTR_SSL_CA) => env('MYSQL_ATTR_SSL_CA'),
+            ]) : [],
+        ],
+
+        'pgsql' => [
+            'driver' => 'pgsql',
+            'url' => env('DB_URL'),
+            'host' => env('DB_HOST', '127.0.0.1'),
+            'port' => env('DB_PORT', '5432'),
+            'database' => env('DB_DATABASE', 'laravel'),
+            'username' => env('DB_USERNAME', 'root'),
+            'password' => env('DB_PASSWORD', ''),
+            'charset' => env('DB_CHARSET', 'utf8'),
+            'prefix' => '',
+            'prefix_indexes' => true,
+            'search_path' => 'public',
+            'sslmode' => env('DB_SSLMODE', 'prefer'),
+        ],
+
+        'sqlsrv' => [
+            'driver' => 'sqlsrv',
+            'url' => env('DB_URL'),
+            'host' => env('DB_HOST', 'localhost'),
+            'port' => env('DB_PORT', '1433'),
+            'database' => env('DB_DATABASE', 'laravel'),
+            'username' => env('DB_USERNAME', 'root'),
+            'password' => env('DB_PASSWORD', ''),
+            'charset' => env('DB_CHARSET', 'utf8'),
+            'prefix' => '',
+            'prefix_indexes' => true,
+            // 'encrypt' => env('DB_ENCRYPT', 'yes'),
+            // 'trust_server_certificate' => env('DB_TRUST_SERVER_CERTIFICATE', 'false'),
+        ],
+
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Migration Repository Table
+    |--------------------------------------------------------------------------
+    |
+    | This table keeps track of all the migrations that have already run for
+    | your application. Using this information, we can determine which of
+    | the migrations on disk haven't actually been run on the database.
+    |
+    */
+
+    'migrations' => [
+        'table' => 'migrations',
+        'update_date_on_publish' => true,
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Redis Databases
+    |--------------------------------------------------------------------------
+    |
+    | Redis is an open source, fast, and advanced key-value store that also
+    | provides a richer body of commands than a typical key-value system
+    | such as Memcached. You may define your connection settings here.
+    |
+    */
+
+    'redis' => [
+
+        'client' => env('REDIS_CLIENT', 'phpredis'),
+
+        'options' => [
+            'cluster' => env('REDIS_CLUSTER', 'redis'),
+            'prefix' => env('REDIS_PREFIX', Str::slug((string) env('APP_NAME', 'laravel')).'-database-'),
+            'persistent' => env('REDIS_PERSISTENT', false),
+        ],
+
+        'default' => [
+            'url' => env('REDIS_URL'),
+            'host' => env('REDIS_HOST', '127.0.0.1'),
+            'username' => env('REDIS_USERNAME'),
+            'password' => env('REDIS_PASSWORD'),
+            'port' => env('REDIS_PORT', '6379'),
+            'database' => env('REDIS_DB', '0'),
+            'max_retries' => env('REDIS_MAX_RETRIES', 3),
+            'backoff_algorithm' => env('REDIS_BACKOFF_ALGORITHM', 'decorrelated_jitter'),
+            'backoff_base' => env('REDIS_BACKOFF_BASE', 100),
+            'backoff_cap' => env('REDIS_BACKOFF_CAP', 1000),
+        ],
+
+        'cache' => [
+            'url' => env('REDIS_URL'),
+            'host' => env('REDIS_HOST', '127.0.0.1'),
+            'username' => env('REDIS_USERNAME'),
+            'password' => env('REDIS_PASSWORD'),
+            'port' => env('REDIS_PORT', '6379'),
+            'database' => env('REDIS_CACHE_DB', '1'),
+            'max_retries' => env('REDIS_MAX_RETRIES', 3),
+            'backoff_algorithm' => env('REDIS_BACKOFF_ALGORITHM', 'decorrelated_jitter'),
+            'backoff_base' => env('REDIS_BACKOFF_BASE', 100),
+            'backoff_cap' => env('REDIS_BACKOFF_CAP', 1000),
+        ],
+
+    ],
+
+];

config/filesystems.php

@@ -0,0 +1,80 @@
+<?php
+
+return [
+
+    /*
+    |--------------------------------------------------------------------------
+    | Default Filesystem Disk
+    |--------------------------------------------------------------------------
+    |
+    | Here you may specify the default filesystem disk that should be used
+    | by the framework. The "local" disk, as well as a variety of cloud
+    | based disks are available to your application for file storage.
+    |
+    */
+
+    'default' => env('FILESYSTEM_DISK', 'local'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Filesystem Disks
+    |--------------------------------------------------------------------------
+    |
+    | Below you may configure as many filesystem disks as necessary, and you
+    | may even configure multiple disks for the same driver. Examples for
+    | most supported storage drivers are configured here for reference.
+    |
+    | Supported drivers: "local", "ftp", "sftp", "s3"
+    |
+    */
+
+    'disks' => [
+
+        'local' => [
+            'driver' => 'local',
+            'root' => storage_path('app/private'),
+            'serve' => true,
+            'throw' => false,
+            'report' => false,
+        ],
+
+        'public' => [
+            'driver' => 'local',
+            'root' => storage_path('app/public'),
+            'url' => rtrim(env('APP_URL', 'http://localhost'), '/').'/storage',
+            'visibility' => 'public',
+            'throw' => false,
+            'report' => false,
+        ],
+
+        's3' => [
+            'driver' => 's3',
+            'key' => env('AWS_ACCESS_KEY_ID'),
+            'secret' => env('AWS_SECRET_ACCESS_KEY'),
+            'region' => env('AWS_DEFAULT_REGION'),
+            'bucket' => env('AWS_BUCKET'),
+            'url' => env('AWS_URL'),
+            'endpoint' => env('AWS_ENDPOINT'),
+            'use_path_style_endpoint' => env('AWS_USE_PATH_STYLE_ENDPOINT', false),
+            'throw' => false,
+            'report' => false,
+        ],
+
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Symbolic Links
+    |--------------------------------------------------------------------------
+    |
+    | Here you may configure the symbolic links that will be created when the
+    | `storage:link` Artisan command is executed. The array keys should be
+    | the locations of the links and the values should be their targets.
+    |
+    */
+
+    'links' => [
+        public_path('storage') => storage_path('app/public'),
+    ],
+
+];

config/logging.php

@@ -0,0 +1,132 @@
+<?php
+
+use Monolog\Handler\NullHandler;
+use Monolog\Handler\StreamHandler;
+use Monolog\Handler\SyslogUdpHandler;
+use Monolog\Processor\PsrLogMessageProcessor;
+
+return [
+
+    /*
+    |--------------------------------------------------------------------------
+    | Default Log Channel
+    |--------------------------------------------------------------------------
+    |
+    | This option defines the default log channel that is utilized to write
+    | messages to your logs. The value provided here should match one of
+    | the channels present in the list of "channels" configured below.
+    |
+    */
+
+    'default' => env('LOG_CHANNEL', 'stack'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Deprecations Log Channel
+    |--------------------------------------------------------------------------
+    |
+    | This option controls the log channel that should be used to log warnings
+    | regarding deprecated PHP and library features. This allows you to get
+    | your application ready for upcoming major versions of dependencies.
+    |
+    */
+
+    'deprecations' => [
+        'channel' => env('LOG_DEPRECATIONS_CHANNEL', 'null'),
+        'trace' => env('LOG_DEPRECATIONS_TRACE', false),
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Log Channels
+    |--------------------------------------------------------------------------
+    |
+    | Here you may configure the log channels for your application. Laravel
+    | utilizes the Monolog PHP logging library, which includes a variety
+    | of powerful log handlers and formatters that you're free to use.
+    |
+    | Available drivers: "single", "daily", "slack", "syslog",
+    |                    "errorlog", "monolog", "custom", "stack"
+    |
+    */
+
+    'channels' => [
+
+        'stack' => [
+            'driver' => 'stack',
+            'channels' => explode(',', (string) env('LOG_STACK', 'single')),
+            'ignore_exceptions' => false,
+        ],
+
+        'single' => [
+            'driver' => 'single',
+            'path' => storage_path('logs/laravel.log'),
+            'level' => env('LOG_LEVEL', 'debug'),
+            'replace_placeholders' => true,
+        ],
+
+        'daily' => [
+            'driver' => 'daily',
+            'path' => storage_path('logs/laravel.log'),
+            'level' => env('LOG_LEVEL', 'debug'),
+            'days' => env('LOG_DAILY_DAYS', 14),
+            'replace_placeholders' => true,
+        ],
+
+        'slack' => [
+            'driver' => 'slack',
+            'url' => env('LOG_SLACK_WEBHOOK_URL'),
+            'username' => env('LOG_SLACK_USERNAME', 'Laravel Log'),
+            'emoji' => env('LOG_SLACK_EMOJI', ':boom:'),
+            'level' => env('LOG_LEVEL', 'critical'),
+            'replace_placeholders' => true,
+        ],
+
+        'papertrail' => [
+            'driver' => 'monolog',
+            'level' => env('LOG_LEVEL', 'debug'),
+            'handler' => env('LOG_PAPERTRAIL_HANDLER', SyslogUdpHandler::class),
+            'handler_with' => [
+                'host' => env('PAPERTRAIL_URL'),
+                'port' => env('PAPERTRAIL_PORT'),
+                'connectionString' => 'tls://'.env('PAPERTRAIL_URL').':'.env('PAPERTRAIL_PORT'),
+            ],
+            'processors' => [PsrLogMessageProcessor::class],
+        ],
+
+        'stderr' => [
+            'driver' => 'monolog',
+            'level' => env('LOG_LEVEL', 'debug'),
+            'handler' => StreamHandler::class,
+            'handler_with' => [
+                'stream' => 'php://stderr',
+            ],
+            'formatter' => env('LOG_STDERR_FORMATTER'),
+            'processors' => [PsrLogMessageProcessor::class],
+        ],
+
+        'syslog' => [
+            'driver' => 'syslog',
+            'level' => env('LOG_LEVEL', 'debug'),
+            'facility' => env('LOG_SYSLOG_FACILITY', LOG_USER),
+            'replace_placeholders' => true,
+        ],
+
+        'errorlog' => [
+            'driver' => 'errorlog',
+            'level' => env('LOG_LEVEL', 'debug'),
+            'replace_placeholders' => true,
+        ],
+
+        'null' => [
+            'driver' => 'monolog',
+            'handler' => NullHandler::class,
+        ],
+
+        'emergency' => [
+            'path' => storage_path('logs/laravel.log'),
+        ],
+
+    ],
+
+];

config/mail.php

@@ -0,0 +1,118 @@
+<?php
+
+return [
+
+    /*
+    |--------------------------------------------------------------------------
+    | Default Mailer
+    |--------------------------------------------------------------------------
+    |
+    | This option controls the default mailer that is used to send all email
+    | messages unless another mailer is explicitly specified when sending
+    | the message. All additional mailers can be configured within the
+    | "mailers" array. Examples of each type of mailer are provided.
+    |
+    */
+
+    'default' => env('MAIL_MAILER', 'log'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Mailer Configurations
+    |--------------------------------------------------------------------------
+    |
+    | Here you may configure all of the mailers used by your application plus
+    | their respective settings. Several examples have been configured for
+    | you and you are free to add your own as your application requires.
+    |
+    | Laravel supports a variety of mail "transport" drivers that can be used
+    | when delivering an email. You may specify which one you're using for
+    | your mailers below. You may also add additional mailers if needed.
+    |
+    | Supported: "smtp", "sendmail", "mailgun", "ses", "ses-v2",
+    |            "postmark", "resend", "log", "array",
+    |            "failover", "roundrobin"
+    |
+    */
+
+    'mailers' => [
+
+        'smtp' => [
+            'transport' => 'smtp',
+            'scheme' => env('MAIL_SCHEME'),
+            'url' => env('MAIL_URL'),
+            'host' => env('MAIL_HOST', '127.0.0.1'),
+            'port' => env('MAIL_PORT', 2525),
+            'username' => env('MAIL_USERNAME'),
+            'password' => env('MAIL_PASSWORD'),
+            'timeout' => null,
+            'local_domain' => env('MAIL_EHLO_DOMAIN', parse_url((string) env('APP_URL', 'http://localhost'), PHP_URL_HOST)),
+        ],
+
+        'ses' => [
+            'transport' => 'ses',
+        ],
+
+        'postmark' => [
+            'transport' => 'postmark',
+            // 'message_stream_id' => env('POSTMARK_MESSAGE_STREAM_ID'),
+            // 'client' => [
+            //     'timeout' => 5,
+            // ],
+        ],
+
+        'resend' => [
+            'transport' => 'resend',
+        ],
+
+        'sendmail' => [
+            'transport' => 'sendmail',
+            'path' => env('MAIL_SENDMAIL_PATH', '/usr/sbin/sendmail -bs -i'),
+        ],
+
+        'log' => [
+            'transport' => 'log',
+            'channel' => env('MAIL_LOG_CHANNEL'),
+        ],
+
+        'array' => [
+            'transport' => 'array',
+        ],
+
+        'failover' => [
+            'transport' => 'failover',
+            'mailers' => [
+                'smtp',
+                'log',
+            ],
+            'retry_after' => 60,
+        ],
+
+        'roundrobin' => [
+            'transport' => 'roundrobin',
+            'mailers' => [
+                'ses',
+                'postmark',
+            ],
+            'retry_after' => 60,
+        ],
+
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Global "From" Address
+    |--------------------------------------------------------------------------
+    |
+    | You may wish for all emails sent by your application to be sent from
+    | the same address. Here you may specify a name and address that is
+    | used globally for all emails that are sent by your application.
+    |
+    */
+
+    'from' => [
+        'address' => env('MAIL_FROM_ADDRESS', 'hello@example.com'),
+        'name' => env('MAIL_FROM_NAME', 'Example'),
+    ],
+
+];

config/queue.php

@@ -0,0 +1,129 @@
+<?php
+
+return [
+
+    /*
+    |--------------------------------------------------------------------------
+    | Default Queue Connection Name
+    |--------------------------------------------------------------------------
+    |
+    | Laravel's queue supports a variety of backends via a single, unified
+    | API, giving you convenient access to each backend using identical
+    | syntax for each. The default queue connection is defined below.
+    |
+    */
+
+    'default' => env('QUEUE_CONNECTION', 'database'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Queue Connections
+    |--------------------------------------------------------------------------
+    |
+    | Here you may configure the connection options for every queue backend
+    | used by your application. An example configuration is provided for
+    | each backend supported by Laravel. You're also free to add more.
+    |
+    | Drivers: "sync", "database", "beanstalkd", "sqs", "redis",
+    |          "deferred", "background", "failover", "null"
+    |
+    */
+
+    'connections' => [
+
+        'sync' => [
+            'driver' => 'sync',
+        ],
+
+        'database' => [
+            'driver' => 'database',
+            'connection' => env('DB_QUEUE_CONNECTION'),
+            'table' => env('DB_QUEUE_TABLE', 'jobs'),
+            'queue' => env('DB_QUEUE', 'default'),
+            'retry_after' => (int) env('DB_QUEUE_RETRY_AFTER', 90),
+            'after_commit' => false,
+        ],
+
+        'beanstalkd' => [
+            'driver' => 'beanstalkd',
+            'host' => env('BEANSTALKD_QUEUE_HOST', 'localhost'),
+            'queue' => env('BEANSTALKD_QUEUE', 'default'),
+            'retry_after' => (int) env('BEANSTALKD_QUEUE_RETRY_AFTER', 90),
+            'block_for' => 0,
+            'after_commit' => false,
+        ],
+
+        'sqs' => [
+            'driver' => 'sqs',
+            'key' => env('AWS_ACCESS_KEY_ID'),
+            'secret' => env('AWS_SECRET_ACCESS_KEY'),
+            'prefix' => env('SQS_PREFIX', 'https://sqs.us-east-1.amazonaws.com/your-account-id'),
+            'queue' => env('SQS_QUEUE', 'default'),
+            'suffix' => env('SQS_SUFFIX'),
+            'region' => env('AWS_DEFAULT_REGION', 'us-east-1'),
+            'after_commit' => false,
+        ],
+
+        'redis' => [
+            'driver' => 'redis',
+            'connection' => env('REDIS_QUEUE_CONNECTION', 'default'),
+            'queue' => env('REDIS_QUEUE', 'default'),
+            'retry_after' => (int) env('REDIS_QUEUE_RETRY_AFTER', 90),
+            'block_for' => null,
+            'after_commit' => false,
+        ],
+
+        'deferred' => [
+            'driver' => 'deferred',
+        ],
+
+        'background' => [
+            'driver' => 'background',
+        ],
+
+        'failover' => [
+            'driver' => 'failover',
+            'connections' => [
+                'database',
+                'deferred',
+            ],
+        ],
+
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Job Batching
+    |--------------------------------------------------------------------------
+    |
+    | The following options configure the database and table that store job
+    | batching information. These options can be updated to any database
+    | connection and table which has been defined by your application.
+    |
+    */
+
+    'batching' => [
+        'database' => env('DB_CONNECTION', 'sqlite'),
+        'table' => 'job_batches',
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Failed Queue Jobs
+    |--------------------------------------------------------------------------
+    |
+    | These options configure the behavior of failed queue job logging so you
+    | can control how and where failed jobs are stored. Laravel ships with
+    | support for storing failed jobs in a simple file or in a database.
+    |
+    | Supported drivers: "database-uuids", "dynamodb", "file", "null"
+    |
+    */
+
+    'failed' => [
+        'driver' => env('QUEUE_FAILED_DRIVER', 'database-uuids'),
+        'database' => env('DB_CONNECTION', 'sqlite'),
+        'table' => 'failed_jobs',
+    ],
+
+];

config/services.php

@@ -0,0 +1,38 @@
+<?php
+
+return [
+
+    /*
+    |--------------------------------------------------------------------------
+    | Third Party Services
+    |--------------------------------------------------------------------------
+    |
+    | This file is for storing the credentials for third party services such
+    | as Mailgun, Postmark, AWS and more. This file provides the de facto
+    | location for this type of information, allowing packages to have
+    | a conventional file to locate the various service credentials.
+    |
+    */
+
+    'postmark' => [
+        'key' => env('POSTMARK_API_KEY'),
+    ],
+
+    'resend' => [
+        'key' => env('RESEND_API_KEY'),
+    ],
+
+    'ses' => [
+        'key' => env('AWS_ACCESS_KEY_ID'),
+        'secret' => env('AWS_SECRET_ACCESS_KEY'),
+        'region' => env('AWS_DEFAULT_REGION', 'us-east-1'),
+    ],
+
+    'slack' => [
+        'notifications' => [
+            'bot_user_oauth_token' => env('SLACK_BOT_USER_OAUTH_TOKEN'),
+            'channel' => env('SLACK_BOT_USER_DEFAULT_CHANNEL'),
+        ],
+    ],
+
+];

config/session.php

@@ -0,0 +1,217 @@
+<?php
+
+use Illuminate\Support\Str;
+
+return [
+
+    /*
+    |--------------------------------------------------------------------------
+    | Default Session Driver
+    |--------------------------------------------------------------------------
+    |
+    | This option determines the default session driver that is utilized for
+    | incoming requests. Laravel supports a variety of storage options to
+    | persist session data. Database storage is a great default choice.
+    |
+    | Supported: "file", "cookie", "database", "memcached",
+    |            "redis", "dynamodb", "array"
+    |
+    */
+
+    'driver' => env('SESSION_DRIVER', 'database'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Session Lifetime
+    |--------------------------------------------------------------------------
+    |
+    | Here you may specify the number of minutes that you wish the session
+    | to be allowed to remain idle before it expires. If you want them
+    | to expire immediately when the browser is closed then you may
+    | indicate that via the expire_on_close configuration option.
+    |
+    */
+
+    'lifetime' => (int) env('SESSION_LIFETIME', 120),
+
+    'expire_on_close' => env('SESSION_EXPIRE_ON_CLOSE', false),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Session Encryption
+    |--------------------------------------------------------------------------
+    |
+    | This option allows you to easily specify that all of your session data
+    | should be encrypted before it's stored. All encryption is performed
+    | automatically by Laravel and you may use the session like normal.
+    |
+    */
+
+    'encrypt' => env('SESSION_ENCRYPT', false),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Session File Location
+    |--------------------------------------------------------------------------
+    |
+    | When utilizing the "file" session driver, the session files are placed
+    | on disk. The default storage location is defined here; however, you
+    | are free to provide another location where they should be stored.
+    |
+    */
+
+    'files' => storage_path('framework/sessions'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Session Database Connection
+    |--------------------------------------------------------------------------
+    |
+    | When using the "database" or "redis" session drivers, you may specify a
+    | connection that should be used to manage these sessions. This should
+    | correspond to a connection in your database configuration options.
+    |
+    */
+
+    'connection' => env('SESSION_CONNECTION'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Session Database Table
+    |--------------------------------------------------------------------------
+    |
+    | When using the "database" session driver, you may specify the table to
+    | be used to store sessions. Of course, a sensible default is defined
+    | for you; however, you're welcome to change this to another table.
+    |
+    */
+
+    'table' => env('SESSION_TABLE', 'sessions'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Session Cache Store
+    |--------------------------------------------------------------------------
+    |
+    | When using one of the framework's cache driven session backends, you may
+    | define the cache store which should be used to store the session data
+    | between requests. This must match one of your defined cache stores.
+    |
+    | Affects: "dynamodb", "memcached", "redis"
+    |
+    */
+
+    'store' => env('SESSION_STORE'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Session Sweeping Lottery
+    |--------------------------------------------------------------------------
+    |
+    | Some session drivers must manually sweep their storage location to get
+    | rid of old sessions from storage. Here are the chances that it will
+    | happen on a given request. By default, the odds are 2 out of 100.
+    |
+    */
+
+    'lottery' => [2, 100],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Session Cookie Name
+    |--------------------------------------------------------------------------
+    |
+    | Here you may change the name of the session cookie that is created by
+    | the framework. Typically, you should not need to change this value
+    | since doing so does not grant a meaningful security improvement.
+    |
+    */
+
+    'cookie' => env(
+        'SESSION_COOKIE',
+        Str::slug((string) env('APP_NAME', 'laravel')).'-session'
+    ),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Session Cookie Path
+    |--------------------------------------------------------------------------
+    |
+    | The session cookie path determines the path for which the cookie will
+    | be regarded as available. Typically, this will be the root path of
+    | your application, but you're free to change this when necessary.
+    |
+    */
+
+    'path' => env('SESSION_PATH', '/'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Session Cookie Domain
+    |--------------------------------------------------------------------------
+    |
+    | This value determines the domain and subdomains the session cookie is
+    | available to. By default, the cookie will be available to the root
+    | domain without subdomains. Typically, this shouldn't be changed.
+    |
+    */
+
+    'domain' => env('SESSION_DOMAIN'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | HTTPS Only Cookies
+    |--------------------------------------------------------------------------
+    |
+    | By setting this option to true, session cookies will only be sent back
+    | to the server if the browser has a HTTPS connection. This will keep
+    | the cookie from being sent to you when it can't be done securely.
+    |
+    */
+
+    'secure' => env('SESSION_SECURE_COOKIE'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | HTTP Access Only
+    |--------------------------------------------------------------------------
+    |
+    | Setting this value to true will prevent JavaScript from accessing the
+    | value of the cookie and the cookie will only be accessible through
+    | the HTTP protocol. It's unlikely you should disable this option.
+    |
+    */
+
+    'http_only' => env('SESSION_HTTP_ONLY', true),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Same-Site Cookies
+    |--------------------------------------------------------------------------
+    |
+    | This option determines how your cookies behave when cross-site requests
+    | take place, and can be used to mitigate CSRF attacks. By default, we
+    | will set this value to "lax" to permit secure cross-site requests.
+    |
+    | See: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie#samesitesamesite-value
+    |
+    | Supported: "lax", "strict", "none", null
+    |
+    */
+
+    'same_site' => env('SESSION_SAME_SITE', 'lax'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Partitioned Cookies
+    |--------------------------------------------------------------------------
+    |
+    | Setting this value to true will tie the cookie to the top-level site for
+    | a cross-site context. Partitioned cookies are accepted by the browser
+    | when flagged "secure" and the Same-Site attribute is set to "none".
+    |
+    */
+
+    'partitioned' => env('SESSION_PARTITIONED_COOKIE', false),
+
+];

database/.gitignore

@@ -0,0 +1 @@
+*.sqlite*

database/factories/UserFactory.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace Database\Factories;
+
+use Illuminate\Database\Eloquent\Factories\Factory;
+use Illuminate\Support\Facades\Hash;
+use Illuminate\Support\Str;
+
+/**
+ * @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\User>
+ */
+class UserFactory extends Factory
+{
+    /**
+     * The current password being used by the factory.
+     */
+    protected static ?string $password;
+
+    /**
+     * Define the model's default state.
+     *
+     * @return array<string, mixed>
+     */
+    public function definition(): array
+    {
+        return [
+            'name' => fake()->name(),
+            'email' => fake()->unique()->safeEmail(),
+            'email_verified_at' => now(),
+            'password' => static::$password ??= Hash::make('password'),
+            'remember_token' => Str::random(10),
+        ];
+    }
+
+    /**
+     * Indicate that the model's email address should be unverified.
+     */
+    public function unverified(): static
+    {
+        return $this->state(fn (array $attributes) => [
+            'email_verified_at' => null,
+        ]);
+    }
+}

database/migrations/0001_01_01_000000_create_users_table.php

@@ -0,0 +1,49 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('users', function (Blueprint $table) {
+            $table->id();
+            $table->string('name');
+            $table->string('email')->unique();
+            $table->timestamp('email_verified_at')->nullable();
+            $table->string('password');
+            $table->rememberToken();
+            $table->timestamps();
+        });
+
+        Schema::create('password_reset_tokens', function (Blueprint $table) {
+            $table->string('email')->primary();
+            $table->string('token');
+            $table->timestamp('created_at')->nullable();
+        });
+
+        Schema::create('sessions', function (Blueprint $table) {
+            $table->string('id')->primary();
+            $table->foreignId('user_id')->nullable()->index();
+            $table->string('ip_address', 45)->nullable();
+            $table->text('user_agent')->nullable();
+            $table->longText('payload');
+            $table->integer('last_activity')->index();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('users');
+        Schema::dropIfExists('password_reset_tokens');
+        Schema::dropIfExists('sessions');
+    }
+};

database/migrations/0001_01_01_000001_create_cache_table.php

@@ -0,0 +1,35 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('cache', function (Blueprint $table) {
+            $table->string('key')->primary();
+            $table->mediumText('value');
+            $table->integer('expiration')->index();
+        });
+
+        Schema::create('cache_locks', function (Blueprint $table) {
+            $table->string('key')->primary();
+            $table->string('owner');
+            $table->integer('expiration')->index();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('cache');
+        Schema::dropIfExists('cache_locks');
+    }
+};

database/migrations/0001_01_01_000002_create_jobs_table.php

@@ -0,0 +1,57 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('jobs', function (Blueprint $table) {
+            $table->id();
+            $table->string('queue')->index();
+            $table->longText('payload');
+            $table->unsignedTinyInteger('attempts');
+            $table->unsignedInteger('reserved_at')->nullable();
+            $table->unsignedInteger('available_at');
+            $table->unsignedInteger('created_at');
+        });
+
+        Schema::create('job_batches', function (Blueprint $table) {
+            $table->string('id')->primary();
+            $table->string('name');
+            $table->integer('total_jobs');
+            $table->integer('pending_jobs');
+            $table->integer('failed_jobs');
+            $table->longText('failed_job_ids');
+            $table->mediumText('options')->nullable();
+            $table->integer('cancelled_at')->nullable();
+            $table->integer('created_at');
+            $table->integer('finished_at')->nullable();
+        });
+
+        Schema::create('failed_jobs', function (Blueprint $table) {
+            $table->id();
+            $table->string('uuid')->unique();
+            $table->text('connection');
+            $table->text('queue');
+            $table->longText('payload');
+            $table->longText('exception');
+            $table->timestamp('failed_at')->useCurrent();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('jobs');
+        Schema::dropIfExists('job_batches');
+        Schema::dropIfExists('failed_jobs');
+    }
+};

database/seeders/DatabaseSeeder.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace Database\Seeders;
+
+use App\Models\User;
+use Illuminate\Database\Console\Seeds\WithoutModelEvents;
+use Illuminate\Database\Seeder;
+
+class DatabaseSeeder extends Seeder
+{
+    use WithoutModelEvents;
+
+    /**
+     * Seed the application's database.
+     */
+    public function run(): void
+    {
+        // User::factory(10)->create();
+
+        User::factory()->create([
+            'name' => 'Test User',
+            'email' => 'test@example.com',
+        ]);
+    }
+}

package.json

@@ -0,0 +1,17 @@
+{
+    "$schema": "https://www.schemastore.org/package.json",
+    "private": true,
+    "type": "module",
+    "scripts": {
+        "build": "vite build",
+        "dev": "vite"
+    },
+    "devDependencies": {
+        "@tailwindcss/vite": "^4.0.0",
+        "axios": "^1.11.0",
+        "concurrently": "^9.0.1",
+        "laravel-vite-plugin": "^2.0.0",
+        "tailwindcss": "^4.0.0",
+        "vite": "^7.0.7"
+    }
+}

phpunit.xml

@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:noNamespaceSchemaLocation="vendor/phpunit/phpunit/phpunit.xsd"
+         bootstrap="vendor/autoload.php"
+         colors="true"
+>
+    <testsuites>
+        <testsuite name="Unit">
+            <directory>tests/Unit</directory>
+        </testsuite>
+        <testsuite name="Feature">
+            <directory>tests/Feature</directory>
+        </testsuite>
+    </testsuites>
+    <source>
+        <include>
+            <directory>app</directory>
+        </include>
+    </source>
+    <php>
+        <env name="APP_ENV" value="testing"/>
+        <env name="APP_MAINTENANCE_DRIVER" value="file"/>
+        <env name="BCRYPT_ROUNDS" value="4"/>
+        <env name="BROADCAST_CONNECTION" value="null"/>
+        <env name="CACHE_STORE" value="array"/>
+        <env name="DB_CONNECTION" value="sqlite"/>
+        <env name="DB_DATABASE" value=":memory:"/>
+        <env name="MAIL_MAILER" value="array"/>
+        <env name="QUEUE_CONNECTION" value="sync"/>
+        <env name="SESSION_DRIVER" value="array"/>
+        <env name="PULSE_ENABLED" value="false"/>
+        <env name="TELESCOPE_ENABLED" value="false"/>
+        <env name="NIGHTWATCH_ENABLED" value="false"/>
+    </php>
+</phpunit>

public/.htaccess

@@ -0,0 +1,25 @@
+<IfModule mod_rewrite.c>
+    <IfModule mod_negotiation.c>
+        Options -MultiViews -Indexes
+    </IfModule>
+
+    RewriteEngine On
+
+    # Handle Authorization Header
+    RewriteCond %{HTTP:Authorization} .
+    RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
+
+    # Handle X-XSRF-Token Header
+    RewriteCond %{HTTP:x-xsrf-token} .
+    RewriteRule .* - [E=HTTP_X_XSRF_TOKEN:%{HTTP:X-XSRF-Token}]
+
+    # Redirect Trailing Slashes If Not A Folder...
+    RewriteCond %{REQUEST_FILENAME} !-d
+    RewriteCond %{REQUEST_URI} (.+)/$
+    RewriteRule ^ %1 [L,R=301]
+
+    # Send Requests To Front Controller...
+    RewriteCond %{REQUEST_FILENAME} !-d
+    RewriteCond %{REQUEST_FILENAME} !-f
+    RewriteRule ^ index.php [L]
+</IfModule>

public/index.php

@@ -0,0 +1,20 @@
+<?php
+
+use Illuminate\Foundation\Application;
+use Illuminate\Http\Request;
+
+define('LARAVEL_START', microtime(true));
+
+// Determine if the application is in maintenance mode...
+if (file_exists($maintenance = __DIR__.'/../storage/framework/maintenance.php')) {
+    require $maintenance;
+}
+
+// Register the Composer autoloader...
+require __DIR__.'/../vendor/autoload.php';
+
+// Bootstrap Laravel and handle the request...
+/** @var Application $app */
+$app = require_once __DIR__.'/../bootstrap/app.php';
+
+$app->handleRequest(Request::capture());

public/robots.txt

@@ -0,0 +1,2 @@
+User-agent: *
+Disallow:

public/vfn/45ef8df76816cab9/20260203-v2ray.txt

@@ -0,0 +1 @@
+dmxlc3M6Ly9lNTkwODNhYS1kOTMzLTQ5NTItOGNmMC1lZWM3NGY3MTg3MDVAZnIubG9jYXRpb25zLXNlcnZpY2UuY29tOjMwMzI/c2VjdXJpdHk9cmVhbGl0eSZ0eXBlPXRjcCZzbmk9cmVmZXJzaW9uLmNvbSZmcD1jaHJvbWUmcGJrPTIxVl9Wa01VRDJYUmJ5UkRnN2hqcGJsVUF3eEh2bExtYmFyQVRkaGhKUUkmZW5jcnlwdGlvbj1ub25lIyVFNiVBRiU4RiVFNSVBNCVBOSVFNiU5QiVCNCVFNiU5NiVCMCVFNSU4NSU4RCVFOCVCNCVCOSVFOCU4QSU4MiVFNyU4MiVCOSVFRiVCQyU5QWZuLWIubG9jCnZsZXNzOi8vZTU5MDgzYWEtZDkzMy00OTUyLThjZjAtZWVjNzRmNzE4NzA1QGZyLmxvY2F0aW9ucy1zZXJ2aWNlLmNvbTozMDMyP3NlY3VyaXR5PXJlYWxpdHkmdHlwZT10Y3Amc25pPXJlZmVyc2lvbi5jb20mZnA9Y2hyb21lJnBiaz0yMVZfVmtNVUQyWFJieVJEZzdoanBibFVBd3hIdmxMbWJhckFUZGhoSlFJJmVuY3J5cHRpb249bm9uZSN0ZyVFOSVBMiU5MSVFOSU4MSU5MyVFRiVCQyU5QSU0MHR0dHRnZ2dnCnZsZXNzOi8vZTU5MDgzYWEtZDkzMy00OTUyLThjZjAtZWVjNzRmNzE4NzA1QGZyLmxvY2F0aW9ucy1zZXJ2aWNlLmNvbTozMDMyP3NlY3VyaXR5PXJlYWxpdHkmdHlwZT10Y3Amc25pPXJlZmVyc2lvbi5jb20mZnA9Y2hyb21lJnBiaz0yMVZfVmtNVUQyWFJieVJEZzdoanBibFVBd3hIdmxMbWJhckFUZGhoSlFJJmVuY3J5cHRpb249bm9uZSMlRTYlOUIlQjQlRTYlOTYlQjAlRTQlQkElOEUlRUYlQkMlOUEyMDI2LTAyLTAzJTIwMDclM0ExNCUzQTA3Cu+7v3ZsZXNzOi8vM2UyZTNjMjEtM2ZjOC00NjhmLTlhYjUtZTc4MmJkZjViZjk3QDE2Mi4xNTkuNDQuMTQyOjQ0Mz9zZWN1cml0eT10bHMmdHlwZT13cyZwYXRoPS94LWFuaXUvJmhvc3Q9bC5heW92by5uZXRsaWIucmUmc25pPWwuYXlvdm8ubmV0bGliLnJlJmZwPWNocm9tZSZlbmNyeXB0aW9uPW5vbmUjJUU1JThFJTlGJUU3JTk0JTlGJUU2JTlDJUJBJUU2JTg4JUJGJTIwMDEKdmxlc3M6Ly8xNTIzNWNlOS00Y2QyLTQ0ODMtYjZiNi03ZmM0YTNmNDQ3MzVAMTczLjI0NS41OS4yMjA6NDQzP3NlY3VyaXR5PXRscyZ0eXBlPXdzJnBhdGg9Lz9lZD0yNTYwJmhvc3Q9c25pcC5lcmUuZGU1Lm5ldCZzbmk9c25pcC5lcmUuZGU1Lm5ldCZmcD1yYW5kb20jJUYwJTlGJTg3JUJBJUYwJTlGJTg3JUI4VVMlQzIlQjklRTIlODElQkFfMiU3QzYuNU1CJTJGcyU3Q0QlMkIlN0NYJTIwMDEKdmxlc3M6Ly9lZWFhMDdjYS0yNjkzLTQyZjgtZTU0NC1hMTY1MjFkOGU5MjJAMjAyNi4wMS4xLmtyLmFpbWlycm9yLnRvcDo0NDM/c2VjdXJpdHk9cmVhbGl0eSZ0eXBlPXRjcCZzbmk9d3d3LmljbG91ZC5jb20mZnA9c2FmYXJpJmZsb3c9eHRscy1ycHJ4LXZpc2lvbiZwYms9U1hxRXE2WmhvbER3QWNaUmpWLUU0SWpDUF9xVU5lRGNuenJvUTRsd29BOCMlRjAlOUYlODclQjAlRjAlOUYlODclQjdLUiVDMiVCMl8xJTdDOS4zTUIlMkZzJTdDRCUyQiU3Q1glMjAwMQp2bGVzczovLzE1MjM1Y2U5LTRjZDItNDQ4My1iNmI2LTdmYzRhM2Y0NDczNUAxMDguMTYyLjE5OC4zODo0NDM/c2VjdXJpdHk9dGxzJnR5cGU9d3MmcGF0aD0vP2VkPTI1NjAmaG9zdD1zbmlwLmVyZS5kZTUubmV0JnNuaT1zbmlwLmVyZS5kZTUubmV0JmZwPXJhbmRvbSMlRjAlOUYlODclQjglRjAlOUYlODclQUNTRyVDMiVCMl8xJTdDOS44TUIlMkZzJTdDWCU3Q0hpc3RvcnklMjAwMQp2bGVzczovLzUxN2M3NzZlLWFmYmYtNDc0OS05NjQzLTczYzNlYTI2YjkwNUAxOTIuMjAwLjE2MC45OjIwODM/c2VjdXJpdHk9dGxzJnR5cGU9d3MmcGF0aD0vJmhvc3Q9eGl6MjAud2l6YXJkMnNob3Aub3JnJnNuaT14aXoyMC53aXphcmQyc2hvcC5vcmcmZnA9Y2hyb21lJmVuY3J5cHRpb249bm9uZSMlRjAlOUYlODclQjMlRjAlOUYlODclQjFOTCVDMiVCMl8xJTdDMS4yTUIlMkZzJTdDWCUyMDAxCnZtZXNzOi8veyJ2IjoiMiIsInBzIjoiIiwiYWRkIjoiNjEuMTUuNjAuMTUzIiwicG9ydCI6IjUyMDgwIiwiaWQiOiJiZmI0Nzg0Ni1hZWRiLTRlYTMtYTgxZi0yNzg5NWE0ZWMxYmIiLCJhaWQiOiIwIiwic2N5IjoiYXV0byIsIm5ldCI6InRjcCIsInR5cGUiOiJodHRwIiwidGxzIjoiIiwicGF0aCI6IlwvUVFxdW4tNzM3ODA1NDQzIn0jJUU1JThFJTlGJUU3JTk0JTlGJUU0JUJEJThGJUU1JUFFJTg1JTIwMDEKdmxlc3M6Ly9lNTkwODNhYS1kOTMzLTQ5NTItOGNmMC1lZWM3NGY3MTg3MDVAZnIubG9jYXRpb25zLXNlcnZpY2UuY29tOjMwMzI/c2VjdXJpdHk9cmVhbGl0eSZ0eXBlPXRjcCZzbmk9cmVmZXJzaW9uLmNvbSZmcD1jaHJvbWUmcGJrPTIxVl9Wa01VRDJYUmJ5UkRnN2hqcGJsVUF3eEh2bExtYmFyQVRkaGhKUUkmZW5jcnlwdGlvbj1ub25lIyVGMCU5RiU4NyVBQiVGMCU5RiU4NyVCN0ZSJUMyJUIyXzElN0MyLjBNQiUyRnMlN0NYJTdDSGlzdG9yeSUyMDAx

public/vfn/5832ae1cb93a5d6e/20260204-v2ray.txt

@@ -0,0 +1 @@
+c29ja3M6Ly9PZz09QDEyMS4xNjkuNDYuMTE2OjEwOTAjJUU2JUFGJThGJUU1JUE0JUE5JUU2JTlCJUI0JUU2JTk2JUIwJUU1JTg1JThEJUU4JUI0JUI5JUU4JThBJTgyJUU3JTgyJUI5JUVGJUJDJTlBZm4tYi5sb2MKc29ja3M6Ly9PZz09QDEyMS4xNjkuNDYuMTE2OjEwOTAjdGclRTklQTIlOTElRTklODElOTMlRUYlQkMlOUElNDB0dHR0Z2dnZwpzb2NrczovL09nPT1AMTIxLjE2OS40Ni4xMTY6MTA5MCMlRTYlOUIlQjQlRTYlOTYlQjAlRTQlQkElOEUlRUYlQkMlOUEyMDI2LTAyLTA0JTIwMTElM0EzNiUzQTU5CnNzOi8vWTJoaFkyaGhNakF0YVdWMFpqcGhjMlF4TWpNME5UWT1AMTAzLjE0OS4xODMuMTI6ODM4OCMlRTklQTYlOTklRTYlQjglQUYlMjAwMQpzb2NrczovL1QyY2xNMFFsTTBRNkAxMjEuMTY5LjQ2LjExNjoxMDkwIyVGMCU5RiU4NyVCMCVGMCU5RiU4NyVCN0tSJUMyJUIyXzIlN0MxLjRNQiUyRnMlN0NHUFQlRTIlODElQkElN0NYJTdDU3VjY2VlZCUyMDAxCnZsZXNzOi8vNTZkMWQzNTUtOTJjOS00YTljLTkxZTQtMzI3ZDI5ZDlhODJmQHNlLnJha3NsaW5ldnBuLnN1OjQ0Mz9zZWN1cml0eT1yZWFsaXR5JnR5cGU9dGNwJnNuaT1zZS5yYWtzbGluZXZwbi5zdSZmcD1jaHJvbWUmZmxvdz14dGxzLXJwcngtdmlzaW9uJnNpZD1kMGQ2NjA3YmM4NzBjMjAyJnBiaz01U2VsRlZQT1dwNHhDRmJBcXUxZ3dZQUhlUm93emhjWWxTUndjYkhhaFJRJmVuY3J5cHRpb249bm9uZSMlRTUlQjklQkYlRTYlOTIlQUQlRTUlOTUlODYlRTUlQUUlQkQlMjAwMQpzczovL1lXVnpMVEkxTmkxalptSTZjWGRsY2xKRlYxRkFRQT09QDEyNS4xNDEuMjYuMTU6NDgwNDEjJUYwJTlGJTg3JUIwJUYwJTlGJTg3JUI3S1IlQzIlQjJfMyU3QzguOU1CJTJGcyU3QzIlMjUlN0NHUFQlN0NORiU3Q1glN0NTdWNjZWVkJTIwMDEKc3M6Ly9ZMmhoWTJoaE1qQXRhV1YwWmpwaGMyUXhNak0wTlRZPUAxMDMuMzYuOTEuMzI6ODM4OCMlRjAlOUYlODclQjglRjAlOUYlODclQUNTRyVDMiVCMl8xJTdDNi44TUIlMkZzJTdDMCUyNSU3Q1glN0NIaXN0b3J5JTIwMDEKaHlzdGVyaWEyOi8vZTcyYjU0ZGYtM2M0NS00ODU2LWJjZjktYmYzZTFiZjZmZjVlQDEzNC4xOTUuMTAxLjE5MTo0NDM/aW5zZWN1cmU9MSZzbmk9d3d3LmFwcGxlLmNvbSMlRjAlOUYlODclQkElRjAlOUYlODclQjhVUyVDMiVCMl8xJTdDMi4zTUIlMkZzJTdDMCUyNSU3Q0dQVCVFMiU4MSVCQSU3Q0dNJTdDTkYlN0NYJTdDU3VjY2VlZCUyMDAxCnZsZXNzOi8vMjU4YmFkOTEtNzMzYS00ZTZhLTk2ZjQtMTE1NjhiOTdjMDRhQDIwOC4xMDMuMTYxLjExMDo0NDM/c2VjdXJpdHk9dGxzJnR5cGU9d3MmcGF0aD0vd3MmaG9zdD1yQXlBbi1jT25GaUctZGUtMS5wQXJTYS5kUGROcy5vUmcmc25pPXJBeUFuLWNPbkZpRy1kZS0xLnBBclNhLmRQZE5zLm9SZyZmcD1jaHJvbWUmZW5jcnlwdGlvbj1ub25lIyVFNSVCOSVCRiVFNiU5MiVBRCVFNiU5QyVCQSVFNiU4OCVCRiUyMDAxCnNzOi8vWVdWekxUSTFOaTFqWm1JNldHNDRha3RrYlVSTk1EQkpaVThsSXlRalprcEJUWFJ6UlVGRlZVOXdTQzlaVjFsMFdYRkVSbTVVTUZOV0AxMDMuMTg2LjE1NC41MjozODM4OCMlRTUlOEUlOUYlRTclOTQlOUYlRTYlOUMlQkElRTYlODglQkYlMjAwMQpzczovL1kyaGhZMmhoTWpBdGFXVjBaaTF3YjJ4NU1UTXdOVG8yTm1ZNE9UWXlNUzAwT1dZd0xUUTNPRGd0T0RWalpTMW1PV0UyTWpVek4yRTRaVFE9QDEyMC4yMzMuNDEuNzA6NDg4MDIjJUYwJTlGJTg3JUFGJUYwJTlGJTg3JUI1SlAlQzIlQjJfMSU3QzMuOU1CJTJGcyU3Q0dQVCVFMiU4MSVCQSU3Q1lUJTdDTkYlN0NEJTJCJTdDWCUyMDAxCnZsZXNzOi8vMDQ3OTNkNWItMWI3OS00OWZjLWI1ZjktMmU4Y2UwZTNlYmM2QGhpbmV0Mi5nemNsb3VkLnNob3A6MjA1MTk/c2VjdXJpdHk9cmVhbGl0eSZ0eXBlPXRjcCZzbmk9YnV5bGl0ZS5tdXNpYy5hcHBsZS5jb20mZnA9Y2hyb21lJmZsb3c9eHRscy1ycHJ4LXZpc2lvbiZzaWQ9NGIwNzA3MzUmcGJrPWZiQUJ6VU9iTTFlaFkwQzlWODNwMzRwOGFoOXcyczRsRHJkQWlYZHpHeEkmZW5jcnlwdGlvbj1ub25lIyVGMCU5RiU4NyVCOSVGMCU5RiU4NyVCQ1RXJUMyJUIyXzElN0M3LjRNQiUyRnMlN0NHUFQlN0NZVCU3Q05GJTdDRCUyQiU3Q1glN0NTdWNjZWVkJTIwMDEKdmxlc3M6Ly9mODhjODNhZC1jMWVhLTQ2NGEtYmM4ZC00YjNmNWJmNDhkMTRAMTUyLjUzLjE4Mi4yMzU6NDQzP3NlY3VyaXR5PXJlYWxpdHkmdHlwZT10Y3Amc25pPWxpdmUuY29tJmZwPWNocm9tZSZmbG93PXh0bHMtcnByeC12aXNpb24mcGJrPWNrUmN1ZUVSa1BxcWpaQUJ3eHFuaV9KX05iYjcwUTZrNWZFRVVBam9JbXcmZW5jcnlwdGlvbj1ub25lIyVGMCU5RiU4NyVBNiVGMCU5RiU4NyVCOUFUJUMyJUIyXzElN0M1LjhNQiUyRnMlN0NHUFQlRTIlODElQkElN0NZVC1SVSU3Q0QlMkIlN0NYJTdDU3VjY2VlZCUyMDAxCnZsZXNzOi8vMjU4YmFkOTEtNzMzYS00ZTZhLTk2ZjQtMTE1NjhiOTdjMDRhQDE5NC43Ni4xOC4yNTo0NDM/c2VjdXJpdHk9dGxzJnR5cGU9d3MmcGF0aD0vd3MmaG9zdD1yQXlBbi1jT25GaUctZGUtMS5wQXJTYS5kUGROcy5vUmcmc25pPXJBeUFuLWNPbkZpRy1kZS0xLnBBclNhLmRQZE5zLm9SZyZmcD1jaHJvbWUjJUYwJTlGJTg3JUE5JUYwJTlGJTg3JUFBREUlQzIlQjJfMyU3QzYuNk1CJTJGcyU3QzQ5JTI1JTdDWCU3Q1N1Y2NlZWQlMjAwMQpzczovL1lXVnpMVEkxTmkxalptSTZXRzQ0YWt0a2JVUk5NREJKWlU4bEl5UWpaa3BCVFhSelJVRkZWVTl3U0M5WlYxbDBXWEZFUm01VU1GTldAMTAzLjE4Ni4xNTUuMTA4OjM4Mzg4IyVGMCU5RiU4NyVCQiVGMCU5RiU4NyVCM1ZOJUMyJUIyXzIlN0MyLjlNQiUyRnMlN0NHUFQlRTIlODElQkElN0NHTSU3Q1glN0NTdWNjZWVkJTIwMDEKc29ja3M6Ly9PZz09QDEyMS4xNjkuNDYuMTE2OjEwOTAjJUYwJTlGJTg3JUIwJUYwJTlGJTg3JUI3S1IlQzIlQjJfNCU3QzAuOE1CJTJGcyU3Q0dQVCU3Q1glN0NIaXN0b3J5JTIwMDE=

resources/css/app.css

@@ -0,0 +1,11 @@
+@import 'tailwindcss';
+
+@source '../../vendor/laravel/framework/src/Illuminate/Pagination/resources/views/*.blade.php';
+@source '../../storage/framework/views/*.php';
+@source '../**/*.blade.php';
+@source '../**/*.js';
+
+@theme {
+    --font-sans: 'Instrument Sans', ui-sans-serif, system-ui, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji',
+        'Segoe UI Symbol', 'Noto Color Emoji';
+}

resources/js/app.js

@@ -0,0 +1 @@
+import './bootstrap';

resources/js/bootstrap.js

@@ -0,0 +1,4 @@
+import axios from 'axios';
+window.axios = axios;
+
+window.axios.defaults.headers.common['X-Requested-With'] = 'XMLHttpRequest';

routes/console.php

@@ -0,0 +1,8 @@
+<?php
+
+use Illuminate\Foundation\Inspiring;
+use Illuminate\Support\Facades\Artisan;
+
+Artisan::command('inspire', function () {
+    $this->comment(Inspiring::quote());
+})->purpose('Display an inspiring quote');

routes/web.php

@@ -0,0 +1,10 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+use App\Http\Controllers\Api\v1\FreenodeController as ApiFreenodeController;
+
+Route::get('/', function () {
+    return view('welcome');
+});
+
+Route::post('/api/freenode/file/put', [ApiFreenodeController::class, 'filePut']);

storage/app/.gitignore

@@ -0,0 +1,4 @@
+*
+!private/
+!public/
+!.gitignore

storage/app/private/.gitignore

@@ -0,0 +1,2 @@
+*
+!.gitignore

storage/app/public/.gitignore

@@ -0,0 +1,2 @@
+*
+!.gitignore

storage/framework/.gitignore

@@ -0,0 +1,9 @@
+compiled.php
+config.php
+down
+events.scanned.php
+maintenance.php
+routes.php
+routes.scanned.php
+schedule-*
+services.json

storage/framework/cache/.gitignore

@@ -0,0 +1,3 @@
+*
+!data/
+!.gitignore

storage/framework/cache/data/.gitignore

@@ -0,0 +1,2 @@
+*
+!.gitignore

storage/framework/sessions/.gitignore

@@ -0,0 +1,2 @@
+*
+!.gitignore

storage/framework/testing/.gitignore

@@ -0,0 +1,2 @@
+*
+!.gitignore

storage/framework/views/.gitignore

@@ -0,0 +1,2 @@
+*
+!.gitignore

storage/logs/.gitignore

@@ -0,0 +1,2 @@
+*
+!.gitignore

tests/Feature/ExampleTest.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace Tests\Feature;
+
+// use Illuminate\Foundation\Testing\RefreshDatabase;
+use Tests\TestCase;
+
+class ExampleTest extends TestCase
+{
+    /**
+     * A basic test example.
+     */
+    public function test_the_application_returns_a_successful_response(): void
+    {
+        $response = $this->get('/');
+
+        $response->assertStatus(200);
+    }
+}

tests/TestCase.php

@@ -0,0 +1,10 @@
+<?php
+
+namespace Tests;
+
+use Illuminate\Foundation\Testing\TestCase as BaseTestCase;
+
+abstract class TestCase extends BaseTestCase
+{
+    //
+}

tests/Unit/ExampleTest.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace Tests\Unit;
+
+use PHPUnit\Framework\TestCase;
+
+class ExampleTest extends TestCase
+{
+    /**
+     * A basic test example.
+     */
+    public function test_that_true_is_true(): void
+    {
+        $this->assertTrue(true);
+    }
+}

vendor/autoload.php

@@ -0,0 +1,25 @@
+<?php
+
+// autoload.php @generated by Composer
+
+if (PHP_VERSION_ID < 50600) {
+    if (!headers_sent()) {
+        header('HTTP/1.1 500 Internal Server Error');
+    }
+    $err = 'Composer 2.3.0 dropped support for autoloading on PHP <5.6 and you are running '.PHP_VERSION.', please upgrade PHP or use Composer 2.2 LTS via "composer self-update --2.2". Aborting.'.PHP_EOL;
+    if (!ini_get('display_errors')) {
+        if (PHP_SAPI === 'cli' || PHP_SAPI === 'phpdbg') {
+            fwrite(STDERR, $err);
+        } elseif (!headers_sent()) {
+            echo $err;
+        }
+    }
+    trigger_error(
+        $err,
+        E_USER_ERROR
+    );
+}
+
+require_once __DIR__ . '/composer/autoload_real.php';
+
+return ComposerAutoloaderInitc514d8f7b9fc5970bdd94287905ef584::getLoader();

vendor/bin/carbon

@@ -0,0 +1,119 @@
+#!/usr/bin/env php
+<?php
+
+/**
+ * Proxy PHP file generated by Composer
+ *
+ * This file includes the referenced bin path (../nesbot/carbon/bin/carbon)
+ * using a stream wrapper to prevent the shebang from being output on PHP<8
+ *
+ * @generated
+ */
+
+namespace Composer;
+
+$GLOBALS['_composer_bin_dir'] = __DIR__;
+$GLOBALS['_composer_autoload_path'] = __DIR__ . '/..'.'/autoload.php';
+
+if (PHP_VERSION_ID < 80000) {
+    if (!class_exists('Composer\BinProxyWrapper')) {
+        /**
+         * @internal
+         */
+        final class BinProxyWrapper
+        {
+            private $handle;
+            private $position;
+            private $realpath;
+
+            public function stream_open($path, $mode, $options, &$opened_path)
+            {
+                // get rid of phpvfscomposer:// prefix for __FILE__ & __DIR__ resolution
+                $opened_path = substr($path, 17);
+                $this->realpath = realpath($opened_path) ?: $opened_path;
+                $opened_path = $this->realpath;
+                $this->handle = fopen($this->realpath, $mode);
+                $this->position = 0;
+
+                return (bool) $this->handle;
+            }
+
+            public function stream_read($count)
+            {
+                $data = fread($this->handle, $count);
+
+                if ($this->position === 0) {
+                    $data = preg_replace('{^#!.*\r?\n}', '', $data);
+                }
+
+                $this->position += strlen($data);
+
+                return $data;
+            }
+
+            public function stream_cast($castAs)
+            {
+                return $this->handle;
+            }
+
+            public function stream_close()
+            {
+                fclose($this->handle);
+            }
+
+            public function stream_lock($operation)
+            {
+                return $operation ? flock($this->handle, $operation) : true;
+            }
+
+            public function stream_seek($offset, $whence)
+            {
+                if (0 === fseek($this->handle, $offset, $whence)) {
+                    $this->position = ftell($this->handle);
+                    return true;
+                }
+
+                return false;
+            }
+
+            public function stream_tell()
+            {
+                return $this->position;
+            }
+
+            public function stream_eof()
+            {
+                return feof($this->handle);
+            }
+
+            public function stream_stat()
+            {
+                return array();
+            }
+
+            public function stream_set_option($option, $arg1, $arg2)
+            {
+                return true;
+            }
+
+            public function url_stat($path, $flags)
+            {
+                $path = substr($path, 17);
+                if (file_exists($path)) {
+                    return stat($path);
+                }
+
+                return false;
+            }
+        }
+    }
+
+    if (
+        (function_exists('stream_get_wrappers') && in_array('phpvfscomposer', stream_get_wrappers(), true))
+        || (function_exists('stream_wrapper_register') && stream_wrapper_register('phpvfscomposer', 'Composer\BinProxyWrapper'))
+    ) {
+        return include("phpvfscomposer://" . __DIR__ . '/..'.'/nesbot/carbon/bin/carbon');
+    }
+}
+
+return include __DIR__ . '/..'.'/nesbot/carbon/bin/carbon';

vendor/bin/patch-type-declarations

@@ -0,0 +1,119 @@
+#!/usr/bin/env php
+<?php
+
+/**
+ * Proxy PHP file generated by Composer
+ *
+ * This file includes the referenced bin path (../symfony/error-handler/Resources/bin/patch-type-declarations)
+ * using a stream wrapper to prevent the shebang from being output on PHP<8
+ *
+ * @generated
+ */
+
+namespace Composer;
+
+$GLOBALS['_composer_bin_dir'] = __DIR__;
+$GLOBALS['_composer_autoload_path'] = __DIR__ . '/..'.'/autoload.php';
+
+if (PHP_VERSION_ID < 80000) {
+    if (!class_exists('Composer\BinProxyWrapper')) {
+        /**
+         * @internal
+         */
+        final class BinProxyWrapper
+        {
+            private $handle;
+            private $position;
+            private $realpath;
+
+            public function stream_open($path, $mode, $options, &$opened_path)
+            {
+                // get rid of phpvfscomposer:// prefix for __FILE__ & __DIR__ resolution
+                $opened_path = substr($path, 17);
+                $this->realpath = realpath($opened_path) ?: $opened_path;
+                $opened_path = $this->realpath;
+                $this->handle = fopen($this->realpath, $mode);
+                $this->position = 0;
+
+                return (bool) $this->handle;
+            }
+
+            public function stream_read($count)
+            {
+                $data = fread($this->handle, $count);
+
+                if ($this->position === 0) {
+                    $data = preg_replace('{^#!.*\r?\n}', '', $data);
+                }
+
+                $this->position += strlen($data);
+
+                return $data;
+            }
+
+            public function stream_cast($castAs)
+            {
+                return $this->handle;
+            }
+
+            public function stream_close()
+            {
+                fclose($this->handle);
+            }
+
+            public function stream_lock($operation)
+            {
+                return $operation ? flock($this->handle, $operation) : true;
+            }
+
+            public function stream_seek($offset, $whence)
+            {
+                if (0 === fseek($this->handle, $offset, $whence)) {
+                    $this->position = ftell($this->handle);
+                    return true;
+                }
+
+                return false;
+            }
+
+            public function stream_tell()
+            {
+                return $this->position;
+            }
+
+            public function stream_eof()
+            {
+                return feof($this->handle);
+            }
+
+            public function stream_stat()
+            {
+                return array();
+            }
+
+            public function stream_set_option($option, $arg1, $arg2)
+            {
+                return true;
+            }
+
+            public function url_stat($path, $flags)
+            {
+                $path = substr($path, 17);
+                if (file_exists($path)) {
+                    return stat($path);
+                }
+
+                return false;
+            }
+        }
+    }
+
+    if (
+        (function_exists('stream_get_wrappers') && in_array('phpvfscomposer', stream_get_wrappers(), true))
+        || (function_exists('stream_wrapper_register') && stream_wrapper_register('phpvfscomposer', 'Composer\BinProxyWrapper'))
+    ) {
+        return include("phpvfscomposer://" . __DIR__ . '/..'.'/symfony/error-handler/Resources/bin/patch-type-declarations');
+    }
+}
+
+return include __DIR__ . '/..'.'/symfony/error-handler/Resources/bin/patch-type-declarations';

vendor/bin/php-parse

@@ -0,0 +1,119 @@
+#!/usr/bin/env php
+<?php
+
+/**
+ * Proxy PHP file generated by Composer
+ *
+ * This file includes the referenced bin path (../nikic/php-parser/bin/php-parse)
+ * using a stream wrapper to prevent the shebang from being output on PHP<8
+ *
+ * @generated
+ */
+
+namespace Composer;
+
+$GLOBALS['_composer_bin_dir'] = __DIR__;
+$GLOBALS['_composer_autoload_path'] = __DIR__ . '/..'.'/autoload.php';
+
+if (PHP_VERSION_ID < 80000) {
+    if (!class_exists('Composer\BinProxyWrapper')) {
+        /**
+         * @internal
+         */
+        final class BinProxyWrapper
+        {
+            private $handle;
+            private $position;
+            private $realpath;
+
+            public function stream_open($path, $mode, $options, &$opened_path)
+            {
+                // get rid of phpvfscomposer:// prefix for __FILE__ & __DIR__ resolution
+                $opened_path = substr($path, 17);
+                $this->realpath = realpath($opened_path) ?: $opened_path;
+                $opened_path = $this->realpath;
+                $this->handle = fopen($this->realpath, $mode);
+                $this->position = 0;
+
+                return (bool) $this->handle;
+            }
+
+            public function stream_read($count)
+            {
+                $data = fread($this->handle, $count);
+
+                if ($this->position === 0) {
+                    $data = preg_replace('{^#!.*\r?\n}', '', $data);
+                }
+
+                $this->position += strlen($data);
+
+                return $data;
+            }
+
+            public function stream_cast($castAs)
+            {
+                return $this->handle;
+            }
+
+            public function stream_close()
+            {
+                fclose($this->handle);
+            }
+
+            public function stream_lock($operation)
+            {
+                return $operation ? flock($this->handle, $operation) : true;
+            }
+
+            public function stream_seek($offset, $whence)
+            {
+                if (0 === fseek($this->handle, $offset, $whence)) {
+                    $this->position = ftell($this->handle);
+                    return true;
+                }
+
+                return false;
+            }
+
+            public function stream_tell()
+            {
+                return $this->position;
+            }
+
+            public function stream_eof()
+            {
+                return feof($this->handle);
+            }
+
+            public function stream_stat()
+            {
+                return array();
+            }
+
+            public function stream_set_option($option, $arg1, $arg2)
+            {
+                return true;
+            }
+
+            public function url_stat($path, $flags)
+            {
+                $path = substr($path, 17);
+                if (file_exists($path)) {
+                    return stat($path);
+                }
+
+                return false;
+            }
+        }
+    }
+
+    if (
+        (function_exists('stream_get_wrappers') && in_array('phpvfscomposer', stream_get_wrappers(), true))
+        || (function_exists('stream_wrapper_register') && stream_wrapper_register('phpvfscomposer', 'Composer\BinProxyWrapper'))
+    ) {
+        return include("phpvfscomposer://" . __DIR__ . '/..'.'/nikic/php-parser/bin/php-parse');
+    }
+}
+
+return include __DIR__ . '/..'.'/nikic/php-parser/bin/php-parse';

vendor/bin/phpunit

@@ -0,0 +1,122 @@
+#!/usr/bin/env php
+<?php
+
+/**
+ * Proxy PHP file generated by Composer
+ *
+ * This file includes the referenced bin path (../phpunit/phpunit/phpunit)
+ * using a stream wrapper to prevent the shebang from being output on PHP<8
+ *
+ * @generated
+ */
+
+namespace Composer;
+
+$GLOBALS['_composer_bin_dir'] = __DIR__;
+$GLOBALS['_composer_autoload_path'] = __DIR__ . '/..'.'/autoload.php';
+$GLOBALS['__PHPUNIT_ISOLATION_EXCLUDE_LIST'] = $GLOBALS['__PHPUNIT_ISOLATION_BLACKLIST'] = array(realpath(__DIR__ . '/..'.'/phpunit/phpunit/phpunit'));
+
+if (PHP_VERSION_ID < 80000) {
+    if (!class_exists('Composer\BinProxyWrapper')) {
+        /**
+         * @internal
+         */
+        final class BinProxyWrapper
+        {
+            private $handle;
+            private $position;
+            private $realpath;
+
+            public function stream_open($path, $mode, $options, &$opened_path)
+            {
+                // get rid of phpvfscomposer:// prefix for __FILE__ & __DIR__ resolution
+                $opened_path = substr($path, 17);
+                $this->realpath = realpath($opened_path) ?: $opened_path;
+                $opened_path = 'phpvfscomposer://'.$this->realpath;
+                $this->handle = fopen($this->realpath, $mode);
+                $this->position = 0;
+
+                return (bool) $this->handle;
+            }
+
+            public function stream_read($count)
+            {
+                $data = fread($this->handle, $count);
+
+                if ($this->position === 0) {
+                    $data = preg_replace('{^#!.*\r?\n}', '', $data);
+                }
+                $data = str_replace('__DIR__', var_export(dirname($this->realpath), true), $data);
+                $data = str_replace('__FILE__', var_export($this->realpath, true), $data);
+
+                $this->position += strlen($data);
+
+                return $data;
+            }
+
+            public function stream_cast($castAs)
+            {
+                return $this->handle;
+            }
+
+            public function stream_close()
+            {
+                fclose($this->handle);
+            }
+
+            public function stream_lock($operation)
+            {
+                return $operation ? flock($this->handle, $operation) : true;
+            }
+
+            public function stream_seek($offset, $whence)
+            {
+                if (0 === fseek($this->handle, $offset, $whence)) {
+                    $this->position = ftell($this->handle);
+                    return true;
+                }
+
+                return false;
+            }
+
+            public function stream_tell()
+            {
+                return $this->position;
+            }
+
+            public function stream_eof()
+            {
+                return feof($this->handle);
+            }
+
+            public function stream_stat()
+            {
+                return array();
+            }
+
+            public function stream_set_option($option, $arg1, $arg2)
+            {
+                return true;
+            }
+
+            public function url_stat($path, $flags)
+            {
+                $path = substr($path, 17);
+                if (file_exists($path)) {
+                    return stat($path);
+                }
+
+                return false;
+            }
+        }
+    }
+
+    if (
+        (function_exists('stream_get_wrappers') && in_array('phpvfscomposer', stream_get_wrappers(), true))
+        || (function_exists('stream_wrapper_register') && stream_wrapper_register('phpvfscomposer', 'Composer\BinProxyWrapper'))
+    ) {
+        return include("phpvfscomposer://" . __DIR__ . '/..'.'/phpunit/phpunit/phpunit');
+    }
+}
+
+return include __DIR__ . '/..'.'/phpunit/phpunit/phpunit';

vendor/bin/pint

@@ -0,0 +1,119 @@
+#!/usr/bin/env php
+<?php
+
+/**
+ * Proxy PHP file generated by Composer
+ *
+ * This file includes the referenced bin path (../laravel/pint/builds/pint)
+ * using a stream wrapper to prevent the shebang from being output on PHP<8
+ *
+ * @generated
+ */
+
+namespace Composer;
+
+$GLOBALS['_composer_bin_dir'] = __DIR__;
+$GLOBALS['_composer_autoload_path'] = __DIR__ . '/..'.'/autoload.php';
+
+if (PHP_VERSION_ID < 80000) {
+    if (!class_exists('Composer\BinProxyWrapper')) {
+        /**
+         * @internal
+         */
+        final class BinProxyWrapper
+        {
+            private $handle;
+            private $position;
+            private $realpath;
+
+            public function stream_open($path, $mode, $options, &$opened_path)
+            {
+                // get rid of phpvfscomposer:// prefix for __FILE__ & __DIR__ resolution
+                $opened_path = substr($path, 17);
+                $this->realpath = realpath($opened_path) ?: $opened_path;
+                $opened_path = $this->realpath;
+                $this->handle = fopen($this->realpath, $mode);
+                $this->position = 0;
+
+                return (bool) $this->handle;
+            }
+
+            public function stream_read($count)
+            {
+                $data = fread($this->handle, $count);
+
+                if ($this->position === 0) {
+                    $data = preg_replace('{^#!.*\r?\n}', '', $data);
+                }
+
+                $this->position += strlen($data);
+
+                return $data;
+            }
+
+            public function stream_cast($castAs)
+            {
+                return $this->handle;
+            }
+
+            public function stream_close()
+            {
+                fclose($this->handle);
+            }
+
+            public function stream_lock($operation)
+            {
+                return $operation ? flock($this->handle, $operation) : true;
+            }
+
+            public function stream_seek($offset, $whence)
+            {
+                if (0 === fseek($this->handle, $offset, $whence)) {
+                    $this->position = ftell($this->handle);
+                    return true;
+                }
+
+                return false;
+            }
+
+            public function stream_tell()
+            {
+                return $this->position;
+            }
+
+            public function stream_eof()
+            {
+                return feof($this->handle);
+            }
+
+            public function stream_stat()
+            {
+                return array();
+            }
+
+            public function stream_set_option($option, $arg1, $arg2)
+            {
+                return true;
+            }
+
+            public function url_stat($path, $flags)
+            {
+                $path = substr($path, 17);
+                if (file_exists($path)) {
+                    return stat($path);
+                }
+
+                return false;
+            }
+        }
+    }
+
+    if (
+        (function_exists('stream_get_wrappers') && in_array('phpvfscomposer', stream_get_wrappers(), true))
+        || (function_exists('stream_wrapper_register') && stream_wrapper_register('phpvfscomposer', 'Composer\BinProxyWrapper'))
+    ) {
+        return include("phpvfscomposer://" . __DIR__ . '/..'.'/laravel/pint/builds/pint');
+    }
+}
+
+return include __DIR__ . '/..'.'/laravel/pint/builds/pint';

vendor/bin/psysh

@@ -0,0 +1,119 @@
+#!/usr/bin/env php
+<?php
+
+/**
+ * Proxy PHP file generated by Composer
+ *
+ * This file includes the referenced bin path (../psy/psysh/bin/psysh)
+ * using a stream wrapper to prevent the shebang from being output on PHP<8
+ *
+ * @generated
+ */
+
+namespace Composer;
+
+$GLOBALS['_composer_bin_dir'] = __DIR__;
+$GLOBALS['_composer_autoload_path'] = __DIR__ . '/..'.'/autoload.php';
+
+if (PHP_VERSION_ID < 80000) {
+    if (!class_exists('Composer\BinProxyWrapper')) {
+        /**
+         * @internal
+         */
+        final class BinProxyWrapper
+        {
+            private $handle;
+            private $position;
+            private $realpath;
+
+            public function stream_open($path, $mode, $options, &$opened_path)
+            {
+                // get rid of phpvfscomposer:// prefix for __FILE__ & __DIR__ resolution
+                $opened_path = substr($path, 17);
+                $this->realpath = realpath($opened_path) ?: $opened_path;
+                $opened_path = $this->realpath;
+                $this->handle = fopen($this->realpath, $mode);
+                $this->position = 0;
+
+                return (bool) $this->handle;
+            }
+
+            public function stream_read($count)
+            {
+                $data = fread($this->handle, $count);
+
+                if ($this->position === 0) {
+                    $data = preg_replace('{^#!.*\r?\n}', '', $data);
+                }
+
+                $this->position += strlen($data);
+
+                return $data;
+            }
+
+            public function stream_cast($castAs)
+            {
+                return $this->handle;
+            }
+
+            public function stream_close()
+            {
+                fclose($this->handle);
+            }
+
+            public function stream_lock($operation)
+            {
+                return $operation ? flock($this->handle, $operation) : true;
+            }
+
+            public function stream_seek($offset, $whence)
+            {
+                if (0 === fseek($this->handle, $offset, $whence)) {
+                    $this->position = ftell($this->handle);
+                    return true;
+                }
+
+                return false;
+            }
+
+            public function stream_tell()
+            {
+                return $this->position;
+            }
+
+            public function stream_eof()
+            {
+                return feof($this->handle);
+            }
+
+            public function stream_stat()
+            {
+                return array();
+            }
+
+            public function stream_set_option($option, $arg1, $arg2)
+            {
+                return true;
+            }
+
+            public function url_stat($path, $flags)
+            {
+                $path = substr($path, 17);
+                if (file_exists($path)) {
+                    return stat($path);
+                }
+
+                return false;
+            }
+        }
+    }
+
+    if (
+        (function_exists('stream_get_wrappers') && in_array('phpvfscomposer', stream_get_wrappers(), true))
+        || (function_exists('stream_wrapper_register') && stream_wrapper_register('phpvfscomposer', 'Composer\BinProxyWrapper'))
+    ) {
+        return include("phpvfscomposer://" . __DIR__ . '/..'.'/psy/psysh/bin/psysh');
+    }
+}
+
+return include __DIR__ . '/..'.'/psy/psysh/bin/psysh';

vendor/bin/sail

@@ -0,0 +1,37 @@
+#!/usr/bin/env sh
+
+# Support bash to support `source` with fallback on $0 if this does not run with bash
+# https://stackoverflow.com/a/35006505/6512
+selfArg="$BASH_SOURCE"
+if [ -z "$selfArg" ]; then
+    selfArg="$0"
+fi
+
+self=$(realpath $selfArg 2> /dev/null)
+if [ -z "$self" ]; then
+    self="$selfArg"
+fi
+
+dir=$(cd "${self%[/\\]*}" > /dev/null; cd '../laravel/sail/bin' && pwd)
+
+if [ -d /proc/cygdrive ]; then
+    case $(which php) in
+        $(readlink -n /proc/cygdrive)/*)
+            # We are in Cygwin using Windows php, so the path must be translated
+            dir=$(cygpath -m "$dir");
+            ;;
+    esac
+fi
+
+export COMPOSER_RUNTIME_BIN_DIR="$(cd "${self%[/\\]*}" > /dev/null; pwd)"
+
+# If bash is sourcing this file, we have to source the target as well
+bashSource="$BASH_SOURCE"
+if [ -n "$bashSource" ]; then
+    if [ "$bashSource" != "$0" ]; then
+        source "${dir}/sail" "$@"
+        return
+    fi
+fi
+
+exec "${dir}/sail" "$@"

vendor/bin/var-dump-server

@@ -0,0 +1,119 @@
+#!/usr/bin/env php
+<?php
+
+/**
+ * Proxy PHP file generated by Composer
+ *
+ * This file includes the referenced bin path (../symfony/var-dumper/Resources/bin/var-dump-server)
+ * using a stream wrapper to prevent the shebang from being output on PHP<8
+ *
+ * @generated
+ */
+
+namespace Composer;
+
+$GLOBALS['_composer_bin_dir'] = __DIR__;
+$GLOBALS['_composer_autoload_path'] = __DIR__ . '/..'.'/autoload.php';
+
+if (PHP_VERSION_ID < 80000) {
+    if (!class_exists('Composer\BinProxyWrapper')) {
+        /**
+         * @internal
+         */
+        final class BinProxyWrapper
+        {
+            private $handle;
+            private $position;
+            private $realpath;
+
+            public function stream_open($path, $mode, $options, &$opened_path)
+            {
+                // get rid of phpvfscomposer:// prefix for __FILE__ & __DIR__ resolution
+                $opened_path = substr($path, 17);
+                $this->realpath = realpath($opened_path) ?: $opened_path;
+                $opened_path = $this->realpath;
+                $this->handle = fopen($this->realpath, $mode);
+                $this->position = 0;
+
+                return (bool) $this->handle;
+            }
+
+            public function stream_read($count)
+            {
+                $data = fread($this->handle, $count);
+
+                if ($this->position === 0) {
+                    $data = preg_replace('{^#!.*\r?\n}', '', $data);
+                }
+
+                $this->position += strlen($data);
+
+                return $data;
+            }
+
+            public function stream_cast($castAs)
+            {
+                return $this->handle;
+            }
+
+            public function stream_close()
+            {
+                fclose($this->handle);
+            }
+
+            public function stream_lock($operation)
+            {
+                return $operation ? flock($this->handle, $operation) : true;
+            }
+
+            public function stream_seek($offset, $whence)
+            {
+                if (0 === fseek($this->handle, $offset, $whence)) {
+                    $this->position = ftell($this->handle);
+                    return true;
+                }
+
+                return false;
+            }
+
+            public function stream_tell()
+            {
+                return $this->position;
+            }
+
+            public function stream_eof()
+            {
+                return feof($this->handle);
+            }
+
+            public function stream_stat()
+            {
+                return array();
+            }
+
+            public function stream_set_option($option, $arg1, $arg2)
+            {
+                return true;
+            }
+
+            public function url_stat($path, $flags)
+            {
+                $path = substr($path, 17);
+                if (file_exists($path)) {
+                    return stat($path);
+                }
+
+                return false;
+            }
+        }
+    }
+
+    if (
+        (function_exists('stream_get_wrappers') && in_array('phpvfscomposer', stream_get_wrappers(), true))
+        || (function_exists('stream_wrapper_register') && stream_wrapper_register('phpvfscomposer', 'Composer\BinProxyWrapper'))
+    ) {
+        return include("phpvfscomposer://" . __DIR__ . '/..'.'/symfony/var-dumper/Resources/bin/var-dump-server');
+    }
+}
+
+return include __DIR__ . '/..'.'/symfony/var-dumper/Resources/bin/var-dump-server';

vendor/bin/yaml-lint

@@ -0,0 +1,119 @@
+#!/usr/bin/env php
+<?php
+
+/**
+ * Proxy PHP file generated by Composer
+ *
+ * This file includes the referenced bin path (../symfony/yaml/Resources/bin/yaml-lint)
+ * using a stream wrapper to prevent the shebang from being output on PHP<8
+ *
+ * @generated
+ */
+
+namespace Composer;
+
+$GLOBALS['_composer_bin_dir'] = __DIR__;
+$GLOBALS['_composer_autoload_path'] = __DIR__ . '/..'.'/autoload.php';
+
+if (PHP_VERSION_ID < 80000) {
+    if (!class_exists('Composer\BinProxyWrapper')) {
+        /**
+         * @internal
+         */
+        final class BinProxyWrapper
+        {
+            private $handle;
+            private $position;
+            private $realpath;
+
+            public function stream_open($path, $mode, $options, &$opened_path)
+            {
+                // get rid of phpvfscomposer:// prefix for __FILE__ & __DIR__ resolution
+                $opened_path = substr($path, 17);
+                $this->realpath = realpath($opened_path) ?: $opened_path;
+                $opened_path = $this->realpath;
+                $this->handle = fopen($this->realpath, $mode);
+                $this->position = 0;
+
+                return (bool) $this->handle;
+            }
+
+            public function stream_read($count)
+            {
+                $data = fread($this->handle, $count);
+
+                if ($this->position === 0) {
+                    $data = preg_replace('{^#!.*\r?\n}', '', $data);
+                }
+
+                $this->position += strlen($data);
+
+                return $data;
+            }
+
+            public function stream_cast($castAs)
+            {
+                return $this->handle;
+            }
+
+            public function stream_close()
+            {
+                fclose($this->handle);
+            }
+
+            public function stream_lock($operation)
+            {
+                return $operation ? flock($this->handle, $operation) : true;
+            }
+
+            public function stream_seek($offset, $whence)
+            {
+                if (0 === fseek($this->handle, $offset, $whence)) {
+                    $this->position = ftell($this->handle);
+                    return true;
+                }
+
+                return false;
+            }
+
+            public function stream_tell()
+            {
+                return $this->position;
+            }
+
+            public function stream_eof()
+            {
+                return feof($this->handle);
+            }
+
+            public function stream_stat()
+            {
+                return array();
+            }
+
+            public function stream_set_option($option, $arg1, $arg2)
+            {
+                return true;
+            }
+
+            public function url_stat($path, $flags)
+            {
+                $path = substr($path, 17);
+                if (file_exists($path)) {
+                    return stat($path);
+                }
+
+                return false;
+            }
+        }
+    }
+
+    if (
+        (function_exists('stream_get_wrappers') && in_array('phpvfscomposer', stream_get_wrappers(), true))
+        || (function_exists('stream_wrapper_register') && stream_wrapper_register('phpvfscomposer', 'Composer\BinProxyWrapper'))
+    ) {
+        return include("phpvfscomposer://" . __DIR__ . '/..'.'/symfony/yaml/Resources/bin/yaml-lint');
+    }
+}
+
+return include __DIR__ . '/..'.'/symfony/yaml/Resources/bin/yaml-lint';

vendor/brick/math/CHANGELOG.md

@@ -0,0 +1,582 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [0.14.4](https://github.com/brick/math/releases/tag/0.14.4) - 2026-02-02
+
+🗑️ **Deprecations**
+
+- Passing a negative modulus to `BigInteger::mod()` is deprecated to align with Euclidean modulo semantics; it will throw `NegativeNumberException` in 0.15
+- Method `BigDecimal::stripTrailingZeros()` is deprecated, use `strippedOfTrailingZeros()` instead
+
+✨ **New features**
+
+- `BigInteger::modPow()` now accepts negative bases
+- New method: `BigDecimal::strippedOfTrailingZeros()` (replaces `stripTrailingZeros()`)
+
+👌 **Improvements**
+
+- `clamp()` methods are now marked as `@pure`
+
+## [0.14.3](https://github.com/brick/math/releases/tag/0.14.3) - 2026-02-01
+
+✨ **New features**
+
+- New method: `BigInteger::lcm()`
+- New method: `BigInteger::lcmAll()`
+- New method: `BigRational::toRepeatingDecimalString()`
+
+🐛 **Bug fixes**
+
+- `BigInteger::gcdAll()` / `gcdMultiple()` could return a negative result when used with a single negative number
+
+## [0.14.2](https://github.com/brick/math/releases/tag/0.14.2) - 2026-01-30
+
+🗑️ **Deprecations**
+
+- **Passing `float` values to `of()` or arithmetic methods is deprecated** and will be removed in 0.15; cast to string explicitly to preserve the previous behaviour (#105)
+- **Accessing `RoundingMode` enum cases through upper snake case (e.g. `HALF_UP`) is deprecated**, use the pascal case version (e.g. `HalfUp`) instead
+- Method `BigInteger::gcdMultiple()` is deprecated, use `gcdAll()` instead
+- Method `BigDecimal::exactlyDividedBy()` is deprecated, use `dividedByExact()` instead
+- Method `BigDecimal::getIntegralPart()` is deprecated (will be removed in 0.15, and re-introduced as returning `BigInteger` in 0.16)
+- Method `BigDecimal::getFractionalPart()` is deprecated (will be removed in 0.15, and re-introduced as returning `BigDecimal` with a different meaning in 0.16)
+- Method `BigRational::nd()` is deprecated, use `ofFraction()` instead
+- Method `BigRational::quotient()` is deprecated, use `getIntegralPart()` instead
+- Method `BigRational::remainder()` is deprecated, use `$number->getNumerator()->remainder($number->getDenominator())` instead
+- Method `BigRational::quotientAndRemainder()` is deprecated, use `$number->getNumerator()->quotientAndRemainder($number->getDenominator())` instead
+
+✨ **New features**
+
+- New method: `BigInteger::gcdAll()` (replaces `gcdMultiple()`)
+- New method: `BigRational::clamp()`
+- New method: `BigRational::ofFraction()` (replaces `nd()`)
+- New method: `BigRational::getIntegralPart()` (replaces `quotient()`)
+- New method: `BigRational::getFractionalPart()`
+
+👌 **Improvements**
+
+- `BigInteger::modInverse()` now accepts `BigNumber|int|float|string` instead of just `BigInteger`
+- `BigInteger::gcdMultiple()` now accepts `BigNumber|int|float|string` instead of just `BigInteger`
+
+🐛 **Bug fixes**
+
+- `BigInteger::clamp()` and `BigDecimal::clamp()` now throw an exception on inverted bounds, instead of returning an incorrect result
+
+## [0.14.1](https://github.com/brick/math/releases/tag/0.14.1) - 2025-11-24
+
+✨ **New features**
+
+- New method: `BigNumber::ofNullable()` (#94 by @mrkh995)
+
+✨ **Compatibility fixes**
+
+- Fixed warnings on PHP 8.5 (#101 and #102 by @julien-boudry)
+
+## [0.14.0](https://github.com/brick/math/releases/tag/0.14.0) - 2025-08-29
+
+✨ **New features**
+
+- New methods: `BigInteger::clamp()` and `BigDecimal::clamp()` (#96 by @JesterIruka)
+
+✨ **Improvements**
+
+- All pure methods in `BigNumber` classes are now marked as `@pure` for better static analysis
+
+💥 **Breaking changes**
+
+- Minimum PHP version is now 8.2
+- `BigNumber` classes are now `readonly`
+- `BigNumber` is now marked as sealed: it must not be extended outside of this package
+- Exception classes are now `final`
+
+## [0.13.1](https://github.com/brick/math/releases/tag/0.13.1) - 2025-03-29
+
+✨ **Improvements**
+
+- `__toString()` methods of `BigInteger` and `BigDecimal` are now type-hinted as returning `numeric-string` instead of `string` (#90 by @vudaltsov)
+
+## [0.13.0](https://github.com/brick/math/releases/tag/0.13.0) - 2025-03-03
+
+💥 **Breaking changes**
+
+- `BigDecimal::ofUnscaledValue()` no longer throws an exception if the scale is negative
+- `MathException` now extends `RuntimeException` instead of `Exception`; this reverts the change introduced in version `0.11.0` (#82)
+
+✨ **New features**
+
+- `BigDecimal::ofUnscaledValue()` allows a negative scale (and converts the values to create a zero scale number)
+
+## [0.12.3](https://github.com/brick/math/releases/tag/0.12.3) - 2025-02-28
+
+✨ **New features**
+
+- `BigDecimal::getPrecision()` Returns the number of significant digits in a decimal number
+
+## [0.12.2](https://github.com/brick/math/releases/tag/0.12.2) - 2025-02-26
+
+⚡️ **Performance improvements**
+
+- Division in `NativeCalculator` is now faster for small divisors, thanks to [@Izumi-kun](https://github.com/Izumi-kun) in [#87](https://github.com/brick/math/pull/87).
+
+👌 **Improvements**
+
+- Add missing `RoundingNecessaryException` to the `@throws` annotation of `BigNumber::of()`
+
+## [0.12.1](https://github.com/brick/math/releases/tag/0.12.1) - 2023-11-29
+
+⚡️ **Performance improvements**
+
+- `BigNumber::of()` is now faster, thanks to [@SebastienDug](https://github.com/SebastienDug) in [#77](https://github.com/brick/math/pull/77).
+
+## [0.12.0](https://github.com/brick/math/releases/tag/0.12.0) - 2023-11-26
+
+💥 **Breaking changes**
+
+- Minimum PHP version is now 8.1
+- `RoundingMode` is now an `enum`; if you're type-hinting rounding modes, you need to type-hint against `RoundingMode` instead of `int` now
+- `BigNumber` classes do not implement the `Serializable` interface anymore (they use the [new custom object serialization mechanism](https://wiki.php.net/rfc/custom_object_serialization))
+- The following breaking changes only affect you if you're creating your own `BigNumber` subclasses:
+  - the return type of `BigNumber::of()` is now `static`
+  - `BigNumber` has a new abstract method `from()`
+  - all `public` and `protected` functions of `BigNumber` are now `final`
+
+## [0.11.0](https://github.com/brick/math/releases/tag/0.11.0) - 2023-01-16
+
+💥 **Breaking changes**
+
+- Minimum PHP version is now 8.0
+- Methods accepting a union of types are now strongly typed<sup>*</sup>
+- `MathException` now extends `Exception` instead of `RuntimeException`
+
+<sup>* You may now run into type errors if you were passing `Stringable` objects to `of()` or any of the methods
+internally calling `of()`, with `strict_types` enabled. You can fix this by casting `Stringable` objects to `string`
+first.</sup>
+
+## [0.10.2](https://github.com/brick/math/releases/tag/0.10.2) - 2022-08-11
+
+👌 **Improvements**
+
+- `BigRational::toFloat()` now simplifies the fraction before performing division (#73) thanks to @olsavmic
+
+## [0.10.1](https://github.com/brick/math/releases/tag/0.10.1) - 2022-08-02
+
+✨ **New features**
+
+- `BigInteger::gcdMultiple()` returns the GCD of multiple `BigInteger` numbers
+
+## [0.10.0](https://github.com/brick/math/releases/tag/0.10.0) - 2022-06-18
+
+💥 **Breaking changes**
+
+- Minimum PHP version is now 7.4
+
+## [0.9.3](https://github.com/brick/math/releases/tag/0.9.3) - 2021-08-15
+
+🚀 **Compatibility with PHP 8.1**
+
+- Support for custom object serialization; this removes a warning on PHP 8.1 due to the `Serializable` interface being deprecated (#60) thanks @TRowbotham
+
+## [0.9.2](https://github.com/brick/math/releases/tag/0.9.2) - 2021-01-20
+
+🐛 **Bug fix**
+
+- Incorrect results could be returned when using the BCMath calculator, with a default scale set with `bcscale()`, on PHP >= 7.2 (#55).
+
+## [0.9.1](https://github.com/brick/math/releases/tag/0.9.1) - 2020-08-19
+
+✨ **New features**
+
+- `BigInteger::not()` returns the bitwise `NOT` value
+
+🐛 **Bug fixes**
+
+- `BigInteger::toBytes()` could return an incorrect binary representation for some numbers
+- The bitwise operations `and()`, `or()`, `xor()` on `BigInteger` could return an incorrect result when the GMP extension is not available
+
+## [0.9.0](https://github.com/brick/math/releases/tag/0.9.0) - 2020-08-18
+
+👌 **Improvements**
+
+- `BigNumber::of()` now accepts `.123` and `123.` formats, both of which return a `BigDecimal`
+
+💥 **Breaking changes**
+
+- Deprecated method `BigInteger::powerMod()` has been removed - use `modPow()` instead
+- Deprecated method `BigInteger::parse()` has been removed - use `fromBase()` instead
+
+## [0.8.17](https://github.com/brick/math/releases/tag/0.8.17) - 2020-08-19
+
+🐛 **Bug fix**
+
+- `BigInteger::toBytes()` could return an incorrect binary representation for some numbers
+- The bitwise operations `and()`, `or()`, `xor()` on `BigInteger` could return an incorrect result when the GMP extension is not available
+
+## [0.8.16](https://github.com/brick/math/releases/tag/0.8.16) - 2020-08-18
+
+🚑 **Critical fix**
+
+- This version reintroduces the deprecated `BigInteger::parse()` method, that has been removed by mistake in version `0.8.9` and should have lasted for the whole `0.8` release cycle.
+
+✨ **New features**
+
+- `BigInteger::modInverse()` calculates a modular multiplicative inverse
+- `BigInteger::fromBytes()` creates a `BigInteger` from a byte string
+- `BigInteger::toBytes()` converts a `BigInteger` to a byte string
+- `BigInteger::randomBits()` creates a pseudo-random `BigInteger` of a given bit length
+- `BigInteger::randomRange()` creates a pseudo-random `BigInteger` between two bounds
+
+💩 **Deprecations**
+
+- `BigInteger::powerMod()` is now deprecated in favour of `modPow()`
+
+## [0.8.15](https://github.com/brick/math/releases/tag/0.8.15) - 2020-04-15
+
+🐛 **Fixes**
+
+- added missing `ext-json` requirement, due to `BigNumber` implementing `JsonSerializable`
+
+⚡️ **Optimizations**
+
+- additional optimization in `BigInteger::remainder()`
+
+## [0.8.14](https://github.com/brick/math/releases/tag/0.8.14) - 2020-02-18
+
+✨ **New features**
+
+- `BigInteger::getLowestSetBit()` returns the index of the rightmost one bit
+
+## [0.8.13](https://github.com/brick/math/releases/tag/0.8.13) - 2020-02-16
+
+✨ **New features**
+
+- `BigInteger::isEven()` tests whether the number is even
+- `BigInteger::isOdd()` tests whether the number is odd
+- `BigInteger::testBit()` tests if a bit is set
+- `BigInteger::getBitLength()` returns the number of bits in the minimal representation of the number
+
+## [0.8.12](https://github.com/brick/math/releases/tag/0.8.12) - 2020-02-03
+
+🛠️ **Maintenance release**
+
+Classes are now annotated for better static analysis with [psalm](https://psalm.dev/).
+
+This is a maintenance release: no bug fixes, no new features, no breaking changes.
+
+## [0.8.11](https://github.com/brick/math/releases/tag/0.8.11) - 2020-01-23
+
+✨ **New feature**
+
+`BigInteger::powerMod()` performs a power-with-modulo operation. Useful for crypto.
+
+## [0.8.10](https://github.com/brick/math/releases/tag/0.8.10) - 2020-01-21
+
+✨ **New feature**
+
+`BigInteger::mod()` returns the **modulo** of two numbers. The *modulo* differs from the *remainder* when the signs of the operands are different.
+
+## [0.8.9](https://github.com/brick/math/releases/tag/0.8.9) - 2020-01-08
+
+⚡️ **Performance improvements**
+
+A few additional optimizations in `BigInteger` and `BigDecimal` when one of the operands can be returned as is. Thanks to @tomtomsen in #24.
+
+## [0.8.8](https://github.com/brick/math/releases/tag/0.8.8) - 2019-04-25
+
+🐛 **Bug fixes**
+
+- `BigInteger::toBase()` could return an empty string for zero values (BCMath & Native calculators only, GMP calculator unaffected)
+
+✨ **New features**
+
+- `BigInteger::toArbitraryBase()` converts a number to an arbitrary base, using a custom alphabet
+- `BigInteger::fromArbitraryBase()` converts a string in an arbitrary base, using a custom alphabet, back to a number
+
+These methods can be used as the foundation to convert strings between different bases/alphabets, using BigInteger as an intermediate representation.
+
+💩 **Deprecations**
+
+- `BigInteger::parse()` is now deprecated in favour of `fromBase()`
+
+`BigInteger::fromBase()` works the same way as `parse()`, with 2 minor differences:
+
+- the `$base` parameter is required, it does not default to `10`
+- it throws a `NumberFormatException` instead of an `InvalidArgumentException` when the number is malformed
+
+## [0.8.7](https://github.com/brick/math/releases/tag/0.8.7) - 2019-04-20
+
+**Improvements**
+
+- Safer conversion from `float` when using custom locales
+- **Much faster** `NativeCalculator` implementation 🚀
+
+You can expect **at least a 3x performance improvement** for common arithmetic operations when using the library on systems without GMP or BCMath; it gets exponentially faster on multiplications with a high number of digits. This is due to calculations now being performed on whole blocks of digits (the block size depending on the platform, 32-bit or 64-bit) instead of digit-by-digit as before.
+
+## [0.8.6](https://github.com/brick/math/releases/tag/0.8.6) - 2019-04-11
+
+**New method**
+
+`BigNumber::sum()` returns the sum of one or more numbers.
+
+## [0.8.5](https://github.com/brick/math/releases/tag/0.8.5) - 2019-02-12
+
+**Bug fix**: `of()` factory methods could fail when passing a `float` in environments using a `LC_NUMERIC` locale with a decimal separator other than `'.'` (#20).
+
+Thanks @manowark 👍
+
+## [0.8.4](https://github.com/brick/math/releases/tag/0.8.4) - 2018-12-07
+
+**New method**
+
+`BigDecimal::sqrt()` calculates the square root of a decimal number, to a given scale.
+
+## [0.8.3](https://github.com/brick/math/releases/tag/0.8.3) - 2018-12-06
+
+**New method**
+
+`BigInteger::sqrt()` calculates the square root of a number (thanks @peter279k).
+
+**New exception**
+
+`NegativeNumberException` is thrown when calling `sqrt()` on a negative number.
+
+## [0.8.2](https://github.com/brick/math/releases/tag/0.8.2) - 2018-11-08
+
+**Performance update**
+
+- Further improvement of `toInt()` performance
+- `NativeCalculator` can now perform some multiplications more efficiently
+
+## [0.8.1](https://github.com/brick/math/releases/tag/0.8.1) - 2018-11-07
+
+Performance optimization of `toInt()` methods.
+
+## [0.8.0](https://github.com/brick/math/releases/tag/0.8.0) - 2018-10-13
+
+**Breaking changes**
+
+The following deprecated methods have been removed. Use the new method name instead:
+
+| Method removed | Replacement method |
+| --- | --- |
+| `BigDecimal::getIntegral()` | `BigDecimal::getIntegralPart()` |
+| `BigDecimal::getFraction()` | `BigDecimal::getFractionalPart()` |
+
+---
+
+**New features**
+
+`BigInteger` has been augmented with 5 new methods for bitwise operations:
+
+| New method | Description |
+| --- | --- |
+| `and()` | performs a bitwise `AND` operation on two numbers |
+| `or()` | performs a bitwise `OR` operation on two numbers |
+| `xor()` | performs a bitwise `XOR` operation on two numbers |
+| `shiftedLeft()` | returns the number shifted left by a number of bits |
+| `shiftedRight()` | returns the number shifted right by a number of bits |
+
+Thanks to @DASPRiD 👍
+
+## [0.7.3](https://github.com/brick/math/releases/tag/0.7.3) - 2018-08-20
+
+**New method:** `BigDecimal::hasNonZeroFractionalPart()`
+
+**Renamed/deprecated methods:**
+
+- `BigDecimal::getIntegral()` has been renamed to `getIntegralPart()` and is now deprecated
+- `BigDecimal::getFraction()` has been renamed to `getFractionalPart()` and is now deprecated
+
+## [0.7.2](https://github.com/brick/math/releases/tag/0.7.2) - 2018-07-21
+
+**Performance update**
+
+`BigInteger::parse()` and `toBase()` now use GMP's built-in base conversion features when available.
+
+## [0.7.1](https://github.com/brick/math/releases/tag/0.7.1) - 2018-03-01
+
+This is a maintenance release, no code has been changed.
+
+- When installed with `--no-dev`, the autoloader does not autoload tests anymore
+- Tests and other files unnecessary for production are excluded from the dist package
+
+This will help make installations more compact.
+
+## [0.7.0](https://github.com/brick/math/releases/tag/0.7.0) - 2017-10-02
+
+Methods renamed:
+
+- `BigNumber:sign()` has been renamed to `getSign()`
+- `BigDecimal::unscaledValue()` has been renamed to `getUnscaledValue()`
+- `BigDecimal::scale()` has been renamed to `getScale()`
+- `BigDecimal::integral()` has been renamed to `getIntegral()`
+- `BigDecimal::fraction()` has been renamed to `getFraction()`
+- `BigRational::numerator()` has been renamed to `getNumerator()`
+- `BigRational::denominator()` has been renamed to `getDenominator()`
+
+Classes renamed:
+
+- `ArithmeticException` has been renamed to `MathException`
+
+## [0.6.2](https://github.com/brick/math/releases/tag/0.6.2) - 2017-10-02
+
+The base class for all exceptions is now `MathException`.
+`ArithmeticException` has been deprecated, and will be removed in 0.7.0.
+
+## [0.6.1](https://github.com/brick/math/releases/tag/0.6.1) - 2017-10-02
+
+A number of methods have been renamed:
+
+- `BigNumber:sign()` is deprecated; use `getSign()` instead
+- `BigDecimal::unscaledValue()` is deprecated; use `getUnscaledValue()` instead
+- `BigDecimal::scale()` is deprecated; use `getScale()` instead
+- `BigDecimal::integral()` is deprecated; use `getIntegral()` instead
+- `BigDecimal::fraction()` is deprecated; use `getFraction()` instead
+- `BigRational::numerator()` is deprecated; use `getNumerator()` instead
+- `BigRational::denominator()` is deprecated; use `getDenominator()` instead
+
+The old methods will be removed in version 0.7.0.
+
+## [0.6.0](https://github.com/brick/math/releases/tag/0.6.0) - 2017-08-25
+
+- Minimum PHP version is now [7.1](https://gophp71.org/); for PHP 5.6 and PHP 7.0 support, use version `0.5`
+- Deprecated method `BigDecimal::withScale()` has been removed; use `toScale()` instead
+- Method `BigNumber::toInteger()` has been renamed to `toInt()`
+
+## [0.5.4](https://github.com/brick/math/releases/tag/0.5.4) - 2016-10-17
+
+`BigNumber` classes now implement [JsonSerializable](http://php.net/manual/en/class.jsonserializable.php).
+The JSON output is always a string.
+
+## [0.5.3](https://github.com/brick/math/releases/tag/0.5.3) - 2016-03-31
+
+This is a bugfix release. Dividing by a negative power of 1 with the same scale as the dividend could trigger an incorrect optimization which resulted in a wrong result. See #6.
+
+## [0.5.2](https://github.com/brick/math/releases/tag/0.5.2) - 2015-08-06
+
+The `$scale` parameter of `BigDecimal::dividedBy()` is now optional again.
+
+## [0.5.1](https://github.com/brick/math/releases/tag/0.5.1) - 2015-07-05
+
+**New method: `BigNumber::toScale()`**
+
+This allows to convert any `BigNumber` to a `BigDecimal` with a given scale, using rounding if necessary.
+
+## [0.5.0](https://github.com/brick/math/releases/tag/0.5.0) - 2015-07-04
+
+**New features**
+- Common `BigNumber` interface for all classes, with the following methods:
+  - `sign()` and derived methods (`isZero()`, `isPositive()`, ...)
+  - `compareTo()` and derived methods (`isEqualTo()`, `isGreaterThan()`, ...) that work across different `BigNumber` types
+  - `toBigInteger()`, `toBigDecimal()`, `toBigRational`() conversion methods
+  - `toInteger()` and `toFloat()` conversion methods to native types
+- Unified `of()` behaviour: every class now accepts any type of number, provided that it can be safely converted to the current type
+- New method: `BigDecimal::exactlyDividedBy()`; this method automatically computes the scale of the result, provided that the division yields a finite number of digits
+- New methods: `BigRational::quotient()` and `remainder()`
+- Fine-grained exceptions: `DivisionByZeroException`, `RoundingNecessaryException`, `NumberFormatException`
+- Factory methods `zero()`, `one()` and `ten()` available in all classes
+- Rounding mode reintroduced in `BigInteger::dividedBy()`
+
+This release also comes with many performance improvements.
+
+---
+
+**Breaking changes**
+- `BigInteger`:
+  - `getSign()` is renamed to `sign()`
+  - `toString()` is renamed to `toBase()`
+  - `BigInteger::dividedBy()` now throws an exception by default if the remainder is not zero; use `quotient()` to get the previous behaviour
+- `BigDecimal`:
+  - `getSign()` is renamed to `sign()`
+  - `getUnscaledValue()` is renamed to `unscaledValue()`
+  - `getScale()` is renamed to `scale()`
+  - `getIntegral()` is renamed to `integral()`
+  - `getFraction()` is renamed to `fraction()`
+  - `divideAndRemainder()` is renamed to `quotientAndRemainder()`
+  - `dividedBy()` now takes a **mandatory** `$scale` parameter **before** the rounding mode
+  - `toBigInteger()` does not accept a `$roundingMode` parameter anymore
+  - `toBigRational()` does not simplify the fraction anymore; explicitly add `->simplified()` to get the previous behaviour
+- `BigRational`:
+  - `getSign()` is renamed to `sign()`
+  - `getNumerator()` is renamed to  `numerator()`
+  - `getDenominator()` is renamed to  `denominator()`
+  - `of()` is renamed to `nd()`, while `parse()` is renamed to `of()`
+- Miscellaneous:
+  - `ArithmeticException` is moved to an `Exception\` sub-namespace
+  - `of()` factory methods now throw `NumberFormatException` instead of `InvalidArgumentException`
+
+## [0.4.3](https://github.com/brick/math/releases/tag/0.4.3) - 2016-03-31
+
+Backport of two bug fixes from the 0.5 branch:
+- `BigInteger::parse()` did not always throw `InvalidArgumentException` as expected
+- Dividing by a negative power of 1 with the same scale as the dividend could trigger an incorrect optimization which resulted in a wrong result. See #6.
+
+## [0.4.2](https://github.com/brick/math/releases/tag/0.4.2) - 2015-06-16
+
+New method: `BigDecimal::stripTrailingZeros()`
+
+## [0.4.1](https://github.com/brick/math/releases/tag/0.4.1) - 2015-06-12
+
+Introducing a `BigRational` class, to perform calculations on fractions of any size.
+
+## [0.4.0](https://github.com/brick/math/releases/tag/0.4.0) - 2015-06-12
+
+Rounding modes have been removed from `BigInteger`, and are now a concept specific to `BigDecimal`.
+
+`BigInteger::dividedBy()` now always returns the quotient of the division.
+
+## [0.3.5](https://github.com/brick/math/releases/tag/0.3.5) - 2016-03-31
+
+Backport of two bug fixes from the 0.5 branch:
+
+- `BigInteger::parse()` did not always throw `InvalidArgumentException` as expected
+- Dividing by a negative power of 1 with the same scale as the dividend could trigger an incorrect optimization which resulted in a wrong result. See #6.
+
+## [0.3.4](https://github.com/brick/math/releases/tag/0.3.4) - 2015-06-11
+
+New methods:
+- `BigInteger::remainder()` returns the remainder of a division only
+- `BigInteger::gcd()` returns the greatest common divisor of two numbers
+
+## [0.3.3](https://github.com/brick/math/releases/tag/0.3.3) - 2015-06-07
+
+Fix `toString()` not handling negative numbers.
+
+## [0.3.2](https://github.com/brick/math/releases/tag/0.3.2) - 2015-06-07
+
+`BigInteger` and `BigDecimal` now have a `getSign()` method that returns:
+- `-1` if the number is negative
+- `0` if the number is zero
+- `1` if the number is positive
+
+## [0.3.1](https://github.com/brick/math/releases/tag/0.3.1) - 2015-06-05
+
+Minor performance improvements
+
+## [0.3.0](https://github.com/brick/math/releases/tag/0.3.0) - 2015-06-04
+
+The `$roundingMode` and `$scale` parameters have been swapped in `BigDecimal::dividedBy()`.
+
+## [0.2.2](https://github.com/brick/math/releases/tag/0.2.2) - 2015-06-04
+
+Stronger immutability guarantee for `BigInteger` and `BigDecimal`.
+
+So far, it would have been possible to break immutability of these classes by calling the `unserialize()` internal function. This release fixes that.
+
+## [0.2.1](https://github.com/brick/math/releases/tag/0.2.1) - 2015-06-02
+
+Added `BigDecimal::divideAndRemainder()`
+
+## [0.2.0](https://github.com/brick/math/releases/tag/0.2.0) - 2015-05-22
+
+- `min()` and `max()` do not accept an `array` anymore, but a variable number of parameters
+- **minimum PHP version is now 5.6**
+- continuous integration with PHP 7
+
+## [0.1.1](https://github.com/brick/math/releases/tag/0.1.1) - 2014-09-01
+
+- Added `BigInteger::power()`
+- Added HHVM support
+
+## [0.1.0](https://github.com/brick/math/releases/tag/0.1.0) - 2014-08-31
+
+First beta release.

vendor/brick/math/LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2013-present Benjamin Morel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

vendor/brick/math/composer.json

@@ -0,0 +1,39 @@
+{
+    "name": "brick/math",
+    "description": "Arbitrary-precision arithmetic library",
+    "type": "library",
+    "keywords": [
+        "Brick",
+        "Math",
+        "Mathematics",
+        "Arbitrary-precision",
+        "Arithmetic",
+        "BigInteger",
+        "BigDecimal",
+        "BigRational",
+        "BigNumber",
+        "Bignum",
+        "Decimal",
+        "Rational",
+        "Integer"
+    ],
+    "license": "MIT",
+    "require": {
+        "php": "^8.2"
+    },
+    "require-dev": {
+        "phpunit/phpunit": "^11.5",
+        "php-coveralls/php-coveralls": "^2.2",
+        "phpstan/phpstan": "2.1.22"
+    },
+    "autoload": {
+        "psr-4": {
+            "Brick\\Math\\": "src/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "Brick\\Math\\Tests\\": "tests/"
+        }
+    }
+}

vendor/brick/math/src/BigDecimal.php

@@ -0,0 +1,939 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Brick\Math;
+
+use Brick\Math\Exception\DivisionByZeroException;
+use Brick\Math\Exception\MathException;
+use Brick\Math\Exception\NegativeNumberException;
+use Brick\Math\Internal\Calculator;
+use Brick\Math\Internal\CalculatorRegistry;
+use InvalidArgumentException;
+use LogicException;
+use Override;
+
+use function rtrim;
+use function sprintf;
+use function str_pad;
+use function str_repeat;
+use function strlen;
+use function substr;
+use function trigger_error;
+
+use const E_USER_DEPRECATED;
+use const STR_PAD_LEFT;
+
+/**
+ * Immutable, arbitrary-precision signed decimal numbers.
+ */
+final readonly class BigDecimal extends BigNumber
+{
+    /**
+     * The unscaled value of this decimal number.
+     *
+     * This is a string of digits with an optional leading minus sign.
+     * No leading zero must be present.
+     * No leading minus sign must be present if the value is 0.
+     */
+    private string $value;
+
+    /**
+     * The scale (number of digits after the decimal point) of this decimal number.
+     *
+     * This must be zero or more.
+     */
+    private int $scale;
+
+    /**
+     * Protected constructor. Use a factory method to obtain an instance.
+     *
+     * @param string $value The unscaled value, validated.
+     * @param int    $scale The scale, validated.
+     *
+     * @pure
+     */
+    protected function __construct(string $value, int $scale = 0)
+    {
+        $this->value = $value;
+        $this->scale = $scale;
+    }
+
+    /**
+     * Creates a BigDecimal from an unscaled value and a scale.
+     *
+     * Example: `(12345, 3)` will result in the BigDecimal `12.345`.
+     *
+     * @param BigNumber|int|float|string $value The unscaled value. Must be convertible to a BigInteger.
+     * @param int                        $scale The scale of the number. If negative, the scale will be set to zero
+     *                                          and the unscaled value will be adjusted accordingly.
+     *
+     * @pure
+     */
+    public static function ofUnscaledValue(BigNumber|int|float|string $value, int $scale = 0): BigDecimal
+    {
+        $value = (string) BigInteger::of($value);
+
+        if ($scale < 0) {
+            if ($value !== '0') {
+                $value .= str_repeat('0', -$scale);
+            }
+            $scale = 0;
+        }
+
+        return new BigDecimal($value, $scale);
+    }
+
+    /**
+     * Returns a BigDecimal representing zero, with a scale of zero.
+     *
+     * @pure
+     */
+    public static function zero(): BigDecimal
+    {
+        /** @var BigDecimal|null $zero */
+        static $zero;
+
+        if ($zero === null) {
+            $zero = new BigDecimal('0');
+        }
+
+        return $zero;
+    }
+
+    /**
+     * Returns a BigDecimal representing one, with a scale of zero.
+     *
+     * @pure
+     */
+    public static function one(): BigDecimal
+    {
+        /** @var BigDecimal|null $one */
+        static $one;
+
+        if ($one === null) {
+            $one = new BigDecimal('1');
+        }
+
+        return $one;
+    }
+
+    /**
+     * Returns a BigDecimal representing ten, with a scale of zero.
+     *
+     * @pure
+     */
+    public static function ten(): BigDecimal
+    {
+        /** @var BigDecimal|null $ten */
+        static $ten;
+
+        if ($ten === null) {
+            $ten = new BigDecimal('10');
+        }
+
+        return $ten;
+    }
+
+    /**
+     * Returns the sum of this number and the given one.
+     *
+     * The result has a scale of `max($this->scale, $that->scale)`.
+     *
+     * @param BigNumber|int|float|string $that The number to add. Must be convertible to a BigDecimal.
+     *
+     * @throws MathException If the number is not valid, or is not convertible to a BigDecimal.
+     *
+     * @pure
+     */
+    public function plus(BigNumber|int|float|string $that): BigDecimal
+    {
+        $that = BigDecimal::of($that);
+
+        if ($that->value === '0' && $that->scale <= $this->scale) {
+            return $this;
+        }
+
+        if ($this->value === '0' && $this->scale <= $that->scale) {
+            return $that;
+        }
+
+        [$a, $b] = $this->scaleValues($this, $that);
+
+        $value = CalculatorRegistry::get()->add($a, $b);
+        $scale = $this->scale > $that->scale ? $this->scale : $that->scale;
+
+        return new BigDecimal($value, $scale);
+    }
+
+    /**
+     * Returns the difference of this number and the given one.
+     *
+     * The result has a scale of `max($this->scale, $that->scale)`.
+     *
+     * @param BigNumber|int|float|string $that The number to subtract. Must be convertible to a BigDecimal.
+     *
+     * @throws MathException If the number is not valid, or is not convertible to a BigDecimal.
+     *
+     * @pure
+     */
+    public function minus(BigNumber|int|float|string $that): BigDecimal
+    {
+        $that = BigDecimal::of($that);
+
+        if ($that->value === '0' && $that->scale <= $this->scale) {
+            return $this;
+        }
+
+        [$a, $b] = $this->scaleValues($this, $that);
+
+        $value = CalculatorRegistry::get()->sub($a, $b);
+        $scale = $this->scale > $that->scale ? $this->scale : $that->scale;
+
+        return new BigDecimal($value, $scale);
+    }
+
+    /**
+     * Returns the product of this number and the given one.
+     *
+     * The result has a scale of `$this->scale + $that->scale`.
+     *
+     * @param BigNumber|int|float|string $that The multiplier. Must be convertible to a BigDecimal.
+     *
+     * @throws MathException If the multiplier is not a valid number, or is not convertible to a BigDecimal.
+     *
+     * @pure
+     */
+    public function multipliedBy(BigNumber|int|float|string $that): BigDecimal
+    {
+        $that = BigDecimal::of($that);
+
+        if ($that->value === '1' && $that->scale === 0) {
+            return $this;
+        }
+
+        if ($this->value === '1' && $this->scale === 0) {
+            return $that;
+        }
+
+        $value = CalculatorRegistry::get()->mul($this->value, $that->value);
+        $scale = $this->scale + $that->scale;
+
+        return new BigDecimal($value, $scale);
+    }
+
+    /**
+     * Returns the result of the division of this number by the given one, at the given scale.
+     *
+     * @param BigNumber|int|float|string $that         The divisor.
+     * @param int|null                   $scale        The desired scale, or null to use the scale of this number.
+     * @param RoundingMode               $roundingMode An optional rounding mode, defaults to Unnecessary.
+     *
+     * @throws InvalidArgumentException If the scale is invalid.
+     * @throws MathException            If the number is invalid, is zero, or rounding was necessary.
+     *
+     * @pure
+     */
+    public function dividedBy(BigNumber|int|float|string $that, ?int $scale = null, RoundingMode $roundingMode = RoundingMode::Unnecessary): BigDecimal
+    {
+        $that = BigDecimal::of($that);
+
+        if ($that->isZero()) {
+            throw DivisionByZeroException::divisionByZero();
+        }
+
+        if ($scale === null) {
+            $scale = $this->scale;
+        } elseif ($scale < 0) {
+            throw new InvalidArgumentException('Scale cannot be negative.');
+        }
+
+        if ($that->value === '1' && $that->scale === 0 && $scale === $this->scale) {
+            return $this;
+        }
+
+        $p = $this->valueWithMinScale($that->scale + $scale);
+        $q = $that->valueWithMinScale($this->scale - $scale);
+
+        $result = CalculatorRegistry::get()->divRound($p, $q, $roundingMode);
+
+        return new BigDecimal($result, $scale);
+    }
+
+    /**
+     * Returns the exact result of the division of this number by the given one.
+     *
+     * The scale of the result is automatically calculated to fit all the fraction digits.
+     *
+     * @deprecated Will be removed in 0.15. Use dividedByExact() instead.
+     *
+     * @param BigNumber|int|float|string $that The divisor. Must be convertible to a BigDecimal.
+     *
+     * @throws MathException If the divisor is not a valid number, is not convertible to a BigDecimal, is zero,
+     *                       or the result yields an infinite number of digits.
+     */
+    public function exactlyDividedBy(BigNumber|int|float|string $that): BigDecimal
+    {
+        trigger_error(
+            'BigDecimal::exactlyDividedBy() is deprecated and will be removed in 0.15. Use dividedByExact() instead.',
+            E_USER_DEPRECATED,
+        );
+
+        return $this->dividedByExact($that);
+    }
+
+    /**
+     * Returns the exact result of the division of this number by the given one.
+     *
+     * The scale of the result is automatically calculated to fit all the fraction digits.
+     *
+     * @param BigNumber|int|float|string $that The divisor. Must be convertible to a BigDecimal.
+     *
+     * @throws MathException If the divisor is not a valid number, is not convertible to a BigDecimal, is zero,
+     *                       or the result yields an infinite number of digits.
+     *
+     * @pure
+     */
+    public function dividedByExact(BigNumber|int|float|string $that): BigDecimal
+    {
+        $that = BigDecimal::of($that);
+
+        if ($that->value === '0') {
+            throw DivisionByZeroException::divisionByZero();
+        }
+
+        [, $b] = $this->scaleValues($this, $that);
+
+        $d = rtrim($b, '0');
+        $scale = strlen($b) - strlen($d);
+
+        $calculator = CalculatorRegistry::get();
+
+        foreach ([5, 2] as $prime) {
+            for (; ;) {
+                $lastDigit = (int) $d[-1];
+
+                if ($lastDigit % $prime !== 0) {
+                    break;
+                }
+
+                $d = $calculator->divQ($d, (string) $prime);
+                $scale++;
+            }
+        }
+
+        return $this->dividedBy($that, $scale)->strippedOfTrailingZeros();
+    }
+
+    /**
+     * Limits (clamps) this number between the given minimum and maximum values.
+     *
+     * If the number is lower than $min, returns a copy of $min.
+     * If the number is greater than $max, returns a copy of $max.
+     * Otherwise, returns this number unchanged.
+     *
+     * @param BigNumber|int|float|string $min The minimum. Must be convertible to a BigDecimal.
+     * @param BigNumber|int|float|string $max The maximum. Must be convertible to a BigDecimal.
+     *
+     * @throws MathException            If min/max are not convertible to a BigDecimal.
+     * @throws InvalidArgumentException If min is greater than max.
+     *
+     * @pure
+     */
+    public function clamp(BigNumber|int|float|string $min, BigNumber|int|float|string $max): BigDecimal
+    {
+        $min = BigDecimal::of($min);
+        $max = BigDecimal::of($max);
+
+        if ($min->isGreaterThan($max)) {
+            throw new InvalidArgumentException('Minimum value must be less than or equal to maximum value.');
+        }
+
+        if ($this->isLessThan($min)) {
+            return $min;
+        } elseif ($this->isGreaterThan($max)) {
+            return $max;
+        }
+
+        return $this;
+    }
+
+    /**
+     * Returns this number exponentiated to the given value.
+     *
+     * The result has a scale of `$this->scale * $exponent`.
+     *
+     * @throws InvalidArgumentException If the exponent is not in the range 0 to 1,000,000.
+     *
+     * @pure
+     */
+    public function power(int $exponent): BigDecimal
+    {
+        if ($exponent === 0) {
+            return BigDecimal::one();
+        }
+
+        if ($exponent === 1) {
+            return $this;
+        }
+
+        if ($exponent < 0 || $exponent > Calculator::MAX_POWER) {
+            throw new InvalidArgumentException(sprintf(
+                'The exponent %d is not in the range 0 to %d.',
+                $exponent,
+                Calculator::MAX_POWER,
+            ));
+        }
+
+        return new BigDecimal(CalculatorRegistry::get()->pow($this->value, $exponent), $this->scale * $exponent);
+    }
+
+    /**
+     * Returns the quotient of the division of this number by the given one.
+     *
+     * The quotient has a scale of `0`.
+     *
+     * @param BigNumber|int|float|string $that The divisor. Must be convertible to a BigDecimal.
+     *
+     * @throws MathException If the divisor is not a valid decimal number, or is zero.
+     *
+     * @pure
+     */
+    public function quotient(BigNumber|int|float|string $that): BigDecimal
+    {
+        $that = BigDecimal::of($that);
+
+        if ($that->isZero()) {
+            throw DivisionByZeroException::divisionByZero();
+        }
+
+        $p = $this->valueWithMinScale($that->scale);
+        $q = $that->valueWithMinScale($this->scale);
+
+        $quotient = CalculatorRegistry::get()->divQ($p, $q);
+
+        return new BigDecimal($quotient, 0);
+    }
+
+    /**
+     * Returns the remainder of the division of this number by the given one.
+     *
+     * The remainder has a scale of `max($this->scale, $that->scale)`.
+     *
+     * @param BigNumber|int|float|string $that The divisor. Must be convertible to a BigDecimal.
+     *
+     * @throws MathException If the divisor is not a valid decimal number, or is zero.
+     *
+     * @pure
+     */
+    public function remainder(BigNumber|int|float|string $that): BigDecimal
+    {
+        $that = BigDecimal::of($that);
+
+        if ($that->isZero()) {
+            throw DivisionByZeroException::divisionByZero();
+        }
+
+        $p = $this->valueWithMinScale($that->scale);
+        $q = $that->valueWithMinScale($this->scale);
+
+        $remainder = CalculatorRegistry::get()->divR($p, $q);
+
+        $scale = $this->scale > $that->scale ? $this->scale : $that->scale;
+
+        return new BigDecimal($remainder, $scale);
+    }
+
+    /**
+     * Returns the quotient and remainder of the division of this number by the given one.
+     *
+     * The quotient has a scale of `0`, and the remainder has a scale of `max($this->scale, $that->scale)`.
+     *
+     * @param BigNumber|int|float|string $that The divisor. Must be convertible to a BigDecimal.
+     *
+     * @return array{BigDecimal, BigDecimal} An array containing the quotient and the remainder.
+     *
+     * @throws MathException If the divisor is not a valid decimal number, or is zero.
+     *
+     * @pure
+     */
+    public function quotientAndRemainder(BigNumber|int|float|string $that): array
+    {
+        $that = BigDecimal::of($that);
+
+        if ($that->isZero()) {
+            throw DivisionByZeroException::divisionByZero();
+        }
+
+        $p = $this->valueWithMinScale($that->scale);
+        $q = $that->valueWithMinScale($this->scale);
+
+        [$quotient, $remainder] = CalculatorRegistry::get()->divQR($p, $q);
+
+        $scale = $this->scale > $that->scale ? $this->scale : $that->scale;
+
+        $quotient = new BigDecimal($quotient, 0);
+        $remainder = new BigDecimal($remainder, $scale);
+
+        return [$quotient, $remainder];
+    }
+
+    /**
+     * Returns the square root of this number, rounded down to the given number of decimals.
+     *
+     * @throws InvalidArgumentException If the scale is negative.
+     * @throws NegativeNumberException  If this number is negative.
+     *
+     * @pure
+     */
+    public function sqrt(int $scale): BigDecimal
+    {
+        if ($scale < 0) {
+            throw new InvalidArgumentException('Scale cannot be negative.');
+        }
+
+        if ($this->value === '0') {
+            return new BigDecimal('0', $scale);
+        }
+
+        if ($this->value[0] === '-') {
+            throw new NegativeNumberException('Cannot calculate the square root of a negative number.');
+        }
+
+        $value = $this->value;
+        $addDigits = 2 * $scale - $this->scale;
+
+        if ($addDigits > 0) {
+            // add zeros
+            $value .= str_repeat('0', $addDigits);
+        } elseif ($addDigits < 0) {
+            // trim digits
+            if (-$addDigits >= strlen($this->value)) {
+                // requesting a scale too low, will always yield a zero result
+                return new BigDecimal('0', $scale);
+            }
+
+            $value = substr($value, 0, $addDigits);
+        }
+
+        $value = CalculatorRegistry::get()->sqrt($value);
+
+        return new BigDecimal($value, $scale);
+    }
+
+    /**
+     * Returns a copy of this BigDecimal with the decimal point moved $n places to the left.
+     *
+     * @pure
+     */
+    public function withPointMovedLeft(int $n): BigDecimal
+    {
+        if ($n === 0) {
+            return $this;
+        }
+
+        if ($n < 0) {
+            return $this->withPointMovedRight(-$n);
+        }
+
+        return new BigDecimal($this->value, $this->scale + $n);
+    }
+
+    /**
+     * Returns a copy of this BigDecimal with the decimal point moved $n places to the right.
+     *
+     * @pure
+     */
+    public function withPointMovedRight(int $n): BigDecimal
+    {
+        if ($n === 0) {
+            return $this;
+        }
+
+        if ($n < 0) {
+            return $this->withPointMovedLeft(-$n);
+        }
+
+        $value = $this->value;
+        $scale = $this->scale - $n;
+
+        if ($scale < 0) {
+            if ($value !== '0') {
+                $value .= str_repeat('0', -$scale);
+            }
+            $scale = 0;
+        }
+
+        return new BigDecimal($value, $scale);
+    }
+
+    /**
+     * Returns a copy of this BigDecimal with any trailing zeros removed from the fractional part.
+     *
+     * @deprecated Use strippedOfTrailingZeros() instead.
+     */
+    public function stripTrailingZeros(): BigDecimal
+    {
+        trigger_error(
+            'BigDecimal::stripTrailingZeros() is deprecated, use strippedOfTrailingZeros() instead.',
+            E_USER_DEPRECATED,
+        );
+
+        return $this->strippedOfTrailingZeros();
+    }
+
+    /**
+     * Returns a copy of this BigDecimal with any trailing zeros removed from the fractional part.
+     *
+     * @pure
+     */
+    public function strippedOfTrailingZeros(): BigDecimal
+    {
+        if ($this->scale === 0) {
+            return $this;
+        }
+
+        $trimmedValue = rtrim($this->value, '0');
+
+        if ($trimmedValue === '') {
+            return BigDecimal::zero();
+        }
+
+        $trimmableZeros = strlen($this->value) - strlen($trimmedValue);
+
+        if ($trimmableZeros === 0) {
+            return $this;
+        }
+
+        if ($trimmableZeros > $this->scale) {
+            $trimmableZeros = $this->scale;
+        }
+
+        $value = substr($this->value, 0, -$trimmableZeros);
+        $scale = $this->scale - $trimmableZeros;
+
+        return new BigDecimal($value, $scale);
+    }
+
+    /**
+     * Returns the absolute value of this number.
+     *
+     * @pure
+     */
+    public function abs(): BigDecimal
+    {
+        return $this->isNegative() ? $this->negated() : $this;
+    }
+
+    /**
+     * Returns the negated value of this number.
+     *
+     * @pure
+     */
+    public function negated(): BigDecimal
+    {
+        return new BigDecimal(CalculatorRegistry::get()->neg($this->value), $this->scale);
+    }
+
+    #[Override]
+    public function compareTo(BigNumber|int|float|string $that): int
+    {
+        $that = BigNumber::of($that);
+
+        if ($that instanceof BigInteger) {
+            $that = $that->toBigDecimal();
+        }
+
+        if ($that instanceof BigDecimal) {
+            [$a, $b] = $this->scaleValues($this, $that);
+
+            return CalculatorRegistry::get()->cmp($a, $b);
+        }
+
+        return -$that->compareTo($this);
+    }
+
+    #[Override]
+    public function getSign(): int
+    {
+        return ($this->value === '0') ? 0 : (($this->value[0] === '-') ? -1 : 1);
+    }
+
+    /**
+     * @pure
+     */
+    public function getUnscaledValue(): BigInteger
+    {
+        return self::newBigInteger($this->value);
+    }
+
+    /**
+     * @pure
+     */
+    public function getScale(): int
+    {
+        return $this->scale;
+    }
+
+    /**
+     * Returns the number of significant digits in the number.
+     *
+     * This is the number of digits to both sides of the decimal point, stripped of leading zeros.
+     * The sign has no impact on the result.
+     *
+     * Examples:
+     *   0 => 0
+     *   0.0 => 0
+     *   123 => 3
+     *   123.456 => 6
+     *   0.00123 => 3
+     *   0.0012300 => 5
+     *
+     * @pure
+     */
+    public function getPrecision(): int
+    {
+        $value = $this->value;
+
+        if ($value === '0') {
+            return 0;
+        }
+
+        $length = strlen($value);
+
+        return ($value[0] === '-') ? $length - 1 : $length;
+    }
+
+    /**
+     * Returns a string representing the integral part of this decimal number.
+     *
+     * Example: `-123.456` => `-123`.
+     *
+     * @deprecated Will be removed in 0.15 and re-introduced as returning BigInteger in 0.16.
+     */
+    public function getIntegralPart(): string
+    {
+        trigger_error(
+            'BigDecimal::getIntegralPart() is deprecated and will be removed in 0.15. It will be re-introduced as returning BigInteger in 0.16.',
+            E_USER_DEPRECATED,
+        );
+
+        if ($this->scale === 0) {
+            return $this->value;
+        }
+
+        $value = $this->getUnscaledValueWithLeadingZeros();
+
+        return substr($value, 0, -$this->scale);
+    }
+
+    /**
+     * Returns a string representing the fractional part of this decimal number.
+     *
+     * If the scale is zero, an empty string is returned.
+     *
+     * Examples: `-123.456` => '456', `123` => ''.
+     *
+     * @deprecated Will be removed in 0.15 and re-introduced as returning BigDecimal with a different meaning in 0.16.
+     */
+    public function getFractionalPart(): string
+    {
+        trigger_error(
+            'BigDecimal::getFractionalPart() is deprecated and will be removed in 0.15. It will be re-introduced as returning BigDecimal with a different meaning in 0.16.',
+            E_USER_DEPRECATED,
+        );
+
+        if ($this->scale === 0) {
+            return '';
+        }
+
+        $value = $this->getUnscaledValueWithLeadingZeros();
+
+        return substr($value, -$this->scale);
+    }
+
+    /**
+     * Returns whether this decimal number has a non-zero fractional part.
+     *
+     * @pure
+     */
+    public function hasNonZeroFractionalPart(): bool
+    {
+        if ($this->scale === 0) {
+            return false;
+        }
+
+        $value = $this->getUnscaledValueWithLeadingZeros();
+
+        return substr($value, -$this->scale) !== str_repeat('0', $this->scale);
+    }
+
+    #[Override]
+    public function toBigInteger(): BigInteger
+    {
+        $zeroScaleDecimal = $this->scale === 0 ? $this : $this->dividedBy(1, 0);
+
+        return self::newBigInteger($zeroScaleDecimal->value);
+    }
+
+    #[Override]
+    public function toBigDecimal(): BigDecimal
+    {
+        return $this;
+    }
+
+    #[Override]
+    public function toBigRational(): BigRational
+    {
+        $numerator = self::newBigInteger($this->value);
+        $denominator = self::newBigInteger('1' . str_repeat('0', $this->scale));
+
+        return self::newBigRational($numerator, $denominator, false);
+    }
+
+    #[Override]
+    public function toScale(int $scale, RoundingMode $roundingMode = RoundingMode::Unnecessary): BigDecimal
+    {
+        if ($scale === $this->scale) {
+            return $this;
+        }
+
+        return $this->dividedBy(BigDecimal::one(), $scale, $roundingMode);
+    }
+
+    #[Override]
+    public function toInt(): int
+    {
+        return $this->toBigInteger()->toInt();
+    }
+
+    #[Override]
+    public function toFloat(): float
+    {
+        return (float) (string) $this;
+    }
+
+    /**
+     * @return numeric-string
+     */
+    #[Override]
+    public function __toString(): string
+    {
+        if ($this->scale === 0) {
+            /** @var numeric-string */
+            return $this->value;
+        }
+
+        $value = $this->getUnscaledValueWithLeadingZeros();
+
+        /** @phpstan-ignore return.type */
+        return substr($value, 0, -$this->scale) . '.' . substr($value, -$this->scale);
+    }
+
+    /**
+     * This method is required for serializing the object and SHOULD NOT be accessed directly.
+     *
+     * @internal
+     *
+     * @return array{value: string, scale: int}
+     */
+    public function __serialize(): array
+    {
+        return ['value' => $this->value, 'scale' => $this->scale];
+    }
+
+    /**
+     * This method is only here to allow unserializing the object and cannot be accessed directly.
+     *
+     * @internal
+     *
+     * @param array{value: string, scale: int} $data
+     *
+     * @throws LogicException
+     */
+    public function __unserialize(array $data): void
+    {
+        /** @phpstan-ignore isset.initializedProperty */
+        if (isset($this->value)) {
+            throw new LogicException('__unserialize() is an internal function, it must not be called directly.');
+        }
+
+        /** @phpstan-ignore deadCode.unreachable */
+        $this->value = $data['value'];
+        $this->scale = $data['scale'];
+    }
+
+    #[Override]
+    protected static function from(BigNumber $number): static
+    {
+        return $number->toBigDecimal();
+    }
+
+    /**
+     * Puts the internal values of the given decimal numbers on the same scale.
+     *
+     * @return array{string, string} The scaled integer values of $x and $y.
+     *
+     * @pure
+     */
+    private function scaleValues(BigDecimal $x, BigDecimal $y): array
+    {
+        $a = $x->value;
+        $b = $y->value;
+
+        if ($b !== '0' && $x->scale > $y->scale) {
+            $b .= str_repeat('0', $x->scale - $y->scale);
+        } elseif ($a !== '0' && $x->scale < $y->scale) {
+            $a .= str_repeat('0', $y->scale - $x->scale);
+        }
+
+        return [$a, $b];
+    }
+
+    /**
+     * @pure
+     */
+    private function valueWithMinScale(int $scale): string
+    {
+        $value = $this->value;
+
+        if ($this->value !== '0' && $scale > $this->scale) {
+            $value .= str_repeat('0', $scale - $this->scale);
+        }
+
+        return $value;
+    }
+
+    /**
+     * Adds leading zeros if necessary to the unscaled value to represent the full decimal number.
+     *
+     * @pure
+     */
+    private function getUnscaledValueWithLeadingZeros(): string
+    {
+        $value = $this->value;
+        $targetLength = $this->scale + 1;
+        $negative = ($value[0] === '-');
+        $length = strlen($value);
+
+        if ($negative) {
+            $length--;
+        }
+
+        if ($length >= $targetLength) {
+            return $this->value;
+        }
+
+        if ($negative) {
+            $value = substr($value, 1);
+        }
+
+        $value = str_pad($value, $targetLength, '0', STR_PAD_LEFT);
+
+        if ($negative) {
+            $value = '-' . $value;
+        }
+
+        return $value;
+    }
+}

vendor/brick/math/src/BigNumber.php

@@ -0,0 +1,629 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Brick\Math;
+
+use Brick\Math\Exception\DivisionByZeroException;
+use Brick\Math\Exception\MathException;
+use Brick\Math\Exception\NumberFormatException;
+use Brick\Math\Exception\RoundingNecessaryException;
+use InvalidArgumentException;
+use JsonSerializable;
+use Override;
+use Stringable;
+
+use function array_shift;
+use function assert;
+use function filter_var;
+use function is_float;
+use function is_int;
+use function is_nan;
+use function is_null;
+use function ltrim;
+use function preg_match;
+use function str_contains;
+use function str_repeat;
+use function strlen;
+use function substr;
+use function trigger_error;
+
+use const E_USER_DEPRECATED;
+use const FILTER_VALIDATE_INT;
+use const PREG_UNMATCHED_AS_NULL;
+
+/**
+ * Base class for arbitrary-precision numbers.
+ *
+ * This class is sealed: it is part of the public API but should not be subclassed in userland.
+ * Protected methods may change in any version.
+ *
+ * @phpstan-sealed BigInteger|BigDecimal|BigRational
+ */
+abstract readonly class BigNumber implements JsonSerializable, Stringable
+{
+    /**
+     * The regular expression used to parse integer or decimal numbers.
+     */
+    private const PARSE_REGEXP_NUMERICAL =
+        '/^' .
+        '(?<sign>[\-\+])?' .
+        '(?<integral>[0-9]+)?' .
+        '(?<point>\.)?' .
+        '(?<fractional>[0-9]+)?' .
+        '(?:[eE](?<exponent>[\-\+]?[0-9]+))?' .
+        '$/';
+
+    /**
+     * The regular expression used to parse rational numbers.
+     */
+    private const PARSE_REGEXP_RATIONAL =
+        '/^' .
+        '(?<sign>[\-\+])?' .
+        '(?<numerator>[0-9]+)' .
+        '\/?' .
+        '(?<denominator>[0-9]+)' .
+        '$/';
+
+    /**
+     * Creates a BigNumber of the given value.
+     *
+     * When of() is called on BigNumber, the concrete return type is dependent on the given value, with the following
+     * rules:
+     *
+     * - BigNumber instances are returned as is
+     * - integer numbers are returned as BigInteger
+     * - floating point numbers are converted to a string then parsed as such (deprecated, will be removed in 0.15)
+     * - strings containing a `/` character are returned as BigRational
+     * - strings containing a `.` character or using an exponential notation are returned as BigDecimal
+     * - strings containing only digits with an optional leading `+` or `-` sign are returned as BigInteger
+     *
+     * When of() is called on BigInteger, BigDecimal, or BigRational, the resulting number is converted to an instance
+     * of the subclass when possible; otherwise a RoundingNecessaryException exception is thrown.
+     *
+     * @throws NumberFormatException      If the format of the number is not valid.
+     * @throws DivisionByZeroException    If the value represents a rational number with a denominator of zero.
+     * @throws RoundingNecessaryException If the value cannot be converted to an instance of the subclass without rounding.
+     *
+     * @pure
+     */
+    final public static function of(BigNumber|int|float|string $value): static
+    {
+        $value = self::_of($value);
+
+        if (static::class === BigNumber::class) {
+            assert($value instanceof static);
+
+            return $value;
+        }
+
+        return static::from($value);
+    }
+
+    /**
+     * Creates a BigNumber of the given value, or returns null if the input is null.
+     *
+     * Behaves like of() for non-null values.
+     *
+     * @see BigNumber::of()
+     *
+     * @throws NumberFormatException      If the format of the number is not valid.
+     * @throws DivisionByZeroException    If the value represents a rational number with a denominator of zero.
+     * @throws RoundingNecessaryException If the value cannot be converted to an instance of the subclass without rounding.
+     */
+    public static function ofNullable(BigNumber|int|float|string|null $value): ?static
+    {
+        if (is_null($value)) {
+            return null;
+        }
+
+        return static::of($value);
+    }
+
+    /**
+     * Returns the minimum of the given values.
+     *
+     * @param BigNumber|int|float|string ...$values The numbers to compare. All the numbers need to be convertible
+     *                                              to an instance of the class this method is called on.
+     *
+     * @throws InvalidArgumentException If no values are given.
+     * @throws MathException            If an argument is not valid.
+     *
+     * @pure
+     */
+    final public static function min(BigNumber|int|float|string ...$values): static
+    {
+        $min = null;
+
+        foreach ($values as $value) {
+            $value = static::of($value);
+
+            if ($min === null || $value->isLessThan($min)) {
+                $min = $value;
+            }
+        }
+
+        if ($min === null) {
+            throw new InvalidArgumentException(__METHOD__ . '() expects at least one value.');
+        }
+
+        return $min;
+    }
+
+    /**
+     * Returns the maximum of the given values.
+     *
+     * @param BigNumber|int|float|string ...$values The numbers to compare. All the numbers need to be convertible
+     *                                              to an instance of the class this method is called on.
+     *
+     * @throws InvalidArgumentException If no values are given.
+     * @throws MathException            If an argument is not valid.
+     *
+     * @pure
+     */
+    final public static function max(BigNumber|int|float|string ...$values): static
+    {
+        $max = null;
+
+        foreach ($values as $value) {
+            $value = static::of($value);
+
+            if ($max === null || $value->isGreaterThan($max)) {
+                $max = $value;
+            }
+        }
+
+        if ($max === null) {
+            throw new InvalidArgumentException(__METHOD__ . '() expects at least one value.');
+        }
+
+        return $max;
+    }
+
+    /**
+     * Returns the sum of the given values.
+     *
+     * When called on BigNumber, sum() accepts any supported type and returns a result whose type is the widest among
+     * the given values (BigInteger < BigDecimal < BigRational).
+     *
+     * When called on BigInteger, BigDecimal, or BigRational, sum() requires that all values can be converted to that
+     * specific subclass, and returns a result of the same type.
+     *
+     * @param BigNumber|int|float|string ...$values The values to add. All values must be convertible to the class on
+     *                                              which this method is called.
+     *
+     * @throws InvalidArgumentException If no values are given.
+     * @throws MathException            If an argument is not valid.
+     *
+     * @pure
+     */
+    final public static function sum(BigNumber|int|float|string ...$values): static
+    {
+        $first = array_shift($values);
+
+        if ($first === null) {
+            throw new InvalidArgumentException(__METHOD__ . '() expects at least one value.');
+        }
+
+        $sum = static::of($first);
+
+        foreach ($values as $value) {
+            $sum = self::add($sum, static::of($value));
+        }
+
+        assert($sum instanceof static);
+
+        return $sum;
+    }
+
+    /**
+     * Checks if this number is equal to the given one.
+     *
+     * @pure
+     */
+    final public function isEqualTo(BigNumber|int|float|string $that): bool
+    {
+        return $this->compareTo($that) === 0;
+    }
+
+    /**
+     * Checks if this number is strictly lower than the given one.
+     *
+     * @pure
+     */
+    final public function isLessThan(BigNumber|int|float|string $that): bool
+    {
+        return $this->compareTo($that) < 0;
+    }
+
+    /**
+     * Checks if this number is lower than or equal to the given one.
+     *
+     * @pure
+     */
+    final public function isLessThanOrEqualTo(BigNumber|int|float|string $that): bool
+    {
+        return $this->compareTo($that) <= 0;
+    }
+
+    /**
+     * Checks if this number is strictly greater than the given one.
+     *
+     * @pure
+     */
+    final public function isGreaterThan(BigNumber|int|float|string $that): bool
+    {
+        return $this->compareTo($that) > 0;
+    }
+
+    /**
+     * Checks if this number is greater than or equal to the given one.
+     *
+     * @pure
+     */
+    final public function isGreaterThanOrEqualTo(BigNumber|int|float|string $that): bool
+    {
+        return $this->compareTo($that) >= 0;
+    }
+
+    /**
+     * Checks if this number equals zero.
+     *
+     * @pure
+     */
+    final public function isZero(): bool
+    {
+        return $this->getSign() === 0;
+    }
+
+    /**
+     * Checks if this number is strictly negative.
+     *
+     * @pure
+     */
+    final public function isNegative(): bool
+    {
+        return $this->getSign() < 0;
+    }
+
+    /**
+     * Checks if this number is negative or zero.
+     *
+     * @pure
+     */
+    final public function isNegativeOrZero(): bool
+    {
+        return $this->getSign() <= 0;
+    }
+
+    /**
+     * Checks if this number is strictly positive.
+     *
+     * @pure
+     */
+    final public function isPositive(): bool
+    {
+        return $this->getSign() > 0;
+    }
+
+    /**
+     * Checks if this number is positive or zero.
+     *
+     * @pure
+     */
+    final public function isPositiveOrZero(): bool
+    {
+        return $this->getSign() >= 0;
+    }
+
+    /**
+     * Returns the sign of this number.
+     *
+     * Returns -1 if the number is negative, 0 if zero, 1 if positive.
+     *
+     * @return -1|0|1
+     *
+     * @pure
+     */
+    abstract public function getSign(): int;
+
+    /**
+     * Compares this number to the given one.
+     *
+     * Returns -1 if `$this` is lower than, 0 if equal to, 1 if greater than `$that`.
+     *
+     * @return -1|0|1
+     *
+     * @throws MathException If the number is not valid.
+     *
+     * @pure
+     */
+    abstract public function compareTo(BigNumber|int|float|string $that): int;
+
+    /**
+     * Converts this number to a BigInteger.
+     *
+     * @throws RoundingNecessaryException If this number cannot be converted to a BigInteger without rounding.
+     *
+     * @pure
+     */
+    abstract public function toBigInteger(): BigInteger;
+
+    /**
+     * Converts this number to a BigDecimal.
+     *
+     * @throws RoundingNecessaryException If this number cannot be converted to a BigDecimal without rounding.
+     *
+     * @pure
+     */
+    abstract public function toBigDecimal(): BigDecimal;
+
+    /**
+     * Converts this number to a BigRational.
+     *
+     * @pure
+     */
+    abstract public function toBigRational(): BigRational;
+
+    /**
+     * Converts this number to a BigDecimal with the given scale, using rounding if necessary.
+     *
+     * @param int          $scale        The scale of the resulting `BigDecimal`.
+     * @param RoundingMode $roundingMode An optional rounding mode, defaults to Unnecessary.
+     *
+     * @throws RoundingNecessaryException If this number cannot be converted to the given scale without rounding.
+     *                                    This only applies when RoundingMode::Unnecessary is used.
+     *
+     * @pure
+     */
+    abstract public function toScale(int $scale, RoundingMode $roundingMode = RoundingMode::Unnecessary): BigDecimal;
+
+    /**
+     * Returns the exact value of this number as a native integer.
+     *
+     * If this number cannot be converted to a native integer without losing precision, an exception is thrown.
+     * Note that the acceptable range for an integer depends on the platform and differs for 32-bit and 64-bit.
+     *
+     * @throws MathException If this number cannot be exactly converted to a native integer.
+     *
+     * @pure
+     */
+    abstract public function toInt(): int;
+
+    /**
+     * Returns an approximation of this number as a floating-point value.
+     *
+     * Note that this method can discard information as the precision of a floating-point value
+     * is inherently limited.
+     *
+     * If the number is greater than the largest representable floating point number, positive infinity is returned.
+     * If the number is less than the smallest representable floating point number, negative infinity is returned.
+     *
+     * @pure
+     */
+    abstract public function toFloat(): float;
+
+    #[Override]
+    final public function jsonSerialize(): string
+    {
+        return $this->__toString();
+    }
+
+    /**
+     * Returns a string representation of this number.
+     *
+     * The output of this method can be parsed by the `of()` factory method;
+     * this will yield an object equal to this one, without any information loss.
+     *
+     * @pure
+     */
+    abstract public function __toString(): string;
+
+    /**
+     * Overridden by subclasses to convert a BigNumber to an instance of the subclass.
+     *
+     * @throws RoundingNecessaryException If the value cannot be converted.
+     *
+     * @pure
+     */
+    abstract protected static function from(BigNumber $number): static;
+
+    /**
+     * Proxy method to access BigInteger's protected constructor from sibling classes.
+     *
+     * @internal
+     *
+     * @pure
+     */
+    final protected function newBigInteger(string $value): BigInteger
+    {
+        return new BigInteger($value);
+    }
+
+    /**
+     * Proxy method to access BigDecimal's protected constructor from sibling classes.
+     *
+     * @internal
+     *
+     * @pure
+     */
+    final protected function newBigDecimal(string $value, int $scale = 0): BigDecimal
+    {
+        return new BigDecimal($value, $scale);
+    }
+
+    /**
+     * Proxy method to access BigRational's protected constructor from sibling classes.
+     *
+     * @internal
+     *
+     * @pure
+     */
+    final protected function newBigRational(BigInteger $numerator, BigInteger $denominator, bool $checkDenominator): BigRational
+    {
+        return new BigRational($numerator, $denominator, $checkDenominator);
+    }
+
+    /**
+     * @throws NumberFormatException   If the format of the number is not valid.
+     * @throws DivisionByZeroException If the value represents a rational number with a denominator of zero.
+     *
+     * @pure
+     */
+    private static function _of(BigNumber|int|float|string $value): BigNumber
+    {
+        if ($value instanceof BigNumber) {
+            return $value;
+        }
+
+        if (is_int($value)) {
+            return new BigInteger((string) $value);
+        }
+
+        if (is_float($value)) {
+            // @phpstan-ignore-next-line
+            trigger_error(
+                'Passing floats to BigNumber::of() and arithmetic methods is deprecated and will be removed in 0.15. ' .
+                'Cast the float to string explicitly to preserve the previous behaviour.',
+                E_USER_DEPRECATED,
+            );
+
+            if (is_nan($value)) {
+                $value = 'NAN';
+            } else {
+                $value = (string) $value;
+            }
+        }
+
+        if (str_contains($value, '/')) {
+            // Rational number
+            if (preg_match(self::PARSE_REGEXP_RATIONAL, $value, $matches, PREG_UNMATCHED_AS_NULL) !== 1) {
+                throw NumberFormatException::invalidFormat($value);
+            }
+
+            $sign = $matches['sign'];
+            $numerator = $matches['numerator'];
+            $denominator = $matches['denominator'];
+
+            $numerator = self::cleanUp($sign, $numerator);
+            $denominator = self::cleanUp(null, $denominator);
+
+            if ($denominator === '0') {
+                throw DivisionByZeroException::denominatorMustNotBeZero();
+            }
+
+            return new BigRational(
+                new BigInteger($numerator),
+                new BigInteger($denominator),
+                false,
+            );
+        } else {
+            // Integer or decimal number
+            if (preg_match(self::PARSE_REGEXP_NUMERICAL, $value, $matches, PREG_UNMATCHED_AS_NULL) !== 1) {
+                throw NumberFormatException::invalidFormat($value);
+            }
+
+            $sign = $matches['sign'];
+            $point = $matches['point'];
+            $integral = $matches['integral'];
+            $fractional = $matches['fractional'];
+            $exponent = $matches['exponent'];
+
+            if ($integral === null && $fractional === null) {
+                throw NumberFormatException::invalidFormat($value);
+            }
+
+            if ($integral === null) {
+                $integral = '0';
+            }
+
+            if ($point !== null || $exponent !== null) {
+                $fractional ??= '';
+
+                if ($exponent !== null) {
+                    if ($exponent[0] === '-') {
+                        $exponent = ltrim(substr($exponent, 1), '0') ?: '0';
+                        $exponent = filter_var($exponent, FILTER_VALIDATE_INT);
+                        if ($exponent !== false) {
+                            $exponent = -$exponent;
+                        }
+                    } else {
+                        if ($exponent[0] === '+') {
+                            $exponent = substr($exponent, 1);
+                        }
+                        $exponent = ltrim($exponent, '0') ?: '0';
+                        $exponent = filter_var($exponent, FILTER_VALIDATE_INT);
+                    }
+                } else {
+                    $exponent = 0;
+                }
+
+                if ($exponent === false) {
+                    throw new NumberFormatException('Exponent too large.');
+                }
+
+                $unscaledValue = self::cleanUp($sign, $integral . $fractional);
+
+                $scale = strlen($fractional) - $exponent;
+
+                if ($scale < 0) {
+                    if ($unscaledValue !== '0') {
+                        $unscaledValue .= str_repeat('0', -$scale);
+                    }
+                    $scale = 0;
+                }
+
+                return new BigDecimal($unscaledValue, $scale);
+            }
+
+            $integral = self::cleanUp($sign, $integral);
+
+            return new BigInteger($integral);
+        }
+    }
+
+    /**
+     * Removes optional leading zeros and applies sign.
+     *
+     * @param string|null $sign   The sign, '+' or '-', optional. Null is allowed for convenience and treated as '+'.
+     * @param string      $number The number, validated as a string of digits.
+     *
+     * @pure
+     */
+    private static function cleanUp(string|null $sign, string $number): string
+    {
+        $number = ltrim($number, '0');
+
+        if ($number === '') {
+            return '0';
+        }
+
+        return $sign === '-' ? '-' . $number : $number;
+    }
+
+    /**
+     * Adds two BigNumber instances in the correct order to avoid a RoundingNecessaryException.
+     *
+     * @pure
+     */
+    private static function add(BigNumber $a, BigNumber $b): BigNumber
+    {
+        if ($a instanceof BigRational) {
+            return $a->plus($b);
+        }
+
+        if ($b instanceof BigRational) {
+            return $b->plus($a);
+        }
+
+        if ($a instanceof BigDecimal) {
+            return $a->plus($b);
+        }
+
+        if ($b instanceof BigDecimal) {
+            return $b->plus($a);
+        }
+
+        return $a->plus($b);
+    }
+}

vendor/brick/math/src/BigRational.php

@@ -0,0 +1,618 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Brick\Math;
+
+use Brick\Math\Exception\DivisionByZeroException;
+use Brick\Math\Exception\MathException;
+use Brick\Math\Exception\NumberFormatException;
+use Brick\Math\Exception\RoundingNecessaryException;
+use InvalidArgumentException;
+use LogicException;
+use Override;
+
+use function substr;
+use function trigger_error;
+
+use const E_USER_DEPRECATED;
+
+/**
+ * An arbitrarily large rational number.
+ *
+ * This class is immutable.
+ */
+final readonly class BigRational extends BigNumber
+{
+    /**
+     * The numerator.
+     */
+    private BigInteger $numerator;
+
+    /**
+     * The denominator. Always strictly positive.
+     */
+    private BigInteger $denominator;
+
+    /**
+     * Protected constructor. Use a factory method to obtain an instance.
+     *
+     * @param BigInteger $numerator        The numerator.
+     * @param BigInteger $denominator      The denominator.
+     * @param bool       $checkDenominator Whether to check the denominator for negative and zero.
+     *
+     * @throws DivisionByZeroException If the denominator is zero.
+     *
+     * @pure
+     */
+    protected function __construct(BigInteger $numerator, BigInteger $denominator, bool $checkDenominator)
+    {
+        if ($checkDenominator) {
+            if ($denominator->isZero()) {
+                throw DivisionByZeroException::denominatorMustNotBeZero();
+            }
+
+            if ($denominator->isNegative()) {
+                $numerator = $numerator->negated();
+                $denominator = $denominator->negated();
+            }
+        }
+
+        $this->numerator = $numerator;
+        $this->denominator = $denominator;
+    }
+
+    /**
+     * Creates a BigRational out of a numerator and a denominator.
+     *
+     * If the denominator is negative, the signs of both the numerator and the denominator
+     * will be inverted to ensure that the denominator is always positive.
+     *
+     * @deprecated Use ofFraction() instead.
+     *
+     * @param BigNumber|int|float|string $numerator   The numerator. Must be convertible to a BigInteger.
+     * @param BigNumber|int|float|string $denominator The denominator. Must be convertible to a BigInteger.
+     *
+     * @throws NumberFormatException      If an argument does not represent a valid number.
+     * @throws RoundingNecessaryException If an argument represents a non-integer number.
+     * @throws DivisionByZeroException    If the denominator is zero.
+     */
+    public static function nd(
+        BigNumber|int|float|string $numerator,
+        BigNumber|int|float|string $denominator,
+    ): BigRational {
+        trigger_error(
+            'The BigRational::nd() method is deprecated, use BigRational::ofFraction() instead.',
+            E_USER_DEPRECATED,
+        );
+
+        return self::ofFraction($numerator, $denominator);
+    }
+
+    /**
+     * Creates a BigRational out of a numerator and a denominator.
+     *
+     * If the denominator is negative, the signs of both the numerator and the denominator
+     * will be inverted to ensure that the denominator is always positive.
+     *
+     * @param BigNumber|int|float|string $numerator   The numerator. Must be convertible to a BigInteger.
+     * @param BigNumber|int|float|string $denominator The denominator. Must be convertible to a BigInteger.
+     *
+     * @throws NumberFormatException      If an argument does not represent a valid number.
+     * @throws RoundingNecessaryException If an argument represents a non-integer number.
+     * @throws DivisionByZeroException    If the denominator is zero.
+     *
+     * @pure
+     */
+    public static function ofFraction(
+        BigNumber|int|float|string $numerator,
+        BigNumber|int|float|string $denominator,
+    ): BigRational {
+        $numerator = BigInteger::of($numerator);
+        $denominator = BigInteger::of($denominator);
+
+        return new BigRational($numerator, $denominator, true);
+    }
+
+    /**
+     * Returns a BigRational representing zero.
+     *
+     * @pure
+     */
+    public static function zero(): BigRational
+    {
+        /** @var BigRational|null $zero */
+        static $zero;
+
+        if ($zero === null) {
+            $zero = new BigRational(BigInteger::zero(), BigInteger::one(), false);
+        }
+
+        return $zero;
+    }
+
+    /**
+     * Returns a BigRational representing one.
+     *
+     * @pure
+     */
+    public static function one(): BigRational
+    {
+        /** @var BigRational|null $one */
+        static $one;
+
+        if ($one === null) {
+            $one = new BigRational(BigInteger::one(), BigInteger::one(), false);
+        }
+
+        return $one;
+    }
+
+    /**
+     * Returns a BigRational representing ten.
+     *
+     * @pure
+     */
+    public static function ten(): BigRational
+    {
+        /** @var BigRational|null $ten */
+        static $ten;
+
+        if ($ten === null) {
+            $ten = new BigRational(BigInteger::ten(), BigInteger::one(), false);
+        }
+
+        return $ten;
+    }
+
+    /**
+     * @pure
+     */
+    public function getNumerator(): BigInteger
+    {
+        return $this->numerator;
+    }
+
+    /**
+     * @pure
+     */
+    public function getDenominator(): BigInteger
+    {
+        return $this->denominator;
+    }
+
+    /**
+     * Returns the quotient of the division of the numerator by the denominator.
+     *
+     * @deprecated Will be removed in 0.15. Use getIntegralPart() instead.
+     */
+    public function quotient(): BigInteger
+    {
+        trigger_error(
+            'BigRational::quotient() is deprecated and will be removed in 0.15. Use getIntegralPart() instead.',
+            E_USER_DEPRECATED,
+        );
+
+        return $this->numerator->quotient($this->denominator);
+    }
+
+    /**
+     * Returns the remainder of the division of the numerator by the denominator.
+     *
+     * @deprecated Will be removed in 0.15. Use `$number->getNumerator()->remainder($number->getDenominator())` instead.
+     */
+    public function remainder(): BigInteger
+    {
+        trigger_error(
+            'BigRational::remainder() is deprecated and will be removed in 0.15. Use `$number->getNumerator()->remainder($number->getDenominator())` instead.',
+            E_USER_DEPRECATED,
+        );
+
+        return $this->numerator->remainder($this->denominator);
+    }
+
+    /**
+     * Returns the quotient and remainder of the division of the numerator by the denominator.
+     *
+     * @deprecated Will be removed in 0.15. Use `$number->getNumerator()->quotientAndRemainder($number->getDenominator())` instead.
+     *
+     * @return array{BigInteger, BigInteger}
+     */
+    public function quotientAndRemainder(): array
+    {
+        trigger_error(
+            'BigRational::quotientAndRemainder() is deprecated and will be removed in 0.15. Use `$number->getNumerator()->quotientAndRemainder($number->getDenominator())` instead.',
+            E_USER_DEPRECATED,
+        );
+
+        return $this->numerator->quotientAndRemainder($this->denominator);
+    }
+
+    /**
+     * Returns the integral part of this rational number.
+     *
+     * Examples:
+     *
+     * - `7/3` returns `2` (since 7/3 = 2 + 1/3)
+     * - `-7/3` returns `-2` (since -7/3 = -2 + (-1/3))
+     *
+     * The following identity holds: `$r->isEqualTo($r->getFractionalPart()->plus($r->getIntegralPart()))`.
+     *
+     * @pure
+     */
+    public function getIntegralPart(): BigInteger
+    {
+        return $this->numerator->quotient($this->denominator);
+    }
+
+    /**
+     * Returns the fractional part of this rational number.
+     *
+     * Examples:
+     *
+     * - `7/3` returns `1/3` (since 7/3 = 2 + 1/3)
+     * - `-7/3` returns `-1/3` (since -7/3 = -2 + (-1/3))
+     *
+     * The following identity holds: `$r->isEqualTo($r->getFractionalPart()->plus($r->getIntegralPart()))`.
+     *
+     * @pure
+     */
+    public function getFractionalPart(): BigRational
+    {
+        return new BigRational($this->numerator->remainder($this->denominator), $this->denominator, false);
+    }
+
+    /**
+     * Returns the sum of this number and the given one.
+     *
+     * @param BigNumber|int|float|string $that The number to add.
+     *
+     * @throws MathException If the number is not valid.
+     *
+     * @pure
+     */
+    public function plus(BigNumber|int|float|string $that): BigRational
+    {
+        $that = BigRational::of($that);
+
+        $numerator = $this->numerator->multipliedBy($that->denominator);
+        $numerator = $numerator->plus($that->numerator->multipliedBy($this->denominator));
+        $denominator = $this->denominator->multipliedBy($that->denominator);
+
+        return new BigRational($numerator, $denominator, false);
+    }
+
+    /**
+     * Returns the difference of this number and the given one.
+     *
+     * @param BigNumber|int|float|string $that The number to subtract.
+     *
+     * @throws MathException If the number is not valid.
+     *
+     * @pure
+     */
+    public function minus(BigNumber|int|float|string $that): BigRational
+    {
+        $that = BigRational::of($that);
+
+        $numerator = $this->numerator->multipliedBy($that->denominator);
+        $numerator = $numerator->minus($that->numerator->multipliedBy($this->denominator));
+        $denominator = $this->denominator->multipliedBy($that->denominator);
+
+        return new BigRational($numerator, $denominator, false);
+    }
+
+    /**
+     * Returns the product of this number and the given one.
+     *
+     * @param BigNumber|int|float|string $that The multiplier.
+     *
+     * @throws MathException If the multiplier is not a valid number.
+     *
+     * @pure
+     */
+    public function multipliedBy(BigNumber|int|float|string $that): BigRational
+    {
+        $that = BigRational::of($that);
+
+        $numerator = $this->numerator->multipliedBy($that->numerator);
+        $denominator = $this->denominator->multipliedBy($that->denominator);
+
+        return new BigRational($numerator, $denominator, false);
+    }
+
+    /**
+     * Returns the result of the division of this number by the given one.
+     *
+     * @param BigNumber|int|float|string $that The divisor.
+     *
+     * @throws MathException If the divisor is not a valid number, or is zero.
+     *
+     * @pure
+     */
+    public function dividedBy(BigNumber|int|float|string $that): BigRational
+    {
+        $that = BigRational::of($that);
+
+        $numerator = $this->numerator->multipliedBy($that->denominator);
+        $denominator = $this->denominator->multipliedBy($that->numerator);
+
+        return new BigRational($numerator, $denominator, true);
+    }
+
+    /**
+     * Returns this number exponentiated to the given value.
+     *
+     * @throws InvalidArgumentException If the exponent is not in the range 0 to 1,000,000.
+     *
+     * @pure
+     */
+    public function power(int $exponent): BigRational
+    {
+        if ($exponent === 0) {
+            $one = BigInteger::one();
+
+            return new BigRational($one, $one, false);
+        }
+
+        if ($exponent === 1) {
+            return $this;
+        }
+
+        return new BigRational(
+            $this->numerator->power($exponent),
+            $this->denominator->power($exponent),
+            false,
+        );
+    }
+
+    /**
+     * Limits (clamps) this number between the given minimum and maximum values.
+     *
+     * If the number is lower than $min, returns a copy of $min.
+     * If the number is greater than $max, returns a copy of $max.
+     * Otherwise, returns this number unchanged.
+     *
+     * @param BigNumber|int|float|string $min The minimum. Must be convertible to a BigRational.
+     * @param BigNumber|int|float|string $max The maximum. Must be convertible to a BigRational.
+     *
+     * @throws MathException            If min/max are not convertible to a BigRational.
+     * @throws InvalidArgumentException If min is greater than max.
+     *
+     * @pure
+     */
+    public function clamp(BigNumber|int|float|string $min, BigNumber|int|float|string $max): BigRational
+    {
+        $min = BigRational::of($min);
+        $max = BigRational::of($max);
+
+        if ($min->isGreaterThan($max)) {
+            throw new InvalidArgumentException('Minimum value must be less than or equal to maximum value.');
+        }
+
+        if ($this->isLessThan($min)) {
+            return $min;
+        } elseif ($this->isGreaterThan($max)) {
+            return $max;
+        }
+
+        return $this;
+    }
+
+    /**
+     * Returns the reciprocal of this BigRational.
+     *
+     * The reciprocal has the numerator and denominator swapped.
+     *
+     * @throws DivisionByZeroException If the numerator is zero.
+     *
+     * @pure
+     */
+    public function reciprocal(): BigRational
+    {
+        return new BigRational($this->denominator, $this->numerator, true);
+    }
+
+    /**
+     * Returns the absolute value of this BigRational.
+     *
+     * @pure
+     */
+    public function abs(): BigRational
+    {
+        return new BigRational($this->numerator->abs(), $this->denominator, false);
+    }
+
+    /**
+     * Returns the negated value of this BigRational.
+     *
+     * @pure
+     */
+    public function negated(): BigRational
+    {
+        return new BigRational($this->numerator->negated(), $this->denominator, false);
+    }
+
+    /**
+     * Returns the simplified value of this BigRational.
+     *
+     * @pure
+     */
+    public function simplified(): BigRational
+    {
+        $gcd = $this->numerator->gcd($this->denominator);
+
+        $numerator = $this->numerator->quotient($gcd);
+        $denominator = $this->denominator->quotient($gcd);
+
+        return new BigRational($numerator, $denominator, false);
+    }
+
+    #[Override]
+    public function compareTo(BigNumber|int|float|string $that): int
+    {
+        return $this->minus($that)->getSign();
+    }
+
+    #[Override]
+    public function getSign(): int
+    {
+        return $this->numerator->getSign();
+    }
+
+    #[Override]
+    public function toBigInteger(): BigInteger
+    {
+        $simplified = $this->simplified();
+
+        if (! $simplified->denominator->isEqualTo(1)) {
+            throw new RoundingNecessaryException('This rational number cannot be represented as an integer value without rounding.');
+        }
+
+        return $simplified->numerator;
+    }
+
+    #[Override]
+    public function toBigDecimal(): BigDecimal
+    {
+        return $this->numerator->toBigDecimal()->dividedByExact($this->denominator);
+    }
+
+    #[Override]
+    public function toBigRational(): BigRational
+    {
+        return $this;
+    }
+
+    #[Override]
+    public function toScale(int $scale, RoundingMode $roundingMode = RoundingMode::Unnecessary): BigDecimal
+    {
+        return $this->numerator->toBigDecimal()->dividedBy($this->denominator, $scale, $roundingMode);
+    }
+
+    #[Override]
+    public function toInt(): int
+    {
+        return $this->toBigInteger()->toInt();
+    }
+
+    #[Override]
+    public function toFloat(): float
+    {
+        $simplified = $this->simplified();
+
+        return $simplified->numerator->toFloat() / $simplified->denominator->toFloat();
+    }
+
+    /**
+     * Returns the decimal representation of this rational number, with repeating decimals in parentheses.
+     *
+     * Examples:
+     *
+     * - `10/3` returns `3.(3)`
+     * - `171/70` returns `2.4(428571)`
+     * - `1/2` returns `0.5`
+     *
+     * Warning: the length of the repeating decimal period can be as large as `denominator - 1`.
+     * For fractions with large denominators, this method may use excessive memory and time.
+     * For example, `1/100019` has a repeating period of 100,018 digits.
+     *
+     * @pure
+     */
+    public function toRepeatingDecimalString(): string
+    {
+        if ($this->numerator->isZero()) {
+            return '0';
+        }
+
+        $sign = $this->numerator->isNegative() ? '-' : '';
+        $numerator = $this->numerator->abs();
+        $denominator = $this->denominator;
+
+        $integral = $numerator->quotient($denominator);
+        $remainder = $numerator->remainder($denominator);
+
+        $integralString = (string) $integral;
+
+        if ($remainder->isZero()) {
+            return $sign . $integralString;
+        }
+
+        $digits = '';
+        $remainderPositions = [];
+        $index = 0;
+
+        while (! $remainder->isZero()) {
+            $remainderString = (string) $remainder;
+
+            if (isset($remainderPositions[$remainderString])) {
+                $repeatIndex = $remainderPositions[$remainderString];
+                $nonRepeating = substr($digits, 0, $repeatIndex);
+                $repeating = substr($digits, $repeatIndex);
+
+                return $sign . $integralString . '.' . $nonRepeating . '(' . $repeating . ')';
+            }
+
+            $remainderPositions[$remainderString] = $index;
+            $remainder = $remainder->multipliedBy(10);
+
+            $digits .= (string) $remainder->quotient($denominator);
+            $remainder = $remainder->remainder($denominator);
+            $index++;
+        }
+
+        return $sign . $integralString . '.' . $digits;
+    }
+
+    #[Override]
+    public function __toString(): string
+    {
+        $numerator = (string) $this->numerator;
+        $denominator = (string) $this->denominator;
+
+        if ($denominator === '1') {
+            return $numerator;
+        }
+
+        return $numerator . '/' . $denominator;
+    }
+
+    /**
+     * This method is required for serializing the object and SHOULD NOT be accessed directly.
+     *
+     * @internal
+     *
+     * @return array{numerator: BigInteger, denominator: BigInteger}
+     */
+    public function __serialize(): array
+    {
+        return ['numerator' => $this->numerator, 'denominator' => $this->denominator];
+    }
+
+    /**
+     * This method is only here to allow unserializing the object and cannot be accessed directly.
+     *
+     * @internal
+     *
+     * @param array{numerator: BigInteger, denominator: BigInteger} $data
+     *
+     * @throws LogicException
+     */
+    public function __unserialize(array $data): void
+    {
+        /** @phpstan-ignore isset.initializedProperty */
+        if (isset($this->numerator)) {
+            throw new LogicException('__unserialize() is an internal function, it must not be called directly.');
+        }
+
+        /** @phpstan-ignore deadCode.unreachable */
+        $this->numerator = $data['numerator'];
+        $this->denominator = $data['denominator'];
+    }
+
+    #[Override]
+    protected static function from(BigNumber $number): static
+    {
+        return $number->toBigRational();
+    }
+}

vendor/brick/math/src/Exception/DivisionByZeroException.php

@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Brick\Math\Exception;
+
+/**
+ * Exception thrown when a division by zero occurs.
+ */
+final class DivisionByZeroException extends MathException
+{
+    /**
+     * @pure
+     */
+    public static function divisionByZero(): DivisionByZeroException
+    {
+        return new self('Division by zero.');
+    }
+
+    /**
+     * @pure
+     */
+    public static function modulusMustNotBeZero(): DivisionByZeroException
+    {
+        return new self('The modulus must not be zero.');
+    }
+
+    /**
+     * @pure
+     */
+    public static function denominatorMustNotBeZero(): DivisionByZeroException
+    {
+        return new self('The denominator of a rational number cannot be zero.');
+    }
+}

vendor/brick/math/src/Exception/IntegerOverflowException.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Brick\Math\Exception;
+
+use Brick\Math\BigInteger;
+
+use function sprintf;
+
+use const PHP_INT_MAX;
+use const PHP_INT_MIN;
+
+/**
+ * Exception thrown when an integer overflow occurs.
+ */
+final class IntegerOverflowException extends MathException
+{
+    /**
+     * @pure
+     */
+    public static function toIntOverflow(BigInteger $value): IntegerOverflowException
+    {
+        $message = '%s is out of range %d to %d and cannot be represented as an integer.';
+
+        return new self(sprintf($message, (string) $value, PHP_INT_MIN, PHP_INT_MAX));
+    }
+}

vendor/brick/math/src/Exception/MathException.php

@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Brick\Math\Exception;
+
+use RuntimeException;
+
+/**
+ * Base class for all math exceptions.
+ */
+class MathException extends RuntimeException
+{
+}

vendor/brick/math/src/Exception/NegativeNumberException.php

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Brick\Math\Exception;
+
+/**
+ * Exception thrown when attempting to perform an unsupported operation, such as a square root, on a negative number.
+ */
+final class NegativeNumberException extends MathException
+{
+}

vendor/brick/math/src/Exception/NumberFormatException.php

@@ -0,0 +1,49 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Brick\Math\Exception;
+
+use function dechex;
+use function ord;
+use function sprintf;
+use function strtoupper;
+
+/**
+ * Exception thrown when attempting to create a number from a string with an invalid format.
+ */
+final class NumberFormatException extends MathException
+{
+    /**
+     * @pure
+     */
+    public static function invalidFormat(string $value): self
+    {
+        return new self(sprintf(
+            'The given value "%s" does not represent a valid number.',
+            $value,
+        ));
+    }
+
+    /**
+     * @param string $char The failing character.
+     *
+     * @pure
+     */
+    public static function charNotInAlphabet(string $char): self
+    {
+        $ord = ord($char);
+
+        if ($ord < 32 || $ord > 126) {
+            $char = strtoupper(dechex($ord));
+
+            if ($ord < 10) {
+                $char = '0' . $char;
+            }
+        } else {
+            $char = '"' . $char . '"';
+        }
+
+        return new self(sprintf('Char %s is not a valid character in the given alphabet.', $char));
+    }
+}

vendor/brick/math/src/Exception/RoundingNecessaryException.php

@@ -0,0 +1,19 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Brick\Math\Exception;
+
+/**
+ * Exception thrown when a number cannot be represented at the requested scale without rounding.
+ */
+final class RoundingNecessaryException extends MathException
+{
+    /**
+     * @pure
+     */
+    public static function roundingNecessary(): RoundingNecessaryException
+    {
+        return new self('Rounding is necessary to represent the result of the operation at this scale.');
+    }
+}