AbstractDataTransferObject

28abstract class AbstractDataTransferObject implements WithArrayTransformationInterface, WithJsonSchemaInterface, JsonSerializable29{30    /**31     * Validates that required keys exist in the array data.32     *33     * @since 0.1.034     *35     * @param array<mixed> $data The array data to validate.36     * @param string[] $requiredKeys The keys that must be present.37     * @throws InvalidArgumentException If any required key is missing.38     */39    protected static function validateFromArrayData(array $data, array $requiredKeys): void40    {41        $missingKeys = [];42        foreach ($requiredKeys as $key) {43            if (!array_key_exists($key, $data)) {44                $missingKeys[] = $key;45            }46        }47        if (!empty($missingKeys)) {48            throw new InvalidArgumentException(sprintf('%s::fromArray() missing required keys: %s', static::class, implode(', ', $missingKeys)));49        }50    }51    /**52     * {@inheritDoc}53     *54     * @since 0.1.055     */56    public static function isArrayShape(array $array): bool57    {58        try {59            /** @var TArrayShape $array */60            static::fromArray($array);61            return \true;62        } catch (InvalidArgumentException $e) {63            return \false;64        }65    }66    /**67     * Converts the object to a JSON-serializable format.68     *69     * This method uses the toArray() method and then processes the result70     * based on the JSON schema to ensure proper object representation for71     * empty arrays.72     *73     * @since 0.1.074     *75     * @return mixed The JSON-serializable representation.76     */77    #[\ReturnTypeWillChange]78    public function jsonSerialize()79    {80        $data = $this->toArray();81        $schema = static::getJsonSchema();82        return $this->convertEmptyArraysToObjects($data, $schema);83    }84    /**85     * Recursively converts empty arrays to stdClass objects where the schema expects objects.86     *87     * @since 0.1.088     *89     * @param mixed $data The data to process.90     * @param array<mixed, mixed> $schema The JSON schema for the data.91     * @return mixed The processed data.92     */93    private function convertEmptyArraysToObjects($data, array $schema)94    {95        // If data is an empty array and schema expects object, convert to stdClass96        if (is_array($data) && empty($data) && isset($schema['type']) && $schema['type'] === 'object') {97            return new stdClass();98        }99        // If data is an array with content, recursively process nested structures100        if (is_array($data)) {101            // Handle object properties102            if (isset($schema['properties']) && is_array($schema['properties'])) {103                foreach ($data as $key => $value) {104                    if (isset($schema['properties'][$key]) && is_array($schema['properties'][$key])) {105                        $data[$key] = $this->convertEmptyArraysToObjects($value, $schema['properties'][$key]);106                    }107                }