@smartico/public-api 0.0.416 → 0.0.417

package/package.json

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

package/src/ActivityLog/ActivityLogActivities.ts

@@ -0,0 +1,66 @@
+import { UserBalanceType } from './UserBalanceType';
+
+/** 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,
+}
+
+export enum WalletChangeType {
+	Add = 1,
+	Deduct = 2,
+	Set = 3,
+}
+
+export enum LevelChangeType {
+	Increase = 1,
+	Decrease = 2,
+}
+
+/** Wire ctx_1 for Mission / Badge / Task — see SMR-44986. */
+export enum AchievementChangeType {
+	Complete = 1,
+	Unlock = 2,
+}
+
+/** Wire ctx_1 for Jackpot rows — SMR-44986. */
+export enum JackpotContextValue {
+	Registration = 1,
+	Win = 3,
+}
+
+const WALLET_TYPE_IDS = new Set<number>([
+	ActivityLogActivities.Gems,
+	ActivityLogActivities.Diamonds,
+	ActivityLogActivities.Points,
+]);
+
+export const isWalletActivityTypeId = (typeId: number): boolean => WALLET_TYPE_IDS.has(typeId);
+
+export const activityTypeIdToBalanceType = (typeId: ActivityLogActivities): UserBalanceType => {
+	switch (typeId) {
+		case ActivityLogActivities.Gems:
+			return UserBalanceType.Gems;
+		case ActivityLogActivities.Diamonds:
+			return UserBalanceType.Diamonds;
+		default:
+			return UserBalanceType.Points;
+	}
+};

package/src/ActivityLog/ActivityLogMapper.ts

