Add inverse relations + property accessors (Spatie/Maklad parity) (1.6.0)

- Role::users() (soporta role_ids plano y estructurado) + getUsersAttribute / getPermissionsAttribute
- Permission::roles() + getRolesAttribute
- HasRoles::getRolesAttribute, HasPermissions::getPermissionsAttribute

Permite acceso por propiedad ($role->users, $role->permissions, $permission->roles,
$user->roles, $user->permissions) como en Spatie/Maklad, sin romper los métodos.

Author: webrek

src/Models/Permission.php

@@ -116,4 +116,19 @@ public function getGuardName(): string
     {
         return $this->guard_name;
     }
+
+    /**
+     * Roles que tienen este permiso (roles.permission_ids es un array plano de ids).
+     */
+    public function roles(): \Illuminate\Support\Collection
+    {
+        $roleClass = config('permission.models.role');
+        return $roleClass::query()->where('permission_ids', (string) $this->getKey())->get();
+    }
+
+    /** Acceso por propiedad: $permission->roles (paridad Spatie/Maklad). */
+    public function getRolesAttribute(): \Illuminate\Support\Collection
+    {
+        return $this->roles();
+    }
 }

src/Models/Role.php

@@ -117,6 +117,37 @@ public function permissions(): Collection
         return $permClass::query()->whereIn('_id', $this->permission_ids ?? [])->get();
     }
 
+    /**
+     * Usuarios que tienen este rol. Soporta role_ids plano (["id"]) y
+     * estructurado ([{role_id: "id"}]) para compatibilidad con datos legacy.
+     */
+    public function users(): Collection
+    {
+        $userClass = config('auth.providers.users.model');
+        if (! $userClass) {
+            return collect();
+        }
+        $id = (string) $this->getKey();
+        return $userClass::query()
+            ->where(function ($q) use ($id): void {
+                $q->where('role_ids', $id)
+                  ->orWhere('role_ids.role_id', $id);
+            })
+            ->get();
+    }
+
+    /** Acceso por propiedad: $role->users (paridad Spatie/Maklad). */
+    public function getUsersAttribute(): Collection
+    {
+        return $this->users();
+    }
+
+    /** Acceso por propiedad: $role->permissions (paridad Spatie/Maklad). */
+    public function getPermissionsAttribute(): Collection
+    {
+        return $this->permissions();
+    }
+
     public function givePermissionTo(...$permissions): self
     {
         $ids = $this->resolvePermissionIds($this->flatten($permissions));

src/Traits/HasPermissions.php

@@ -20,6 +20,12 @@ public function permissions()
         return $permClass::query()->whereIn('_id', $ids)->get();
     }
 
+    /** Acceso por propiedad: $user->permissions (paridad Spatie/Maklad). */
+    public function getPermissionsAttribute(): \Illuminate\Support\Collection
+    {
+        return $this->permissions();
+    }
+
     public function givePermissionTo(...$permissions): self
     {
         return $this->attachPermissions($this->flattenInput($permissions), null);

src/Traits/HasRoles.php

@@ -23,6 +23,12 @@ public function roles(): Collection
         return $roleClass::query()->whereIn('_id', $ids)->get();
     }
 
+    /** Acceso por propiedad: $user->roles (paridad Spatie/Maklad). */
+    public function getRolesAttribute(): Collection
+    {
+        return $this->roles();
+    }
+
     public function assignRole(...$roles): self
     {
         return $this->attachRoles($this->flattenInput($roles), null);