@smartico/public-api 0.0.416 → 0.0.418

package/package.json

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

package/src/ActivityLog/ActivityLogActivities.ts

@@ -0,0 +1,22 @@
+/** Activity-log entry type as returned on the v2 wire (`type_id`). */
+export enum ActivityLogActivities {
+	Gems = 1,
+	Diamonds = 2,
+	Points = 3,
+	LevelChanged = 4,
+	Bonus = 5,
+	PrizeDrop = 6,
+	Minigame = 7,
+	RaffleTicket = 8,
+	Avatar = 9,
+	Task = 10,
+	Mission = 11,
+	Badge = 12,
+	TangiblePrize = 13,
+	Jackpot = 14,
+	Spin = 15,
+	NoPrize = 16,
+	Leaderboard = 17,
+	Tournament = 18,
+	ClanTournament = 19,
+}

package/src/ActivityLog/ActivityLogMeta.ts

@@ -0,0 +1,8 @@
+export interface ActivityLogMeta {
+	name?: string;
+	image_url?: string;
+	position?: number;
+	user_points_balance_before?: number;
+	points_requested?: number;
+	user_points_ever?: number;
+}

package/src/ActivityLog/GetActivityLogRequest.ts

@@ -6,6 +6,8 @@ export interface GetActivityLogRequest extends ProtocolMessage {
 	endTimeSeconds: number;
 	limit: number;
 	offset: number;
+	/** Optional v2 filter — {@link ActivityLogActivities} values to include. */
+	types?: number[];
 }
 
 

package/src/ActivityLog/GetActivityLogResponse.ts

@@ -1,6 +1,7 @@
 import { ProtocolResponse } from '../Base/ProtocolResponse';
 import { ActivityLogEntry } from './ActivityLogEntry';
-import { TActivityLog } from '../WSAPI/WSAPITypes';
+import { ActivityLogActivities } from './ActivityLogActivities';
+import { TActivityLog, TActivityLogEntry } from '../WSAPI/WSAPITypes';
 import { UserBalanceType } from './UserBalanceType';
 
 export interface GetActivityLogResponse extends ProtocolResponse {
@@ -14,11 +15,11 @@ export const ActivityLogTransform = (items: ActivityLogEntry[]): TActivityLog[]
 
 	return items.map((item: any): TActivityLog => {
 		const itemTransformed: Partial<TActivityLog> = {
-			create_date: item.create_date,
+			create_date: item.create_date?.seconds ?? item.create_date,
 			user_ext_id: item.user_ext_id,
 			crm_brand_id: item.crm_brand_id,
 			source_type_id: item.source_type_id,
-		}
+		};
 
 		item.type = item.type ?? UserBalanceType.Points;
 
@@ -39,4 +40,37 @@ export const ActivityLogTransform = (items: ActivityLogEntry[]): TActivityLog[]
 	});
 };
 
+export const ActivityLogV2Transform = (items: any[]): TActivityLogEntry[] => {
+	if (!items) {
+		return [];
+	}
 
+	return items.map((r) => {
+		const isGems = r.type_id === ActivityLogActivities.Gems || r.type === UserBalanceType.Gems;
+		const isDiamonds = r.type_id === ActivityLogActivities.Diamonds || r.type === UserBalanceType.Diamonds;
+
+		const x: TActivityLogEntry = {
+			create_date: r.create_date?.seconds ?? r.create_date,
+			user_ext_id: r.user_ext_id,
+			crm_brand_id: r.crm_brand_id,
+			type: isGems ? UserBalanceType.Gems : isDiamonds ? UserBalanceType.Diamonds : UserBalanceType.Points,
+			amount: r.points_collected ?? r.amount,
+			balance: r.user_points_balance ?? r.balance,
+			total_ever: r.user_points_ever,
+			source_type_id: r.source_type_id,
+			activity_type_id: r.type_id,
+			context_value_1: r.context_value_1,
+			meta: r.context_value_meta,
+			source_entity_name: r.source_entity_name,
+			source_entity_id: r.source_entity_id,
+			source_reference_id: r.source_reference_id,
+			source_root_id: r.source_root_id,
+			is_wallet_entry:
+				r.type_id == null
+				|| r.type_id === ActivityLogActivities.Gems
+				|| r.type_id === ActivityLogActivities.Diamonds
+				|| r.type_id === ActivityLogActivities.Points,
+		};
+		return x;
+	});
+};

package/src/ActivityLog/index.ts

@@ -1,7 +1,7 @@
 export * from './GetActivityLogRequest';
 export * from './GetActivityLogResponse';
 export * from './ActivityLogEntry';
