Add initial core abilities for WordPress 6.9

includes/abilities-api/class-wp-ability.php

@@ -320,6 +320,27 @@ public function get_input_schema(): array {
 		return $this->input_schema;
 	}
 
+	/**
+	 * Applies the defined input default when no input is provided.
+	 *
+	 * @since 0.4.0
+	 *
+	 * @param mixed $input Optional. The raw input provided for the ability. Default `null`.
+	 * @return mixed The input with the schema default applied when available.
+	 */
+	public function normalize_input( $input = null ) {
+		if ( null !== $input ) {
+			return $input;
+		}
+
+		$input_schema = $this->get_input_schema();
+		if ( ! empty( $input_schema ) && array_key_exists( 'default', $input_schema ) ) {
+			return $input_schema['default'];
+		}
+
+		return null;
+	}
+
 	/**
 	 * Retrieves the output schema for the ability.
 	 *
@@ -436,6 +457,7 @@ protected function invoke_callback( callable $callback, $input = null ) {
 	 * @return bool|\WP_Error Whether the ability has the necessary permission.
 	 */
 	public function check_permissions( $input = null ) {
+		$input    = $this->normalize_input( $input );
 		$is_valid = $this->validate_input( $input );
 		if ( is_wp_error( $is_valid ) ) {
 			return $is_valid;
@@ -522,6 +544,7 @@ protected function validate_output( $output ) {
 	 * @return mixed|\WP_Error The result of the ability execution, or WP_Error on failure.
 	 */
 	public function execute( $input = null ) {
+		$input           = $this->normalize_input( $input );
 		$has_permissions = $this->check_permissions( $input );
 		if ( true !== $has_permissions ) {
 			if ( is_wp_error( $has_permissions ) ) {

includes/abilities/class-wp-core-abilities.php

@@ -101,6 +101,7 @@ protected static function register_get_site_info(): void {
 						),
 					),
 					'additionalProperties' => false,
+					'default'              => array(),
 				),
 				'output_schema'       => array(
 					'type'                 => 'object',
@@ -141,6 +142,7 @@ protected static function register_get_site_info(): void {
 					'additionalProperties' => false,
 				),
 				'execute_callback'    => static function ( $input = array() ): array {
+					$input = is_array( $input ) ? $input : array();
 					$all_fields       = array( 'name', 'description', 'url', 'wpurl', 'admin_email', 'charset', 'language', 'version' );
 					$requested_fields = ! empty( $input['fields'] ) ? $input['fields'] : $all_fields;
 
@@ -151,7 +153,8 @@ protected static function register_get_site_info(): void {
 
 					return $result;
 				},
-				'permission_callback' => static function (): bool {
+				'permission_callback' => static function ( $input = null ): bool {
+					unset( $input );
 					return current_user_can( 'manage_options' );
 				},
 				'meta'                => array(

includes/rest-api/endpoints/class-wp-rest-abilities-run-controller.php

@@ -132,7 +132,7 @@ public function run_ability( $request ) {
 			);
 		}
 
-		$input  = $this->get_input_from_request( $request );
+		$input  = $ability->normalize_input( $this->get_input_from_request( $request ) );
 		$result = $ability->execute( $input );
 		if ( is_wp_error( $result ) ) {
 			if ( 'ability_invalid_input' === $result->get_error_code() ) {
@@ -162,7 +162,7 @@ public function run_ability_permissions_check( $request ) {
 			);
 		}
 
-		$input = $this->get_input_from_request( $request );
+		$input = $ability->normalize_input( $this->get_input_from_request( $request ) );
 		if ( ! $ability->check_permissions( $input ) ) {
 			return new \WP_Error(
 				'rest_ability_cannot_execute',

tests/unit/abilities-api/wpCoreAbilities.php

@@ -63,6 +63,10 @@ public function test_core_get_bloginfo_ability_is_registered(): void {
 		$input_schema  = $ability->get_input_schema();
 		$output_schema = $ability->get_output_schema();
 
+		$this->assertSame( 'object', $input_schema['type'] );
+		$this->assertArrayHasKey( 'default', $input_schema );
+		$this->assertSame( array(), $input_schema['default'] );
+
 		// Input schema should have optional fields array.
 		$this->assertArrayHasKey( 'fields', $input_schema['properties'] );
 		$this->assertSame( 'array', $input_schema['properties']['fields']['type'] );
@@ -85,7 +89,7 @@ public function test_core_get_bloginfo_executes(): void {
         $ability = wp_get_ability( 'core/get-site-info' );
 
 		// Test without fields parameter - should return all fields.
-		$result = $ability->execute( array() );
+		$result = $ability->execute();
 
 		$this->assertIsArray( $result );
 		$this->assertArrayHasKey( 'name', $result );