@smartico/public-api 0.0.322 → 0.0.323

package/package.json

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

package/src/Missions/BadgesTimeLimitStates.ts

@@ -0,0 +1,15 @@
+export enum BadgesTimeLimitStates {
+	/** Before Start Date */
+	BeforeStartDate = 0,
+	/** After Start Date but before earned */
+	AfterStartDateNoProgress = 1,
+	/** After Start Date but before started (no progress) + End date */
+	AfterStartDateNoProgressAndEndDate = 2,
+	/** After Start Date, but with some progress + End date */
+	AfterStartDateWithProgressAndEndDate = 3,
+	/** After End Date (not started) */
+	AfterEndDateNotStarted = 4,
+	/** After End Date (player has some progress, but not completed) */
+	AfterEndDateWithProgress = 5,
+}
+

package/src/Missions/MissionsUtils.ts

@@ -3,6 +3,7 @@ import { AchievementAvailabilityStatus } from "./AchievementAvailabilityStatus";
 import { AchievementStatus } from "./AchievementStatus";
 import { UserAchievement } from "./UserAchievement";
 import { UserAchievementTask } from "./UserAchievementTask";
+import { BadgesTimeLimitStates } from "./BadgesTimeLimitStates";
 
 export class MissionUtils {
 
@@ -246,4 +247,41 @@ export class MissionUtils {
 
         return task;
     }
+
+    public static determineBadgeState = (badge: UserAchievement): BadgesTimeLimitStates => {
+        const now = Date.now();
+        const { active_from_ts, active_till_ts, progress } = badge;
+      
+        // 1. BEFORE START
+        if (active_from_ts > now) {
+            return BadgesTimeLimitStates.BeforeStartDate;
+        }
+      
+        // 2. AFTER START, NO END DATE (infinite badge)
+        //    → grey, no locked, no date chip
+        if (!active_till_ts) {
+            if (progress === 0) {
+                return BadgesTimeLimitStates.AfterStartDateNoProgress;
+            }
+            // If infinite and with progress → this state does not exist in enum
+            // (but if needed we can add one)
+        }
+      
+        // 3. AFTER START, BEFORE END DATE
+        if (now < active_till_ts) {
+            if (progress === 0) {
+                // now < end + has end date → must show chip
+                return BadgesTimeLimitStates.AfterStartDateNoProgressAndEndDate;
+            }
+        
+            return BadgesTimeLimitStates.AfterStartDateWithProgressAndEndDate;
+        }
+      
+        // 4. AFTER END DATE
+        if (progress === 0) {
+            return BadgesTimeLimitStates.AfterEndDateNotStarted;
+        }
+      
+        return BadgesTimeLimitStates.AfterEndDateWithProgress;
+    }
 }

package/src/Missions/UserAchievement.ts

@@ -8,6 +8,7 @@ import { AchievementType } from './AchievementType';
 import { MissionUtils } from './MissionsUtils';
 import { ScheduledMissionType } from './ScheduledMissionType';
 import { UserAchievementTask } from './UserAchievementTask';
