@smartico/public-api 0.0.386 → 0.0.387

package/docs/SmarticoObject.md

@@ -108,6 +108,14 @@ login payload and (optionally) the language. Both are being consolidated into
 Logs the current user out, forgets the session, and reconnects as anonymous.
 Fires the `logout` callback on success.
 
+### `checkSuccessfullyIdentify()`
+
+Returns `true` once the SDK is initialized **and** a user has been
+successfully identified, `false` otherwise. Use it as a synchronous gate
+before calling user-scoped `_smartico.api.*` methods (e.g. `getUserProfile()`),
+as an alternative to waiting on the `identify` callback. Returns `false` in
+visitor mode.
+
 ### `changeLanguage(language)`
 
 Switches the active language. The code is normalized to a 2-letter form
@@ -396,6 +404,13 @@ Returns `true` on mobile user agents.
 Parse the current page URL / URL hash into an object (helpers for reading
 query / hash parameters).
 
+### `sendServerError(message)` · `sendServerDebug(message)`
+
+Forward a client-side message to Smartico's servers for support correlation —
+`sendServerError` for error conditions, `sendServerDebug` for diagnostic
+detail. Useful when reporting an integration issue so the message lands
+alongside your session server-side. No-ops if the SDK isn't initialized.
+
 ---
 
 ## Setup notes

package/docs/api/README.md

@@ -10,6 +10,7 @@
 
 - [PointChangeSourceType](enumerations/PointChangeSourceType.md)
 - [UserBalanceType](enumerations/UserBalanceType.md)
+- [AvatarCustomizeErrorCode](enumerations/AvatarCustomizeErrorCode.md)
 - [BonusStatus](enumerations/BonusStatus.md)
 - [JoinClanErrorCode](enumerations/JoinClanErrorCode.md)
 - [ActivityTypeLimited](enumerations/ActivityTypeLimited.md)
@@ -78,6 +79,7 @@
 
 - [PointsLog](interfaces/PointsLog.md)
 - [GemsDiamondsLog](interfaces/GemsDiamondsLog.md)
+- [AvatarCustomizeResponse](interfaces/AvatarCustomizeResponse.md)
 - [AvatarCustomized](interfaces/AvatarCustomized.md)
 - [AvatarDefinition](interfaces/AvatarDefinition.md)
 - [AvatarPrompt](interfaces/AvatarPrompt.md)

package/docs/api/classes/WSAPIAvatars.md