+export * from './ActivityLogActivities';
+export * from './ActivityLogMeta';
 export * from './PointChangeSourceType';
 export * from './UserBalanceType';
-
-

package/src/SmarticoAPI.ts

@@ -102,6 +102,7 @@ import {
 	TRaffle,
 	TLevelCurrent,
 	TActivityLog,
+	TActivityLogEntry,
 	TRaffleDraw,
 	TAvatarDefinition,
 	TAvatarCustomized,
@@ -136,7 +137,7 @@ import { GetRelatedAchTourRequest } from './Missions/GetRelatedAchTourRequest';
 import { GetRelatedAchTourResponse } from './Missions/GetRelatedAchTourResponse';
 import { GetRafflesResponse, raffleTransform } from './Raffle/GetRafflesResponse';
 import { GetRafflesRequest } from './Raffle/GetRafflesRequest';
-import { GetActivityLogRequest, GetActivityLogResponse, ActivityLogTransform } from './ActivityLog';
+import { GetActivityLogRequest, GetActivityLogResponse, ActivityLogTransform, ActivityLogV2Transform } from './ActivityLog';
 import { GetClanListRequest, GetClanListResponse, GetClanInfoRequest, GetClanInfoResponse, JoinClanRequest, JoinClanResponse } from './Clans';
 import { InboxCategories } from './Inbox/InboxCategories';
 import { GetDrawRunRequest, GetDrawRunResponse, GetRaffleDrawRunsHistoryRequest, GetRaffleDrawRunsHistoryResponse, RaffleClaimPrizeRequest, RaffleClaimPrizeResponse, RaffleOptinRequest, RaffleOptinResponse, drawRunTransform, GetRaffleWonPrizesRequest, GetRaffleWonPrizesResponse } from './Raffle';
@@ -1778,6 +1779,29 @@ class SmarticoAPI {
 		return await this.send<GetActivityLogResponse>(message, ClassId.GET_POINT_HISTORY_RESPONSE);
 	}
 
+	public async getActivityLogV2(
+		user_ext_id: string,
+		startTimeSeconds: number,
+		endTimeSeconds: number,
+		limit: number,
+		offset: number,
+		types?: number[],
+	): Promise<GetActivityLogResponse> {
+		const message = this.buildMessage<GetActivityLogRequest, GetActivityLogResponse>(
+			user_ext_id,
+			ClassId.GET_POINT_HISTORY_REQUEST,
+			{
+				startTimeSeconds: Math.floor(startTimeSeconds),
+				endTimeSeconds: Math.floor(endTimeSeconds),
+				limit,
+				offset,
+				...(types ? { types } : {}),
+			},
+		);
+
+		return await this.send<GetActivityLogResponse>(message, ClassId.GET_POINT_HISTORY_RESPONSE);
+	}
+
 	public async getActivityLogT(
 		user_ext_id: string,
 		startTimeSeconds: number,
@@ -1792,6 +1816,22 @@ class SmarticoAPI {
 			(await this.getActivityLog(user_ext_id, startTimeSeconds, endTimeSeconds, limit, offset)).logHistory,
 		);
 	}
+
+	public async getActivityLogV2T(
+		user_ext_id: string,
+		startTimeSeconds: number,
+		endTimeSeconds: number,
+		from: number = 0,
+		to: number = 50,
+		types?: number[],
+	): Promise<TActivityLogEntry[]> {
+		const limit = to - from > 50 ? 50 : to - from;
+		const offset = from;
+
+		return ActivityLogV2Transform(
+			(await this.getActivityLogV2(user_ext_id, startTimeSeconds, endTimeSeconds, limit, offset, types)).logHistory,
+		);
+	}
 }
 
 export { SmarticoAPI, MessageSender };

package/src/WSAPI/WSAPIBase.ts

