@smartico/public-api 0.0.280 → 0.0.282

package/docs/interfaces/SAWTemplateUI.md

@@ -188,6 +188,12 @@ ___
 
 ___
 
+### prize\_pool\_image
+
+• `Optional` **prize\_pool\_image**: `string`
+
+___
+
 ### ask\_for\_username
 
 • `Optional` **ask\_for\_username**: [`SAWAskForUsername`](../enums/SAWAskForUsername.md)

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@smartico/public-api",
-	"version": "0.0.280",
+	"version": "0.0.282",
 	"description": "Smartico public API",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",

package/src/MiniGames/SAWTemplateUI.ts

@@ -35,6 +35,7 @@ export interface SAWTemplateUI {
 	matchx_is_completed?: boolean;
 	matchx_general_board_users_count?: number;
 	matchx_hide_ranking?: boolean;
+	prize_pool_image?: string;
 	ask_for_username?: SAWAskForUsername;
 	show_prize_board?: boolean;
 

package/src/Missions/AchievementTaskPublicMeta.ts

@@ -1,4 +1,5 @@
 export interface AchievementTaskPublicMeta {
 	name?: string;
 	display_progress_as_count?: boolean;
+	stage_image?: string;
 }

package/src/Missions/UserAchievement.ts

@@ -92,6 +92,7 @@ export const UserAchievementTransform = (items: UserAchievement[]): TMissionOrBa
 						execution_count_expected: t.executionCount,
 						execution_count_actual: t.userExecutedCount,
 						display_progress_as_count: t.task_public_meta.display_progress_as_count,
+						stage_image: t.task_public_meta.stage_image,
 					})),
 				related_games: (r.related_games || []).map((g) => ({
 					ext_game_id: g.ext_game_id,

package/src/SmarticoAPI.ts

@@ -94,6 +94,7 @@ import {
 	TUICustomSection,
 	TBonus,
 	TRaffle,
+	TLevelCurrent,
 } from './WSAPI/WSAPITypes';
 import { getLeaderBoardTransform } from './Leaderboard/LeaderBoards';
 import { GetAchievementsUserInfoResponse } from './Core/GetAchievementsUserInfoResponse';
@@ -1028,6 +1029,35 @@ class SmarticoAPI {
 		return GetLevelMapResponseTransform(await this.levelsGet(user_ext_id));
 	}
 
+	public async getLevelCurrent(user_ext_id: string): Promise<TLevelCurrent> {
+		const levels = await this.levelsGetT(user_ext_id);
+		const userInfo = await this.getUserGamificationInfo(user_ext_id);
+		if (!levels || levels.length === 0) return null;
+
+		const userPoints = userInfo.points_balance;
+
+		const sortedLevels = levels.sort((a, b) => a.required_points - b.required_points);
+
+		let currentLevelIndex = sortedLevels.findIndex((level, index) => {
+			const nextLevel = sortedLevels[index + 1];
+			return userPoints >= level.required_points && (!nextLevel || userPoints < nextLevel.required_points);
+		});
+
+		if (currentLevelIndex === -1) {
+			currentLevelIndex = sortedLevels.length - 1;
+		}
+
+		const currentLevel = sortedLevels[currentLevelIndex];
+		const nextLevel = sortedLevels[currentLevelIndex + 1];
+		const progress = nextLevel ? ((userPoints - currentLevel.required_points) / (nextLevel.required_points - currentLevel.required_points)) * 100 : 100;
+
+		return {
+			...currentLevel,
+			ordinal_position: currentLevelIndex + 1,
+			progress: Math.min(Math.max(progress, 0), 100)
+		};
+	}
+
 	public async customSectionsGet(user_ext_id: string, force_language?: string): Promise<GetCustomSectionsResponse> {
 		const message = this.buildMessage<GetCustomSectionsRequest, GetCustomSectionsResponse>(
 			user_ext_id,

package/src/SmarticoLib/index.ts

@@ -414,6 +414,7 @@ export interface SAWTemplateUI {
 	matchx_is_completed?: boolean;
 	matchx_general_board_users_count?: number;
 	matchx_hide_ranking?: boolean;
+	prize_pool_image?: string;
 	ask_for_username?: SAWAskForUsername;
 	show_prize_board?: boolean;
 	max_spins_period_ms?: number;

package/src/WSAPI/WSAPI.ts

@@ -36,6 +36,7 @@ import {
 	TRaffleDraw,
 	TRaffleDrawRun,
 	TransformedRaffleClaimPrizeResponse,
+	TLevelCurrent
 } from './WSAPITypes';
 import { LeaderBoardPeriodType } from '../Leaderboard';
 import {
@@ -88,6 +89,7 @@ enum onUpdateContextKey {
 	JackpotWinners = 'jackpotWinners',
 	Raffles = 'raffles',
 	JackpotEligibleGames = 'jackpotEligibleGames',
+	CurrentLevel = 'currentLevel',
 }
 
 /** @group General API */
@@ -211,6 +213,22 @@ export class WSAPI {
 		return OCache.use(onUpdateContextKey.Levels, ECacheContext.WSAPI, () => this.api.levelsGetT(null), CACHE_DATA_SEC);
 	}
 
+	/**
+	 * Returns the current level of the user with extended information including ordinal position and progress.
+	 *
+	 * **Example**:
+	 * ```
+	 * _smartico.api.getCurrentLevel().then((result) => {
+	 *      console.log(result);
+	 * });
+	 * ```
+	 *
+	 * **Visitor mode: not supported**
+	 */
+	public async getCurrentLevel(): Promise<TLevelCurrent> {
+		return OCache.use(onUpdateContextKey.CurrentLevel, ECacheContext.WSAPI, () => this.api.getLevelCurrent(null), CACHE_DATA_SEC);
+	}
+
 	/** Returns all the missions available the current user.
 	 * The returned missions are cached for 30 seconds. But you can pass the onUpdate callback as a parameter.
 	 * Note that each time you call getMissions with a new onUpdate callback, the old one will be overwritten by the new one.

package/src/WSAPI/WSAPITypes.ts

@@ -260,6 +260,17 @@ export interface TLevel {
 	custom_data: string;
 }
 
+/**
+ * TLevelCurrent describes the information of each level defined in the system along with ordinal position and progress of the current level
+ */
+
+export interface TLevelCurrent extends TLevel {
+	/** The ordinal position of the level */
+	ordinal_position: number;
+	/** The progress of the level */
+	progress: number;
+}
+
 /**
  * TTournament describes the general information of the tournament item
  */

package/tsconfig.json

@@ -18,17 +18,16 @@
 			"src/WSAPI/WSAPITypes.ts",
 			"src/Tournaments/TournamentRegistrationStatus.ts",
 			"src/Tournaments/TournamentRegistrationType.ts",
-			"src/MiniGames/SAWBuyInType.ts",
-			"src/MiniGames/SAWGameType.ts",
-			"src/MiniGames/SAWPrizeType.ts",
-			"src/MiniGames/SAWSpinErrorCode.ts",
+			"src/Bonuses/BonusStatus.ts",
+			"src/MiniGames/index.ts",
+			"src/CustomSections/AchCustomSection.ts",
 			"src/Tournaments/TournamentRegistrationError.ts",
 			"src/Store/BuyStoreItemErrorCode.ts",
 			"src/Leaderboard/LeaderBoardPeriodType.ts",
 			"src/Base/AchRelatedGame.ts",
 			"src/Jackpots/index.ts",
 			"src/Raffle/index.ts",
-			"src/Missions/AchievementAvailabilityStatus.ts"
+			"src/Missions/AchievementAvailabilityStatus.ts",
 		],
 		"out": "docs",
 		"plugin": ["typedoc-plugin-markdown", "typedoc-plugin-merge-modules"],