یک‌بار قصه-کدی را بنویس؛ بر چندین جهان فرمان بده.

namespace App\Nexus;
// To Activate, Just Drop The Code In :: app/Nexus/GamePanelNexus.php

class GamePanelNexus
{
    #[OnCommand('panel')]
    public function showDashboard(Krubot $bot): void
    {
        // Super-Speed Fail-safe resolver for userData
        $isActive = $bot->userStorage()->get('subscribed', false);

        $bot->reply('**Welcome back Commander!**\nYour Account Status 🎮: ' . ($isActive ? 'Active ✅' : 'DeActive ❌️'))
            ->attachKeyboard(function($kb) use($isActive) {
                
            $kb

                // 🟡 Row 1: Primary Action Buttons (3 columns each = 50% width distribution)
                ->row(fn($row) => $row
                    ->add(PowerButton::make('♦️ Buy Gems 💎')->col(3)->action('buy_gem'))
                    ->add(PowerButton::make('♦️ Top-up Wallet 💰')->col(3)->action('wallet'))
                )

                // Only attach Server buttons IF the account is active
                ->when($isActive, function(Keyboard $kbx) {

                    // 🔵 Row 2: Conditional Server Selection Matrix
                    // This demonstrates the raw power of the col() method; strictly aligning
                    // 3 elements side-by-side (2 columns each = 33.33% viewport width).
                    $kbx->row(
                        fn($row) => $row
                            ->add(PowerButton::simple('srv_1', 'IR 🇮🇷')->col(2))
                            ->add(PowerButton::simple('srv_2', 'US 🇺🇸')->col(2))
                            ->add(PowerButton::simple('srv_3', 'EU 🇪🇺')->col(2))
                    );

                })

                // 🔴 Row 3: Full-width Support / Fallback Button (6 columns = 100% viewport width)
                ->row(fn($row) => $row
                    ->add(PowerButton::make('♦️ Online Support 🆘')->col(6)->action('support'))
                );
            })
        ->send();
    }

    #[Action('buy_gem')]
    public function buy_gem(Krubot $bot): void 
    {
        // Business logic for purchasing gems...
    }
    
    #[Action('wallet')]
    public function show_wallet(Krubot $bot): void 
    {
        // Business logic for wallet top-up...
    }

    #[OnCommand('menu')]
    public function showGamesMenu(Krubot $bot): void
    {
        // 1. Fetching VIP products from the database.
        $products = Product::query()
            ->where('is_vip', true)
            ->get(['id', 'name', 'price']); // Returns an Eloquent Collection
        
        // 2. Rapid Transformation via Laravel Collections.
        // Mapping the Products directly into the PowerButton actionable architecture.
        $buttons = $products->map(function (Product $product) {
            $label = "{$product->name} (💰 {$product->price}T)";
            return PowerButton::make($label)->action('order', ['id' => $product->id]);
        })->toArray();

        // 3. The Magic of Chunking: Automatically grouping elements into a pristine matrix.
        // Changing chunk(2) to chunk(3) effortlessly switches the grid layout to a 3-column UI.
        $bot->reply("Today's Exclusive VIP Games: ✨️🧧")
            ->keyboard(
                Keyboard::make()
                    ->rtl() // Can be used for properly Align Persian layouts on the screen by forcing Right-to-Left rendering order // + rtl(false) === ltr()
                    ->buttons($buttons)
                    ->chunk(2) // <--- Its DX! Zero manual row calculation!
            )
        ->send();
    }

    #[Action('order')]
    public function orderGame(Krubot $bot, int $id): void 
    {
        // Business logic for $product Order

        $product = Product::find($id);
        if(!$product)
            return $bot->reply("Product Id is Invalid")->send();

        // $userId = $bot->userId();
        // AmethystMatrix::whisper('Order Started', compact('userId', 'product'));
        // not needed userId, AmethystMatrix collects & logs any data allowed to her via: `config('krubot.amethyst.report_context')[]`

        AmethystMatrix::whisper('Order Started', $product);

        $bot
        ->reply('You\'ve Chosen a Great Game to Engage ✨️🎮️ :: ***' . $product->name . '***')
        ->send();

    }
}