What does this implement/fix? Explain your changes.

This fixes a bug where the MediaDetails.file field was returning a path to the file instead of the filename.

The description of the field is: The filename of the mediaItem, however values such as 2025/02/test-4.png were being returned, which is unexpected behavior.

• failing test: https://github.com/wp-graphql/wp-graphql/actions/runs/13205103635/job/36866295120?pr=3293#step:7:916
• passing test: https://github.com/wp-graphql/wp-graphql/actions/runs/13205434357

Does this close any currently open issues?

closes: #2982

Any other comments?

Running a query like so:

query GetMediaItemFilePath($id: ID!) {
  mediaItem(id: $id, idType: DATABASE_ID) {
    mediaDetails {
      file
    }
  }
}

Before

the file field returns a path:

After

the file field returns just the filename as the field description states it will:

Breaking Change?

This is not considered a breaking change as the actual behavior was not matching the documented intent of the field.

However, some users may have been relying on the output with the path, using the bug as a feature, so for those users this might come across as a breaking change.

Should a user need the field to resolve how it was previously, the following filter can be used, which will resolve the field as it was before this bugfix:

add_filter( 'graphql_resolve_field', function( $result, $source, $args, $context, $info, $type_name, $field_key ) {

  if ( 'MediaDetails' !== $type_name && 'file' !== $field_key ) {
    return $result;
  }
  
  return $source['file'];

}, 10, 7 );