REST: Allow optional denial context for permission denied errors

Bug: T330914
Change-Id: I5d135a407fea89647d368475d4f91a43b32c98a2

Author: jakobw

repo/rest-api/src/Application/UseCases/UseCaseError.php

@@ -60,6 +60,7 @@ class UseCaseError extends UseCaseException {
 	public const CONTEXT_PATH = 'path';
 	public const CONTEXT_PROPERTY_ID = 'property_id';
 	public const CONTEXT_DENIAL_REASON = 'denial_reason';
+	public const CONTEXT_DENIAL_CONTEXT = 'denial_context';
 	public const CONTEXT_REDIRECT_TARGET = 'redirect_target';
 	public const CONTEXT_RESOURCE_TYPE = 'resource_type';
 	public const CONTEXT_SITE_ID = 'site_id';
@@ -212,8 +213,13 @@ public static function newPatchResultModifiedReadOnlyValue( string $path ): self
 		);
 	}
 
-	public static function newPermissionDenied( string $reason ): self {
-		return new self( self::PERMISSION_DENIED, 'Access to resource is denied', [ self::CONTEXT_DENIAL_REASON => $reason ] );
+	public static function newPermissionDenied( string $reason, array $denialContext = [] ): self {
+		$error = new self( self::PERMISSION_DENIED, 'Access to resource is denied', [ self::CONTEXT_DENIAL_REASON => $reason ] );
+		if ( $denialContext ) {
+			$error->errorContext[self::CONTEXT_DENIAL_CONTEXT] = $denialContext;
+		}
+
+		return $error;
 	}
 
 	public static function newResourceNotFound( string $resourceType ): self {

repo/rest-api/tests/phpunit/Application/UseCases/UseCaseErrorTest.php

@@ -70,4 +70,26 @@ public function provideInvalidUseCaseErrorData(): Generator {
 		];
 	}
 
+	/**
+	 * @dataProvider permissionDeniedContextProvider
+	 */
+	public function testNewPermissionDenied( UseCaseError $error, array $expectedContext ): void {
+		$this->assertEquals( $expectedContext, $error->getErrorContext() );
+	}
+
+	public function permissionDeniedContextProvider(): Generator {
+		yield 'no additional context' => [
+			UseCaseError::newPermissionDenied( 'some-reason' ),
+			[ UseCaseError::CONTEXT_DENIAL_REASON => 'some-reason' ],
+		];
+
+		yield 'with additional context' => [
+			UseCaseError::newPermissionDenied( 'some-other-reason', [ 'some' => 'context' ] ),
+			[
+				UseCaseError::CONTEXT_DENIAL_REASON => 'some-other-reason',
+				UseCaseError::CONTEXT_DENIAL_CONTEXT => [ 'some' => 'context' ],
+			],
+		];
+	}
+
 }