<?php

namespace Kylin\Modules\Console\Commands;

use Illuminate\Console\Command;
use Illuminate\Filesystem\Filesystem;
use Kylin\Modules\ModuleManager;

/**
 * 模块生成事件命令
 *
 * 为模块生成新的事件类
 */
class ModuleMakeEventCommand extends Command
{
    /**
     * 命令名称和签名
     *
     * @var string
     * 
     * 命令参数说明：
     * 1. {module} - 模块名称（必填）
     *    - 数据类型：字符串
     *    - 用途：指定事件类所属的模块名称
     *    - 示例：php artisan module:make-event game UserRegistered
     * 
     * 2. {name} - 事件类名称（必填）
     *    - 数据类型：字符串
     *    - 用途：指定要创建的事件类名称
     *    - 示例：php artisan module:make-event game UserRegistered
     * 
     * 命令选项说明：
     * 1. {--q|queued} - 生成队列事件
     *    - 简写：-q
     *    - 完整形式：--queued
     *    - 用途：生成一个可队列化的事件类
     *    - 示例：php artisan module:make-event game UserRegistered --queued
     */
    protected $signature = 'module:make-event {module : 模块名称} {name : 事件类名称} {--q|queued : 生成队列事件}';

    /**
     * 命令描述
     *
     * @var string
     */
    protected $description = '为模块生成新的事件类';

    /**
     * 文件系统实例
     *
     * @var Filesystem
     */
    private readonly Filesystem $files;

    /**
     * 创建新命令实例
     *
     * @param  ModuleManager  $moduleManager  模块管理器实例
     * @param  Filesystem  $files  文件系统实例
     */
    public function __construct(
        private readonly ModuleManager $moduleManager,
        Filesystem $files
    ) {
        parent::__construct();
        $this->files = $files;
    }

    /**
     * 执行控制台命令
     */
    public function handle(): int
    {
        $moduleName = (string) $this->argument('module');
        $name = (string) $this->argument('name');
        $queued = $this->option('queued');

        // 检查模块是否存在
        $module = $this->moduleManager->get($moduleName);
        if (!$module) {
            $this->error("模块 [{$moduleName}] 未找到");
            return 1;
        }

        $modulePath = $module->getPath();
        $srcPath = "{$modulePath}/src";
        $eventsPath = "{$srcPath}/Events";

        // 确保目录存在
        if (!($this->files->exists($eventsPath))) {
            $this->files->makeDirectory($eventsPath, 0755, true);
            $this->info("创建事件目录: {$eventsPath}");
        }

        // 生成事件类
        $eventClass = $this->buildEventClass($moduleName, $name, $queued);
        $eventFile = "{$eventsPath}/{$name}.php";

        if ($this->files->exists($eventFile)) {
            $this->error("事件 [{$name}] 已存在");
            return 1;
        }

        $this->files->put($eventFile, $eventClass);
        $this->info("创建事件: {$eventFile}");

        return 0;
    }

    /**
     * 构建事件类
     *
     * @param  string  $moduleName  模块名称
     * @param  string  $name  事件名称
     * @param  bool  $queued  是否生成队列事件
     * @return string  事件类代码
     */
    protected function buildEventClass(string $moduleName, string $name, bool $queued): string
    {
        $namespace = "{$moduleName}\Events";
        $stubPath = __DIR__ . '/../../../stubs/event.stub';
        $stub = $this->files->get($stubPath);

        $implements = '';
        $useStatements = '';

        if ($queued) {
            $implements = ' implements ShouldQueue';
            $useStatements = "use Illuminate\\Contracts\\Queue\\ShouldQueue;\n";
        }

        return str_replace(
            ['{{ namespace }}', '{{ class }}', '{{ implements }}', '{{ use_statements }}'],
            [$namespace, $name, $implements, $useStatements],
            $stub
        );
    }
}