Add configurable team resolver for permission team id (#2790)

* Add Permissions Team Resolver Implementation

- Introduced a new `PermissionsTeamResolver` interface to standardize team ID handling for permissions.
- Implemented `DefaultPermissionsTeamResolver` class to manage team IDs.
- Updated `permission.php` configuration to include `team_resolver` setting.
- Modified `PermissionRegistrar` to utilize the new team resolver for setting and getting permissions team IDs.

Author: adrenallen

config/permission.php

@@ -122,6 +122,12 @@
 
     'teams' => false,
 
+
+    /*
+     * The class to use to resolve the permissions team id
+     */
+    'team_resolver' => \Spatie\Permission\DefaultTeamResolver::class,
+
     /*
      * Passport Client Credentials Grant
      * When set to true the package will use Passports Client to check permissions

src/Contracts/PermissionsTeamResolver.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace Spatie\Permission\Contracts;
+
+interface PermissionsTeamResolver
+{
+    /**
+     * @return int|string|null
+     */
+    public function getPermissionsTeamId() : int|string|null;
+
+    /**
+     * Set the team id for teams/groups support, this id is used when querying permissions/roles
+     *
+     * @param  int|string|\Illuminate\Database\Eloquent\Model|null  $id
+     */
+    public function setPermissionsTeamId($id): void;
+}

src/DefaultTeamResolver.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace Spatie\Permission;
+
+use Spatie\Permission\Contracts\PermissionsTeamResolver;
+
+class DefaultTeamResolver implements PermissionsTeamResolver
+{
+    protected int|string|null $teamId = null;
+
+    /**
+     * Set the team id for teams/groups support, this id is used when querying permissions/roles
+     *
+     * @param  int|string|\Illuminate\Database\Eloquent\Model|null  $id
+     */
+    public function setPermissionsTeamId($id): void
+    {
+        if ($id instanceof \Illuminate\Database\Eloquent\Model) {
+            $id = $id->getKey();
+        }
+        $this->teamId = $id;
+    }
+
+    /**
+     * @return int|string|null
+     */
+    public function getPermissionsTeamId() : int|string|null
+    {
+        return $this->teamId;
+    }
+}

src/PermissionRegistrar.php

@@ -10,6 +10,7 @@
 use Illuminate\Database\Eloquent\Collection;
 use Illuminate\Database\Eloquent\Model;
 use Spatie\Permission\Contracts\Permission;
+use Spatie\Permission\Contracts\PermissionsTeamResolver;
 use Spatie\Permission\Contracts\Role;
 
 class PermissionRegistrar
@@ -34,9 +35,9 @@ class PermissionRegistrar
 
     public bool $teams;
 
-    public string $teamsKey;
+    protected PermissionsTeamResolver $teamResolver;
 
-    protected string|int|null $teamId = null;
+    public string $teamsKey;
 
     public string $cacheKey;
 
@@ -55,6 +56,7 @@ public function __construct(CacheManager $cacheManager)
     {
         $this->permissionClass = config('permission.models.permission');
         $this->roleClass = config('permission.models.role');
+        $this->teamResolver = new (config('permission.team_resolver', DefaultTeamResolver::class));
 
         $this->cacheManager = $cacheManager;
         $this->initializeCache();
@@ -101,18 +103,15 @@ protected function getCacheStoreFromConfig(): Repository
      */
     public function setPermissionsTeamId($id): void
     {
-        if ($id instanceof \Illuminate\Database\Eloquent\Model) {
-            $id = $id->getKey();
-        }
-        $this->teamId = $id;
+        $this->teamResolver->setPermissionsTeamId($id);
     }
 
     /**
      * @return int|string|null
      */
     public function getPermissionsTeamId()
     {
-        return $this->teamId;
+        return $this->teamResolver->getPermissionsTeamId();
     }
 
     /**