@smartico/public-api 0.0.362 → 0.0.363

package/package.json

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

package/src/Avatars/GetAvatarPromptsResponse.ts

@@ -1,6 +1,17 @@
+import { TAvatarPrompt } from '../WSAPI/WSAPITypes';
 import { ProtocolResponse } from '../Base/ProtocolResponse';
 import { AvatarPrompt } from './AvatarPrompt';
 
 export interface GetAvatarPromptsResponse extends ProtocolResponse {
 	prompts: AvatarPrompt[];
 }
+
+export const avatarPromptTransform = (items: AvatarPrompt[], avatarDomain: string): TAvatarPrompt[] => {
+	return items.map((item) => ({
+		prompt_id: item.prompt_id,
+		name: item.public_meta.name,
+		icon_url: item.public_meta.icon_url && !item.public_meta.icon_url.startsWith('http') ? `${avatarDomain}${item.public_meta.icon_url}` : item.public_meta.icon_url,
+		cost_currency_type_id: item.cost_currency_type_id,
+		cost_value: item.cost_value,
+	}));
+};

package/src/Avatars/GetAvatarsCustomizedResponse.ts

@@ -1,6 +1,15 @@
+import { TAvatarCustomized } from '../WSAPI/WSAPITypes';
 import { ProtocolResponse } from '../Base/ProtocolResponse';
 import { AvatarCustomized } from './AvatarCustomized';
 
 export interface GetAvatarsCustomizedResponse extends ProtocolResponse {
 	avatars: AvatarCustomized[];
 }
+
+export const avatarCustomizedTransform = (items: AvatarCustomized[], avatarDomain: string): TAvatarCustomized[] => {
+	return items.map((item) => ({
+		avatar_real_id: item.avatar_real_id,
+		url: item.url && !item.url.startsWith('http') ? `${avatarDomain}${item.url}` : item.url,
+		dt_created: item.dt_created,
+	}));
+};

package/src/Avatars/GetAvatarsListResponse.ts

@@ -1,6 +1,24 @@
+import { TAvatarDefinition } from '../WSAPI/WSAPITypes';
 import { ProtocolResponse } from '../Base/ProtocolResponse';
 import { AvatarDefinition } from './AvatarDefinition';
 
 export interface GetAvatarsListResponse extends ProtocolResponse {
 	avatars: AvatarDefinition[];
 }
+
+export const avatarDefinitionTransform = (items: AvatarDefinition[], avatarDomain: string): TAvatarDefinition[] => {
+	return items.map((item) => ({
+		avatar_real_id: item.avatar_real_id,
+		is_default: item.is_default,
+		hide_until_achieved: item.hide_until_achieved,
+		priority: item.priority,
+		description: item.public_meta.description,
+		url: item.public_meta.url,
+		avatar_url: item.public_meta.url && !item.public_meta.url.startsWith('http') ? `${avatarDomain}${item.public_meta.url}` : item.public_meta.url,
+		avatar_source_type_id: item.avatar_source_type_id,
+		active_from_date: item.active_from_date,
+		active_till_date: item.active_till_date,
+		is_given: item.is_given,
+		is_in_use: item.is_in_use,
+	}));
+};

package/src/SmarticoAPI.ts

@@ -100,6 +100,9 @@ import {
 	TLevelCurrent,
 	TActivityLog,
 	TRaffleDraw,
+	TAvatarDefinition,
+	TAvatarCustomized,
+	TAvatarPrompt,
 } from './WSAPI/WSAPITypes';
 import { getLeaderBoardTransform } from './Leaderboard/LeaderBoards';
 import { GetAchievementsUserInfoResponse } from './Core/GetAchievementsUserInfoResponse';