@@ -0,0 +1,358 @@
+import { PointChangeSourceType } from './PointChangeSourceType';
+import { UserBalanceType } from './UserBalanceType';
+import {
+	ActivityLogActivities,
+	activityTypeIdToBalanceType,
+	isWalletActivityTypeId,
+} from './ActivityLogActivities';
+import { ActivityLogMeta, ActivityLogPublicMeta } from './ActivityLogMeta';
+import { TActivityLogEntry } from '../WSAPI/WSAPITypes';
+
+const POINTS_COLLECTED_SENTINEL = -1;
+
+const parseCreateDate = (raw: unknown): number => {
+	if (raw === undefined || raw === null) {
+		return 0;
+	}
+	if (typeof raw === 'number') {
+		return raw;
+	}
+	if (typeof raw === 'object' && raw !== null) {
+		if ('seconds' in raw) {
+			return Number((raw as { seconds: number }).seconds);
+		}
+		if ('epochSecond' in raw) {
+			return Number((raw as { epochSecond: number }).epochSecond);
+		}
+	}
+	if (typeof raw === 'string') {
+		const ms = Date.parse(raw);
+		if (!Number.isNaN(ms)) {
+			return Math.floor(ms / 1000);
+		}
+	}
+	return 0;
+};
+
+const readWireNumber = (log: Record<string, unknown>, ...keys: string[]): number | undefined => {
+	for (const key of keys) {
+		const value = log[key];
+		if (value !== undefined && value !== null && value !== '') {
+			return Number(value);
+		}
+	}
+	return undefined;
+};
+
+const normalizeWireLog = (raw: Record<string, unknown>): Record<string, unknown> => {
+	const log: Record<string, unknown> = { ...raw };
+	const explicitTypeId = readWireNumber(log, 'type_id');
+	if (explicitTypeId !== undefined) {
+		log.type_id = explicitTypeId;
+	} else {
+		const wireType = readWireNumber(log, 'type');
+		if (wireType !== undefined && wireType > UserBalanceType.Diamonds) {
+			log.type_id = wireType;
+		}
+	}
+	if (log.context_value_1 === undefined && log.ctx_1 !== undefined) {
+		log.context_value_1 = log.ctx_1;
+	}
+	if (log.context_value_meta === undefined && log.ctx_meta !== undefined) {
+		log.context_value_meta = log.ctx_meta;
+	}
+	if (log.source_reference_id === undefined && log.source_ref_id !== undefined) {
+		log.source_reference_id = log.source_ref_id;
+	}
+	if (log.source_entity_id === undefined && log.source_root_id !== undefined) {
+		log.source_entity_id = log.source_root_id;
+	}
+	return log;
+};
+
+const isActivityLogWireEntry = (log: Record<string, unknown>): boolean => {
+	if (log.is_activity_log === true) {
+		return true;
+	}
+	if (log.label_id !== undefined && log.label_id !== null) {
+		return true;
+	}
+	if (log.ctx_meta !== undefined || log.context_value_meta !== undefined) {
+		return true;
+	}
+	if (log.ctx_1 !== undefined || log.context_value_1 !== undefined) {
+		return true;
+	}
+	if (log.user_id !== undefined && log.user_id !== null) {
+		return true;
+	}
+	const wireTypeId = readWireNumber(log, 'type_id');
+	return wireTypeId !== undefined && wireTypeId > UserBalanceType.Diamonds;
+};
+
+const readWireBalanceType = (log: Record<string, unknown>): UserBalanceType | undefined => {
+	const balanceType = readWireNumber(log, 'type');
+	if (balanceType === UserBalanceType.Gems || balanceType === UserBalanceType.Diamonds) {
+		return balanceType;
+	}
+	return undefined;
+};
+
+const hasGemsOrDiamondsWalletFields = (log: Record<string, unknown>): boolean =>
+	log.amount !== undefined
+	|| log.balance !== undefined
+	|| readWireNumber(log, 'amount', 'collected_amount') !== undefined
+	|| readWireNumber(log, 'balance', 'user_balance') !== undefined;
+
+const isGemsOrDiamondsWalletWireEntry = (log: Record<string, unknown>): boolean => {
+	const balanceType = readWireBalanceType(log);
+	return balanceType !== undefined && hasGemsOrDiamondsWalletFields(log);
+};
+
+const resolveWalletAmount = (log: Record<string, unknown>, isPoints: boolean): number => {
+	const pointsCollected = readWireNumber(log, 'points_collected');
+	if (isPoints && pointsCollected !== undefined && pointsCollected !== POINTS_COLLECTED_SENTINEL) {
+		return pointsCollected;
+	}
+	if (isPoints) {
+		const amount = readWireNumber(log, 'amount', 'collected_amount');
+		return amount === undefined ? 0 : amount;
+	}
+	const amount = readWireNumber(log, 'amount', 'collected_amount');
+	return amount === undefined ? 0 : amount;
+};
+
+const resolveWalletBalance = (log: Record<string, unknown>, isPoints: boolean): number => {
+	if (isPoints) {
+		const balance = readWireNumber(log, 'balance', 'user_points_balance', 'user_balance');
+		return balance === undefined ? 0 : balance;
+	}
+	const balance = readWireNumber(log, 'balance', 'user_balance');
+	return balance === undefined ? 0 : balance;
+};
+
+const resolveSourceTypeId = (log: Record<string, unknown>): PointChangeSourceType => {
+	const sourceTypeId = readWireNumber(log, 'source_type_id', 'entity_type_id');
+	return (sourceTypeId === undefined ? 0 : sourceTypeId) as PointChangeSourceType;
+};
+
+const parseMeta = (contextValueMeta: unknown): ActivityLogMeta | undefined => {
+	if (!contextValueMeta) {
+		return undefined;
+	}
+	let meta: ActivityLogMeta | undefined;
+	if (typeof contextValueMeta === 'object') {
+		meta = contextValueMeta as ActivityLogMeta;
+	} else if (typeof contextValueMeta === 'string') {
+		try {
+			meta = JSON.parse(contextValueMeta) as ActivityLogMeta;
+		} catch {
+			return undefined;
+		}
+	}
+	if (!meta) {
+		return undefined;
+	}
+	const nested = meta.public_meta ?? meta.public_map;
+	const pickImage = (src?: ActivityLogMeta | ActivityLogPublicMeta): string | undefined =>
+		src?.image_url ?? src?.image ?? src?.url ?? src?.avatar_url ?? src?.icon_url ?? src?.avatar_id;
+	if (nested) {
+		return {
+			...meta,
+			name: meta.name ?? nested.name,
+			image_url: pickImage(meta) ?? pickImage(nested),
+			position: meta.position ?? nested.position ?? meta.score,
+		};
+	}
+	const topImage = pickImage(meta);
+	if (topImage && meta.image_url === undefined) {
+		return { ...meta, image_url: topImage, position: meta.position ?? meta.score };
+	}
+	if (meta.score !== undefined && meta.position === undefined) {
+		return { ...meta, position: meta.score };
+	}
+	return meta;
+};
+
+const isLegacyPointsEntry = (log: Record<string, unknown>): boolean => {
+	if (isActivityLogWireEntry(log)) {
+		return false;
+	}
+	const pointsCollected = readWireNumber(log, 'points_collected');
+	return pointsCollected !== undefined && pointsCollected !== POINTS_COLLECTED_SENTINEL;
+};
+
+const isLegacyGemsDiamondsEntry = (log: Record<string, unknown>): boolean => {
+	if (isActivityLogWireEntry(log)) {
+		return false;
+	}
+	const balanceType = readWireNumber(log, 'type');
+	return (balanceType === UserBalanceType.Gems || balanceType === UserBalanceType.Diamonds)
+		&& log.amount !== undefined;
+};
+
+const isV2Entry = (log: Record<string, unknown>): boolean =>
+	isActivityLogWireEntry(log) || (log.type_id !== undefined && log.type_id !== null);
+
+const resolveSourceEntityName = (log: Record<string, unknown>, meta: ActivityLogMeta | undefined): string | undefined => {
+	const fromWire = log.source_entity_name ?? log.source_public_name;
+	if (typeof fromWire === 'string' && fromWire.length > 0) {
+		return fromWire;
+	}
+	if (meta?.name) {
+		return meta.name;
+	}
+	return undefined;
+};
+
+const buildEntryKey = (log: Record<string, unknown>, index: number): string =>
+	[
+		parseCreateDate(log.create_date),
+		log.type_id ?? log.type ?? 'legacy',
+		log.source_type_id ?? '',
+		log.source_entity_id ?? log.source_root_id ?? '',
+		log.context_value_1 ?? log.ctx_1 ?? '',
+		index,
+	].join('-');
+
+const mapLegacyPointsEntry = (log: Record<string, unknown>, index: number): TActivityLogEntry => ({
+	entry_key: buildEntryKey(log, index),
+	create_date: parseCreateDate(log.create_date),
+	user_ext_id: String(log.user_ext_id ?? ''),
+	crm_brand_id: Number(log.crm_brand_id ?? 0),
+	type: UserBalanceType.Points,
+	amount: resolveWalletAmount(log, true),
+	balance: resolveWalletBalance(log, true),
+	total_ever: readWireNumber(log, 'user_points_ever', 'collected_ever'),
+	context_value_1: readWireNumber(log, 'context_value_1', 'ctx_1'),
+	source_type_id: resolveSourceTypeId(log),
+	activity_type_id: ActivityLogActivities.Points,
+	is_wallet_entry: true,
+});
+
+const mapLegacyGemsDiamondsEntry = (log: Record<string, unknown>, index: number): TActivityLogEntry => {
+	const wireType = readWireNumber(log, 'type') as UserBalanceType;
+	const activityTypeId = wireType === UserBalanceType.Gems
+		? ActivityLogActivities.Gems
+		: ActivityLogActivities.Diamonds;
+	return {
+		entry_key: buildEntryKey(log, index),
+		create_date: parseCreateDate(log.create_date),
+		user_ext_id: String(log.user_ext_id ?? ''),
+		crm_brand_id: Number(log.crm_brand_id ?? 0),
+		type: activityTypeIdToBalanceType(activityTypeId),
+		amount: resolveWalletAmount(log, false),
+		balance: resolveWalletBalance(log, false),
+		context_value_1: readWireNumber(log, 'context_value_1', 'ctx_1'),
+		source_type_id: resolveSourceTypeId(log),
+		activity_type_id: activityTypeId,
+		is_wallet_entry: true,
+	};
+};
+
+const mapV2Entry = (log: Record<string, unknown>, index: number): TActivityLogEntry | null => {
+	const typeId = readWireNumber(log, 'type_id');
+	const contextValue1 = readWireNumber(log, 'context_value_1', 'ctx_1');
+
+	const meta = parseMeta(log.context_value_meta);
+	const sourceEntityName = resolveSourceEntityName(log, meta);
+	const sourceEntityId = readWireNumber(log, 'source_entity_id', 'source_root_id');
+	const sourceReferenceId = readWireNumber(log, 'source_reference_id', 'source_ref_id');
+	const sourceRootId = readWireNumber(log, 'source_root_id');
+	const gemsOrDiamondsWallet = isGemsOrDiamondsWalletWireEntry(log);
+	const isWalletEntry = (typeId !== undefined && isWalletActivityTypeId(typeId)) || gemsOrDiamondsWallet;
+
+	const base = {
+		entry_key: buildEntryKey(log, index),
+		create_date: parseCreateDate(log.create_date),
+		user_ext_id: String(log.user_ext_id ?? ''),
+		crm_brand_id: Number(log.crm_brand_id ?? 0),
+		source_type_id: resolveSourceTypeId(log),
+		activity_type_id: typeId as ActivityLogActivities,
+		context_value_1: contextValue1,
+		meta,
+		source_entity_name: sourceEntityName,
+		source_entity_id: sourceEntityId && sourceEntityId > 0 ? sourceEntityId : undefined,
+		source_reference_id: sourceReferenceId && sourceReferenceId > 0 ? sourceReferenceId : undefined,
+		source_root_id: sourceRootId && sourceRootId > 0 ? sourceRootId : undefined,
+	};
+
+	if (isWalletEntry) {
+		const wireBalanceType = readWireBalanceType(log);
+		const balanceType = wireBalanceType ?? (typeId !== undefined ? activityTypeIdToBalanceType(typeId as ActivityLogActivities) : UserBalanceType.Points);
+		const walletActivityTypeId = typeId !== undefined && isWalletActivityTypeId(typeId)
+			? typeId
+			: balanceType === UserBalanceType.Gems
+				? ActivityLogActivities.Gems
+				: balanceType === UserBalanceType.Diamonds
+					? ActivityLogActivities.Diamonds
+					: ActivityLogActivities.Points;
+		const isPoints = balanceType === UserBalanceType.Points;
+		const totalEver = isPoints
+			? readWireNumber(log, 'user_points_ever', 'collected_ever')
+				?? (meta?.user_points_ever !== undefined ? Number(meta.user_points_ever) : undefined)
+			: undefined;
+		return {
+			...base,
+			activity_type_id: walletActivityTypeId as ActivityLogActivities,
+			type: balanceType,
+			amount: resolveWalletAmount(log, isPoints),
+			balance: resolveWalletBalance(log, isPoints),
+			total_ever: totalEver === POINTS_COLLECTED_SENTINEL ? undefined : totalEver,
+			is_wallet_entry: true,
+		};
+	}
+
+	return {
+		...base,
+		type: UserBalanceType.Points,
+		amount: 0,
+		balance: 0,
+		is_wallet_entry: false,
+		is_level_entry: typeId === ActivityLogActivities.LevelChanged,
+	};
+};
+
+const mapWireEntry = (log: Record<string, unknown>, index: number): TActivityLogEntry | null => {
+	const normalized = normalizeWireLog(log);
+	if (isLegacyPointsEntry(normalized)) {
+		return mapLegacyPointsEntry(normalized, index);
+	}
+	if (isLegacyGemsDiamondsEntry(normalized)) {
+		return mapLegacyGemsDiamondsEntry(normalized, index);
+	}
+	if (isV2Entry(normalized)) {
+		return mapV2Entry(normalized, index);
+	}
+	return null;
+};
+
+export const mapActivityLogHistory = (logHistory: unknown[]): TActivityLogEntry[] => {
+	const entries: TActivityLogEntry[] = [];
+	(logHistory || []).forEach((raw, index) => {
+		const mapped = mapWireEntry(raw as Record<string, unknown>, index);
+		if (mapped) {
+			entries.push(mapped);
+		}
+	});
+	return entries;
+};
+
+export const resolveWalletDisplayType = (entry: TActivityLogEntry): UserBalanceType => {
+	switch (entry.activity_type_id) {
+		case ActivityLogActivities.Gems:
+			return UserBalanceType.Gems;
+		case ActivityLogActivities.Diamonds:
+			return UserBalanceType.Diamonds;
+		case ActivityLogActivities.Points:
+			return UserBalanceType.Points;
+	}
+	switch (Number(entry.type)) {
+		case UserBalanceType.Gems:
+			return UserBalanceType.Gems;
+		case UserBalanceType.Diamonds:
+			return UserBalanceType.Diamonds;
+		default:
+			return UserBalanceType.Points;
+	}
+};

