Fix #687

Author: santigarcor

src/Laratrust.php

@@ -51,6 +51,18 @@ public function hasPermission(
         return false;
     }
 
+    /**
+     * Check if the current user has a permission by its name.
+     * Alias to hasPermission.
+     */
+    public function isAbleTo(
+        string|array|BackedEnum $permission,
+        mixed $team = null,
+        bool $requireAll = false
+    ): bool {
+        return $this->hasPermission($permission, $team, $requireAll);
+    }
+
     /**
      * Check if the current user has a role or permission by its name.
      *

tests/LaratrustFacadeTest.php

@@ -2,14 +2,15 @@
 
 declare(strict_types=1);
 
-use Mockery as m;
 use Laratrust\Laratrust;
-use Laratrust\Tests\Models\User;
 use Laratrust\Tests\LaratrustTestCase;
+use Laratrust\Tests\Models\User;
+use Mockery as m;
 
 class LaratrustFacadeTest extends LaratrustTestCase
 {
     protected $laratrust;
+
     protected $user;
 
     protected function setUp(): void
@@ -45,6 +46,18 @@ public function testHasPermission()
         $this->assertFalse($this->laratrust->hasPermission('any_permission'));
     }
 
+    public function testIsAbleTo()
+    {
+        $this->laratrust->shouldReceive('user')->andReturn($this->user)->twice()->ordered();
+        $this->laratrust->shouldReceive('user')->andReturn(null)->once()->ordered();
+        $this->user->shouldReceive('hasPermission')->with('user_can', null, false)->andReturn(true)->once();
+        $this->user->shouldReceive('hasPermission')->with('user_cannot', null, false)->andReturn(false)->once();
+
+        $this->assertTrue($this->laratrust->isAbleTo('user_can'));
+        $this->assertFalse($this->laratrust->isAbleTo('user_cannot'));
+        $this->assertFalse($this->laratrust->isAbleTo('any_permission'));
+    }
+
     public function testAbility()
     {
         $this->laratrust->shouldReceive('user')->andReturn($this->user)->twice()->ordered();