@smartico/public-api 0.0.403 → 0.0.405

package/docs/capabilities/gamePickGetRoundInfoForUser.md

@@ -0,0 +1,189 @@
+# gamePickGetRoundInfoForUser — API (GamePickRound)
+
+> Returns a round with another player's predictions instead of the current user's.
+> Import: `import { GamePickRound } from '@smartico/public-api'`
+> Search terms: gamePickGetRoundInfoForUser, gamepick, GamePickRound, GPRoundStatus, GamePickScoreType, GameRoundOrderType, GamePickRoundPublicMeta, GamePickEvent, SAWGPMarketType, GamePickEventMeta, QuizAnswersValueType, GamePickResolutionType
+
+## Signature
+```ts
+_smartico.api.gamePickGetRoundInfoForUser(props: GamePickRoundRequestParams & { int_user_id: number }): Promise<GamesApiResponse<GamePickRound>>
+```
+
+## Parameters
+- `props.saw_template_id` — ID of the MatchX or Quiz game template.
+- `props.round_id` — ID of the round to inspect.
+- `props.int_user_id` — Internal user ID from `gamePickGetBoard.users[].int_user_id`.
+
+## Returns — `Promise<GamesApiResponse<GamePickRound>>`
+Wrapped in `GamesApiResponse`: `errCode` (number — `0` = success), `errMessage?` (string), `data?` — the payload:
+
+`GamePickRound`:
+- `round_id` (number) — Unique round identifier
+- `round_row_id` (number) — Sequential row ID used for ordering rounds
+- `round_name` (string) — Localized display name of the round
+- `round_description` (string) — Localized description of the round
+- `final_screen_cta_button_title` (string) — Label for the CTA button on the final/results screen
+- `final_screen_message` (string) — Message displayed on the final/results screen
+- `final_screen_image_desktop` (string) — URL of the final screen image (desktop)
+- `final_screen_image_mobile` (string) — URL of the final screen image (mobile)
+- `promo_image` (string) — URL of the promotional image for the round
+- `promo_text` (string) — Promotional text displayed with the round
+- `open_date` (number) — Timestamp (ms) when the round opens for participation
+- `last_bet_date` (number) — Timestamp (ms) of the last moment bets are accepted
+- `resolution_date` (number) — Timestamp (ms) when the round is expected to be resolved
+- `score_full_win` (number) — Points awarded for a fully correct prediction
+- `score_part_win` (number) — Points awarded for a partially correct prediction
+- `score_lost` (number) — Points awarded (or deducted) for an incorrect prediction
+- `is_active_now` (boolean) — Whether the round is currently active for participation
+- `is_resolved` (boolean) — Whether the round has been fully resolved and scored
+- `round_status_id` (GPRoundStatus) — Current lifecycle status of the round
+- `events_total` (number) — Total number of events in the round
+- `events_resolved` (number) — Number of events that have been resolved
+- `score_type_id` (GamePickScoreType) — Scoring method used for this round
+- `order_events` (GameRoundOrderType) — How events are ordered for display
+- `board_users_count` (number) — Maximum number of users shown on the leaderboard
+- `hide_users_predictions` (boolean) — Whether other users' predictions are hidden until resolution
+- `public_meta` (GamePickRoundPublicMeta) — Public metadata including translations and display settings from the BackOffice
+  - `round_name` (string) — Localized round name
+  - `round_description` (string) — Localized round description
+  - `promo_image` (string) — URL of the promotional image for the round
+  - `promo_text` (string) — Promotional text displayed with the round
+  - `hide_resolved_round` (boolean) — Whether to hide the round from the UI after it has been resolved
+  - `final_screen_image_desktop` (string) — URL of the final screen image for desktop
+  - `final_screen_image_mobile` (string) — URL of the final screen image for mobile
+  - `final_screen_message` (string) — Message displayed on the final/results screen
+  - `final_screen_cta_button_title` (string) — Label for the CTA button on the final screen
+  - `final_screen_cta_dp` (string) — Deep link triggered by the CTA button on the final screen
+  - `allow_edit_answers` (boolean) — Whether users can edit their answers after initial submission (within betting window)
+  - `_translations` ({
+		[key: string]: {
+			round_name: string;
+			round_description: string;
+			promo_image: string;
+			promo_text: string;
+			final_screen_image_desktop: string;
+			final_screen_image_mobile: string;
+			final_screen_message: string;
+			final_screen_cta_button_title: string;
+		};
+	}) — Per-language overrides for round display content
+- `next_round_open_date` (number) — Timestamp (ms) when the next round opens, if available
+- `show_users_preference` (boolean) — Whether to show aggregated user preference percentages for each outcome
+- `events` (GamePickEvent[]) — List of events (matches/questions) in this round
+  - `gp_event_id` (number) — Unique identifier of the event
+  - `event_resolution_date` (string) — ISO 8601 date-time string when the event was resolved; null until resolved.
+  - `match_date` (string) — ISO 8601 date-time string of the match/event start time.
+  - `market_type_id` (SAWGPMarketType) — Market type defining the prediction format (e.g. two-team score, quiz question, custom)
+  - `event_meta` (GamePickEventMeta) — Event metadata containing team names, images, sport type, and question details
+    - `answers` ({
+		/** Answer identifier value sent on submission */
+		value: string;
+		/** Localized display text of the answer */
+		text: string;
+		/** Per-language overrides for the answer text */
+		_translations: {
+			[key: string]: {
+				text: string;
+			};
+		};
+	}[]) — List of possible answer options for the quiz question
+    - `question_image` (string) — URL of an image associated with the question
+    - `result` (QuizAnswersValueType) — Correct answer value after resolution
+    - `custom_question` (string) — Custom question text displayed to the user
+    - `event_name` (string) — Display name of the event/match
+    - `team1_name` (string) — Name of the first team (home)
+    - `team1_image` (string) — URL of the first team's logo image
+    - `team2_name` (string) — Name of the second team (away)
+    - `team2_image` (string) — URL of the second team's logo image
+    - `team1_result` (number) — Actual result score for team 1 after resolution
+    - `team2_result` (number) — Actual result score for team 2 after resolution
+    - `sport_type_id` (number) — Betradar sport type ID for the event
+    - `is_canceled` (boolean) — Whether the event has been canceled
+    - `auto_resolve_enabled` (boolean) — Whether auto-resolution from live data feed is enabled
+    - `auto_resolve_date` (string) — ISO date string for when auto-resolution is expected
+    - `team1_auto_result` (number) — Auto-resolved score for team 1 from live data feed
+    - `team2_auto_result` (number) — Auto-resolved score for team 2 from live data feed
+    - `auto_result` (string) — Auto-resolved answer value from live data feed (for quiz events)
+    - `_translations` ({
+		[key: string]: {
+			team1_name: string;
+			team2_name: string;
+			event_name: string;
+			custom_question: string;
+		};
+	}) — Per-language overrides for team names, event name, and custom question
+  - `user_placed_bet` (boolean) — Whether the current user has submitted a prediction for this event
+  - `team1_user_selection` (number | { from: number; to: number }) — User's predicted score for team 1 (MatchX only). Can be a number or a range object
+  - `team2_user_selection` (number | { from: number; to: number }) — User's predicted score for team 2 (MatchX only). Can be a number or a range object
+  - `user_selection` (QuizAnswersValueType) — User's selected answer (Quiz only). Value depends on market type (e.g. '1', '2', 'x', 'yes', 'no')
+  - `resolution_type_id` (GamePickResolutionType) — How the user's prediction was scored after resolution
+  - `resolution_score` (number) — Points awarded for this event based on prediction accuracy
+  - `is_open_for_bets` (boolean) — Whether this event is still accepting predictions
+  - `odds_details` ({ odd_value: { [key: string]: number } }) — Betting odds details for the event outcomes
+  - `question_image` (string) — URL of a question-specific image (quiz events)
+- `user_score` (number) — Current user's total score in this round
+- `user_placed_bet` (boolean) — Whether the current user has submitted any predictions in this round
+- `has_open_for_bet_events` (boolean) — Whether there are events still open for betting
+- `has_not_submitted_changes` (boolean) — Whether the user has unsaved changes to their predictions
+
+## Behavioral contract
+**Preconditions**
+- User must be authenticated. Visitor mode not supported.
+- `saw_template_id`, `round_id`, and `int_user_id` are all mandatory — SDK
+ throws synchronously if any is missing.
+- `int_user_id` must come from a leaderboard fetch in the same game
+ template; it is stable within a template but not portable across
+ templates.
+
+**Shape vs `gamePickGetActiveRound`**
+Same `GamePickRound` structure, but `user_selection` /
+`team1_user_selection` / `team2_user_selection` reflect the TARGET user's
+predictions instead of the caller's. Each event still carries its own
+`resolution_type_id` (see `GamePickResolutionType`) so the UI can
+render result badges per pick.
+
+
+
+**Refresh**
+- No cache. Re-call when opening a different leaderboard row's
+ "view picks" modal.
+- No push subscription.
+
+**Visitor mode**: not supported.
+
+**UI guidance**: see [UI Guide — `gamePickGetRoundInfoForUser`](../../docs/ui/gamepick/UIGuide_gamePickGetRoundInfoForUser.md).
+
+## Example
+```ts
+const board = await window._smartico.api.gamePickGetBoard({
+    saw_template_id: 1083, round_id: 31652,
+});
+const topPlayer = board.data?.users?.[0];
+if (!topPlayer) return;
+
+const r = await window._smartico.api.gamePickGetRoundInfoForUser({
+    saw_template_id: 1083,
+    round_id:        31652,
+    int_user_id:     topPlayer.int_user_id,
+});
+
+if (r.errCode === 0 && r.data) {
+    for (const ev of r.data.events) {
+        console.log('[smartico] render row —', ev.event_meta.team1_name, 'vs', ev.event_meta.team2_name, '— picked:', ev.user_selection, '— resolution:', ev.resolution_type_id);
+    }
+}
+```
+
+## Errors
+**Error codes** (in `errCode`)
+- `0` — success.
+- `4` — round / event / user not found.
+- `100002` — template not found.
+- `100000` — auth hash invalid.
+- `100004` — generic server error.
+
+## Related
+- `gamePickGetBoard`
+- `GamePickRound`
+- `GamePickResolutionType`
+- `GamesApiResponse`

