<?php

declare(strict_types=1);

/**
 * vim:set softtabstop=4 shiftwidth=4 expandtab:
 *
 * LICENSE: GNU Affero General Public License, version 3 (AGPL-3.0-or-later)
 * Copyright Ampache.org, 2001-2026
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Affero General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Affero General Public License for more details.
 *
 * You should have received a copy of the GNU Affero General Public License
 * along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */

namespace Ampache\Module\System\Cache;

use DateInterval;
use Generator;
use Psr\SimpleCache\CacheInterface;
use Psr\SimpleCache\InvalidArgumentException;

/**
 * Simple array-cache implementation
 *
 * @see CacheInterface
 */
final class ArrayCacheDriver implements CacheInterface
{
    /** @var array<string, scalar> */
    private array $cache = [];

    public function get(string $key, mixed $default = null): mixed
    {
        return $this->cache[$key] ?? $default;
    }

    public function set(string $key, mixed $value, null|int|DateInterval $ttl = null): bool
    {
        $this->cache[$key] = $value;

        return true;
    }

    public function delete(string $key): bool
    {
        if ($this->has($key)) {
            unset($this->cache[$key]);
        }

        return true;
    }

    public function clear(): bool
    {
        $this->cache = [];

        return true;
    }

    /**
     * @param iterable<string> $keys
     *
     * @return Generator<string, scalar>
     */
    public function getMultiple(iterable $keys, mixed $default = null): Generator
    {
        foreach ($keys as $key) {
            yield $key => $this->cache[$key] ?? $default;
        }
    }

    /**
     * @param iterable<string, scalar> $values
     */
    public function setMultiple(iterable $values, null|int|DateInterval $ttl = null): bool
    {
        foreach ($values as $key => $value) {
            $this->cache[$key] = $value;
        }

        return true;
    }

    /**
     * @param iterable<string> $keys
     */
    public function deleteMultiple(iterable $keys): bool
    {
        foreach ($keys as $key) {
            try {
                $this->delete($key);
            } catch (InvalidArgumentException) {
                // try to delete everything and skip the exception
            }
        }

        return true;
    }

    public function has(string $key): bool
    {
        return array_key_exists($key, $this->cache);
    }
}
