@smartico/public-api 0.0.378 → 0.0.380

package/docs/ui/user/UIGuide_getLevels.md

@@ -0,0 +1,162 @@
+# UI Guide — `getLevels`
+
+## Overview
+- Returns the full level ladder for the label — one `TLevel` per
+  active level, server-sorted by `required_points` ASC.
+- Use as a lookup table to resolve `ach_level_current_id` from
+  [`getUserProfile`](../../api/classes/WSAPIUser.md#getuserprofile)
+  into a richer level object, or as the source for a level map UI.
+- Loading indicator: skip on cache hit (30 s); show a brief shimmer
+  on cold fetch (typically 100–300 ms).
+
+## List view organization
+
+The default Smartico UI renders levels as a **vertical grid** —
+2-column on mobile (`grid-boxes-2 levels`), responsive on desktop
+(`grid-boxes-levels`). No horizontal-scroll layout, no tabs.
+
+Items are already sorted by `required_points` ASC; `ordinal_position`
+is a 1-based index matching that sort. Render in the returned array
+order — no client-side sort needed unless your label uses
+sliding-window leveling (then sort secondary on
+`required_level_counter_1`, then `required_level_counter_2`).
+
+## Client-side filtering by `visibility_points`
+
+The server returns ALL active levels; the default Smartico UI hides
+levels the user hasn't reached the visibility threshold for:
+
+```ts
+const visible = levels.filter(l =>
+  l.visibility_points == null || l.visibility_points <= profile.ach_points_ever
+);
+```
+
+Hidden levels are absent from the render entirely — no "?" tile, no
+silhouette. If your product surface wants a teaser for upcoming
+levels, render the hidden ones with a custom CSS treatment instead
+of filtering them out.
+
+## Level tile
+
+Fields rendered per tile:
+
+| Field | Use |
+|---|---|
+| `image` | Tile icon (square, 256×256 px source). |
+| `name` | Tile heading. |
+| `description` | Optional sub-text under the heading; the default UI shows this in the detail modal, not on the tile. |
+| `required_points` | Threshold display: `"{N} pts to reach"` or progress bar. |
+| `ordinal_position` | Tile order; matches array order. |
+
+**Locked vs unlocked treatment** — apply a `disabled` class to tiles
+where the user hasn't met the threshold:
+
+- Points-only leveling (most labels): `disabled = ach_points_ever < required_points`
+- Sliding-window leveling: also check
+  `level_counter_1 < required_level_counter_1` (and `_2`) from
+  [`getUserLevelExtraCounters`](../../api/classes/WSAPIUser.md#getuserlevelextracounters).
+- Manual-only leveling: `disabled` unless the level matches the
+  user's current `ach_level_current_id`.
+
+The default Smartico UI uses CSS-only treatment for locked tiles —
+no padlock icon, no greyscale by default. Brands can add those via
+custom CSS / Liquid skin overrides.
+
+## Detail view (per-level modal)
+
+When the user taps a tile, open a modal showing:
+
+- Hero image (`image`)
+- Title (`name`), description (`description`)
+- Progress block: for the user's current level, three stacked
+  progress bars (points / counter 1 / counter 2) — see "Sliding-window
+  leveling" below. For other levels, just the requirement display.
+- Custom fields rendered from `custom_data` (operator-defined).
+
+`custom_data` is typed as `string` but at runtime is `any` — the SDK
+auto-parses JSON-looking strings. Always guard with
+`typeof custom_data === 'object'` before property access; treat
+non-object values as raw strings.
+
+## Sliding-window leveling (advanced)
+
+If your label uses sliding-window leveling (the "Logic 2" model), the
+`required_level_counter_1` and `required_level_counter_2` fields are
+populated. Render alongside the points threshold:
+
+```
+Points:    {ach_points_ever} / {required_points}
+Counter 1: {level_counter_1} / {required_level_counter_1}   ← from getUserLevelExtraCounters
+Counter 2: {level_counter_2} / {required_level_counter_2}
+```
+
+The operator names the counters via translation keys
+(`levelsCounter1Name`, `levelsCounter2Name`) — typical values are
+"Total Deposits", "Total Wagering", etc. The SDK does not expose the
+operator's chosen labels; resolve them via
+[`getTranslations`](../../api/classes/WSAPIGeneral.md#gettranslations).
+
+On points-only labels, both `required_level_counter_*` fields are
+`null` — skip rendering the counter rows.
+
+## Progress to next level
+
+Two formulas are in use; pick whichever fits your design:
+
+- **From-zero (default Smartico UI uses this)**:
+  `ach_points_ever / next_level.required_points × 100`. Shows
+  "absolute" progress; never decreases as the user gains points.
+- **From-current-level-floor (SDK uses this in
+  [`getCurrentLevel`](../../api/classes/WSAPIUser.md#getcurrentlevel))**:
+  `(ach_points_ever − current.required_points) / (next.required_points
+  − current.required_points) × 100`. Resets to 0 when the user levels
+  up; better for "how far through this level" UX.
+
+Both bound at 100; at the max level the bar shows full.
+
+## Image / asset specs
+
+| Field | Aspect | Notes |
+|---|---|---|
+| `image` | 1:1 (square), 256×256 px documented source | Render in a square tile container; fallback: text-only tile with the level name if `image` is missing. |
+
+## Empty / loading / error states
+
+- **Loading (cold fetch)**: render a skeleton grid (3–6 placeholder
+  tiles) sized to the eventual layout.
+- **Loading (cache hit)**: do not render a loading state — the
+  promise resolves within a microtask.
+- **Empty result**: `[]` means no levels are configured for the
+  label. Hide the level UI entirely (or render a neutral
+  "no levels configured" placeholder).
+- **Error**: keep the prior list visible if any; show a small
+  non-blocking error banner; retry on next user-driven action.
+
+## Animations / transitions
+
+- **Tile entry**: stagger fade-in (~30 ms per tile) on first render.
+- **Level-up celebration**: when `ach_level_current_id` flips on a
+  push (detect via [`getUserProfile`](../../api/classes/WSAPIUser.md#getuserprofile)'s
+  `props_change`), animate the newly-reached tile (scale-up,
+  shine sweep). The default Smartico UI does this on the header
+  badge, not on the level-map tiles.
+
+## Mobile vs desktop
+
+- **Grid columns**: desktop responsive (3–5 columns depending on
+  viewport); mobile 2 columns.
+- **Detail view**: desktop opens as a centered modal with backdrop
+  dim; mobile opens as a full-screen sheet.
+- **Counter rows in detail**: identical on both — three stacked
+  progress bars on Logic 2 labels.
+
+## Performance
+
+- The 30 s cache deduplicates rapid refetches; a poll loop hitting
+  `getLevels()` every 5 s effectively translates to one network
+  round-trip per 30 s.
+- `getLevels` is suitable to call once at app boot and cache the
+  array in your own state (re-fetch only when the user's level
+  changes per `props_change`, since the operator-driven ladder
+  rarely changes mid-session).

package/docs/ui/user/UIGuide_getUserProfile.md

@@ -0,0 +1,213 @@
+# UI Guide — `getUserProfile`
+
+## Overview
+- The synchronous source of truth for the current user's public
+  properties — balances, level, username, avatar, tags, language,
+  inbox count.
+- The SDK keeps a local snapshot updated by a server push channel.
+  Every call returns the latest cached values; no network round-trip.
+- Drive long-lived widgets (header user-bar, balance display, inbox
+  badge, level badge) by **subscribing to `props_change` events** and
+  re-reading via `getUserProfile()` on each fire. Don't poll.
+
+## Subscription pattern
+
+The default Smartico UI registers a single `props_change` listener
+at boot and re-renders the affected widgets from the current
+`getUserProfile()` snapshot. The callback's argument carries only
+the changed keys, so you can branch on which subset of widgets to
+update:
+
+```ts
+window._smartico.on('props_change', (changed) => {
+  const profile = window._smartico.api.getUserProfile();
+
+  if ('ach_points_balance' in changed
+   || 'ach_gems_balance' in changed
+   || 'ach_diamonds_balance' in changed) {
+    console.log('[smartico] balance changed — re-render the currency strip:',
+      profile.ach_points_balance, profile.ach_gems_balance, profile.ach_diamonds_balance);
+  }
+  if ('ach_level_current_id' in changed) {
+    console.log('[smartico] level changed — call getCurrentLevel() and animate the badge');
+  }
+  if ('core_inbox_unread_count' in changed) {
+    console.log('[smartico] inbox count changed — update the inbox badge to:',
+      profile.core_inbox_unread_count);
+  }
+  if ('core_public_tags' in changed) {
+    console.log('[smartico] tags changed — re-evaluate any tag-gated UI:',
+      profile.core_public_tags);
+  }
+});
+```
+
+For one-time reads (e.g. inside a click handler), call
+`getUserProfile()` directly — no subscription needed.
+
+## Balance widget
+
+The default Smartico UI renders a horizontal strip of currency
+counters in the header / menu bar. Render rules:
+
+| Field | Rendered | Format |
+|---|---|---|
+| `ach_points_balance` | Always | Locale-aware integer (e.g. `"1,234"`); show even when zero. |
+| `ach_gems_balance` | Only if the operator has enabled gems for this label | Same locale format. |
+| `ach_diamonds_balance` | Only if the operator has enabled diamonds for this label | Same locale format. |
+
+Gems and diamonds are conditionally rendered per label
+configuration — not just based on whether the value is non-zero. For
+labels that don't use these currencies, hide the counters entirely
+rather than showing `0`. (The SDK doesn't expose label settings; ask
+the operator or detect by other context.)
+
+Pair the counter with an icon for each currency (points icon, gem
+icon, diamond icon). Use brand assets — none ship with the SDK.
+
+## Affordability checks
+
+`getUserProfile()` is the source for paid-mutation gating across
+the SDK. Same pattern for each domain:
+
+| Method | Read balance for | Compare against |
+|---|---|---|
+| [`buyStoreItem`](../../api/classes/WSAPIStore.md#buystoreitem) | `item.purchase_type` (`'points'` / `'gems'` / `'diamonds'`) | `item.discounted_price ?? item.price` |
+| [`joinClan`](../../api/classes/WSAPIClans.md#joinclan) | `clan.entry_fee_currency_type_id` (`0`/`1`/`2`/`3`) | `clan.entry_fee_amount` |
+| [`registerInTournament`](../../api/classes/WSAPITournaments.md#registerintournament) | Whichever of `registration_cost_points` / `_gems` / `_diamonds` is set | The same field |
+
+Disable the CTA when the user's balance is below the cost; show the
+deficit in the disabled state's text.
+
+## Level badge
+
+Render the level badge using `ach_level_current_id` as a lookup key
+into the level ladder fetched separately:
+
+1. Call [`getLevels`](../../api/classes/WSAPIUser.md#getlevels) once
+   at app boot to cache the full ladder.
+2. On `ach_level_current_id` change (via `props_change`), look up the
+   level by ID and render its `name` + `image`.
+3. For the richer "progress to next level" UI, call
+   [`getCurrentLevel`](../../api/classes/WSAPIUser.md#getcurrentlevel)
+   — it adds a computed `progress` percentage.
+
+`ach_level_current_id` may briefly be `0` (or undefined) for new
+users with no points yet. Handle that as "no level" — render a
+default badge (e.g. "Newcomer" or hide the badge).
+
+## Avatar widget
+
+`avatar_url` is a CDN URL resolved by the SDK from the server's
+`avatar_id` field. To render:
+
+- Place inside a square container (1:1 aspect ratio).
+- The default Smartico UI proxies the URL through a CDN resizer
+  (`resize/128/128/webp/...`) for size-appropriate fetches and
+  WebP-where-supported. Brands that don't use that resizer can
+  load `avatar_url` directly.
+- **No built-in placeholder**: when `avatar_url` is missing, the
+  default Smartico UI renders an empty container (no fallback
+  image). Provide your own placeholder asset / initial-letter
+  fallback if the empty state matters.
+
+## Username widget
+
+`public_username` is the user's display name. Fallback chain:
+
+- `public_username` if set
+- `'...'` (three dots) or a localized "Anonymous" string if not set
+
+The default Smartico UI uses `'...'`. There's no automatic fallback
+to `user_ext_id` — that field is internal and should never be
+displayed.
+
+## Inbox badge
+
+`core_inbox_unread_count` is the authoritative source for inbox
+unread badge rendering — it's push-updated in real time (under 1
+second), unlike
+[`getInboxUnreadCount()`](../../api/classes/WSAPIInbox.md#getinboxunreadcount)
+which caches for 30 s.
+
+Render rules:
+
+- `0` (or undefined) → badge hidden entirely
+- `1`–`N` → render the raw integer (e.g. `"5"`, `"42"`)
+- No truncation to `"99+"` in the default Smartico UI; brands that
+  want a cap should apply it themselves.
+
+## Public tags
+
+`core_public_tags` is an array of operator-defined uppercase strings
+(e.g. `['VIP', 'NEWSLETTER_OPT_IN']`). Use them to gate UI
+visibility — show a "VIP rewards" link only when `'VIP'` is in the
+array.
+
+To modify tags, use `_smartico.updatePublicTags(operation, tags)` —
+the change round-trips through the server and arrives back as a
+`props_change` push (usually within ~1 second).
+
+## Language
+
+`core_user_language` is the server-stored language code (e.g.
+`"en"`, `"de"`). The SDK uses this for:
+
+- Pre-translated content fields on missions, bonuses, clans, etc.
+- The `lang_code` parameter that
+  [`getTranslations`](../../api/classes/WSAPIGeneral.md#gettranslations)
+  is typically called with.
+
+When the user just changed language client-side, this field may
+briefly lag the local intent until the server push arrives. If your
+UI needs instant accuracy (e.g. switching the in-page language
+without a refresh), use `_smartico.getPublicProps()` which applies
+the client-side fallback.
+
+## AI-recommended amounts
+
+`core_recommended_deposit_amount` and
+`core_recommended_casino_bet_amount` are AI-computed for the user.
+The default Smartico UI doesn't render them — they're exposed for
+custom integrations (e.g. operator-specific deposit prompts,
+personalized bet suggestions).
+
+Guard against `undefined` — these are absent for users with no
+current recommendation.
+
+## Empty / loading / error states
+
+- **Pre-identify**: `getUserProfile()` throws
+  `"Tracker is not initialized, cannot getUserProfile"`. Render
+  widgets as skeleton/placeholder until the `identify` event fires
+  (or until the first `props_change` callback).
+- **Visitor mode**: not supported; will throw. Render a "Log in to
+  see your profile" CTA instead of a balance widget for anonymous
+  sessions.
+- **Stale data**: real-time push usually keeps the snapshot under 1
+  second behind server state. There's no explicit "stale" state —
+  trust the snapshot.
+
+## Animations / transitions
+
+- **Balance changes**: when `ach_points_balance` / `_gems` /
+  `_diamonds` change, animate the count-up/down between the prior
+  and new value (200–600 ms). Detect by diffing the prior snapshot
+  inside `props_change`.
+- **Level-up**: when `ach_level_current_id` increases, play a
+  celebration animation on the badge (sparkle, scale-up, color
+  flash). Detect by diffing the prior `ach_level_current_id`.
+- **Inbox badge appearing**: when `core_inbox_unread_count` flips
+  from `0` to `>0`, animate the badge fade-in.
+
+## Performance
+
+- `getUserProfile()` is effectively free (synchronous, in-memory
+  copy). Call it as often as you need.
+- Avoid re-rendering every widget on every `props_change` push —
+  branch on the changed keys and re-render only the affected
+  surfaces.
+- `getUserProfile()` returns a shallow copy on each call; for
+  performance-critical paths (e.g. animations), prefer memoizing
+  the result inside `props_change` rather than calling on every
+  frame.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@smartico/public-api",
-	"version": "0.0.378",
+	"version": "0.0.380",
 	"description": "Smartico public API",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
@@ -24,7 +24,7 @@
 		"bump-ach": "cd ../tracker/ach && npm install @smartico/public-api@latest --legacy-peer-deps",
 		"bump-bo-server": "cd ../bo_server/server && source ~/.nvm/nvm.sh && nvm use v13.13.0 && npm install @smartico/public-api@latest",
 		"bump-bo-client": "cd ../bo_server/client && source ~/.nvm/nvm.sh && nvm use v13.13.0 && npm install @smartico/public-api@latest",
-		"doc": "typedoc"
+		"doc": "typedoc && node scripts/postdoc-cleanup.js"
 	},
 	"author": "",
 	"license": "ISC",
@@ -40,6 +40,6 @@
 		"typedoc-plugin-markdown": "^4.11.0",
 		"typedoc-plugin-merge-modules": "^7.0.0",
 		"typescript": "~5.1.0",
-		"@types/node": "^18.19.130"
+		"@types/node": "^22.9.0"
 	}
 }

package/scripts/postdoc-cleanup.js

@@ -0,0 +1,195 @@
+#!/usr/bin/env node
+/**
+ * Post-process step after `typedoc` runs.
+ *
+ * Fixes three cosmetic issues typedoc / typedoc-plugin-markdown produce
+ * that have no config flag to disable:
+ *
+ *   1. **"Extends" / "Extended by" blocks** on every class doc are pure
+ *      inheritance-chain plumbing that consumers don't need to see. We
+ *      strip them.
+ *
+ *   2. **Inherited methods duplicated on every subclass doc.** Each class
+ *      .md re-lists every method from every ancestor in the inheritance
+ *      chain (e.g. `WSAPIInbox.md` ends up with all 65+ methods even
+ *      though only ~8 are its own). We detect inherited methods via the
+ *      `#### Inherited from` marker typedoc emits, strip those method
+ *      blocks, and leave each class doc focused on the methods that
+ *      class actually declares.
+ *
+ *   3. **`docs/api/_media/` duplication** of UI guides. The TSDoc UI link
+ *      uses a relative path `[label](../../docs/ui/<domain>/UIGuide_X.md)`
+ *      which typedoc treats as a local "media" reference — it copies the
+ *      file into `docs/api/_media/` and rewrites the link to point there.
+ *      We delete `_media/` and rewrite the links back to the original
+ *      `docs/ui/<domain>/UIGuide_X.md` so there's a single source of
+ *      truth (in `docs/ui/`).
+ *
+ * Run via `npm run doc` (chained after typedoc) — see `package.json`.
+ */
+const fs = require('fs');
+const path = require('path');
+
+const DOCS_API = path.join(__dirname, '..', 'docs', 'api');
+const DOCS_API_CLASSES = path.join(DOCS_API, 'classes');
+const DOCS_API_MEDIA = path.join(DOCS_API, '_media');
+
+let mdFilesProcessed = 0;
+let mediaLinksRewritten = 0;
+let extendsBlocksRemoved = 0;
+let inheritedMethodsStripped = 0;
+
+/** Recursively list all `.md` files under a directory. */
+function walkMd(dir) {
+	const out = [];
+	for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+		const p = path.join(dir, entry.name);
+		if (entry.isDirectory()) {
+			out.push(...walkMd(p));
+		} else if (entry.isFile() && entry.name.endsWith('.md')) {
+			out.push(p);
+		}
+	}
+	return out;
+}
+
+/**
+ * Strip `## Extends\n\n- [Foo](...)` and `## Extended by\n\n- [...]` sections.
+ * The block ends at the next `## ` heading (or end of file).
+ */
+function stripExtendsBlocks(text) {
+	const lines = text.split('\n');
+	const out = [];
+	let i = 0;
+	let removed = 0;
+	while (i < lines.length) {
+		const ln = lines[i];
+		if (ln === '## Extends' || ln === '## Extended by') {
+			// Skip until the next `## ` heading or EOF
+			let j = i + 1;
+			while (j < lines.length && !lines[j].startsWith('## ')) {
+				j++;
+			}
+			// Also drop one trailing blank line if present right before the
+			// `## Extends` line to avoid leaving a double-blank gap.
+			while (out.length > 0 && out[out.length - 1] === '') {
+				out.pop();
+			}
+			i = j;
+			removed++;
+			continue;
+		}
+		out.push(ln);
+		i++;
+	}
+	return { text: out.join('\n'), removed };
+}
+
+/**
+ * Rewrite `(../_media/UIGuide_X.md)` → `(../../docs/ui/<domain>/UIGuide_X.md)`.
+ * Domain is inferred from the filename prefix when possible; otherwise we
+ * map known UI guides to their domain.
+ */
+const UI_GUIDE_DOMAIN = {
+	UIGuide_getMissions: 'missions',
+	UIGuide_getBadges: 'missions',
+	UIGuide_getAchCategories: 'missions',
+	UIGuide_requestMissionOptIn: 'missions',
+	UIGuide_requestMissionClaimReward: 'missions',
+	UIGuide_getStoreItems: 'store',
+	UIGuide_buyStoreItem: 'store',
+	UIGuide_getStoreCategories: 'store',
+	UIGuide_getStorePurchasedItems: 'store',
+};
+
+function rewriteMediaLinks(text) {
+	let count = 0;
+	// Pattern: `(../_media/<filename>.md)` (when generated inside docs/api/classes/).
+	// Rewrite to `(../../ui/<domain>/<filename>.md)` — correct relative from
+	// `docs/api/classes/` to `docs/ui/<domain>/`. Going through `docs/` once is
+	// enough; an extra `docs/` in the path would resolve to `docs/docs/ui/...`.
+	const out = text.replace(/\(\.\.\/_media\/([A-Za-z0-9_]+)\.md\)/g, (m, name) => {
+		const domain = UI_GUIDE_DOMAIN[name];
+		if (!domain) return m; // unknown media file — leave it
+		count++;
+		return `(../../ui/${domain}/${name}.md)`;
+	});
+	return { text: out, count };
+}
+
+/**
+ * Strip inherited method blocks. A method block:
+ *   - Starts at `### methodName()`
+ *   - Ends just before the next `### ` (next method) or `## ` (next major
+ *     section), whichever comes first
+ * A method is "inherited" if its block contains `#### Inherited from`.
+ *
+ * After stripping, the file's `## Methods` section may be empty — that's
+ * OK: it means the class has no own methods (which shouldn't happen for
+ * the domain classes, but is graceful for edge cases).
+ */
+function stripInheritedMethods(text) {
+	const lines = text.split('\n');
+	const out = [];
+	let i = 0;
+	let removed = 0;
+	while (i < lines.length) {
+		const ln = lines[i];
+		// Detect method-block start
+		if (ln.startsWith('### ')) {
+			// Find block end
+			let j = i + 1;
+			while (
+				j < lines.length &&
+				!lines[j].startsWith('### ') &&
+				!lines[j].startsWith('## ')
+			) {
+				j++;
+			}
+			const block = lines.slice(i, j);
+			const isInherited = block.some((l) => l === '#### Inherited from');
+			if (isInherited) {
+				removed++;
+				i = j;
+				continue;
+			}
+			// Keep the block
+			out.push(...block);
+			i = j;
+			continue;
+		}
+		out.push(ln);
+		i++;
+	}
+	return { text: out.join('\n'), removed };
+}
+
+// 1. Process every class .md
+if (fs.existsSync(DOCS_API_CLASSES)) {
+	for (const file of walkMd(DOCS_API_CLASSES)) {
+		const orig = fs.readFileSync(file, 'utf8');
+		const a = stripExtendsBlocks(orig);
+		const b = stripInheritedMethods(a.text);
+		const c = rewriteMediaLinks(b.text);
+		if (c.text !== orig) {
+			fs.writeFileSync(file, c.text);
+			mdFilesProcessed++;
+			extendsBlocksRemoved += a.removed;
+			inheritedMethodsStripped += b.removed;
+			mediaLinksRewritten += c.count;
+		}
+	}
+}
+
+// 2. Delete _media/ (UI guides now linked from docs/ui/; any non-UI media
+// like images would also be wiped — none expected in this project)
+if (fs.existsSync(DOCS_API_MEDIA)) {
+	const count = fs.readdirSync(DOCS_API_MEDIA).length;
+	fs.rmSync(DOCS_API_MEDIA, { recursive: true, force: true });
+	console.log(`Removed docs/api/_media/ (${count} duplicate file(s))`);
+}
+
+console.log(`Processed ${mdFilesProcessed} .md files`);
+console.log(`Removed ${extendsBlocksRemoved} Extends/Extended-by block(s)`);
+console.log(`Stripped ${inheritedMethodsStripped} inherited-method block(s)`);
+console.log(`Rewrote ${mediaLinksRewritten} _media link(s) → docs/ui/`);

package/src/Missions/MissionsUtils.ts

@@ -5,9 +5,12 @@ import { UserAchievement } from "./UserAchievement";
 import { UserAchievementTask } from "./UserAchievementTask";
 import { BadgesTimeLimitStates } from "./BadgesTimeLimitStates";
 
-type UserStateParamsKeys = 'core_fav_game_top3' | 'core_fav_game_type_top3' | 'core_fav_game_provider_top3' | 'core_recommended_deposit_amount' | 'core_recommended_casino_bet_amount' | 'casino_last_bet_amount' | 'casino_last_bet_amount_real' | 'casino_last_bet_amount_bonus' | 'acc_last_deposit_amount';
+type UserStateParamsKeys = 'core_fav_game_top3' | 'core_fav_game_type_top3' | 'core_fav_game_provider_top3' | 'core_recommended_deposit_amount' | 'core_recommended_casino_bet_amount';
 const USER_STATE_PARAMS_KEYS_GAMES: UserStateParamsKeys[] = ['core_fav_game_top3', 'core_fav_game_type_top3', 'core_fav_game_provider_top3'];
-const USER_STATE_PARAMS_KEYS_BET_AMOUNT: UserStateParamsKeys[] = ['core_recommended_deposit_amount', 'core_recommended_casino_bet_amount', 'casino_last_bet_amount', 'casino_last_bet_amount_real', 'casino_last_bet_amount_bonus', 'acc_last_deposit_amount'];
+const USER_STATE_PARAMS_KEYS_BET_AMOUNT: UserStateParamsKeys[] = [
+    'core_recommended_deposit_amount',
+    'core_recommended_casino_bet_amount',
+];
 
 const MINOR_WORDS = new Set([
     'of', 'at', 'in', 'on', 'to', 'up', 'as', 'by', 'for',

package/src/Store/BuyStoreItemErrorCode.ts

@@ -1,4 +1,8 @@
 export enum BuyStoreItemErrorCode {
+	/** Generic server error / control-group rejection */
+	SHOP_FAILED_GENERIC = 1,
+	/** Label mismatch detected before purchase transaction */
+	SHOP_WRONG_LABEL_PRECHECK = 106,
 	/** User don't have enough points on balance */
 	SHOP_NO_BALANCE = 11000,
 	/** Wrong shop item id */
@@ -13,6 +17,8 @@ export enum BuyStoreItemErrorCode {
 	SHOP_FAILED_TO_BUY_MATCHING_BONUS = 11005,
 	/** Failed to buy item because of limit of max items is reached */
 	SHOP_FAILED_MAX_BOUGHT_ITEMS_REACHED = 11006,
+	/** Bonus was issued but a follow-up redemption step failed */
+	SHOP_FAILED_BONUS_REDEMPTION = 11007,
 	/** Failed to buy item because no more items are available */
 	SHOP_FAILED_POOL_EMPTY = 11009,
 	/** User doesn't have enough gems on balance */
@@ -21,4 +27,6 @@ export enum BuyStoreItemErrorCode {
 	SHOP_NO_BALANCE_DIAMONDS = 11012,
 	/** Failed to buy item because of purchase limitation */
 	SHOP_FAILED_PURCHASE_LIMITATION = 11014,
+	/** Uncaught server exception */
+	SHOP_UNEXPECTED_EXCEPTION = 9999,
 }

package/src/Store/StoreItem.ts

@@ -52,6 +52,7 @@ export const StoreItemTransform = (items: StoreItem[]): TStoreItem[] => {
 				pool: r.shopPool,
 				custom_data: IntUtils.JsonOrText(r.itemPublicMeta.custom_data),
 				active_till_date: r.activeTillDate,
+				show_timer: r.itemPublicMeta.show_timer,
 				discounted_price: r.itemPublicMeta.discount_prize,
 				discount_price_ribbon: r.itemPublicMeta.discount_prize_ribbon,
 				custom_ribbon_image: r.itemPublicMeta.custom_ribbon_image,

package/src/Store/StoreItemPurchased.ts

@@ -55,6 +55,7 @@ export const StoreItemPurchasedTransform = (items: StoreItemPurchased[]): TStore
 				purchased_this_week: purchasedThisWeek,
 				purchased_this_month: purchasedThisMonth,
 				custom_data: r.itemPublicMeta.custom_data,
+				show_timer: r.itemPublicMeta.show_timer,
 				related_games: (r.relatedGames?.filter((g) => g.game_public_meta.enabled) || []).map((g, i) => ({
 					ext_game_id: g.ext_game_id,
 					game_public_meta: {

package/src/Store/StoreItemType.ts

@@ -21,7 +21,7 @@ export const StoreItemTypeNamed = (type: StoreItemType): StoreItemTypeName => {
 	return (
 		{
 			[StoreItemType.Bonus]: StoreItemTypeName.Bonus,
-			[StoreItemType.Tangible]: StoreItemTypeName.Bonus,
+			[StoreItemType.Tangible]: StoreItemTypeName.Tangible,
 			[StoreItemType.MiniGameSpin]: StoreItemTypeName.MiniGameSpin,
 			[StoreItemType.ChangeLevel]: StoreItemTypeName.ChangeLevel,
 			[StoreItemType.PrizeDrop]: StoreItemTypeName.PrizeDrop,

package/src/Tournaments/TournamentRegistrationError.ts

@@ -9,4 +9,8 @@ export enum TournamentRegistrationError {
 	TOURNAMENT_USER_NOT_REGISTERED = 30006,
 	TOURNAMENT_CANT_CHANGE_REGISTRATION_STATUS = 30007,
 	TOURNAMENT_MAX_REGISTRATIONS_REACHED = 30008,
+    TOURNAMENT_REGISTRATION_NOT_ENOUGH_GEMS = 30010,
+    TOURNAMENT_REGISTRATION_NOT_ENOUGH_DIAMONDS = 30011,
+
+
 }