@smartico/public-api 0.0.379 → 0.0.381

package/docs/api/interfaces/TBonus.md

@@ -1,12 +1,15 @@
 # Interface: TBonus
 
+TBonus describes one bonus awarded to the user.
+Returned by `_smartico.api.getBonuses()`.
+
 ## Properties
 
 ### bonus\_id
 
 > **bonus\_id**: `number`
 
-ID of the bonus
+Stable ID of the bonus.
 
 ***
 
@@ -14,7 +17,8 @@ ID of the bonus
 
 > `optional` **is\_redeemable?**: `boolean`
 
-Can the bonus be redeemed (if bonus is redeemable the user needs to claim it)
+`true` when the bonus is in a player-claim-required state.
+Gate the Claim button on this; see `claimBonus` TSDoc.
 
 ***
 
@@ -22,7 +26,8 @@ Can the bonus be redeemed (if bonus is redeemable the user needs to claim it)
 
 > `optional` **create\_date?**: `string`
 
-Date of creation
+Bonus creation timestamp as ISO 8601 UTC string
+("YYYY-MM-DDTHH:MM:SS", no timezone suffix).
 
 ***
 
@@ -30,7 +35,8 @@ Date of creation
 
 > `optional` **redeem\_date?**: `string`
 
-Date of redemption
+Bonus redemption timestamp as ISO 8601 UTC string. Absent until
+the bonus reaches `BonusStatus.REDEEMED`.
 
 ***
 
@@ -38,7 +44,7 @@ Date of redemption
 
 > `optional` **label\_bonus\_template\_id?**: `number`
 
-ID of template used
+ID of the bonus template used to issue this bonus.
 
 ***
 
@@ -46,7 +52,7 @@ ID of template used
 
 > `optional` **bonus\_status\_id?**: [`BonusStatus`](../enumerations/BonusStatus-1.md)
 
-ID of the bonus status
+Lifecycle status; see [BonusStatus](../enumerations/BonusStatus-1.md).
 
 ***
 
@@ -54,7 +60,8 @@ ID of the bonus status
 
 > `optional` **label\_bonus\_template\_meta\_map?**: [`BonusTemplateMetaMap`](BonusTemplateMetaMap-1.md)
 
-Additional information about the bonus(edscription, image,name, acknowledge)
+Template-level display metadata (operator-configured, identical
+across all bonuses from the same template).
 
 ***
 
@@ -62,4 +69,5 @@ Additional information about the bonus(edscription, image,name, acknowledge)
 
 > `optional` **bonus\_meta\_map?**: [`BonusMetaMap`](BonusMetaMap-1.md)
 
-Additional information presented to the player when the bonus is redeemed
+Instance-level display metadata (per-issuance; carries the
+dynamic amount computed at award time).

package/docs/api/interfaces/TBuyStoreItemResult.md

@@ -1,21 +1,14 @@
 # Interface: TBuyStoreItemResult
 
+Result of `_smartico.api.buyStoreItem(store_item_id)`.
+
 ## Properties
 
 ### err\_code
 
 > **err\_code**: [`BuyStoreItemErrorCode`](../enumerations/BuyStoreItemErrorCode.md)
 
-Error code representing the result of the purchase of the shop item. Successful purchase if err_code is 0 
-
-Example for error handling:
-```javascript
-SmarticoAPI.buyStoreItem(item_id).then(res => {
-  if (res.err_code !== 0) {
-    // YOUR LOGIC HERE, you can use res.err_message, but it's optional and not always present
-  }
-});
-```
+Error code. `0` = success. See `buyStoreItem` TSDoc for the full table.
 
 ***
 
