<?php

declare(strict_types=1);

/**
 * 本文件属于 DBErp 进销存系统。
 *
 * 版权所有 © 2026 北京珑大钜商科技有限公司。保留所有权利。
 *
 * 未经官方授权，不得删除、篡改或隐藏本文件中的版权声明、产品标识与来源信息。
 * 商业授权、官方更新与技术支持服务，请以珑大官方支持中心记录为准。
 *
 * @link https://support.loongdom.cn
 * @see  https://www.dberp.com.cn
 */

namespace App\Services\Plugin;

use Illuminate\Support\Facades\Cache;

/**
 * 插件安装/更新任务锁：防止启停与并发安装/更新冲突。
 */
final class HostPluginOperationLock
{
    private const CACHE_PREFIX = 'dberp.plugin.operation_lock.';

    private const DEFAULT_TTL_SECONDS = 1800;

    public function acquire(string $pluginCode, string $operation): bool
    {
        $key = $this->cacheKey($pluginCode);

        if (Cache::has($key)) {
            return false;
        }

        return Cache::put($key, $operation, self::DEFAULT_TTL_SECONDS);
    }

    public function release(string $pluginCode): void
    {
        Cache::forget($this->cacheKey($pluginCode));
    }

    public function isLocked(string $pluginCode): bool
    {
        return Cache::has($this->cacheKey($pluginCode));
    }

    public function currentOperation(string $pluginCode): ?string
    {
        $value = Cache::get($this->cacheKey($pluginCode));

        return is_string($value) && $value !== '' ? $value : null;
    }

    private function cacheKey(string $pluginCode): string
    {
        return self::CACHE_PREFIX.strtolower(trim($pluginCode));
    }
}