@@ -129,7 +132,10 @@ import { GetRafflesRequest } from './Raffle/GetRafflesRequest';
 import { GetActivityLogRequest, GetActivityLogResponse, ActivityLogTransform } from './ActivityLog';
 import { InboxCategories } from './Inbox/InboxCategories';
 import { GetDrawRunRequest, GetDrawRunResponse, GetRaffleDrawRunsHistoryRequest, GetRaffleDrawRunsHistoryResponse, RaffleClaimPrizeRequest, RaffleClaimPrizeResponse, RaffleOptinRequest, RaffleOptinResponse, drawRunTransform } from './Raffle';
-import { GetAvatarsListResponse, GetAvatarsCustomizedResponse, GetAvatarPromptsResponse, SetAvatarRequest, SetAvatarResponse } from './Avatars';
+import { GetAvatarsListResponse, avatarDefinitionTransform } from './Avatars/GetAvatarsListResponse';
+import { GetAvatarsCustomizedResponse, avatarCustomizedTransform } from './Avatars/GetAvatarsCustomizedResponse';
+import { GetAvatarPromptsResponse, avatarPromptTransform } from './Avatars/GetAvatarPromptsResponse';
+import { SetAvatarRequest, SetAvatarResponse } from './Avatars';
 import { GetJackpotWinnersResponse, GetJackpotWinnersResponseTransform, JackpotWinnerHistory } from './Jackpots/GetJackpotWinnersResponse';
 import { GetJackpotWinnersRequest } from './Jackpots/GetJackpotWinnersRequest';
 import { GetJackpotEligibleGamesRequest } from './Jackpots/GetJackpotEligibleGamesRequest';
@@ -1443,6 +1449,18 @@ class SmarticoAPI {
 		return await this.send<SetAvatarResponse>(message, ClassId.CLIENT_SET_AVATAR_RESPONSE);
 	}
 
+	public async avatarsGetListT(user_ext_id: string): Promise<TAvatarDefinition[]> {
+		return avatarDefinitionTransform((await this.avatarsGetList(user_ext_id)).avatars ?? [], this.avatarDomain);
+	}
+
+	public async avatarsGetCustomizedT(user_ext_id: string): Promise<TAvatarCustomized[]> {
+		return avatarCustomizedTransform((await this.avatarsGetCustomized(user_ext_id)).avatars ?? [], this.avatarDomain);
+	}
+
+	public async avatarsGetPromptsT(user_ext_id: string): Promise<TAvatarPrompt[]> {
+		return avatarPromptTransform((await this.avatarsGetPrompts(user_ext_id)).prompts ?? [], this.avatarDomain);
+	}
+
 	public getWSCalls(): WSAPI {
 		return new WSAPI(this);
 	}

package/src/WSAPI/WSAPI.ts

@@ -1471,15 +1471,7 @@ export class WSAPI {
 		return OCache.use(
 			onUpdateContextKey.AvatarsList,
 			ECacheContext.WSAPI,
-			async () => {
-				const response = await this.api.avatarsGetList(this.userExtId);
-				return (response.avatars || []).map((a) => ({
-					...a,
-					avatar_url: this.api.avatarDomain && a.public_meta?.url
-						? (a.public_meta.url.startsWith('http') ? a.public_meta.url : `${this.api.avatarDomain}${a.public_meta.url}`)
-						: (a.public_meta?.url || ''),
-				}));
-			},
+			() => this.api.avatarsGetListT(this.userExtId),
 			CACHE_DATA_SEC,
 		);
 	}
@@ -1502,10 +1494,7 @@ export class WSAPI {
 		return OCache.use(
 			onUpdateContextKey.AvatarsCustomized,
 			ECacheContext.WSAPI,
-			async () => {
-				const response = await this.api.avatarsGetCustomized(this.userExtId);
-				return response.avatars || [];
-			},
+			() => this.api.avatarsGetCustomizedT(this.userExtId),
 			CACHE_DATA_SEC,
 		);
 	}
