complexqa_frontend_core 1.0.13 → 1.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "complexqa_frontend_core",
-  "version": "1.0.13",
+  "version": "1.1.1",
   "description": "core of web ",
   "type": "module",
   "exports": {

package/publish/services/UserService.js

@@ -1,21 +1,68 @@
 import { abstractService } from "./abstractService";
 import { MockUserService } from "./mock_data/MockUserService";
+import { is_array } from "../utils/utils.js";
 
 /**
  *
- * @version          v.1.0 (18/11/2024)
+ * @version          v.1.1 (27/07/2025)
  */
 export class UserService extends abstractService
 {
 
-	static current_user_id   = false;
-	static user_name         = false;
-	static current_team_id   = false;
+	/**
+	 *
+	 * @type {false|number}
+	 */
+	static current_user_id = false;
+
+
+	/**
+	 *
+	 * @type {false|string}
+	 */
+	static user_name = false;
+
+
+	/**
+	 *
+	 * @type {false|number}
+	 */
+	static current_team_id = false;
+
+
+	/**
+	 *
+	 * @type {false|string}
+	 */
 	static current_team_slug = false;
-	static user_teams        = false;
-	static roles             = [ 'guest' ];
-	static current_language  = 'en';
-	static csrf_token        = false;
+
+
+	/**
+	 *
+	 * @type {false|array<typeTeam>}
+	 */
+	static user_teams = false;
+
+
+	/**
+	 *
+	 * @type {array<string>}
+	 */
+	static roles = [ 'guest' ];
+
+
+	/**
+	 *
+	 * @type {string}
+	 */
+	static current_language = 'en';
+
+
+	/**
+	 *
+	 * @type {false|string}
+	 */
+	static csrf_token = false;
 
 
 	/**
@@ -47,81 +94,201 @@ export class UserService extends abstractService
 		});
 	}
 
+
+	/**
+	 *
+	 * @version          v.1.1 (27/07/2025)
+	 * @returns {false|string}
+	 */
 	static get_csrf_token()
 	{
 		return UserService.csrf_token;
 	}
 
+
+	/**
+	 *
+	 * @version          v.1.1 (27/07/2025)
+	 * @param {string} csrf_token
+	 */
 	static set_csrf_token(csrf_token)
 	{
 		UserService.csrf_token = csrf_token;
 	}
 
+
+	/**
+	 *
+	 * @version          v.1.1 (27/07/2025)
+	 * @returns {false|number}
+	 */
 	static get_current_user_id()
 	{
-		return UserService.current_user_id;
+		return Number(UserService.current_user_id);
 	}
 
+
+	/**
+	 *
+	 * @version          v.1.1 (27/07/2025)
+	 * @param {number} current_user_id
+	 */
 	static set_current_user_id(current_user_id)
 	{
-		UserService.current_user_id = current_user_id;
+		UserService.current_user_id = Number(current_user_id);
 	}
 
+
+	/**
+	 *
+	 * @version          v.1.1 (27/07/2025)
+	 * @returns {false|string}
+	 */
 	static get_current_team_slug()
 	{
 		return UserService.current_team_slug;
 	}
 
+
+	/**
+	 *
+	 * @version          v.1.1 (27/07/2025)
+	 * @param {string} current_team_slug
+	 */
 	static set_current_team_slug(current_team_slug)
 	{
 		UserService.current_team_slug = current_team_slug;
 	}
 
+
+	/**
+	 *
+	 * @version          v.1.1 (27/07/2025)
+	 * @returns {false|string}
+	 */
 	static get_user_name()
 	{
 		return UserService.user_name;
 	}
 
+
+	/**
+	 *
+	 * @version          v.1.1 (27/07/2025)
+	 * @param {string} user_name
+	 */
 	static set_user_name(user_name)
 	{
 		UserService.user_name = user_name;
 	}
 
+
+	/**
+	 *
+	 * @version          v.1.1 (27/07/2025)
+	 * @returns {false|number}
+	 */
 	static get_current_team_id()
 	{
-		return UserService.current_team_id;
+		return Number(UserService.current_team_id);
 	}
 
+
+	/**
+	 *
+	 * @version          v.1.1 (27/07/2025)
+	 * @param {number} current_team_id
+	 */
 	static set_current_team_id(current_team_id)
 	{
-		UserService.current_team_id = current_team_id;
+		UserService.current_team_id = Number(current_team_id);
 	}
 
+
+	/**
+	 *
+	 * @version          v.1.1 (27/07/2025)
+	 * @returns {false|Array<typeTeam>}
+	 */
 	static get_user_teams()
 	{
 		return UserService.user_teams;
 	}
 
+
+	/**
+	 *
+	 * @version          v.1.1 (27/07/2025)
+	 * @param {Array<typeTeam>} user_teams
+	 */
 	static set_user_teams(user_teams)
 	{
-		UserService.user_teams = user_teams;
+		if (!is_array(UserService.user_teams))
+		{
+			UserService.user_teams = [];
+		}
+
+		user_teams.map((user_team) =>
+		{
+			UserService.user_teams.push(new typeTeam(user_team));
+		});
+	}
+
+
+	/**
+	 *
+	 * @version          v.1.1 (27/07/2025)
+	 * @param {typeTeam} user_team
+	 */
+	static add_user_teams(user_team)
+	{
+		if (!is_array(UserService.user_teams))
+		{
+			UserService.user_teams = [];
+		}
+
+		UserService.user_teams.push(new typeTeam(user_team));
 	}
 
+
+	/**
+	 *
+	 * @version          v.1.1 (27/07/2025)
+	 * @returns {Array<string>}
+	 */
 	static get_roles()
 	{
 		return UserService.roles;
 	}
 
-	static get_roles(roles)
+
+	/**
+	 *
+	 * @version          v.1.1 (27/07/2025)
+	 * @param {Array<string>} roles
+	 */
+	static set_roles(roles)
 	{
 		UserService.roles = roles;
 	}
 
+
+	/**
+	 *
+	 * @version          v.1.1 (27/07/2025)
+	 * @returns {string}
+	 */
 	static get_current_language()
 	{
 		return UserService.current_language;
 	}
 
+
+	/**
+	 *
+	 * @version          v.1.1 (27/07/2025)
+	 * @param {string} current_language
+	 */
 	static set_current_language(current_language)
 	{
 		UserService.current_language = current_language;