package/src/ActivityLog/ActivityLogMeta.ts

@@ -0,0 +1,27 @@
+export interface ActivityLogPublicMeta {
+	name?: string;
+	image_url?: string;
+	image?: string;
+	url?: string;
+	avatar_url?: string;
+	avatar_id?: string;
+	icon_url?: string;
+	position?: number;
+}
+
+export interface ActivityLogMeta {
+	image_url?: string;
+	image?: string;
+	url?: string;
+	avatar_url?: string;
+	avatar_id?: string;
+	icon_url?: string;
+	name?: string;
+	position?: number;
+	score?: number;
+	user_points_balance_before?: number;
+	points_requested?: number;
+	user_points_ever?: number;
+	public_meta?: ActivityLogPublicMeta;
+	public_map?: ActivityLogPublicMeta;
+}

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,42 +1,42 @@
 import { ProtocolResponse } from '../Base/ProtocolResponse';
 import { ActivityLogEntry } from './ActivityLogEntry';
-import { TActivityLog } from '../WSAPI/WSAPITypes';
-import { UserBalanceType } from './UserBalanceType';
+import { mapActivityLogHistory, resolveWalletDisplayType } from './ActivityLogMapper';
+import { TActivityLog, TActivityLogEntry } from '../WSAPI/WSAPITypes';
 
 export interface GetActivityLogResponse extends ProtocolResponse {
 	logHistory: ActivityLogEntry[];
 }
 