package/docs/capabilities/gamePickGetUserInfo.md

@@ -0,0 +1,91 @@
+# gamePickGetUserInfo — API (GamePickUserInfo)
+
+> Returns the current user's profile within the Game Pick system — display name, avatar, balances, and last wallet-sync timestamp.
+> Import: `import { GamePickUserInfo } from '@smartico/public-api'`
+> Search terms: gamePickGetUserInfo, gamepick, GamePickUserInfo, errCode, data
+
+## Signature
+```ts
+_smartico.api.gamePickGetUserInfo(props: GamePickRequestParams): Promise<GamesApiResponse<GamePickUserInfo>>
+```
+
+## Parameters
+- `props.saw_template_id` — ID of the MatchX or Quiz game template.
+
+## Returns — `Promise<GamesApiResponse<GamePickUserInfo>>`
+Wrapped in `GamesApiResponse`: `errCode` (number — `0` = success), `errMessage?` (string), `data?` — the payload:
+
+`GamePickUserInfo`:
+- `ext_user_id` (string) — External user ID (Smartico numeric user ID)
+- `int_user_id` (number) — Internal user ID within the games system
+- `public_username` (string) — Display name
+- `avatar_url` (string) — URL of the user's avatar image
+- `gp_position` (number) — User's leaderboard rank position
+- `full_wins_count` (number) — Number of fully correct predictions
+- `part_wins_count` (number) — Number of partially correct predictions
+- `resolution_score` (number) — User's total score
+- `last_wallet_sync_time` (string) — ISO 8601 date-time string of the last time the user's balance was synced from the Smartico platform.
+- `ach_points_balance` (number) — User's current points balance
+- `ach_gems_balance` (number) — User's current gems balance
+- `ach_diamonds_balance` (number) — User's current diamonds balance
+- `pubic_username_set` (boolean) — Whether the user has set a custom public username
+
+## Behavioral contract
+**Preconditions**
+- User must be authenticated. Visitor mode not supported.
+
+**Balance freshness**
+The balances returned here are the cached mirror — at most ~1 minute stale.
+For an up-to-the-second view of Points / Gems / Diamonds, read from
+`getUserProfile` instead. Use this method's balances only for
+in-Game-Pick display.
+
+
+
+**Refresh**
+- No cache. Server-side mirror refreshes at most every 60 s.
+- No push subscription.
+
+**Visitor mode**: not supported.
+
+**UI guidance**: see [UI Guide — `gamePickGetUserInfo`](../../docs/ui/gamepick/UIGuide_gamePickGetUserInfo.md).
+
+## Example
+```ts
+const r = await window._smartico.api.gamePickGetUserInfo({ saw_template_id: 1083 });
+
+if (r.errCode === 0 && r.data) {
+    console.log('[smartico] render Game Pick header — name:', r.data.public_username, '— points:', r.data.ach_points_balance, '— synced:', r.data.last_wallet_sync_time);
+}
+```
+
+### Example response (REAL shape)
+> Where this real payload differs from the typed Returns above (TS interface vs raw wire), the REAL shape is the runtime truth.
+```json
+{
+  "errCode": 0,
+  "data": {
+    "ext_user_id": "361368543",
+    "int_user_id": "216289785",
+    "public_username": "Antonio",
+    "avatar_url": "https://cdn.example/avatars/12/00000000-0000-0000-0000-000000000000.png",
+    "last_wallet_sync_time": "2026-06-24T11:56:54.592Z",
+    "ach_points_balance": 326,
+    "ach_gems_balance": 10,
+    "ach_diamonds_balance": 1,
+    "pubic_username_set": true
+  }
+}
+```
+
+## Errors
+**Error codes** (in `errCode`)
+- `0` — success.
+- `100002` — template not found.
+- `100000` — auth hash invalid.
+- `100004` — generic server error.
+
+## Related
+- `getUserProfile`
+- `GamesApiResponse`
+- `GamePickUserInfo`