@@ -1528,17 +1517,14 @@ export class WSAPI {
 		return OCache.use(
 			onUpdateContextKey.AvatarPrompts,
 			ECacheContext.WSAPI,
-			async () => {
-				const response = await this.api.avatarsGetPrompts(this.userExtId);
-				return response.prompts || [];
-			},
+			() => this.api.avatarsGetPromptsT(this.userExtId),
 			CACHE_DATA_SEC,
 		);
 	}
 
 	/**
 	 * Sets the specified avatar as the active avatar for the current user.
-	 * Pass `avatar_url` (the image path from `TAvatarDefinition.public_meta.url` or a CDN URL for AI-customized avatars)
+	 * Pass `avatar_url` (the `TAvatarDefinition.url` path or a CDN URL for AI-customized avatars)
 	 * and `avatar_real_id` from the avatar catalog.
 	 * After a successful call, the avatar list cache is cleared so the next `getAvatarsList()` call reflects `is_in_use`.
 	 *
@@ -1548,7 +1534,7 @@ export class WSAPI {
 	 *      const avatar = avatars.find((a) => !a.hide_until_achieved || a.is_given);
 	 *      if (avatar) {
 	 *          _smartico.api.setAvatar({
-	 *              avatar_url: avatar.public_meta.url,
+	 *              avatar_url: avatar.url,
 	 *              avatar_real_id: avatar.avatar_real_id,
 	 *          }).then((result) => {
 	 *              console.log(result);

package/src/WSAPI/WSAPITypes.ts

@@ -1881,7 +1881,8 @@ export interface GamePickRoundRequestParams extends GamePickRequestParams {
 }
 
 /**
- * TAvatarDefinition describes a single avatar available in the avatar catalog
+ * TAvatarDefinition describes a single avatar available in the avatar catalog.
+ * Fields from the raw `public_meta` object are flattened to the top level.
  */
 export interface TAvatarDefinition {
 	/** Unique identifier of the avatar */
@@ -1892,13 +1893,12 @@ export interface TAvatarDefinition {
 	hide_until_achieved: boolean;
 	/** Display priority — lower value means higher position in the grid */
 	priority: number;
-	/** Public metadata containing the avatar image URL and optional description */
-	public_meta: {
-		/** Optional description of the avatar */
-		description?: string;
-		/** Image path/URL of the avatar */
-		url: string;
-	};
+	/** Optional description of the avatar (from public_meta) */
+	description?: string;
+	/** Raw image path/URL of the avatar as returned by the server (from public_meta) */
+	url: string;
+	/** Full CDN URL of the avatar image, built from avatar_domain + url */
+	avatar_url: string;
 	/**
 	 * Source type of the avatar.
 	 * 0 = free (always available to all users), other values = earned/purchased
@@ -1912,8 +1912,6 @@ export interface TAvatarDefinition {
 	is_given: boolean;
 	/** Whether this avatar is currently in use by the user */
 	is_in_use?: boolean;
-	/** Full CDN URL of the avatar image, built from avatar_domain + public_meta.url */
-	avatar_url: string;
 }
 
 /**
@@ -1929,18 +1927,16 @@ export interface TAvatarCustomized {
 }
 
 /**
- * TAvatarPrompt describes an AI style prompt available for avatar customization
+ * TAvatarPrompt describes an AI style prompt available for avatar customization.
+ * Fields from the raw `public_meta` object are flattened to the top level.
  */
 export interface TAvatarPrompt {
 	/** Unique identifier of the AI customization prompt */
 	prompt_id: number;
-	/** Public metadata for the prompt */
-	public_meta: {
-		/** Display name of the prompt style (e.g. "Cartoon", "Watercolor") */
-		name: string;
-		/** URL of the prompt style icon image */
-		icon_url: string;
-	};
+	/** Display name of the prompt style, e.g. "Cartoon", "Watercolor" (from public_meta) */
+	name: string;
+	/** Full CDN URL of the prompt style icon image (from public_meta) */
+	icon_url: string;
 	/** Currency type used to pay for this customization (0=points, 1=gems, 2=diamonds) */
 	cost_currency_type_id: number;
 	/** Cost amount in the given currency */