@smartico/public-api 0.0.417 → 0.0.418

package/package.json

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

package/src/ActivityLog/ActivityLogActivities.ts

@@ -1,5 +1,3 @@
-import { UserBalanceType } from './UserBalanceType';
-
 /** Activity-log entry type as returned on the v2 wire (`type_id`). */
 export enum ActivityLogActivities {
 	Gems = 1,
@@ -22,45 +20,3 @@ export enum ActivityLogActivities {
 	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/ActivityLogMeta.ts

@@ -1,27 +1,8 @@
-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;
+	image_url?: 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/GetActivityLogResponse.ts

@@ -1,42 +1,76 @@
 import { ProtocolResponse } from '../Base/ProtocolResponse';
 import { ActivityLogEntry } from './ActivityLogEntry';
-import { mapActivityLogHistory, resolveWalletDisplayType } from './ActivityLogMapper';
+import { ActivityLogActivities } from './ActivityLogActivities';
 import { TActivityLog, TActivityLogEntry } from '../WSAPI/WSAPITypes';
+import { UserBalanceType } from './UserBalanceType';
 
 export interface GetActivityLogResponse extends ProtocolResponse {
 	logHistory: ActivityLogEntry[];
 }
 
-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[] => {
+export const ActivityLogTransform = (items: ActivityLogEntry[]): TActivityLog[] => {
 	if (!items) {
 		return [];
 	}
-	return mapActivityLogHistory(items)
-		.filter((entry) => entry.is_wallet_entry)
-		.map(toTActivityLog);
+
+	return items.map((item: any): TActivityLog => {
+		const itemTransformed: Partial<TActivityLog> = {
+			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;
+
+		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;
+	});
 };
 
-/** Maps wire rows to the full v2 {@link TActivityLogEntry} shape. */
-export const ActivityLogV2Transform = (items: ActivityLogEntry[] | unknown[]): TActivityLogEntry[] => {
+export const ActivityLogV2Transform = (items: any[]): TActivityLogEntry[] => {
 	if (!items) {
 		return [];
 	}
-	return mapActivityLogHistory(items);
+
+	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

@@ -3,6 +3,5 @@ export * from './GetActivityLogResponse';
 export * from './ActivityLogEntry';
 export * from './ActivityLogActivities';
 export * from './ActivityLogMeta';
-export * from './ActivityLogMapper';
 export * from './PointChangeSourceType';
 export * from './UserBalanceType';

package/src/WSAPI/WSAPITypes.ts

@@ -1811,7 +1811,6 @@ export interface TActivityLog {
  * 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;
@@ -1828,7 +1827,6 @@ export interface TActivityLogEntry {
 	source_reference_id?: number;
 	source_root_id?: number;
 	is_wallet_entry: boolean;
-	is_level_entry?: boolean;
 }
 
 

package/src/ActivityLog/ActivityLogMapper.ts

@@ -1,358 +0,0 @@
-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;
-	}
-};