�PNG  IHDR22?�� pHYs  �� OiCCPPhotoshop ICC profilexڝSgTS�=���BK���KoR RB���&*! J�!��Q�EEȠ�����Q, � ��!���������{�kּ������>���� �H3Q5� �B�������.@� $p�d!s�#�~<<+"��x� �M��0���B�\���t�8K�@z�B�@F���&S�`�cb�P-`'������{[�!�� e�Dh;��V�EX0fK�9�-0IWfH���� � 0Q��){`�##x��F�W<�+��*x��<�$9E�[-qWW.(�I+6aa�@.�y�2�4���������x����6��_-��"bb���ϫp@�t~��,/��;�m��%�h^ �u��f�@����W�p�~<�5�j>{�-�]c�K'Xt����o��(�h���w��?�G�%�fI�q^D$.Tʳ?�D��*�A��,���� �`6�B$��BB d�r`)��B(�Ͱ*`/�@4�Qh��p.�U�=p�a��(�� A�a!ڈb�X#����!�H�$ ɈQ"K�5H1R�T UH�=r9�\F��;�2����G1���Q=� �C��7�F� �dt1�����r�=�6��Ыhڏ>C�0��3�l0.��B�8, �c˱"� ���V����cϱw�E� 6wB aAHXLXN�H� $4� 7 �Q�'"��K�&���b21�XH,#��/{�C�7$�C2'��I��T��F�nR#�,��4H#���dk�9�, +ȅ����3��!�[ �b@q��S�(R�jJ��4�e�2AU��Rݨ�T5�ZB���R�Q��4u�9̓IK�����hh�i��t�ݕN��W���G���w ��Ljg(�gw��L�Ӌ�T071���oUX*�*|�� �J�&�*/T����ު U�U�T��^S}�FU3S� Ԗ�U��P�SSg�;���g�oT?�~Y��Y�L�OC�Q��_�� c�x,!k ��u�5�&���|v*�����=���9C3J3W�R�f?�q��tN �(���~���)�)�4L�1e\k����X�H�Q�G�6������E�Y��A�J'\'Gg����S�Sݧ �M=:��.�k���Dw�n��^��Lo��y���}/�T�m���G X� $� �<�5qo</���QC]�@C�a�a�ᄑ��<��F�F�i�\�$�m�mƣ&&!&KM�M�RM��)�;L;L���͢�֙5�=1�2��כ߷`ZxZ,����eI��Z�Yn�Z9Y�XUZ]�F���%ֻ�����N�N���gð�ɶ�����ۮ�m�}agbg�Ů��}�}��= ���Z~s�r:V:ޚΜ�?}����/gX���3��)�i�S��Ggg�s�󈋉K��.�>.���Ƚ�Jt�q]�z���������ۯ�6�i�ܟ�4�)�Y3s���C�Q��? ��0k߬~OCO�g��#/c/�W�װ��w��a�>�>r��>�<7�2�Y_�7��ȷ�O�o�_��C#�d�z����%g��A�[��z|!��?:�e����A���AA�������!h�쐭!��Α�i�P~���a�a��~ '���W�?�p�X�1�5w��Cs�D�D�Dޛg1O9�-J5*>�.j<�7�4�?�.fY��X�XIlK9.*�6nl������� �{�/�]py�����.,:�@L�N8��A*��%�w%� y��g"/�6ш�C\*N�H*Mz�쑼5y$�3�,幄'���L Lݛ:��v m2=:�1����qB�!M��g�g�fvˬe����n��/��k���Y- �B��TZ(�*�geWf�͉�9���+��̳�ې7�����ᒶ��KW-X潬j9�������(�x��oʿ�ܔ���Ĺd�f�f���-�[����n �ڴ �V����E�/��(ۻ��C���<��e����;?T�T�T�T6��ݵa��n��{��4���[���>ɾ�UUM�f�e�I���?�������m]�Nmq����#�׹���=TR��+�G�����w- 6 U����#pDy��� �� :�v�{���vg/jB��F�S��[b[�O�>����z�G��499�?r����C�d�&����ˮ/~�����јѡ�򗓿m|������������x31^�V���w�w��O�| (�h���SЧ��������c3-� cHRMz%������u0�`:�o�_�F5IDATx��ytUս�?�;���fN$$��@B�!�k��� -*�gE���j�O�kQ�ʠ`U�B_ �AÐ0%�Ȕ�@r3ޛ;߳��$�@��v����^�s����������$��ߢ !�W��5�̱'-٘������4�>�Rƫ$�G��0U�H}�_ _� #��k�MJ/=�9Du *ڲ�k�PQ;0��j|�*�$�^컂脛y���>�z×� B��� ��(�:$�ʔ_�6��C!B����MVx��a��ζyY����j��ƋY2�9�F�{r��r�딟F��Q��hY6��� x��[l��RC��������nt@��;P��3��� F�w��7��:�P���ɋ'���mj���Bƪ�$�Q�L��y��߷g��\���z����v5�p�v$�v櫻�`6~K �Y�X����,�:��"�o�e0II"(��,������l_�C���/4�+f�E�!q��:����u����c��樼.UE�@� �]K�W���$-�h]�JG���Dz)�`��.�A/ ���mᏣc�3jK� �!�>���$�Q�!�_�? \�C2(E �M$Z I{�U���s�ǣ���=��@Բe ޻��W�����@ �w����}�9v,)��.}*|"�s��di���,���G�]W�AC�������|<����[��ߕ������K�*�G nߴ!��‹��J�!��6(L�a)��Am��������;adf��:�xm��nh�;֦I��(���o�C~ډa?�=��s����h��E������xp����)���_���t��W�����´;8���`dz=(��@@�+,�;�`�fhl��XȌ�3,uI�~z(J����� �ZX�A����H'�À�㜦�82|��a�n�z2��I���� ���EY�h�ε<�0�q�{��C��v�˅��?"@��χ�x�WS+��N�~�KQ�J�8ل�� _.W��� !TU{�����,��"�� �;�������HI S� ��))�o�1�H�D� ���� (� ;����"Ҕ��,���� �F=���O��&�Ph>�`���y��߲ &S��P�<��'��1s�1cĂ�N����2)����@�u��tv��<�+�-&�����h��[!FSG���' � z z0��<����8d&�����E0�,��<��"!P�b4��� �{S�����X����.�囤���T��hEF��X�q0"-<����h���]�Py*����F⩍��@v�˂�Y08�� .q��a��s����(!<̫1�3�L�H��7sYW�`��qtu�\7��?�@�Y�� %Ka�x�GZ�*W�P��y�����N0r9��Z�c�%���q,��k�����!!,��>���IB��� �x1�Xu�Y���v-���ֺ��N������JP��a�2`�e5��w��u;�6�i���̃��(K���ťa��(l51��JL��O'%���]���ٖ뿉!��{*�p+f ���i8��D�ȑ���ܩ�M��V��ӟz��x�7Z�1i}�^͜���6e����x��)u�d�ˏ�V�eG�\�X1�����=n�U'�~Y����L�\,�(d!x ,�:�TW8� M`r���@��r+v�Q0��>^;˴�VbF��('����� �*O��i��j�Ӆ����^�S3&� ���{������.ی�� N;��NU%d0�Ce\r"�C�b��&t7N�7��� �ȪD�[%l�۪�$��'m?�A9tI�9>��NVL ��� 6v~M�����ъ�B���0����9$&=ώm��W�0���L���&��E���f�f��'+�9��hv��7,���M��6�D�&�^� �����8 D֮�����o��k^z��O��hP�8q�5d*��YVq3�{��������#LX4�?��jP=3�~�؅c�ݰ�̱�ұ��8̲��2�G�����j��έ�9��w7���U�X�w�85C��?!I&���o&����L���I#�^�eV�,�^t5�k� �xs˛\��U�8��."���{���ǵ�l4��ݼ�;��r"���G�/~���gJV�N糦��ZZ^k+NN�D��I$�=OE�z����|*�*{��%k���G��>�`9��b;�s���8,�qs��c��.b��q�%�>r��n�R�Ƨ�%�,�A��le#�8���}; 21�0�b�&�QX�f���q�00����$>�h�N�'�a3��A���/�r ��L5�8�GԲ'�����w;��c#�q1���h$*��V^�k��QĽ�b:i������� ����H F#�_���,��]g����Ը����`RUU���� ��"�qD���>-��ϤI�~��3�̴�����NZ[[555�eeek7�m����YF#[��Đ��R��i��L�H�r ��@��J-�Pŝ��_|�-��6y��ks�V�U~��6���w.����(��0A� 4��f��� /���C�xŊ�ٳ����z=6�����rg���mKo��o�/����a�g���?'9%9��P��斓��~���L{�� �H��{AW��B��$����v�1b�&Mb�ر��ر#�0`�`xMBp! )Z�Nmo�mZ�g�}�eذaWTVV ���'99��C5��&�&+5�bT>|8��PUUETT����&���t��~TE%��'������b�tEGG;RSS�S�N�v��ѯ��t����u1@�ޚ"f��͈���r'L�Ph��m��ƌ�74o��`�x�q�P���NRSS�X,�����l&&&��MFFA!-��`��ҷ�n��Yuu�����x<I�LB%����KԒ50�!�3�bz�����ʸKL���;---�l6[��`��������Ȏ;�����egg4��!D�T��jWujyZ��������K����%����p�^���X,6��sV=�ܖ����6�3�X ���4ҿ��A2�&����_k�;d�� �VfOIEND�B`�
Warning: session_start(): Session cannot be started after headers have already been sent in /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php on line 124

Warning: Cannot modify header information - headers already sent by (output started at /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php:1) in /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php on line 130

Warning: Cannot modify header information - headers already sent by (output started at /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php:1) in /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php on line 131

Warning: Cannot modify header information - headers already sent by (output started at /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php:1) in /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php on line 132

Warning: Cannot modify header information - headers already sent by (output started at /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php:1) in /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php on line 133

Warning: Cannot modify header information - headers already sent by (output started at /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php:1) in /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php on line 134

Warning: Cannot modify header information - headers already sent by (output started at /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php:1) in /home/mciraet/www/wp-includes/php-ai-client/src/Providers/Enums/Documentsoliders.php on line 135
0x0x
0x0x
PHP 8.2.31
Preview: MetadataController.php Size: 15.63 KB
/home/mciraet/www/wp-content/plugins/woocommerce/src/Api/Infrastructure/MetadataController.php
<?php

declare(strict_types=1);

namespace Automattic\WooCommerce\Api\Infrastructure;

use Automattic\WooCommerce\Api\Infrastructure\Schema\CustomScalarType;
use Automattic\WooCommerce\Api\Infrastructure\Schema\Error;
use Automattic\WooCommerce\Api\Infrastructure\Schema\ObjectType;
use Automattic\WooCommerce\Api\Infrastructure\Schema\ResolveInfo;
use Automattic\WooCommerce\Api\Infrastructure\Schema\Type;
use Automattic\WooCommerce\Api\Utils\SchemaHandle;
use Automattic\WooCommerce\Vendor\GraphQL\Language\AST\BooleanValueNode;
use Automattic\WooCommerce\Vendor\GraphQL\Language\AST\FloatValueNode;
use Automattic\WooCommerce\Vendor\GraphQL\Language\AST\IntValueNode;
use Automattic\WooCommerce\Vendor\GraphQL\Language\AST\NullValueNode;
use Automattic\WooCommerce\Vendor\GraphQL\Language\AST\StringValueNode;

/**
 * Hand-written controller that contributes the `_apiMetadata` root query
 * field and the supporting `MetadataEntry`, `MetadataTarget`, `MetadataValue`
 * and `AuthEntry` types to the generated schema.
 *
 * The autogenerated `RootQueryType` references this controller alongside the
 * autogenerated query resolvers, so the field appears on the root `Query`
 * type without any special wiring at the controller level. The resolver
 * delegates to {@see SchemaHandle::find_metadata()} for the schema walk and
 * filter application, then reshapes the rows so each entry is exposed as the
 * `{ name, value }` pair that `MetadataEntry` expects. Authorization
 * descriptors (each row's `authorization` list) pass through unchanged.
 *
 * Access is gated by {@see self::can_query_metadata()}; once allowed, the
 * returned content is principal-independent — the full declared shape of the
 * schema, irrespective of who is calling.
 */
class MetadataController {
	/**
	 * Memoised `MetadataValue` scalar type.
	 *
	 * @var ?CustomScalarType
	 */
	private static ?CustomScalarType $value_scalar = null;

	/**
	 * Memoised `MetadataEntry` output type.
	 *
	 * @var ?ObjectType
	 */
	private static ?ObjectType $entry_type = null;

	/**
	 * Memoised `MetadataTarget` output type.
	 *
	 * @var ?ObjectType
	 */
	private static ?ObjectType $target_type = null;

	/**
	 * Memoised `AuthEntry` output type — describes one authorization
	 * attribute attached to a schema target.
	 *
	 * @var ?ObjectType
	 */
	private static ?ObjectType $auth_entry_type = null;

	/**
	 * GraphQL field name used on the root `Query` type.
	 */
	public const FIELD_NAME = '_apiMetadata';

	/**
	 * Field definition for the root `_apiMetadata` query, in the shape the
	 * autogenerated `RootQueryType` expects (same as every autogenerated
	 * resolver's `get_field_definition()`).
	 *
	 * @return array<string, mixed>
	 */
	public static function get_field_definition(): array {
		return array(
			'type'        => Type::nonNull( Type::listOf( Type::nonNull( self::get_target_type() ) ) ),
			'description' => __(
				'Lists metadata attached to elements of this schema. All filter arguments are optional; supplying multiple narrows the result. Use this to discover internal-use APIs, beta features, ownership, etc., or to ask "can I use this specific element?".',
				'woocommerce'
			),
			'args'        => array(
				'name'      => array(
					'type'        => Type::string(),
					'description' => __( 'Match rows that carry a metadata entry with this name. Surviving rows have their entries trimmed to the matching one.', 'woocommerce' ),
				),
				'type'      => array(
					'type'        => Type::string(),
					'description' => __( 'Match rows whose target type equals this name.', 'woocommerce' ),
				),
				'field'     => array(
					'type'        => Type::string(),
					'description' => __( 'Match rows whose target field equals this name.', 'woocommerce' ),
				),
				'attribute' => array(
					'type'        => Type::string(),
					'description' => __( 'Match rows whose authorization carries an attribute with this class short name. Surviving rows have their authorization trimmed to the matching descriptors.', 'woocommerce' ),
				),
			),
			'resolve'     => array( self::class, 'resolve' ),
		);
	}

	/**
	 * Resolver for the `_apiMetadata` root field. Signature matches the
	 * engine's resolver contract; `$root` is unused here (root operations
	 * have no parent). `$context` is read for the principal so the
	 * `can_query_metadata` ladder can run.
	 *
	 * @param ?array      $root    The engine passes null for root resolvers.
	 * @param array       $args    GraphQL arguments (`name`, `type`, `field`, `attribute`).
	 * @param mixed       $context Per-request context — an ArrayObject wrapping {`principal`, `_query_metadata`}.
	 * @param ResolveInfo $info    Carries the schema instance to walk.
	 * @return list<array<string, mixed>>
	 * @throws Error When the principal is not allowed to query `_apiMetadata`.
	 */
	public static function resolve( ?array $root, array $args, mixed $context, ResolveInfo $info ): array {
		unset( $root );

		$principal = is_object( $context ) || is_array( $context ) ? ( $context['principal'] ?? null ) : null;
		if ( ! self::can_query_metadata( $principal ) ) {
			// phpcs:ignore WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Static error message + machine code; serialized as JSON, not HTML.
			throw self::build_metadata_query_authorization_error( $principal );
		}

		// Wrap the resolver's engine-typed schema into the same handle clients
		// receive from `GraphQLControllerBase::get_schema()`, so the resolver and
		// PHP-side callers share a single inspection surface.
		$schema = new SchemaHandle( $info->schema );

		$rows = $schema->find_metadata(
			$args['name'] ?? null,
			$args['type'] ?? null,
			$args['field'] ?? null,
			$args['attribute'] ?? null,
		);

		// SchemaHandle returns entries as an associative `name => value` map,
		// which is the natural shape for filtering and PHP-side consumers. The
		// GraphQL `MetadataEntry` type instead exposes each entry as a
		// `{ name, value }` object so clients can `entries { name value }` over
		// a list. Reshape here.
		return array_map(
			static function ( array $row ): array {
				$row['entries'] = array_map(
					static fn( string $entry_name, $entry_value ): array => array(
						'name'  => $entry_name,
						'value' => $entry_value,
					),
					array_keys( $row['entries'] ),
					array_values( $row['entries'] ),
				);
				return $row;
			},
			$rows
		);
	}

	/**
	 * Whether the principal may run the `_apiMetadata` query.
	 *
	 * Tri-tier ladder, deliberately fail-closed:
	 *
	 *  1. If the principal declares `can_query_metadata(): bool`, use it.
	 *     Plugins distinguish metadata-query access from native
	 *     introspection access by declaring this method.
	 *  2. Else if the principal declares `can_introspect(): bool`, fall
	 *     back to it — one switch then gates both metadata and
	 *     introspection, which is the common case.
	 *  3. Else (neither method declared) deny. Plugin authors that don't
	 *     opt their principal in get a locked-down endpoint rather than
	 *     leaking schema shape and gate descriptors by default.
	 *
	 * The principal-derived decision is then passed through the
	 * {@see 'woocommerce_graphql_can_query_metadata'} filter so sites
	 * can grant or revoke access without subclassing the principal —
	 * useful for per-request rules (specific IPs, headers, query
	 * parameters, etc.).
	 *
	 * Fail-closed contract: null principal denies before the filter is
	 * consulted; either method's return is checked with `=== true`; any
	 * throw from the principal method or the filter denies; the filter
	 * must likewise return strictly `true` to allow.
	 *
	 * @param ?object $principal The resolved principal, or null when principal resolution failed.
	 */
	private static function can_query_metadata( ?object $principal ): bool {
		if ( null === $principal ) {
			return false;
		}

		try {
			if ( method_exists( $principal, 'can_query_metadata' ) ) {
				$allowed = true === $principal->can_query_metadata();
			} elseif ( method_exists( $principal, 'can_introspect' ) ) {
				$allowed = true === $principal->can_introspect();
			} else {
				$allowed = false;
			}

			/**
			 * Filters whether the current principal may run the `_apiMetadata` query.
			 *
			 * The filter receives the principal-derived decision (see the tri-tier
			 * ladder in {@see MetadataController::can_query_metadata()}) and must
			 * return strictly `true` to grant access; any other return value
			 * denies. The filter is not invoked when principal resolution failed
			 * (i.e. when the resolver receives a null principal) — that case
			 * denies outright.
			 *
			 * @since 10.9.0
			 *
			 * @internal
			 *
			 * @param bool   $allowed   Whether the principal may query `_apiMetadata`.
			 * @param object $principal The resolved principal.
			 */
			$allowed = apply_filters( 'woocommerce_graphql_can_query_metadata', $allowed, $principal );
		} catch ( \Throwable $e ) {
			return false;
		}

		return true === $allowed;
	}

	/**
	 * Build the GraphQL error thrown when `_apiMetadata` is queried by a
	 * principal that cannot. Mirrors
	 * {@see ResolverHelpers::build_authorization_error()}'s
	 * UNAUTHORIZED / FORBIDDEN distinction so clients can branch on
	 * `extensions.code` the same way they do for field-level denies.
	 *
	 * @param ?object $principal The resolved principal (null when principal resolution failed).
	 */
	private static function build_metadata_query_authorization_error( ?object $principal ): Error {
		$is_anonymous = null === $principal
			|| ( method_exists( $principal, 'is_authenticated' ) && ! $principal->is_authenticated() );
		return new Error(
			$is_anonymous ? 'Authentication required.' : 'You do not have permission to perform this action.',
			extensions: array( 'code' => $is_anonymous ? 'UNAUTHORIZED' : 'FORBIDDEN' )
		);
	}

	/**
	 * The `MetadataTarget` output type, lazily built and cached.
	 */
	private static function get_target_type(): ObjectType {
		if ( null === self::$target_type ) {
			self::$target_type = new ObjectType(
				array(
					'name'        => 'MetadataTarget',
					'description' => __(
						'One element of the schema with its attached metadata. Type-level rows have `field`, `argument` and `enumValue` set to null; field-level rows set `field` (and `argument` when the target is a field argument); enum-value rows set `enumValue`.',
						'woocommerce'
					),
					'fields'      => fn() => array(
						'type'          => array(
							'type'        => Type::nonNull( Type::string() ),
							'description' => __( 'Name of the GraphQL type this row describes.', 'woocommerce' ),
						),
						'field'         => array(
							'type'        => Type::string(),
							'description' => __( 'Field name when this row describes a field (or a field argument); null for type-level rows.', 'woocommerce' ),
						),
						'argument'      => array(
							'type'        => Type::string(),
							'description' => __( 'Argument name when this row describes a field argument; null otherwise.', 'woocommerce' ),
						),
						'enumValue'     => array(
							'type'        => Type::string(),
							'description' => __( 'Enum value name when this row describes one specific enum value; null otherwise.', 'woocommerce' ),
						),
						'entries'       => array(
							'type'        => Type::nonNull( Type::listOf( Type::nonNull( self::get_entry_type() ) ) ),
							'description' => __( 'Metadata entries attached to the target.', 'woocommerce' ),
						),
						'authorization' => array(
							'type'        => Type::nonNull( Type::listOf( Type::nonNull( self::get_auth_entry_type() ) ) ),
							'description' => __( 'Authorization attributes attached to the target (e.g. `RequiredCapability`, `PublicAccess`, or plugin-defined). Empty when the target carries no authorization attributes.', 'woocommerce' ),
						),
					),
				)
			);
		}
		return self::$target_type;
	}

	/**
	 * The `AuthEntry` output type — one authorization attribute attached
	 * to a target. Carries the attribute's short class name and the
	 * scalar args supplied at the usage site.
	 */
	private static function get_auth_entry_type(): ObjectType {
		if ( null === self::$auth_entry_type ) {
			self::$auth_entry_type = new ObjectType(
				array(
					'name'        => 'AuthEntry',
					'description' => __( 'One authorization attribute attached to a schema target.', 'woocommerce' ),
					'fields'      => fn() => array(
						'attribute' => array(
							'type'        => Type::nonNull( Type::string() ),
							'description' => __( 'Short class name of the authorization attribute (e.g. `RequiredCapability`).', 'woocommerce' ),
						),
						'args'      => array(
							'type'        => Type::nonNull( Type::listOf( self::get_value_scalar() ) ),
							'description' => __( 'Constructor arguments supplied at the usage site, in source order. Element type is the same scalar union as `MetadataValue`.', 'woocommerce' ),
						),
					),
				)
			);
		}
		return self::$auth_entry_type;
	}

	/**
	 * The `MetadataEntry` output type, lazily built and cached.
	 */
	private static function get_entry_type(): ObjectType {
		if ( null === self::$entry_type ) {
			self::$entry_type = new ObjectType(
				array(
					'name'        => 'MetadataEntry',
					'description' => __( 'One metadata entry: a `name` plus a scalar `value`.', 'woocommerce' ),
					'fields'      => fn() => array(
						'name'  => array(
							'type'        => Type::nonNull( Type::string() ),
							'description' => __( 'Identifier of the entry (e.g. `internal`, `beta`).', 'woocommerce' ),
						),
						'value' => array(
							// Nullable: `MetadataValue` itself permits a null payload (e.g.
							// `#[Metadata( 'deprecated_reason', null )]`), so the wrapping
							// must allow it through.
							'type'        => self::get_value_scalar(),
							'description' => __( 'Scalar payload associated with the entry. Null when the metadata entry carries a null value.', 'woocommerce' ),
						),
					),
				)
			);
		}
		return self::$entry_type;
	}

	/**
	 * The `MetadataValue` custom scalar, accepting any GraphQL-compatible scalar.
	 *
	 * The autogenerated scalar template hard-codes acceptance of string
	 * literals only, so this scalar is hand-built rather than going through
	 * ApiBuilder. `parseLiteral` walks the AST node types and `parseValue`
	 * accepts the already-decoded PHP scalar that variables-mode delivers.
	 */
	private static function get_value_scalar(): CustomScalarType {
		if ( null === self::$value_scalar ) {
			self::$value_scalar = new CustomScalarType(
				array(
					'name'         => 'MetadataValue',
					'description'  => __(
						'Scalar payload of a metadata entry. Accepts a string, integer, float, boolean, or null.',
						'woocommerce'
					),
					// Resolvers return the raw PHP scalar; webonyx serialises it as JSON directly.
					'serialize'    => static fn( $value ) => $value,
					'parseValue'   => static function ( $value ) {
						if ( null === $value || is_bool( $value ) || is_int( $value ) || is_float( $value ) || is_string( $value ) ) {
							return $value;
						}
						throw new Error( 'MetadataValue must be a string, integer, float, boolean, or null.' );
					},
					'parseLiteral' => static function ( $value_node, ?array $variables = null ) {
						unset( $variables );

						if ( $value_node instanceof StringValueNode ) {
							return $value_node->value;
						}
						if ( $value_node instanceof BooleanValueNode ) {
							return $value_node->value;
						}
						if ( $value_node instanceof IntValueNode ) {
							return (int) $value_node->value;
						}
						if ( $value_node instanceof FloatValueNode ) {
							return (float) $value_node->value;
						}
						if ( $value_node instanceof NullValueNode ) {
							return null;
						}
						throw new Error( 'MetadataValue must be a string, integer, float, boolean, or null literal.' );
					},
				)
			);
		}
		return self::$value_scalar;
	}
}

Directory Contents

Dirs: 1 × Files: 8
Name Size Perms Modified Actions
Schema DIR
- drwxr-xr-x 2026-08-11 10:05:47
Edit Download
ClassResolver.php
945 B lrw-r--r-- 2026-08-11 10:05:47
Edit Download
GraphQLControllerBase.php
41.99 KB lrw-r--r-- 2026-08-11 10:05:47
Edit Download
Main.php
15.65 KB lrw-r--r-- 2026-08-11 10:05:47
Edit Download
MetadataController.php
15.63 KB lrw-r--r-- 2026-08-11 10:05:47
Edit Download
Principal.php
2.43 KB lrw-r--r-- 2026-08-11 10:05:47
Edit Download
PrincipalResolver.php
1.12 KB lrw-r--r-- 2026-08-11 10:05:47
Edit Download
QueryInfoExtractor.php
7.35 KB lrw-r--r-- 2026-08-11 10:05:47
Edit Download
ResolverHelpers.php
19.25 KB lrw-r--r-- 2026-08-11 10:05:47
Edit Download
If ZipArchive is unavailable, a .tar will be created (no compression).
© 2026 0xNothings — Secure File Manager. All rights reserved. Built with ❤️ & Tailwind x Dark UI