<h2>File Contents: /home/planet5/public_html/wp-includes/php-ai-client/src/Common/AbstractDataTransferObject.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/public_html/wp-includes/php-ai-client/src/Common/AbstractDataTransferObject.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php

declare (strict_types=1);
namespace WordPress\AiClient\Common;

use JsonSerializable;
use stdClass;
use WordPress\AiClient\Common\Contracts\WithArrayTransformationInterface;
use WordPress\AiClient\Common\Contracts\WithJsonSchemaInterface;
use WordPress\AiClient\Common\Exception\InvalidArgumentException;
/**
 * Abstract base class for all Data Value Objects in the AI Client.
 *
 * This abstract class consolidates the common functionality needed by all
 * data transfer objects:
 * - Array transformation for data manipulation
 * - JSON schema support for validation and documentation
 * - JSON serialization with proper empty object handling
 *
 * All DTOs in the AI Client should extend this class to ensure
 * consistent behavior across the codebase.
 *
 * @since 0.1.0
 *
 * @template TArrayShape of array&lt;string, mixed&gt;
 * @implements WithArrayTransformationInterface&lt;TArrayShape&gt;
 */
abstract class AbstractDataTransferObject implements WithArrayTransformationInterface, WithJsonSchemaInterface, JsonSerializable
{
    /**
     * Validates that required keys exist in the array data.
     *
     * @since 0.1.0
     *
     * @param array&lt;mixed&gt; $data The array data to validate.
     * @param string[] $requiredKeys The keys that must be present.
     * @throws InvalidArgumentException If any required key is missing.
     */
    protected static function validateFromArrayData(array $data, array $requiredKeys): void
    {
        $missingKeys = [];
        foreach ($requiredKeys as $key) {
            if (!array_key_exists($key, $data)) {
                $missingKeys[] = $key;
            }
        }
        if (!empty($missingKeys)) {
            throw new InvalidArgumentException(sprintf(&#039;%s::fromArray() missing required keys: %s&#039;, static::class, implode(&#039;, &#039;, $missingKeys)));
        }
    }
    /**
     * {@inheritDoc}
     *
     * @since 0.1.0
     */
    public static function isArrayShape(array $array): bool
    {
        try {
            /** @var TArrayShape $array */
            static::fromArray($array);
            return \true;
        } catch (InvalidArgumentException $e) {
            return \false;
        }
    }
    /**
     * Converts the object to a JSON-serializable format.
     *
     * This method uses the toArray() method and then processes the result
     * based on the JSON schema to ensure proper object representation for
     * empty arrays.
     *
     * @since 0.1.0
     *
     * @return mixed The JSON-serializable representation.
     */
    #[\ReturnTypeWillChange]
    public function jsonSerialize()
    {
        $data = $this-&gt;toArray();
        $schema = static::getJsonSchema();
        return $this-&gt;convertEmptyArraysToObjects($data, $schema);
    }
    /**
     * Recursively converts empty arrays to stdClass objects where the schema expects objects.
     *
     * @since 0.1.0
     *
     * @param mixed $data The data to process.
     * @param array&lt;mixed, mixed&gt; $schema The JSON schema for the data.
     * @return mixed The processed data.
     */
    private function convertEmptyArraysToObjects($data, array $schema)
    {
        // If data is an empty array and schema expects object, convert to stdClass
        if (is_array($data) &amp;&amp; empty($data) &amp;&amp; isset($schema[&#039;type&#039;]) &amp;&amp; $schema[&#039;type&#039;] === &#039;object&#039;) {
            return new stdClass();
        }
        // If data is an array with content, recursively process nested structures
        if (is_array($data)) {
            // Handle object properties
            if (isset($schema[&#039;properties&#039;]) &amp;&amp; is_array($schema[&#039;properties&#039;])) {
                foreach ($data as $key =&gt; $value) {
                    if (isset($schema[&#039;properties&#039;][$key]) &amp;&amp; is_array($schema[&#039;properties&#039;][$key])) {
                        $data[$key] = $this-&gt;convertEmptyArraysToObjects($value, $schema[&#039;properties&#039;][$key]);
                    }
                }
            }
            // Handle array items
            if (isset($schema[&#039;items&#039;]) &amp;&amp; is_array($schema[&#039;items&#039;])) {
                foreach ($data as $index =&gt; $item) {
                    $data[$index] = $this-&gt;convertEmptyArraysToObjects($item, $schema[&#039;items&#039;]);
                }
            }
            // Handle oneOf/anyOf schemas - just use the first one
            foreach ([&#039;oneOf&#039;, &#039;anyOf&#039;] as $keyword) {
                if (isset($schema[$keyword]) &amp;&amp; is_array($schema[$keyword])) {
                    foreach ($schema[$keyword] as $possibleSchema) {
                        if (is_array($possibleSchema)) {
                            return $this-&gt;convertEmptyArraysToObjects($data, $possibleSchema);
                        }
                    }
                }
            }
        }
        return $data;
    }
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fpublic_html%2Fwp-includes%2Fphp-ai-client%2Fsrc%2FCommon'>⬅ Back to Directory</a>