@@ -342,3 +342,138 @@ switch (r.err_code) {
 ```
 
 ***
+
+### avatarsCustomize()
+
+> **avatarsCustomize**(`props`): `Promise`\<[`AvatarCustomizeResponse`](../interfaces/AvatarCustomizeResponse.md)\>
+
+Generates an AI-customized variant of a base avatar by applying an
+operator-defined style prompt, returning the CDN URL of the result.
+This is a paid, generate-only step: it does NOT change the user's
+active avatar — pass the returned `cdn_url` to [setAvatar](#setavatar) to
+activate it.
+
+#### Parameters
+
+##### props
+
+###### label_id
+
+`number`
+
+Numeric Smartico label (brand) ID the user belongs to.
+
+###### user_id
+
+`number`
+
+Numeric Smartico user ID.
+
+###### prompt_id
+
+`number`
+
+Style-prompt ID (`prompt_id`) from [getAvatarPrompts](#getavatarprompts).
+
+###### avatar_url
+
+`string`
+
+CDN URL of the base avatar to customize.
+
+###### avatar_real_id
+
+`number`
+
+`avatar_real_id` of the base avatar.
+
+#### Returns
+
+`Promise`\<[`AvatarCustomizeResponse`](../interfaces/AvatarCustomizeResponse.md)\>
+
+[AvatarCustomizeResponse](../interfaces/AvatarCustomizeResponse.md) — `cdn_url` set on success;
+         `errCode` / `errMessage` set on failure.
+
+#### Remarks
+
+**Preconditions**
+- Authenticated session required; not available in visitor mode (throws).
+- All five fields are mandatory — the SDK throws synchronously
+  (`Error("<field> is required")`) if any is missing or zero.
+- `prompt_id` must be one of the prompts from [getAvatarPrompts](#getavatarprompts);
+  `avatar_url` / `avatar_real_id` identify the base avatar to style.
+
+**Cost**
+Each generation costs the currency the operator configured on the
+chosen prompt (points, gems, or diamonds — some prompts are free; read
+`cost_currency_type_id` / `cost_value` from the [getAvatarPrompts](#getavatarprompts)
+entry to gate the UI before calling). The cost is charged only on
+success; if the user can't afford it the call fails with `errCode -1`
+and nothing is generated or charged.
+
+**Latency**
+Generation runs server-side AI image synthesis and is synchronous from
+the caller's side — expect several seconds (roughly 5–20 s) before the
+promise resolves. There is no SDK cache and no push/subscription; show
+a loading state for the full duration and disable the trigger to
+prevent duplicate submissions.
+
+**Result & error codes**
+On success the result has `cdn_url` set; on failure it has `errCode` /
+`errMessage` set and no `cdn_url`. Branch on `errCode` — the generic
+message is fixed text, not cause-specific:
+- `12001` (`AvatarCustomizeErrorCode.AVATAR_USER_LIMIT`) — the user hit
+  their monthly per-user generation cap. Nothing is generated or charged.
+- `12002` (`AvatarCustomizeErrorCode.AVATAR_LABEL_LIMIT`) — the brand's
+  shared monthly pool is exhausted. Nothing is generated or charged;
+  surface a "try again later" message.
+- `-1` — generic failure: insufficient balance, an unavailable prompt,
+  or a generation error. Nothing is charged. Allow the user to retry.
+
+Both monthly caps are operator-configured and reset at the start of
+each calendar month.
+
+**Side effects (on success)**
+The generated variant is persisted to the user's customization history
+and counts toward the monthly caps **whether or not** it is later
+activated — generation is not reversible. The SDK clears the
+[getAvatarsCustomized](#getavatarscustomized) cache so the next call surfaces the new
+variant. The user's active avatar is unchanged until you call
+[setAvatar](#setavatar) with the returned `cdn_url`.
+
+**Idempotency**: not idempotent — each successful call generates (and
+charges for) a new variant. Guard the call site against double-clicks.
+
+**UI guidance**: see [UI Guide — `avatarsCustomize`](../_media/UIGuide_avatarsCustomize.md).
+
+**Visitor mode**: not supported (throws).
+
+#### Example
+
+```ts
+// label_id / user_id identify the Smartico user being customized.
+const prompts = await window._smartico.api.getAvatarPrompts();
+const prompt = prompts[0];
+
+console.log('[smartico] generating avatar — show a spinner for ~5-20s and disable the Generate button');
+const result = await window._smartico.api.avatarsCustomize({
+  label_id,
+  user_id,
+  prompt_id: prompt.prompt_id,
+  avatar_url: baseAvatar.avatar_url,
+  avatar_real_id: baseAvatar.avatar_real_id,
+});
+
+if (result.cdn_url) {
+  console.log('[smartico] generation succeeded — preview this URL, then call setAvatar to apply it:', result.cdn_url);
+  // await window._smartico.api.setAvatar({ avatar_url: result.cdn_url, avatar_real_id: baseAvatar.avatar_real_id });
+} else if (result.errCode === 12001) {
+  console.error('[smartico] user monthly limit reached — show "you have used all your custom avatars this month"');
+} else if (result.errCode === 12002) {
+  console.error('[smartico] brand monthly pool exhausted — show "custom avatars are unavailable right now, try later"');
+} else {
+  console.error('[smartico] generation failed (e.g. not enough balance) — let the user retry:', result.errMessage);
+}
+```
+
+***

package/docs/api/classes/WSAPIClans.md

@@ -334,12 +334,10 @@ below.
   tournament requires the user to be in a clan first.
 - `1006` (`JOIN_CLAN_COOLDOWN_ACTIVE`) — user is inside the
   switch-cooldown window from a previous clan join (default
-  7 days, configurable per label). Surface the
+  7 days, configurable per label). Only reachable when the user is
+  already in a *different* clan (this call is then a clan switch);
+  a first-time join never returns `1006`. Surface the
   `TClans.cooldown_until` expiry in the disabled CTA.
-- `1007` (`JOIN_CLAN_ARCHIVED`) — defined on the public enum but
-  the server does NOT emit this code in practice (archived clans
-  are reported as `1001`). Handle it as a synonym for `1001`
-  defensively, but do not rely on it.
 - `1011` (`JOIN_CLAN_JOINED_AFTER_TOURNAMENT_START`) — this
   method does NOT return `1011` directly. The code fires on
   [registerInTournament](WSAPITournaments.md#registerintournament) responses when the user joined

package/docs/api/documents/SmarticoObject.md

@@ -108,6 +108,14 @@ login payload and (optionally) the language. Both are being consolidated into
 Logs the current user out, forgets the session, and reconnects as anonymous.
 Fires the `logout` callback on success.
 
+### `checkSuccessfullyIdentify()`
+
+Returns `true` once the SDK is initialized **and** a user has been
+successfully identified, `false` otherwise. Use it as a synchronous gate
+before calling user-scoped `_smartico.api.*` methods (e.g. `getUserProfile()`),
+as an alternative to waiting on the `identify` callback. Returns `false` in
+visitor mode.
+
 ### `changeLanguage(language)`
 
 Switches the active language. The code is normalized to a 2-letter form
@@ -396,6 +404,13 @@ Returns `true` on mobile user agents.
 Parse the current page URL / URL hash into an object (helpers for reading
 query / hash parameters).
 
+### `sendServerError(message)` · `sendServerDebug(message)`
+
+Forward a client-side message to Smartico's servers for support correlation —
+`sendServerError` for error conditions, `sendServerDebug` for diagnostic
+detail. Useful when reporting an integration issue so the message lands
+alongside your session server-side. No-ops if the SDK isn't initialized.
+
 ---
 
 ## Setup notes

package/docs/api/enumerations/AvatarCustomizeErrorCode.md

@@ -0,0 +1,21 @@
+# Enumeration: AvatarCustomizeErrorCode
+
+Limit error codes returned in `errCode` by the `avatarsCustomize` method.
+See the `avatarsCustomize` TSDoc for the full table (including the generic
+`-1` failure, which has no named member here).
+
+## Enumeration Members
+
+### AVATAR\_USER\_LIMIT
+
+> **AVATAR\_USER\_LIMIT**: `12001`
+
+The user has reached the operator-configured per-user monthly cap on custom-avatar generations.
+
+***
+
+### AVATAR\_LABEL\_LIMIT
+
+> **AVATAR\_LABEL\_LIMIT**: `12002`
+
+The brand's operator-configured shared monthly pool of custom-avatar generations is exhausted.

package/docs/api/enumerations/JoinClanErrorCode.md

@@ -1,12 +1,17 @@
 # Enumeration: JoinClanErrorCode
 
+Error codes returned in `errCode` by the `joinClan` method (also carried
+on `TClanJoinResult`). These are terse value definitions for lookup; the
+full per-code narrative and UI handling lives in the `joinClan` method
+TSDoc, which owns the error table.
+
 ## Enumeration Members
 
 ### JOIN\_CLAN\_OK
 
 > **JOIN\_CLAN\_OK**: `0`
 
-No error, join completed
+Success — join completed; entry fee (if any) deducted.
 
 ***
 
@@ -14,7 +19,7 @@ No error, join completed
 
 > **JOIN\_CLAN\_INVALID\_PARAMETERS**: `1000`
 
-Invalid parameters
+Request was malformed (missing or invalid parameters).
 
 ***
 
@@ -22,7 +27,7 @@ Invalid parameters
 
 > **JOIN\_CLAN\_NOT\_FOUND**: `1001`
 
-clan_id doesn't exist for this label
+Clan doesn't exist for this label. Archived clans are also reported as `1001`.
 
 ***
 
@@ -30,7 +35,7 @@ clan_id doesn't exist for this label
 
 > **JOIN\_CLAN\_FULL**: `1002`
 
-members_count >= capacity_limit
+Clan is full — member capacity reached.
 
 ***
 
@@ -38,7 +43,7 @@ members_count >= capacity_limit
 
 > **JOIN\_CLAN\_INSUFFICIENT\_FUNDS**: `1003`
 
-Not enough Points / Gems / Diamonds for entry fee
+Insufficient balance for the entry fee (points / gems / diamonds).
 
 ***
 
@@ -46,7 +51,7 @@ Not enough Points / Gems / Diamonds for entry fee
 
 > **JOIN\_CLAN\_SEGMENT\_MISMATCH**: `1004`
 
-User doesn't satisfy entry_conditions / entry_segment_id
+User doesn't meet the clan's entry segment or conditions.
 
 ***
 
@@ -54,7 +59,8 @@ User doesn't satisfy entry_conditions / entry_segment_id
 
 > **JOIN\_CLAN\_USER\_IS\_NOT\_IN\_CLAN**: `1005`
 
-User is not in a clan
+User is not in a clan. Note: a `registerInTournament` response code
+that shares this enum — never returned by `joinClan`.
 
 ***
 
@@ -62,15 +68,7 @@ User is not in a clan
 
 > **JOIN\_CLAN\_COOLDOWN\_ACTIVE**: `1006`
 
-User is within the CLAN_COOLDOWN_DAYS window
-
-***
-
-### JOIN\_CLAN\_ARCHIVED
-
-> **JOIN\_CLAN\_ARCHIVED**: `1007`
-
-clan_status_id != 1 (clan is archived)
+User is within the clan-switch cooldown window (switch only).
 
 ***
 
@@ -78,4 +76,5 @@ clan_status_id != 1 (clan is archived)
 
 > **JOIN\_CLAN\_JOINED\_AFTER\_TOURNAMENT\_START**: `1011`
 
-Clan joined after tournament start
+Clan joined after tournament start. Note: a `registerInTournament`
+response code that shares this enum — never returned by `joinClan`.

package/docs/api/interfaces/AvatarCustomizeResponse.md

@@ -0,0 +1,31 @@
+# Interface: AvatarCustomizeResponse
+
+Result of `_smartico.api.avatarsCustomize()`. On success only `cdn_url` is
+set; on failure only `errCode` / `errMessage`.
+
+## Properties
+
+### cdn\_url?
+
+> `optional` **cdn\_url?**: `string`
+
+CDN URL of the generated avatar variant. Present on success.
+
+***
+
+### errCode?
+
+> `optional` **errCode?**: `number`
+
+Error code. Present on failure. Typed values are members of
+[AvatarCustomizeErrorCode](../enumerations/AvatarCustomizeErrorCode.md); `-1` is a generic failure. See the
+`avatarsCustomize` TSDoc for the full table.
+
+***
+
+### errMessage?
+
+> `optional` **errMessage?**: `string`
+
+Optional error message. Present on failure; the generic (`-1`) message
+is fixed text, so branch on `errCode`, not this string.

package/docs/api/interfaces/TAvatarPrompt.md

@@ -33,7 +33,7 @@ Absolute CDN URL of the prompt's preview icon.
 
 > **cost\_currency\_type\_id**: `number`
 
-Currency used to pay for the customization. `0` = points, `1` = gems, `2` = diamonds.
+Currency used to pay for the customization. `0` = points, `1` = gems, `2` = diamonds, `3` = free. A `cost_value` of `0` is also free.
 
 ***
 
@@ -41,4 +41,4 @@ Currency used to pay for the customization. `0` = points, `1` = gems, `2` = diam
 
 > **cost\_value**: `number`
 
-Cost amount in the currency named by `cost_currency_type_id`.
+Cost amount in the currency named by `cost_currency_type_id`. `0` = free.

package/docs/api/interfaces/TMissionOrBadgeTask.md

@@ -44,6 +44,22 @@ Reward for completing the task in points
 
 ***
 
+### gems\_reward?
+
+> `optional` **gems\_reward?**: `number`
+
+Reward for completing the task in gems
+
+***
+
+### diamonds\_reward?
+
+> `optional` **diamonds\_reward?**: `number`
+
+Reward for completing the task in diamonds
+
+***
+
 ### execution\_count\_expected?
 
 > `optional` **execution\_count\_expected?**: `number`

package/docs/api/interfaces/UserAchievementTask.md

@@ -20,6 +20,22 @@
 
 ***
 
+### gems\_reward?
+
+> `optional` **gems\_reward?**: `number`
+
+Gems awarded when this task is completed.
+
+***
+
+### diamonds\_reward?
+
+> `optional` **diamonds\_reward?**: `number`
+
+Diamonds awarded when this task is completed.
+
+***
+
 ### task\_type\_id
 
 > **task\_type\_id**: [`AchievementTaskType`](../enumerations/AchievementTaskType.md)

package/docs/native/PROTOCOL.md

@@ -1802,6 +1802,8 @@ Join (or switch to) a clan. On labels with no cooldown, switching clans re-charg
 
 Avatar selection (`setAvatar`) is documented under [User](#setavatar). The methods below read the avatar catalog and the user's AI-customized avatars.
 
+> **Note:** Generating a new AI-customized variant (`avatarsCustomize` in the JS SDK) is a separate **HTTP POST** to the avatar server, not part of this WebSocket protocol. It returns a CDN URL that you then activate via `setAvatar`. Native clients must call that HTTP endpoint directly; it is out of scope for this spec.
+
 ### getAvatarsList
 
 Get the avatar catalog available to the current user.
@@ -1862,7 +1864,7 @@ No method-specific fields. Send only the common fields (see [Common Message Fiel
 |-------|------|-------------|
 | `prompts` | [`AvatarPrompt[]`](../api/interfaces/AvatarPrompt.md) | Available AI style prompts |
 
-> **Note:** Prompt name/icon are nested at `public_meta.name` / `public_meta.icon_url`. `cost_currency_type_id`: `0` = points, `1` = gems, `2` = diamonds; `cost_value` is the amount.
+> **Note:** Prompt name/icon are nested at `public_meta.name` / `public_meta.icon_url`. `cost_currency_type_id`: `0` = points, `1` = gems, `2` = diamonds, `3` = free; `cost_value` is the amount (a `cost_value` of `0` is also free).
 
 ---
 

package/docs/ui/avatars/UIGuide_avatarsCustomize.md

@@ -0,0 +1,69 @@
+# UI Guide — `avatarsCustomize`
+
+## Overview
+- A **paid, generate-only** AI step: it applies an operator-defined style
+  prompt to a base avatar and returns a `cdn_url` for the generated image.
+- It does **not** change the user's active avatar. Activation is a second,
+  explicit step — call `setAvatar({ avatar_url: cdn_url, avatar_real_id })`.
+- Synchronous and slow (~5–20 s). No SDK cache, no push.
+
+## Flow (the default Smartico UI)
+1. **Pick a base avatar** from the avatar catalogue (`getAvatarsList()` /
+   `getAvatarsCustomized()`), then open the "Customize" panel.
+2. **Pick a style prompt** from `getAvatarPrompts()`. Each prompt carries its
+   cost (`cost_currency_type_id` + `cost_value`); render the price on the
+   prompt tile and pre-disable prompts the user can't afford (compare against
+   the balances on `getUserProfile()`).
+3. **Generate.** On tap, call `avatarsCustomize(...)`. Immediately enter a
+   loading state (see below) and lock the prompt list + Generate button.
+4. **Preview.** On success, render `cdn_url` as a preview. The user can keep
+   browsing previously generated variants (they live in the customization
+   history surfaced by `getAvatarsCustomized()`).
+5. **Apply (explicit).** Only when the user taps "Apply" do you call
+   `setAvatar(...)` with the currently-selected URL (which may be the new
+   `cdn_url`, a history item, or the untouched base avatar).
+
+## Loading state
+- The generation blocks for several seconds. Show a spinner/skeleton in the
+  preview slot for the full duration; keep the modal open.
+- Disable the Generate trigger and the prompt list while in flight — there is
+  no SDK-side debounce, so a second tap fires a second (charged) generation.
+
+## Cost gating
+- Read `cost_currency_type_id` (`0` points · `1` gems · `2` diamonds · `3`
+  free) and `cost_value` from the chosen `getAvatarPrompts()` entry.
+- `cost_value === 0` (or type `3`) is free.
+- Gate before calling: if the user can't afford the prompt, disable the tile
+  and show the price; don't rely on the server to be the only guard
+  (insufficient balance comes back as the generic `-1`).
+
+## Error / limit handling
+| Result | UI |
+|---|---|
+| `cdn_url` set | Success. Render the preview; enable "Apply". |
+| `errCode === 12001` | User hit their **monthly per-user cap**. Show e.g. "You've used all your custom avatars this month." Nothing was charged. |
+| `errCode === 12002` | The **brand's monthly pool** is exhausted. Show "Custom avatars are unavailable right now — try again later." Nothing was charged. |
+| `errCode === -1` | Generic failure (insufficient balance, unavailable prompt, generation error). Show a retryable error; nothing was charged. `errMessage` is fixed text — don't surface it as the reason. |
+
+Both monthly caps are operator-configured and reset at the start of each
+calendar month.
+
+## Important behavioral caveats
+- **Generation is irreversible and counts toward the monthly caps on success
+  — even if the user never applies it.** Don't auto-generate on hover/scroll;
+  require an explicit tap.
+- **Apply uses the currently-selected image**, which may be the new variant, a
+  history item, or the base avatar. Track selection explicitly so "Apply"
+  sends the right URL.
+- After a successful generation the SDK refreshes the
+  `getAvatarsCustomized()` cache, so the new variant appears in the history
+  list on the next call.
+
+## Empty / unavailable states
+- No prompts returned by `getAvatarPrompts()` → hide the Customize entry point.
+- `12002` for the whole brand → consider hiding/greying the Customize entry
+  point until next month rather than letting every tap fail.
+
+## Visitor mode
+- Not supported — `avatarsCustomize` throws in visitor mode. Hide the
+  customization surface for unauthenticated sessions.

package/package.json

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

package/src/Avatars/AvatarCustomizeErrorCode.ts

@@ -1,9 +1,11 @@
+/**
+ * Limit error codes returned in `errCode` by the `avatarsCustomize` method.
+ * See the `avatarsCustomize` TSDoc for the full table (including the generic
+ * `-1` failure, which has no named member here).
+ */
 export enum AvatarCustomizeErrorCode {
+	/** The user has reached the operator-configured per-user monthly cap on custom-avatar generations. */
 	AVATAR_USER_LIMIT = 12001,
+	/** The brand's operator-configured shared monthly pool of custom-avatar generations is exhausted. */
 	AVATAR_LABEL_LIMIT = 12002,
 }
-
-export const AvatarCustomizeErrorMessage: Record<AvatarCustomizeErrorCode, string> = {
-	[AvatarCustomizeErrorCode.AVATAR_USER_LIMIT]: 'You have exceeded number of custom avatars creation, please try later',
-	[AvatarCustomizeErrorCode.AVATAR_LABEL_LIMIT]: 'The custom avatars are not available, please try again later',
-};

package/src/Avatars/AvatarCustomizeResponse.ts

@@ -0,0 +1,17 @@
+import { AvatarCustomizeErrorCode } from './AvatarCustomizeErrorCode';
+
+/**
+ * Result of `_smartico.api.avatarsCustomize()`. On success only `cdn_url` is
+ * set; on failure only `errCode` / `errMessage`.
+ */
+export interface AvatarCustomizeResponse {
+	/** CDN URL of the generated avatar variant. Present on success. */
+	cdn_url?: string;
+	/** Error code. Present on failure. Typed values are members of
+	 * {@link AvatarCustomizeErrorCode}; `-1` is a generic failure. See the
+	 * `avatarsCustomize` TSDoc for the full table. */
+	errCode?: AvatarCustomizeErrorCode | number;
+	/** Optional error message. Present on failure; the generic (`-1`) message
+	 * is fixed text, so branch on `errCode`, not this string. */
+	errMessage?: string;
+}

package/src/Avatars/index.ts

@@ -1,4 +1,5 @@
 export * from './AvatarCustomizeErrorCode';
+export * from './AvatarCustomizeResponse';
 export * from './AvatarDefinition';
 export * from './AvatarCustomized';
 export * from './AvatarPrompt';

package/src/Missions/UserAchievement.ts

@@ -123,6 +123,8 @@ export const UserAchievementTransform = (items: UserAchievement[]): TMissionOrBa
 							id: t.task_id,
 							name: t.task_public_meta?.name,
 							points_reward: t.points_reward,
+							gems_reward: t.gems_reward,
+							diamonds_reward: t.diamonds_reward,
 							is_completed: t.isCompleted,
 							progress: t.userProgress,
 							execution_count_expected: t.executionCount,

package/src/Missions/UserAchievementTask.ts

@@ -6,6 +6,10 @@ export interface UserAchievementTask {
 	task_id?: number;
 	task_public_meta?: AchievementTaskPublicMeta;
 	points_reward?: number;
+	/** Gems awarded when this task is completed. */
+	gems_reward?: number;
+	/** Diamonds awarded when this task is completed. */
+	diamonds_reward?: number;
 	task_type_id: AchievementTaskType;
 	isCompleted?: boolean;
 	userExecutedCount?: number; // This is the number of times the user has executed 'activity' of the task. e.g. he bet 5 times out of 100. here will be 5