TracksProvidedFields.php
<?php
declare(strict_types=1);
namespace Automattic\WooCommerce\Api\InputTypes;
/**
* Trait for input types to track which fields were explicitly provided in the GraphQL request.
*
* This allows mutations to distinguish between a field being missing (don't change it)
* and explicitly set to null (clear it).
*/
trait TracksProvidedFields {
/**
* Fields that were explicitly provided in the input.
*
* Using an underscore prefix to keep it invisible to the ApiBuilder
* (which only scans public properties for GraphQL fields).
*
* @var array<string, true>
*/
protected array $provided_fields = array(); // phpcs:ignore WordPress.NamingConventions.ValidVariableName.PropertyNotSnakeCase -- internal tracking array
/**
* Mark a field as explicitly provided in the input.
*
* @param string $field The field name.
*/
public function mark_provided( string $field ): void {
$this->provided_fields[ $field ] = true;
}
/**
* Check whether a field was explicitly provided in the input.
*
* @param string $field The field name.
* @return bool
*/
public function was_provided( string $field ): bool {
return isset( $this->provided_fields[ $field ] );
}
}
