feat: endpoint to get V5 user by handle

Author: maxceem

docs/Topcoder-bookings-api.postman_collection.json

@@ -1,6 +1,6 @@
 {
 	"info": {
-		"_postman_id": "b1144d77-699c-47be-864e-fbe99e7f5c14",
+		"_postman_id": "0c096a43-08c8-4152-83ca-1d544f92cad4",
 		"name": "Topcoder-bookings-api",
 		"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
 	},
@@ -4431,6 +4431,37 @@
 						}
 					},
 					"response": []
+				},
+				{
+					"name": "GET /taas-teams/users/:handle",
+					"request": {
+						"method": "GET",
+						"header": [
+							{
+								"key": "Authorization",
+								"type": "text",
+								"value": "Bearer {{token_member}}"
+							}
+						],
+						"url": {
+							"raw": "{{URL}}/taas-teams/users/:handle",
+							"host": [
+								"{{URL}}"
+							],
+							"path": [
+								"taas-teams",
+								"users",
+								":handle"
+							],
+							"variable": [
+								{
+									"key": "handle",
+									"value": "pshah_customer"
+								}
+							]
+						}
+					},
+					"response": []
 				}
 			]
 		},

src/common/helper.js

@@ -440,6 +440,26 @@ async function getMembers (handles) {
   return res.body
 }
 
+/**
+ * Get Topcoder Member by handle
+ *
+ * @param {String} handle user handle
+ *
+ * @returns the request result
+ */
+async function getMemberByHandle (handle) {
+  const token = await getM2MToken()
+  const url = `${config.TC_API}/members/${handle}`
+
+  const res = await request
+    .get(url)
+    .set('Authorization', `Bearer ${token}`)
+    .set('Content-Type', 'application/json')
+    .set('Accept', 'application/json')
+  localLogger.debug({ context: 'getMemberByHandle', message: `handle: "${handle}", response body: ${JSON.stringify(res.body)}` })
+  return res.body
+}
+
 /**
  * Function to get project by id
  * @param {Object} currentUser the user who perform this operation
@@ -641,5 +661,6 @@ module.exports = {
   ensureJobById,
   ensureUserById,
   getAuditM2Muser,
-  checkIsMemberOfProject
+  checkIsMemberOfProject,
+  getMemberByHandle
 }

src/controllers/SkillController.js

@@ -15,6 +15,18 @@ async function searchSkills (req, res) {
   res.send(result.result)
 }
 
+/**
+ * Get V5 U-bahn user by handle
+ * If user doesn't exists in V5 it creates it
+ *
+ * @param req the request
+ * @param res the response
+ */
+async function getUserByHandle (req, res) {
+  res.send(await service.getUserByHandle(req.params.handle))
+}
+
 module.exports = {
-  searchSkills
+  searchSkills,
+  getUserByHandle
 }

src/routes/TeamRoutes.js

@@ -20,6 +20,14 @@ module.exports = {
       scopes: [constants.Scopes.READ_TAAS_TEAM]
     }
   },
+  '/taas-teams/users/:handle': {
+    get: {
+      controller: 'SkillController',
+      method: 'getUserByHandle',
+      auth: 'jwt',
+      scopes: [constants.Scopes.READ_TAAS_TEAM]
+    }
+  },
   '/taas-teams/:id': {
     get: {
       controller: 'TeamController',

src/services/SkillService.js

@@ -21,6 +21,24 @@ searchSkills.schema = Joi.object().keys({
   }).required()
 }).required()
 
+/**
+ * Get V5 U-bahn user by handle
+ * If user doesn't exists in V5 it creates it
+ *
+ * @param {Object} handle      user handle
+ *
+ * @returns {Object} V5 user
+ */
+async function getUserByHandle(handle) {
+  const v3User = await helper.getMemberByHandle(handle);
+  const v5userId = await helper.getUserId(v3User.userId);
+
+  return {
+    userId: v5userId
+  };
+}
+
 module.exports = {
-  searchSkills
+  searchSkills,
+  getUserByHandle,
 }