@quenty/playersservicepromises 10.19.0 → 10.21.0

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [10.21.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/playersservicepromises@10.20.0...@quenty/playersservicepromises@10.21.0) (2026-07-23)
+
+### Features
+
+- Add baseline player-mock and support across Nevermore for mocked players. ([567d121](https://github.com/Quenty/NevermoreEngine/commit/567d121ffc014b42391554088189a1a6296dda83))
+
+# [10.20.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/playersservicepromises@10.19.0...@quenty/playersservicepromises@10.20.0) (2026-07-18)
+
+**Note:** Version bump only for package @quenty/playersservicepromises
+
 # [10.19.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/playersservicepromises@10.18.1...@quenty/playersservicepromises@10.19.0) (2026-07-18)
 
 **Note:** Version bump only for package @quenty/playersservicepromises

package/deploy.nevermore.json

@@ -0,0 +1,10 @@
+{
+  "targets": {
+    "test": {
+      "universeId": 9716264427,
+      "placeId": 87640721252115,
+      "project": "test/default.project.json",
+      "scriptTemplate": "test/scripts/Server/ServerMain.server.lua"
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quenty/playersservicepromises",
-  "version": "10.19.0",
+  "version": "10.21.0",
   "description": "Utility methods for async methods in Players service",
   "keywords": [
     "Roblox",
@@ -30,10 +30,13 @@
   ],
   "dependencies": {
     "@quenty/loader": "10.11.0",
-    "@quenty/promise": "10.19.0"
+    "@quenty/nevermore-test-runner": "1.5.0",
+    "@quenty/playermock": "1.1.0",
+    "@quenty/promise": "10.21.0",
+    "@quentystudios/jest-lua": "3.10.0-quenty.2"
   },
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "cbbb89635bfdcbf32f26a40422ac736292917cca"
+  "gitHead": "1de37218a2bedb8e3f8614a2e09bba9eddc812da"
 }

package/src/Shared/PlayersServicePromises.lua

@@ -8,6 +8,7 @@ local require = require(script.Parent.loader).load(script)
 
 local Players = game:GetService("Players")
 
+local PlayerMock = require("PlayerMock")
 local Promise = require("Promise")
 
 local PlayersServicePromises = {}
@@ -21,6 +22,11 @@ function PlayersServicePromises.promiseUserIdFromName(name: string): Promise.Pro
 	assert(type(name) == "string", "Bad name")
 
 	return Promise.spawn(function(resolve, reject)
+		local mockPlayer = PlayerMock.getMockByUsername(name)
+		if mockPlayer ~= nil then
+			return resolve(PlayerMock.read(mockPlayer, "UserId"))
+		end
+
 		local userId
 		local ok, err = pcall(function()
 			userId = Players:GetUserIdFromNameAsync(name)

package/src/Shared/PlayersServicePromises.spec.lua

@@ -0,0 +1,56 @@
+--!strict
+--[[
+	@class PlayersServicePromises.spec.lua
+]]
+
+local require = require(script.Parent.loader).load(script)
+
+local Workspace = game:GetService("Workspace")
+
+local Jest = require("Jest")
+local PlayerMock = require("PlayerMock")
+local PlayersServicePromises = require("PlayersServicePromises")
+local PromiseTestUtils = require("PromiseTestUtils")
+
+local describe = Jest.Globals.describe
+local expect = Jest.Globals.expect
+local it = Jest.Globals.it
+
+describe("PlayersServicePromises.promiseUserIdFromName against a mock", function()
+	it("resolves the mock's UserId by its default Name-derived username", function()
+		local player = PlayerMock.new({ UserId = 90071001 })
+		player.Parent = Workspace
+
+		local outcome, userId = PromiseTestUtils.awaitOutcome(PlayersServicePromises.promiseUserIdFromName(player.Name))
+
+		expect(outcome).toBe("resolved")
+		expect(userId).toBe(90071001)
+
+		player:Destroy()
+	end)
+
+	it("resolves the mock's UserId by an injected username", function()
+		local player = PlayerMock.new({ UserId = 90071002 })
+		player.Parent = Workspace
+		PlayerMock.writeLookup(player, "UserService.GetUserInfosByUserIdsAsync", 0, {
+			Id = 90071002,
+			Username = "injected_lookup_name",
+			DisplayName = "Injected",
+			HasVerifiedBadge = false,
+		})
+
+		local outcome, userId =
+			PromiseTestUtils.awaitOutcome(PlayersServicePromises.promiseUserIdFromName("injected_lookup_name"))
+
+		expect(outcome).toBe("resolved")
+		expect(userId).toBe(90071002)
+
+		player:Destroy()
+	end)
+
+	it("asserts on a non-string name", function()
+		expect(function()
+			PlayersServicePromises.promiseUserIdFromName(12345 :: any)
+		end).toThrow()
+	end)
+end)

package/src/jest.config.lua

@@ -0,0 +1,3 @@
+return {
+	testMatch = { "**/*.spec" },
+}

package/test/default.project.json

@@ -0,0 +1,17 @@
+{
+  "name": "PlayersServicePromisesTest",
+  "tree": {
+    "$className": "DataModel",
+    "ServerScriptService": {
+      "$properties": {
+        "LoadStringEnabled": true
+      },
+      "playersservicepromises": {
+        "$path": ".."
+      },
+      "Script": {
+        "$path": "scripts/Server"
+      }
+    }
+  }
+}

package/test/scripts/Server/ServerMain.server.lua

@@ -0,0 +1,12 @@
+--!nonstrict
+local ServerScriptService = game:GetService("ServerScriptService")
+
+local root = ServerScriptService.playersservicepromises
+local loader = root:FindFirstChild("LoaderUtils", true).Parent
+local require = require(loader).bootstrapGame(root)
+
+local NevermoreTestRunnerUtils = require("NevermoreTestRunnerUtils")
+
+if NevermoreTestRunnerUtils.runTestsIfNeededAsync(root) then
+	return
+end