index/src/Http/Content/JsonContent.php

<?php
// JsonContent.php
// Created: 2022-02-10
// Updated: 2024-08-01

namespace Index\Http\Content;

use JsonSerializable;
use Index\IO\{Stream,FileStream};

/**
 * Represents JSON body content for a HTTP message.
 */
class JsonContent implements IHttpContent, JsonSerializable {
    private mixed $content;

    /**
     * @param mixed $content Content to be JSON encoded.
     */
    public function __construct(mixed $content) {
        $this->content = $content;
    }

    /**
     * Retrieves unencoded content.
     *
     * @return mixed Content.
     */
    public function getContent(): mixed {
        return $this->content;
    }

    public function jsonSerialize(): mixed {
        return $this->content;
    }

    /**
     * Encodes the content.
     *
     * @return string JSON encoded string.
     */
    public function encode(): string {
        return json_encode($this->content);
    }

    public function __toString(): string {
        return $this->encode();
    }

    /**
     * Creates an instance from encoded content.
     *
     * @param mixed $encoded JSON encoded content.
     * @return JsonContent Instance representing the provided content.
     */
    public static function fromEncoded(mixed $encoded): JsonContent {
        return new JsonContent(json_decode($encoded));
    }

    /**
     * Creates an instance from an encoded file.
     *
     * @param string $path Path to the JSON encoded file.
     * @return JsonContent Instance representing the provided path.
     */
    public static function fromFile(string $path): JsonContent {
        return self::fromEncoded(FileStream::openRead($path));
    }

    /**
     * Creates an instance from the raw request body.
     *
     * @return JsonContent Instance representing the request body.
     */
    public static function fromRequest(): JsonContent {
        return self::fromFile('php://input');
    }
}