<?php

declare(strict_types=1);

namespace Beste;

use JsonException;
use SplFileInfo;
use SplFileObject;
use Throwable;
use UnexpectedValueException;

final class Json
{
    private const ENCODE_DEFAULT = JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE;
    private const ENCODE_PRETTY = self::ENCODE_DEFAULT | JSON_PRETTY_PRINT;
    private const DECODE_DEFAULT = JSON_BIGINT_AS_STRING;

    /**
     * @throws UnexpectedValueException
     *
     * @return ($forceArray is true ? array<mixed> : mixed)
     */
    public static function decode(string $json, ?bool $forceArray = null): mixed
    {
        $forceArray ??= false;
        $flags = $forceArray ? JSON_OBJECT_AS_ARRAY : 0;

        try {
            return json_decode($json, $forceArray, 512, $flags | self::DECODE_DEFAULT | JSON_THROW_ON_ERROR);
        } catch (JsonException $e) {
            throw new UnexpectedValueException($e->getMessage());
        }
    }

    /**
     * @param non-empty-string $path
     *
     * @throws UnexpectedValueException
     *
     * @return ($forceArray is true ? array<mixed> : mixed)
     */
    public static function decodeFile(string $path, ?bool $forceArray = null): mixed
    {
        if (!is_readable($path)) {
            throw new UnexpectedValueException("The file at '$path' is not readable");
        }

        if (is_dir($path)) {
            throw new UnexpectedValueException("'$path' points to a directory");
        }

        $contents = file_get_contents($path);

        if ($contents === false) {
            throw new UnexpectedValueException("The file at '$path' is not readable");
        }

        if ($contents === '') {
            throw new UnexpectedValueException("The file at '$path' is empty");
        }

        return self::decode($contents, $forceArray);
    }

    /**
     * @throws UnexpectedValueException
     */
    public static function encode(mixed $data, ?int $options = null): string
    {
        $options ??= 0;

        try {
            return json_encode($data, $options | self::ENCODE_DEFAULT | JSON_THROW_ON_ERROR);
        } catch (JsonException $e) {
            throw new UnexpectedValueException($e->getMessage());
        }
    }

    /**
     * @throws UnexpectedValueException
     */
    public static function pretty(mixed $value, ?int $options = null): string
    {
        $options ??= 0;

        return self::encode($value, $options | self::ENCODE_PRETTY);
    }
}