@@ -40,6 +40,7 @@ export enum onUpdateContextKey {
 	CurrentLevel = 'currentLevel',
 	InboxUnreadCount = 'inboxUnreadCount',
 	ActivityLog = 'activityLog',
+	ActivityLogV2 = 'activityLogV2',
 	AvatarsList = 'avatarsList',
 	AvatarsCustomized = 'avatarsCustomized',
 	AvatarPrompts = 'avatarPrompts',

package/src/WSAPI/WSAPITypes.ts

@@ -7,6 +7,8 @@ import { AchCustomLayoutTheme, AchCustomSectionType, AchMissionsTabsOptions, Ach
 import { PrizeModifiers } from '../MiniGames/PrizeModifiers';
 import { InboxCategories } from '../Inbox/InboxCategories';
 import { RaffleDrawInstanceState, RaffleDrawTypeExecution, RaffleTicketCapVisualization } from '../Raffle';
+import { ActivityLogActivities } from '../ActivityLog/ActivityLogActivities';
+import { ActivityLogMeta } from '../ActivityLog/ActivityLogMeta';
 import { PointChangeSourceType } from '../ActivityLog/PointChangeSourceType';
 import { UserBalanceType } from '../ActivityLog/UserBalanceType';
 import { SAWGPMarketType } from '../GamePick/MarketsType';
@@ -1804,6 +1806,29 @@ export interface TActivityLog {
 	source_type_id: PointChangeSourceType;
 }
 
+/**
+ * Full activity-log row returned by {@link WSAPIUser.getActivityLogV2}.
+ * Includes wallet changes and non-wallet activities (missions, badges, levels, …).
+ */
+export interface TActivityLogEntry {
+	create_date: number;
+	user_ext_id: string;
+	crm_brand_id: number;
+	type: UserBalanceType;
+	amount: number;
+	balance: number;
+	total_ever?: number;
+	source_type_id: PointChangeSourceType;
+	activity_type_id?: ActivityLogActivities;
+	context_value_1?: number;
+	meta?: ActivityLogMeta;
+	source_entity_name?: string;
+	source_entity_id?: number;
+	source_reference_id?: number;
+	source_root_id?: number;
+	is_wallet_entry: boolean;
+}
+
 
 /**
  * Result of `_smartico.api.requestRaffleOptin({raffle_id, draw_id, raffle_run_id})`.

package/src/WSAPI/WSAPIUser.ts

@@ -2,6 +2,7 @@ import { CoreUtils } from '../Core';
 import { ECacheContext, OCache } from '../OCache';
 import {
 	TActivityLog,
+	TActivityLogEntry,
 	TLevel,
 	TLevelCurrent,
 	TSegmentCheckResult,
@@ -639,4 +640,43 @@ export class WSAPIUser extends WSAPIBase {
 			onUpdate(payload);
 		}
 	}
+
+	/**
+	 * Returns the full activity log (v2) — wallet changes **and** non-wallet
+	 * activities (missions, badges, levels, tournaments, avatars, …).
+	 *
+	 * **Backwards compatibility**: existing integrations should keep using
+	 * {@link getActivityLog}, which returns wallet-only {@link TActivityLog}
+	 * rows with the original field contract unchanged.
+	 *
+	 * **Pagination** — same `from` / `to` offset model as {@link getActivityLog}
+	 * (server caps a single response at 50 entries).
+	 *
+	 * **Filtering** — pass `types` with {@link ActivityLogActivities} values to
+	 * request a server-side subset (e.g. missions only). Omit for all activity types.
+	 *
+	 * @returns Array of {@link TActivityLogEntry} ordered newest-first.
+	 */
+	public async getActivityLogV2({
+		startTimeSeconds,
+		endTimeSeconds,
+		from,
+		to,
+		types,
+	}: {
+		startTimeSeconds: number;
+		endTimeSeconds: number;
+		from: number;
+		to: number;
+		types?: number[];
+	}): Promise<TActivityLogEntry[]> {
+		const cacheKey = `${onUpdateContextKey.ActivityLogV2}:${startTimeSeconds}:${endTimeSeconds}:${from}:${to}:${types?.join(',') ?? ''}`;
+
+		return await OCache.use(
+			cacheKey,
+			ECacheContext.WSAPI,
+			() => this.api.getActivityLogV2T(this.userExtId, startTimeSeconds, endTimeSeconds, from, to, types),
+			CACHE_DATA_SEC,
+		);
+	}
 }

package/src/index.ts

@@ -12,7 +12,7 @@ export * from './CookieStore';
 // AchRelatedGame, BonusStatus, BonusMetaMap, BonusTemplateMetaMap — are intentionally
 // omitted; import those from their domain module.)
 export type {
-	TAchCategory, TActivityLog, TAvatarCustomized, TAvatarDefinition, TAvatarPrompt,
+	TAchCategory, TActivityLog, TActivityLogEntry, TAvatarCustomized, TAvatarDefinition, TAvatarPrompt,
 	TBonus, TBuyStoreItemResult, TClaimBonusResult, TClan, TClanInfo, TClanJoinResult,
 	TClanTournamentPlayers, TClans, TGetTranslations, TInboxMessage, TInboxMessageBody,
 	TLevel, TLevelCurrent, TMiniGamePlayBatchResult, TMiniGamePlayResult, TMiniGamePrize,