-export const ActivityLogTransform = (items: ActivityLogEntry[]): TActivityLog[] => {
+const toTActivityLog = (entry: TActivityLogEntry): TActivityLog => {
+	const row: TActivityLog = {
+		create_date: entry.create_date,
+		user_ext_id: entry.user_ext_id,
+		crm_brand_id: entry.crm_brand_id,
+		type: resolveWalletDisplayType(entry),
+		amount: entry.amount,
+		balance: entry.balance,
+		source_type_id: entry.source_type_id,
+	};
+	if (entry.total_ever !== undefined) {
+		row.total_ever = entry.total_ever;
+	}
+	return row;
+};
+
+/** Maps wire rows to wallet-only {@link TActivityLog} — legacy consumer contract. */
+export const ActivityLogTransform = (items: ActivityLogEntry[] | unknown[]): TActivityLog[] => {
 	if (!items) {
 		return [];
 	}
-
-	return items.map((item: any): TActivityLog => {
-		const itemTransformed: Partial<TActivityLog> = {
-			create_date: 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;
-
-		if (item.type === UserBalanceType.Diamonds || item.type === UserBalanceType.Gems) {
-			itemTransformed.type = item.type;
-			itemTransformed.amount = item.amount;
-			itemTransformed.balance = item.balance;
-		}
-
-		if (item.type === UserBalanceType.Points) {
-			itemTransformed.type = UserBalanceType.Points;
-			itemTransformed.amount = item.points_collected;
-			itemTransformed.balance = item.user_points_balance;
-			itemTransformed.total_ever = item.user_points_ever;
-		}
-
-		return itemTransformed as TActivityLog;
-	});
+	return mapActivityLogHistory(items)
+		.filter((entry) => entry.is_wallet_entry)
+		.map(toTActivityLog);
 };
 
-
+/** Maps wire rows to the full v2 {@link TActivityLogEntry} shape. */
+export const ActivityLogV2Transform = (items: ActivityLogEntry[] | unknown[]): TActivityLogEntry[] => {
+	if (!items) {
+		return [];
+	}
+	return mapActivityLogHistory(items);
+};

package/src/ActivityLog/index.ts

@@ -1,7 +1,8 @@
 export * from './GetActivityLogRequest';
 export * from './GetActivityLogResponse';
 export * from './ActivityLogEntry';
+export * from './ActivityLogActivities';
+export * from './ActivityLogMeta';
+export * from './ActivityLogMapper';
 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,31 @@ 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 {
+	entry_key: string;
+	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;
+	is_level_entry?: boolean;
+}
+
 
 /**
  * Result of `_smartico.api.requestRaffleOptin({raffle_id, draw_id, raffle_run_id})`.