+import { BadgesTimeLimitStates } from './BadgesTimeLimitStates';
 
 export interface UserAchievement {
 	ach_id?: number;
@@ -45,8 +46,18 @@ export interface UserAchievement {
 	completed_this_week?: boolean;
 	completed_this_month?: boolean;
 	custom_section_type_id?: number;
+	badgeTimeLimitState?: BadgesTimeLimitStates;
 }
 
+export const enrichUserAchievementsWithBadgeState = (items: UserAchievement[]): UserAchievement[] => {
+	return items.map((item) => {
+		if (item.ach_type_id === AchievementType.Badge && (item.active_from_ts || item.active_till_ts)) {
+			item.badgeTimeLimitState = MissionUtils.determineBadgeState(item);
+		}
+		return item;
+	});
+};
+
 export const UserAchievementTransform = (items: UserAchievement[]): TMissionOrBadge[] => {
 	return items
 		.filter((r) => r.ach_id >= 1)
@@ -142,6 +153,7 @@ export const UserAchievementTransform = (items: UserAchievement[]): TMissionOrBa
 				availability_status: MissionUtils.getAvailabilityStatus(r),
 				claim_button_title: r.ach_public_meta.claim_button_title,
 				claim_button_action: r.ach_public_meta.claim_button_action,
+				badgeTimeLimitState: r.badgeTimeLimitState,
 			};
 
 			if (r.ach_status_id === AchievementStatus.Recurring) {

package/src/Missions/index.ts

@@ -9,6 +9,7 @@ export * from './GetAchievementMapRequest';
 export * from './GetAchievementMapResponse';
 export * from './ReloadAchievementsEvent';
 export * from './UserAchievement';
+export { enrichUserAchievementsWithBadgeState } from './UserAchievement';
 export * from './UserAchievementTask';
 export * from './ScheduledMissionType';
 export * from './AchCategoryPublicMeta';
@@ -21,4 +22,5 @@ export * from './AchievementAvailabilityStatus';
 export * from './GetRelatedAchTourResponse';
 export * from './MissionsUtils';
 export * from './MissionCategory';
-export * from './UserAchievementTaskAffectsProgress'
+export * from './UserAchievementTaskAffectsProgress';
+export * from './BadgesTimeLimitStates';

package/src/SmarticoAPI.ts

@@ -64,6 +64,7 @@ import {
 	GetAchievementMapRequest,
 	GetAchievementMapResponse,
 	UserAchievementTransform,
+	enrichUserAchievementsWithBadgeState,
 } from './Missions';
 import {
 	GetTournamentInfoRequest,
@@ -878,6 +879,7 @@ class SmarticoAPI {
 
 		if (responseClone.achievements) {
 			responseClone.achievements = responseClone.achievements.filter((a) => a.ach_type_id === AchievementType.Badge);
+			responseClone.achievements = enrichUserAchievementsWithBadgeState(responseClone.achievements);
 		}
 		return responseClone;
 	}

package/src/SmarticoLib/index.ts

@@ -1,5 +1,7 @@
 // Generated by dts-bundle-generator v9.5.1
 
+import { BadgesTimeLimitStates } from "src/Missions";
+
 declare enum CJMActivityType {
 	Root = 0,
 	Journey_Started = 1,
@@ -1561,6 +1563,7 @@ export interface UserAchievement {
 	completed_this_week?: boolean;
 	completed_this_month?: boolean;
 	custom_section_type_id?: number;
+	badgeTimeLimitState?: BadgesTimeLimitStates;
 }
 export interface GetAchievementMapResponse extends ProtocolResponse {
 	achievements?: UserAchievement[];

package/src/WSAPI/WSAPITypes.ts

@@ -1,7 +1,7 @@
 import { BuyStoreItemErrorCode } from '../Store';
 import { MiniGamePrizeTypeName, SAWAcknowledgeTypeName, SAWAskForUsername, SAWBuyInTypeName, SAWGameLayout, SAWGameTypeName, SAWSpinErrorCode, SAWTemplate, SAWTemplateUI } from '../MiniGames';
 import { TournamentRegistrationError, TournamentRegistrationStatusName, TournamentRegistrationTypeName } from '../Tournaments';
-import { AchievementAvailabilityStatus } from '../Missions';
+import { AchievementAvailabilityStatus, BadgesTimeLimitStates } from '../Missions';
 import { LeaderBoardPeriodType } from '../Leaderboard';
 import { AchCustomLayoutTheme, AchCustomSectionType, AchMissionsTabsOptions, AchOverviewMissionsFilter, LiquidEntityData } from '../CustomSections';
 import { PrizeModifiers } from '../MiniGames/PrizeModifiers';
@@ -677,6 +677,9 @@ export interface TMissionOrBadge {
 
 	/** Action for the claim reward button */
 	claim_button_action?: string;
+
+	/** Badge time limit state for badges with time restrictions */
+	badgeTimeLimitState?: BadgesTimeLimitStates;
 }
 
 export interface AchRelatedGame {