@quenty/grouputils 10.20.1 → 10.20.2

package/CHANGELOG.md

@@ -3,6 +3,10 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [10.20.2](https://github.com/Quenty/NevermoreEngine/compare/@quenty/grouputils@10.20.1...@quenty/grouputils@10.20.2) (2026-06-03)
+
+**Note:** Version bump only for package @quenty/grouputils
+
 ## [10.20.1](https://github.com/Quenty/NevermoreEngine/compare/@quenty/grouputils@10.20.0...@quenty/grouputils@10.20.1) (2026-05-30)
 
 **Note:** Version bump only for package @quenty/grouputils

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quenty/grouputils",
-  "version": "10.20.1",
+  "version": "10.20.2",
   "description": "Group utility functions for Roblox",
   "keywords": [
     "Roblox",
@@ -35,5 +35,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "598b2b62b36bdcbdbbd56f7db10c399831cc6eba"
+  "gitHead": "1acafc712ce34f5dbaa70bb23b16da95e9cd3f82"
 }

package/src/Shared/GroupUtils.lua

@@ -13,6 +13,58 @@ local Promise = require("Promise")
 
 local GroupUtils = {}
 
+type RoleTable = {
+	Id: number,
+	Name: string,
+	Rank: number,
+}
+type RoleTableList = { RoleTable }
+type GetRolesInGroupAsyncResult = {
+	IsMember: boolean,
+	Roles: RoleTableList,
+}
+
+local function _getHighestRoleTable(roleTableList: RoleTableList): RoleTable?
+	local highestRank = 0
+	local highestRankRoleTable: RoleTable? = nil
+	for _, roleTable in roleTableList do
+		if roleTable.Rank > highestRank then
+			highestRank = roleTable.Rank
+			highestRankRoleTable = roleTable
+		end
+	end
+	return highestRankRoleTable
+end
+
+type GetGroupDictionary = {
+	Name: string,
+	Id: number,
+	EmblemUrl: string,
+	EmbelmId: number,
+	Rank: number, -- deprecated, but probably won't annoy lint:luau
+	Role: string, -- deprecated, but probably won't annoy lint:luau
+	IsPrimary: boolean,
+	IsInClan: boolean, -- deprecated, always false
+}
+type GetGroupsAsyncResult = { GetGroupDictionary }
+
+local function _getRankAndRoleFallback(userId: number, groupId: number): (number, string?)
+	-- euvin: i yoinked this from
+	-- https://devforum.roblox.com/t/groupservicegetrolesingroupasync-is-not-enabled-yet-wiki-tells-me-to-use-it/4660969
+
+	--? The GetRankInGroup method is deprecated and unstable now.
+	--? https://devforum.roblox.com/t/excessive-rate-limits-when-checking-gamepasses-group-ranks/3549665
+	local groups = GroupService:GetGroupsAsync(userId) :: GetGroupsAsyncResult
+
+	for _, GroupInfo: GetGroupDictionary in groups do
+		if GroupInfo.Id == groupId then
+			return GroupInfo.Rank, GroupInfo.Role
+		end
+	end
+
+	return 0, nil
+end
+
 --[=[
 	Retrieves the rank of the player in the group.
 
@@ -25,11 +77,25 @@ function GroupUtils.promiseRankInGroup(player: Player, groupId: number): Promise
 	assert(type(groupId) == "number", "Bad groupId")
 
 	return Promise.spawn(function(resolve, reject)
-		local rank = nil
+		local rank: number = nil
 		local ok, err = pcall(function()
-			-- TODO: Replace with GroupService:GetRolesInGroupAsync() once enabled
-			rank = player:GetRankInGroupAsync(groupId)
+			-- GetRankInGroupAsync is deprecated, changed from GetRankInGroupAsync to GetRolesInGroupAsync
+			-- ... but GetRolesInGroupAsync fails for some reason and hasn't been fixed (June 2, 2026)
+			-- so we will fall back to a deprecated method anyway
+			local result = GroupService:GetRolesInGroupAsync(player.UserId, groupId) :: GetRolesInGroupAsyncResult
+			if result.IsMember then
+				local highestRoleTable = _getHighestRoleTable(result.Roles)
+				if highestRoleTable then
+					rank = highestRoleTable.Rank
+				end
+			end
 		end)
+		if not rank then
+			ok, err = pcall(function()
+				local gotRank, _ = _getRankAndRoleFallback(player.UserId, groupId)
+				rank = gotRank
+			end)
+		end
 
 		if not ok then
 			return reject(err)
@@ -55,12 +121,24 @@ function GroupUtils.promiseRoleInGroup(player: Player, groupId: number): Promise
 	assert(type(groupId) == "number", "Bad groupId")
 
 	return Promise.spawn(function(resolve, reject)
-		local role = nil
+		local role: string? = nil
 		local ok, err = pcall(function()
-			-- TODO: Replace with GroupService:GetRolesInGroupAsync() once enabled
-			role = player:GetRoleInGroupAsync(groupId)
+			local result = GroupService:GetRolesInGroupAsync(player.UserId, groupId) :: GetRolesInGroupAsyncResult
+			if result.IsMember then
+				local highestRoleTable = _getHighestRoleTable(result.Roles)
+				if highestRoleTable then
+					role = highestRoleTable.Name
+				end
+			end
 		end)
 
+		if not role then
+			ok, err = pcall(function()
+				local _, gotRole = _getRankAndRoleFallback(player.UserId, groupId)
+				role = gotRole
+			end)
+		end
+
 		if not ok then
 			return reject(err)
 		end