@@ -23,4 +16,4 @@ SmarticoAPI.buyStoreItem(item_id).then(res => {
 
 > **err\_message**: `string`
 
-Optional error message
+Optional error message; populated on non-zero `err_code`.

package/docs/api/interfaces/TClaimBonusResult.md

@@ -1,14 +1,14 @@
 # Interface: TClaimBonusResult
 
-TClaimBonusResult describes the response of call to _smartico.api.claimBonus(bonus_id) method
+Result of `_smartico.api.claimBonus(bonus_id)`.
 
 ## Properties
 
 ### err\_code
 
-> **err\_code**: [`SAWSpinErrorCode`](../enumerations/SAWSpinErrorCode.md)
+> **err\_code**: `number`
 
-Error code that represents outcome of the game play attempt. Game succeed to be played in case err_code is 0
+Error code. `0` = success. See `claimBonus` TSDoc for the full table.
 
 ***
 
@@ -16,7 +16,7 @@ Error code that represents outcome of the game play attempt. Game succeed to be
 
 > **err\_message**: `string`
 
-Optional error message
+Optional error message; populated on non-zero `err_code`.
 
 ***
 
@@ -24,4 +24,4 @@ Optional error message
 
 > `optional` **success?**: `boolean`
 
-If the bonus was claimed successfully, then success is true
+Unreliable on the wire — prefer `err_code === 0` as the success check.

package/docs/api/interfaces/TClan.md

@@ -52,7 +52,8 @@ Max number of members allowed in clan
 
 > **entry\_fee\_currency\_type\_id**: `number`
 
-ShopPurchaseType: 0=Points, 1=Gems, 2=Diamonds, 3=Free
+Currency type for `entry_fee_amount`. `0` = points, `1` = gems,
+`2` = diamonds, `3` = free (no fee).
 
 ***
 
@@ -60,7 +61,8 @@ ShopPurchaseType: 0=Points, 1=Gems, 2=Diamonds, 3=Free
 
 > **entry\_fee\_amount**: `number`
 
-Numeric value for entry fee
+Entry fee amount in the currency indicated by `entry_fee_currency_type_id`.
+`0` (or `entry_fee_currency_type_id === 3`) means the clan is free to join.
 
 ***
 
@@ -68,7 +70,9 @@ Numeric value for entry fee
 
 > **rating\_position**: `number`
 
-F1 rank ASC, 1=best
+Global rank among all active clans in the label, by `rating_score` DESC.
+`1` = highest-rated. May skip positions when some clans are hidden by
+per-user visibility (e.g. user sees positions 1, 3, 7).
 
 ***
 
@@ -76,4 +80,4 @@ F1 rank ASC, 1=best
 
 > **rating\_score**: `number`
 
-Clan rating score
+Clan rating score (higher is better).

package/docs/api/interfaces/TClanInfo.md

@@ -1,6 +1,7 @@
 # Interface: TClanInfo
 
 TClanInfo describes the detailed info of a single clan including its members.
+Returned by `_smartico.api.getClanInfo(clanId)`.
 
 ## Properties
 
@@ -8,12 +9,16 @@ TClanInfo describes the detailed info of a single clan including its members.
 
 > **clan\_id**: `number`
 
+Clan ID.
+
 ***
 
 ### public\_meta
 
 > **public\_meta**: `object`
 
+Translated clan metadata (name, description, image URL).
+
 #### name
 
 > **name**: `string`
@@ -32,80 +37,122 @@ TClanInfo describes the detailed info of a single clan including its members.
 
 > **member\_count**: `number`
 
+Current number of members in clan.
+
 ***
 
 ### capacity\_limit
 
 > **capacity\_limit**: `number`
 
+Max number of members allowed in clan.
+
 ***
 
 ### entry\_fee\_currency\_type\_id
 
 > **entry\_fee\_currency\_type\_id**: `number`
 
+Currency type for `entry_fee_amount`. `0` = points, `1` = gems,
+`2` = diamonds, `3` = free.
+
 ***
 
 ### entry\_fee\_amount
 
 > **entry\_fee\_amount**: `number`
 
+Entry fee amount in the currency indicated by `entry_fee_currency_type_id`.
+
 ***
 
 ### rating\_position
 
 > **rating\_position**: `number`
 
+Global rank among all active clans in the label, by `rating_score` DESC.
+`1` = highest-rated.
+
 ***
 
 ### rating\_score
 
 > **rating\_score**: `number`
 
+Clan rating score (higher is better).
+
 ***
 
 ### cooldown\_until
 
 > **cooldown\_until**: `string`
 
+User-level switch-cooldown expiry as ISO 8601 UTC string
+("YYYY-MM-DDTHH:MM:SS" with no timezone suffix). `null` when no
+cooldown. Same semantic as `TClans.cooldown_until` but always fresh
+(the list version may be up to 30 s stale).
+
 ***
 
 ### members
 
 > **members**: `object`[]
 
+Members of this clan, server-ordered by `contribution_score` DESC
+(i.e. `position` ASC).
+
 #### user\_id
 
 > **user\_id**: `number`
 
+Member's internal user ID.
+
 #### public\_username
 
 > **public\_username**: `string`
 
+Member's display username.
+
 #### avatar\_id
 
 > **avatar\_id**: `string`
 
+Avatar identifier; resolve via `avatar_url` below or rebuild
+from `avatar_id` + brand avatar domain.
+
 #### avatar\_real\_id
 
 > **avatar\_real\_id**: `number`
 
+Numeric avatar ID (alternative identifier).
+
 #### avatar\_url?
 
 > `optional` **avatar\_url?**: `string`
 
+Pre-resolved CDN URL for the avatar.
+
 #### position
 
 > **position**: `number`
 
+Member's rank within this clan; `1` = top contributor.
+
 #### contribution\_score
 
 > **contribution\_score**: `number`
 
+Member's contribution to the clan rating score.
+
 #### is\_me?
 
 > `optional` **is\_me?**: `boolean`
 
+`true` when this row is the current authenticated user.
+
 #### clean\_ext\_user\_id?
 
 > `optional` **clean\_ext\_user\_id?**: `string`
+
+External user identifier (operator-provided alias);
+preferred over `public_username` on some surfaces.

package/docs/api/interfaces/TClanJoinResult.md

@@ -1,6 +1,9 @@
 # Interface: TClanJoinResult
 
-TClanJoinResult describes the result of a join clan request.
+TClanJoinResult describes the result of a join-clan request.
+Note: this type uses `errCode` / `errMsg` (camelCase) — different
+from most other SDK result types in this library which use
+`err_code` / `err_message` (snake_case).
 
 ## Properties
 
@@ -8,8 +11,15 @@ TClanJoinResult describes the result of a join clan request.
 
 > **errCode**: `number`
 
+Error code. `0` = success. Typed values are members of
+[JoinClanErrorCode](../enumerations/JoinClanErrorCode.md). See `joinClan` TSDoc for the full
+table and per-code UI guidance.
+
 ***
 
 ### errMsg
 
 > **errMsg**: `string`
+
+Optional server-side error message. Present only on non-zero
+`errCode`; may be empty even then.

package/docs/api/interfaces/TClanTournamentPlayer.md

@@ -0,0 +1,55 @@
+# Interface: TClanTournamentPlayer
+
+## Properties
+
+### user\_id
+
+> **user\_id**: `number`
+
+***
+
+### clean\_ext\_user\_id
+
+> **clean\_ext\_user\_id**: `string`
+
+***
+
+### public\_username
+
+> **public\_username**: `string`
+
+***
+
+### avatar\_id
+
+> **avatar\_id**: `string`
+
+***
+
+### avatar\_real\_id
+
+> **avatar\_real\_id**: `number`
+
+***
+
+### avatar\_url?
+
+> `optional` **avatar\_url?**: `string`
+
+***
+
+### position
+
+> **position**: `number`
+
+***
+
+### scores
+
+> **scores**: `number`
+
+***
+
+### is\_me
+
+> **is\_me**: `boolean`

package/docs/api/interfaces/TClanTournamentPlayersResult.md

@@ -0,0 +1,27 @@
+# Interface: TClanTournamentPlayersResult
+
+## Properties
+
+### clan\_id
+
+> **clan\_id**: `number`
+
+***
+
+### clan\_public\_meta
+
+> **clan\_public\_meta**: `object`
+
+#### name
+
+> **name**: `string`
+
+#### image\_url
+
+> **image\_url**: `string`
+
+***
+
+### players
+
+> **players**: [`TClanTournamentPlayer`](TClanTournamentPlayer.md)[]

package/docs/api/interfaces/TClans.md

@@ -24,7 +24,9 @@ The clan ID the current user belongs to; null if clanless
 
 > **cooldown\_until**: `string`
 
-Cooldown-until date string; null if no cooldown
+Switch-cooldown expiry as ISO 8601 UTC string ("YYYY-MM-DDTHH:MM:SS"
+with no timezone suffix; interpret as UTC). `null` when no cooldown.
+User-level: while set, the user cannot join any clan.
 
 ***
 

package/docs/api/interfaces/TGetTranslations.md

@@ -1,11 +1,15 @@
 # Interface: TGetTranslations
 
+Result of `getTranslations(lang_code)`.
+
 ## Properties
 
 ### translations
 
 > **translations**: `object`
 
+Flat dictionary of operator-defined translation key → translated string.
+
 #### Index Signature
 
 \[`key`: `string`\]: `string`

package/docs/api/interfaces/TInboxMessage.md

@@ -1,12 +1,18 @@
 # Interface: TInboxMessage
 
+TInboxMessage is the lightweight envelope returned by
+`_smartico.api.getInboxMessages()`. Fetch the rich body (title,
+preview, icon, html_body, buttons) separately via
+`_smartico.api.getInboxMessageBody(message_guid)`.
+
 ## Properties
 
 ### message\_guid
 
 > **message\_guid**: `string`
 
-Uniq identifier of the message. It is needed to request the message body, mark the message as read/deleted/favorite.
+Unique identifier of the message. Pass to `getInboxMessageBody`
+and the mark / favorite / delete mutations.
 
 ***
 
@@ -14,7 +20,7 @@ Uniq identifier of the message. It is needed to request the message body, mark t
 
 > **sent\_date**: `string`
 
-Date when the message was sent
+Date when the message was sent (server timestamp).
 
 ***
 
@@ -22,7 +28,7 @@ Date when the message was sent
 
 > **read**: `boolean`
 
-Indicator if a message is read
+`true` when the message has been marked read.
 
 ***
 
@@ -30,7 +36,7 @@ Indicator if a message is read
 
 > **favorite**: `boolean`
 
-Indicator if a message is added to favorites
+`true` when the message has been starred (favorited).
 
 ***
 
@@ -38,7 +44,7 @@ Indicator if a message is added to favorites
 
 > `optional` **category\_id?**: [`InboxCategories`](../enumerations/InboxCategories.md)
 
-Category id per inbox message, can be part of System inboxes, Personal inboxes or General inbox messages
+Operator-assigned category ([InboxCategories](../enumerations/InboxCategories.md)).
 
 ***
 
@@ -46,4 +52,6 @@ Category id per inbox message, can be part of System inboxes, Personal inboxes o
 
 > `optional` **expire\_on\_dt?**: `number`
 
-The epoch timestamp, with milliseconds, when the message is going to be expired
+Expiry timestamp as Unix-ms epoch. Server filters out expired
+messages from list responses — consumers rarely see this set
+unless the expiry is upcoming.

package/docs/api/interfaces/TInboxMessageBody.md

@@ -1,12 +1,16 @@
 # Interface: TInboxMessageBody
 
+TInboxMessageBody is the rich body of one inbox message.
+Returned by `_smartico.api.getInboxMessageBody(message_guid)`.
+Fetched from a CDN (not over WebSocket).
+
 ## Properties
 
 ### title
 
 > **title**: `string`
 
-Message title
+Display title.
 
 ***
 
@@ -14,7 +18,7 @@ Message title
 
 > **preview\_body**: `string`
 
-Short preview body of the message
+Short preview text (typically rendered alongside the title in list items).
 
 ***
 
@@ -22,7 +26,7 @@ Short preview body of the message
 
 > **icon**: `string`
 
-Message icon, 128x128px
+Message icon URL (128×128 px recommended).
 
 ***
 
@@ -30,10 +34,10 @@ Message icon, 128x128px
 
 > **action**: `string`
 
-The action that should be performed when user clicks on the message.
-Can be URL or deep link, e.g. 'dp:deposit'. The most safe to execute CTA is to pass it to _smartico.dp(cta_action);
-The 'dp' function will handle the CTA and will execute it in the most safe way.
-If the message has a rich html body - the action will always be 'dp:inbox' which will open the inbox widget when triggered.
+Click-action — either a deep-link (e.g. `'dp:deposit'`) or a
+plain URL. The literal `'dp:inbox'` indicates the message has a
+rich `html_body`; for any other value `html_body` and `buttons`
+are absent. Pass to `_smartico.dp(action)` for safe execution.
 
 ***
 
@@ -41,7 +45,7 @@ If the message has a rich html body - the action will always be 'dp:inbox' which
 
 > `optional` **html\_body?**: `string`
 
-Rich HTML body of the message.
+Rich HTML body. Populated only when `action === 'dp:inbox'`.
 
 ***
 
@@ -49,19 +53,20 @@ Rich HTML body of the message.
 
 > `optional` **buttons?**: `object`[]
 
-Optional additional buttons to show in the message, available only if message has rich HTML body. Max count - 2.
+Up to 2 additional action buttons. Populated only when
+`action === 'dp:inbox'`.
 
 #### action
 
 > **action**: `string`
 
-The action that should be performed when user clicks on the button. The logic is the same as for message actions
+Button click-action (deep-link or URL).
 
 #### text
 
 > **text**: `string`
 
-Button text
+Button label.
 
 ***
 
@@ -69,4 +74,5 @@ Button text
 
 > `optional` **custom\_data?**: `string`
 
-The custom data of the inbox message defined by operator. Can be a JSON object, string or number
+Operator-defined custom data. The SDK auto-parses JSON-looking
+strings, so at runtime this is `any` despite the `string` type.