package/docs/capabilities/gamePickSubmitSelection.md

@@ -0,0 +1,222 @@
+# gamePickSubmitSelection — API (GamePickRound)
+
+> Submits all score predictions for a round in a MatchX game in one shot.
+> Import: `import { GamePickRound } from '@smartico/public-api'`
+> Search terms: gamePickSubmitSelection, gamepick, GamePickRound, GPRoundStatus, GamePickScoreType, GameRoundOrderType, GamePickRoundPublicMeta, GamePickEvent, SAWGPMarketType, GamePickEventMeta, QuizAnswersValueType, GamePickResolutionType
+
+## Signature
+```ts
+_smartico.api.gamePickSubmitSelection(props: GamePickRequestParams & { round: Partial<GamePickRound> }): Promise<GamesApiResponse<GamePickRound>>
+```
+
+## Parameters
+- `props.saw_template_id` — ID of the MatchX game template.
+- `props.round` — Round object with `round_id` + `events[]` carrying the user's score predictions.
+
+## Returns — `Promise<GamesApiResponse<GamePickRound>>`
+Wrapped in `GamesApiResponse`: `errCode` (number — `0` = success), `errMessage?` (string), `data?` — the payload:
+
+`GamePickRound`:
+- `round_id` (number) — Unique round identifier
+- `round_row_id` (number) — Sequential row ID used for ordering rounds
+- `round_name` (string) — Localized display name of the round
+- `round_description` (string) — Localized description of the round
+- `final_screen_cta_button_title` (string) — Label for the CTA button on the final/results screen
+- `final_screen_message` (string) — Message displayed on the final/results screen
+- `final_screen_image_desktop` (string) — URL of the final screen image (desktop)
+- `final_screen_image_mobile` (string) — URL of the final screen image (mobile)
+- `promo_image` (string) — URL of the promotional image for the round
+- `promo_text` (string) — Promotional text displayed with the round
+- `open_date` (number) — Timestamp (ms) when the round opens for participation
+- `last_bet_date` (number) — Timestamp (ms) of the last moment bets are accepted
+- `resolution_date` (number) — Timestamp (ms) when the round is expected to be resolved
+- `score_full_win` (number) — Points awarded for a fully correct prediction
+- `score_part_win` (number) — Points awarded for a partially correct prediction
+- `score_lost` (number) — Points awarded (or deducted) for an incorrect prediction
+- `is_active_now` (boolean) — Whether the round is currently active for participation
+- `is_resolved` (boolean) — Whether the round has been fully resolved and scored
+- `round_status_id` (GPRoundStatus) — Current lifecycle status of the round
+- `events_total` (number) — Total number of events in the round
+- `events_resolved` (number) — Number of events that have been resolved
+- `score_type_id` (GamePickScoreType) — Scoring method used for this round
+- `order_events` (GameRoundOrderType) — How events are ordered for display
+- `board_users_count` (number) — Maximum number of users shown on the leaderboard
+- `hide_users_predictions` (boolean) — Whether other users' predictions are hidden until resolution
+- `public_meta` (GamePickRoundPublicMeta) — Public metadata including translations and display settings from the BackOffice
+  - `round_name` (string) — Localized round name
+  - `round_description` (string) — Localized round description
+  - `promo_image` (string) — URL of the promotional image for the round
+  - `promo_text` (string) — Promotional text displayed with the round
+  - `hide_resolved_round` (boolean) — Whether to hide the round from the UI after it has been resolved
+  - `final_screen_image_desktop` (string) — URL of the final screen image for desktop
+  - `final_screen_image_mobile` (string) — URL of the final screen image for mobile
+  - `final_screen_message` (string) — Message displayed on the final/results screen
+  - `final_screen_cta_button_title` (string) — Label for the CTA button on the final screen
+  - `final_screen_cta_dp` (string) — Deep link triggered by the CTA button on the final screen
+  - `allow_edit_answers` (boolean) — Whether users can edit their answers after initial submission (within betting window)
+  - `_translations` ({
+		[key: string]: {
+			round_name: string;
+			round_description: string;
+			promo_image: string;
+			promo_text: string;
+			final_screen_image_desktop: string;
+			final_screen_image_mobile: string;
+			final_screen_message: string;
+			final_screen_cta_button_title: string;
+		};
+	}) — Per-language overrides for round display content
+- `next_round_open_date` (number) — Timestamp (ms) when the next round opens, if available
+- `show_users_preference` (boolean) — Whether to show aggregated user preference percentages for each outcome
+- `events` (GamePickEvent[]) — List of events (matches/questions) in this round
+  - `gp_event_id` (number) — Unique identifier of the event
+  - `event_resolution_date` (string) — ISO 8601 date-time string when the event was resolved; null until resolved.
+  - `match_date` (string) — ISO 8601 date-time string of the match/event start time.
+  - `market_type_id` (SAWGPMarketType) — Market type defining the prediction format (e.g. two-team score, quiz question, custom)
+  - `event_meta` (GamePickEventMeta) — Event metadata containing team names, images, sport type, and question details
+    - `answers` ({
+		/** Answer identifier value sent on submission */
+		value: string;
+		/** Localized display text of the answer */
+		text: string;
+		/** Per-language overrides for the answer text */
+		_translations: {
+			[key: string]: {
+				text: string;
+			};
+		};
+	}[]) — List of possible answer options for the quiz question
+    - `question_image` (string) — URL of an image associated with the question
+    - `result` (QuizAnswersValueType) — Correct answer value after resolution
+    - `custom_question` (string) — Custom question text displayed to the user
+    - `event_name` (string) — Display name of the event/match
+    - `team1_name` (string) — Name of the first team (home)
+    - `team1_image` (string) — URL of the first team's logo image
+    - `team2_name` (string) — Name of the second team (away)
+    - `team2_image` (string) — URL of the second team's logo image
+    - `team1_result` (number) — Actual result score for team 1 after resolution
+    - `team2_result` (number) — Actual result score for team 2 after resolution
+    - `sport_type_id` (number) — Betradar sport type ID for the event
+    - `is_canceled` (boolean) — Whether the event has been canceled
+    - `auto_resolve_enabled` (boolean) — Whether auto-resolution from live data feed is enabled
+    - `auto_resolve_date` (string) — ISO date string for when auto-resolution is expected
+    - `team1_auto_result` (number) — Auto-resolved score for team 1 from live data feed
+    - `team2_auto_result` (number) — Auto-resolved score for team 2 from live data feed
+    - `auto_result` (string) — Auto-resolved answer value from live data feed (for quiz events)
+    - `_translations` ({
+		[key: string]: {
+			team1_name: string;
+			team2_name: string;
+			event_name: string;
+			custom_question: string;
+		};
+	}) — Per-language overrides for team names, event name, and custom question
+  - `user_placed_bet` (boolean) — Whether the current user has submitted a prediction for this event
+  - `team1_user_selection` (number | { from: number; to: number }) — User's predicted score for team 1 (MatchX only). Can be a number or a range object
+  - `team2_user_selection` (number | { from: number; to: number }) — User's predicted score for team 2 (MatchX only). Can be a number or a range object
+  - `user_selection` (QuizAnswersValueType) — User's selected answer (Quiz only). Value depends on market type (e.g. '1', '2', 'x', 'yes', 'no')
+  - `resolution_type_id` (GamePickResolutionType) — How the user's prediction was scored after resolution
+  - `resolution_score` (number) — Points awarded for this event based on prediction accuracy
+  - `is_open_for_bets` (boolean) — Whether this event is still accepting predictions
+  - `odds_details` ({ odd_value: { [key: string]: number } }) — Betting odds details for the event outcomes
+  - `question_image` (string) — URL of a question-specific image (quiz events)
+- `user_score` (number) — Current user's total score in this round
+- `user_placed_bet` (boolean) — Whether the current user has submitted any predictions in this round
+- `has_open_for_bet_events` (boolean) — Whether there are events still open for betting
+- `has_not_submitted_changes` (boolean) — Whether the user has unsaved changes to their predictions
+
+## Behavioral contract
+**Preconditions**
+- User must be authenticated. Visitor mode not supported.
+- `saw_template_id` and `props.round.round_id` are mandatory — SDK throws if
+ either is missing.
+- Each event passed must include `gp_event_id` and the two
+ `team{1,2}_user_selection` fields. Missing events default to "no change".
+
+
+
+**Idempotency**
+Re-submitting identical selections returns `errCode: 3` (no changes); the
+buy-in is consumed exactly once per round-per-user. Re-submitting after
+`last_bet_date` also returns `errCode: 3` without consuming the buy-in.
+
+**Side effects**
+- First successful submit deducts the buy-in (Points / Gems / Diamonds /
+ one Spin) per `saw_buyin_type_id`.
+- Records the user's participation against the round and its events
+ server-side and reports a prediction event to the operator's activity
+ stream.
+- Score is awarded after the operator resolves the round
+ (`GPRoundStatus` = `RoundResolved`).
+
+**Visitor mode**: not supported.
+
+**UI guidance**: see [UI Guide — `gamePickSubmitSelection`](../../docs/ui/gamepick/UIGuide_gamePickSubmitSelection.md).
+
+## Example
+```ts
+const ar = await window._smartico.api.gamePickGetActiveRound({
+    saw_template_id: 1190,
+    round_id:        38665,
+});
+if (ar.errCode !== 0 || !ar.data) {
+    console.error('[smartico] could not fetch round to submit — show error and bounce back');
+    return;
+}
+
+const round = ar.data;
+round.events = round.events.map(e => ({
+    gp_event_id:          e.gp_event_id,
+    team1_user_selection: 1,
+    team2_user_selection: 0,
+}));
+
+const r = await window._smartico.api.gamePickSubmitSelection({
+    saw_template_id: 1190,
+    round,
+});
+
+switch (r.errCode) {
+    case 0:
+        console.log('[smartico] predictions saved — show confirmation, refresh leaderboard');
+        break;
+    case 3:
+        console.log('[smartico] nothing changed (or all events closed) — silent no-op');
+        break;
+    case 40001:
+    case 40003:
+    case 40011:
+    case 40012:
+        console.error('[smartico] insufficient balance / spins — show top-up CTA:', r.errMessage);
+        break;
+    default:
+        console.error('[smartico] submit failed — show generic error toast:', r.errMessage);
+}
+```
+
+## Errors
+**Error codes** (in `errCode`)
+- `0` — success; the response `data` is the updated round with
+ `user_placed_bet === true` and `has_not_submitted_changes === false`.
+- `3` (`NoBetsUpdatedOnSubmit`) — submit produced no changes, OR every event
+ is past its `last_bet_date` deadline. The buy-in is NOT consumed; the
+ current round is still returned in `data`.
+- `4` — round / event not found; refresh state and retry.
+- `100002` — template not found.
+- `100000` — auth hash invalid.
+- `100004` — generic server error.
+
+Buy-in failures pass through the `SAWSpinErrorCode` values on first
+submit:
+- `40001` — no spins left (when `saw_buyin_type_id` is Spins).
+- `40003` — insufficient points.
+- `40004` — global max-spins cap hit.
+- `40007` — template outside its active date window.
+- `40009` — user excluded by segment rule.
+- `40011` — insufficient gems.
+- `40012` — insufficient diamonds.
+
+## Related
+- `SAWSpinErrorCode`
+- `GPRoundStatus`
+- `GamesApiResponse`