@smartico/public-api 0.0.356 → 0.0.357
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +33 -8
- package/dist/WSAPI/WSAPI.d.ts +26 -26
- package/dist/index.js +26 -26
- package/dist/index.js.map +1 -1
- package/dist/index.modern.mjs +26 -26
- package/dist/index.modern.mjs.map +1 -1
- package/docs/api/classes/WSAPI.md +19 -19
- package/package.json +1 -1
- package/src/WSAPI/WSAPI.ts +26 -26
|
@@ -1030,9 +1030,9 @@ _smartico.api.getActivityLog({
|
|
|
1030
1030
|
|
|
1031
1031
|
___
|
|
1032
1032
|
|
|
1033
|
-
###
|
|
1033
|
+
### gamePickGetActiveRounds
|
|
1034
1034
|
|
|
1035
|
-
▸ **
|
|
1035
|
+
▸ **gamePickGetActiveRounds**(`props`): `Promise`\<[`GamesApiResponse`](../interfaces/GamesApiResponse.md)\<[`GamePickRound`](../interfaces/GamePickRound.md)[]\>\>
|
|
1036
1036
|
|
|
1037
1037
|
Returns the active rounds for the specified MatchX or Quiz game.
|
|
1038
1038
|
Each round includes its events (matches/questions) along with the current user's selections and scores.
|
|
@@ -1049,9 +1049,9 @@ Each round includes its events (matches/questions) along with the current user's
|
|
|
1049
1049
|
|
|
1050
1050
|
___
|
|
1051
1051
|
|
|
1052
|
-
###
|
|
1052
|
+
### gamePickGetActiveRound
|
|
1053
1053
|
|
|
1054
|
-
▸ **
|
|
1054
|
+
▸ **gamePickGetActiveRound**(`props`): `Promise`\<[`GamesApiResponse`](../interfaces/GamesApiResponse.md)\<[`GamePickRound`](../interfaces/GamePickRound.md)\>\>
|
|
1055
1055
|
|
|
1056
1056
|
Returns a single active round for the specified MatchX or Quiz game.
|
|
1057
1057
|
The round includes full event details with the current user's selections.
|
|
@@ -1068,9 +1068,9 @@ The round includes full event details with the current user's selections.
|
|
|
1068
1068
|
|
|
1069
1069
|
___
|
|
1070
1070
|
|
|
1071
|
-
###
|
|
1071
|
+
### gamePickGetHistory
|
|
1072
1072
|
|
|
1073
|
-
▸ **
|
|
1073
|
+
▸ **gamePickGetHistory**(`props`): `Promise`\<[`GamesApiResponse`](../interfaces/GamesApiResponse.md)\<[`GamePickRound`](../interfaces/GamePickRound.md)[]\>\>
|
|
1074
1074
|
|
|
1075
1075
|
Returns the history of all rounds (including resolved ones) for the specified MatchX or Quiz game.
|
|
1076
1076
|
Each round contains full event details with results and the current user's predictions.
|
|
@@ -1087,9 +1087,9 @@ Each round contains full event details with results and the current user's predi
|
|
|
1087
1087
|
|
|
1088
1088
|
___
|
|
1089
1089
|
|
|
1090
|
-
###
|
|
1090
|
+
### gamePickGetBoard
|
|
1091
1091
|
|
|
1092
|
-
▸ **
|
|
1092
|
+
▸ **gamePickGetBoard**(`props`): `Promise`\<[`GamesApiResponse`](../interfaces/GamesApiResponse.md)\<[`GamePickRoundBoard`](../interfaces/GamePickRoundBoard.md)\>\>
|
|
1093
1093
|
|
|
1094
1094
|
Returns the leaderboard for a specific round within a MatchX or Quiz game.
|
|
1095
1095
|
Use `round_id = -1` (AllRoundsGameBoardID) to get the season/overall leaderboard across all rounds.
|
|
@@ -1106,9 +1106,9 @@ Use `round_id = -1` (AllRoundsGameBoardID) to get the season/overall leaderboard
|
|
|
1106
1106
|
|
|
1107
1107
|
___
|
|
1108
1108
|
|
|
1109
|
-
###
|
|
1109
|
+
### gamePickSubmitSelection
|
|
1110
1110
|
|
|
1111
|
-
▸ **
|
|
1111
|
+
▸ **gamePickSubmitSelection**(`props`): `Promise`\<[`GamesApiResponse`](../interfaces/GamesApiResponse.md)\<[`GamePickRound`](../interfaces/GamePickRound.md)\>\>
|
|
1112
1112
|
|
|
1113
1113
|
Submits score predictions for a round in a MatchX game.
|
|
1114
1114
|
Sends the round object with user selections for all events at once.
|
|
@@ -1128,9 +1128,9 @@ Predictions can be edited until each match starts (if `allow_edit_answers` is en
|
|
|
1128
1128
|
|
|
1129
1129
|
___
|
|
1130
1130
|
|
|
1131
|
-
###
|
|
1131
|
+
### gamePickSubmitSelectionQuiz
|
|
1132
1132
|
|
|
1133
|
-
▸ **
|
|
1133
|
+
▸ **gamePickSubmitSelectionQuiz**(`props`): `Promise`\<[`GamesApiResponse`](../interfaces/GamesApiResponse.md)\<[`GamePickRound`](../interfaces/GamePickRound.md)\>\>
|
|
1134
1134
|
|
|
1135
1135
|
Submits answers for a round in a Quiz game.
|
|
1136
1136
|
Sends the round object with user answers for all events at once.
|
|
@@ -1150,9 +1150,9 @@ Answers can be edited until each match starts (if `allow_edit_answers` is enable
|
|
|
1150
1150
|
|
|
1151
1151
|
___
|
|
1152
1152
|
|
|
1153
|
-
###
|
|
1153
|
+
### gamePickGetUserInfo
|
|
1154
1154
|
|
|
1155
|
-
▸ **
|
|
1155
|
+
▸ **gamePickGetUserInfo**(`props`): `Promise`\<[`GamesApiResponse`](../interfaces/GamesApiResponse.md)\<[`GamePickUserInfo`](../interfaces/GamePickUserInfo.md)\>\>
|
|
1156
1156
|
|
|
1157
1157
|
Returns the current user's profile information within the specified MatchX or Quiz game.
|
|
1158
1158
|
The user record is synced from the Smartico platform into the games DB (synced every 1 minute).
|
|
@@ -1170,9 +1170,9 @@ If the user doesn't exist in the games DB yet, it will be created automatically
|
|
|
1170
1170
|
|
|
1171
1171
|
___
|
|
1172
1172
|
|
|
1173
|
-
###
|
|
1173
|
+
### gamePickGetGameInfo
|
|
1174
1174
|
|
|
1175
|
-
▸ **
|
|
1175
|
+
▸ **gamePickGetGameInfo**(`props`): `Promise`\<[`GamesApiResponse`](../interfaces/GamesApiResponse.md)\<[`GamePickGameInfo`](../interfaces/GamePickGameInfo.md)\>\>
|
|
1176
1176
|
|
|
1177
1177
|
Returns the game configuration and the list of all rounds for the specified MatchX or Quiz game.
|
|
1178
1178
|
Includes the SAW template definition, label settings, and round metadata (without events).
|
|
@@ -1189,13 +1189,13 @@ Includes the SAW template definition, label settings, and round metadata (withou
|
|
|
1189
1189
|
|
|
1190
1190
|
___
|
|
1191
1191
|
|
|
1192
|
-
###
|
|
1192
|
+
### gamePickGetRoundInfoForUser
|
|
1193
1193
|
|
|
1194
|
-
▸ **
|
|
1194
|
+
▸ **gamePickGetRoundInfoForUser**(`props`): `Promise`\<[`GamesApiResponse`](../interfaces/GamesApiResponse.md)\<[`GamePickRound`](../interfaces/GamePickRound.md)\>\>
|
|
1195
1195
|
|
|
1196
1196
|
Returns round data with events and picks for a specific user (identified by their internal user ID).
|
|
1197
1197
|
Useful for viewing another user's predictions from the leaderboard.
|
|
1198
|
-
The `int_user_id` can be obtained from the `
|
|
1198
|
+
The `int_user_id` can be obtained from the `gamePickGetBoard` response (`users[].int_user_id`).
|
|
1199
1199
|
|
|
1200
1200
|
#### Parameters
|
|
1201
1201
|
|
package/package.json
CHANGED
package/src/WSAPI/WSAPI.ts
CHANGED
|
@@ -1097,7 +1097,7 @@ export class WSAPI {
|
|
|
1097
1097
|
*
|
|
1098
1098
|
* **Example**:
|
|
1099
1099
|
* ```
|
|
1100
|
-
* _smartico.api.
|
|
1100
|
+
* _smartico.api.gamePickGetActiveRounds({
|
|
1101
1101
|
* saw_template_id: 1083,
|
|
1102
1102
|
* }).then((result) => {
|
|
1103
1103
|
* console.log(result.data); // GamePickRound[]
|
|
@@ -1109,7 +1109,7 @@ export class WSAPI {
|
|
|
1109
1109
|
*
|
|
1110
1110
|
* **Visitor mode: not supported**
|
|
1111
1111
|
*/
|
|
1112
|
-
public async
|
|
1112
|
+
public async gamePickGetActiveRounds(props: GamePickRequestParams): Promise<GamesApiResponse<GamePickRound[]>> {
|
|
1113
1113
|
if (!props.saw_template_id) {
|
|
1114
1114
|
throw new Error('saw_template_id is required');
|
|
1115
1115
|
}
|
|
@@ -1125,12 +1125,12 @@ export class WSAPI {
|
|
|
1125
1125
|
*
|
|
1126
1126
|
* **Response** `GamesApiResponse<GamePickRound>`:
|
|
1127
1127
|
* - `errCode` - 0 on success
|
|
1128
|
-
* - `data` - Single round object with the same structure as in `
|
|
1128
|
+
* - `data` - Single round object with the same structure as in `gamePickGetActiveRounds`,
|
|
1129
1129
|
* including `events[]` with full event details, user selections, and resolution info
|
|
1130
1130
|
*
|
|
1131
1131
|
* **Example**:
|
|
1132
1132
|
* ```
|
|
1133
|
-
* _smartico.api.
|
|
1133
|
+
* _smartico.api.gamePickGetActiveRound({
|
|
1134
1134
|
* saw_template_id: 1083,
|
|
1135
1135
|
* round_id: 31652,
|
|
1136
1136
|
* }).then((result) => {
|
|
@@ -1141,7 +1141,7 @@ export class WSAPI {
|
|
|
1141
1141
|
*
|
|
1142
1142
|
* **Visitor mode: not supported**
|
|
1143
1143
|
*/
|
|
1144
|
-
public async
|
|
1144
|
+
public async gamePickGetActiveRound(props: GamePickRoundRequestParams): Promise<GamesApiResponse<GamePickRound>> {
|
|
1145
1145
|
if (!props.saw_template_id) {
|
|
1146
1146
|
throw new Error('saw_template_id is required');
|
|
1147
1147
|
}
|
|
@@ -1160,12 +1160,12 @@ export class WSAPI {
|
|
|
1160
1160
|
* **Response** `GamesApiResponse<GamePickRound[]>`:
|
|
1161
1161
|
* - `errCode` - 0 on success
|
|
1162
1162
|
* - `data` - Array of rounds ordered by `round_row_id` descending (newest first).
|
|
1163
|
-
* Each round has the same structure as in `
|
|
1163
|
+
* Each round has the same structure as in `gamePickGetActiveRounds`, including resolved events
|
|
1164
1164
|
* with `resolution_type_id` (0=None, 2=Lost, 3=PartialWin, 4=FullWin) and `resolution_score`
|
|
1165
1165
|
*
|
|
1166
1166
|
* **Example**:
|
|
1167
1167
|
* ```
|
|
1168
|
-
* _smartico.api.
|
|
1168
|
+
* _smartico.api.gamePickGetHistory({
|
|
1169
1169
|
* saw_template_id: 1083,
|
|
1170
1170
|
* }).then((result) => {
|
|
1171
1171
|
* result.data.forEach(round => {
|
|
@@ -1176,7 +1176,7 @@ export class WSAPI {
|
|
|
1176
1176
|
*
|
|
1177
1177
|
* **Visitor mode: not supported**
|
|
1178
1178
|
*/
|
|
1179
|
-
public async
|
|
1179
|
+
public async gamePickGetHistory(props: GamePickRequestParams): Promise<GamesApiResponse<GamePickRound[]>> {
|
|
1180
1180
|
if (!props.saw_template_id) {
|
|
1181
1181
|
throw new Error('saw_template_id is required');
|
|
1182
1182
|
}
|
|
@@ -1204,7 +1204,7 @@ export class WSAPI {
|
|
|
1204
1204
|
*
|
|
1205
1205
|
* **Example**:
|
|
1206
1206
|
* ```
|
|
1207
|
-
* _smartico.api.
|
|
1207
|
+
* _smartico.api.gamePickGetBoard({
|
|
1208
1208
|
* saw_template_id: 1083,
|
|
1209
1209
|
* round_id: 31652,
|
|
1210
1210
|
* }).then((result) => {
|
|
@@ -1215,7 +1215,7 @@ export class WSAPI {
|
|
|
1215
1215
|
*
|
|
1216
1216
|
* **Visitor mode: not supported**
|
|
1217
1217
|
*/
|
|
1218
|
-
public async
|
|
1218
|
+
public async gamePickGetBoard(props: GamePickRoundRequestParams): Promise<GamesApiResponse<GamePickRoundBoard>> {
|
|
1219
1219
|
if (!props.saw_template_id) {
|
|
1220
1220
|
throw new Error('saw_template_id is required');
|
|
1221
1221
|
}
|
|
@@ -1233,7 +1233,7 @@ export class WSAPI {
|
|
|
1233
1233
|
* Predictions can be edited until each match starts (if `allow_edit_answers` is enabled on the round).
|
|
1234
1234
|
*
|
|
1235
1235
|
* @param props.saw_template_id - The ID of the MatchX game template
|
|
1236
|
-
* @param props.round - Round object containing `round_id` and `events[]`. Typically obtained from `
|
|
1236
|
+
* @param props.round - Round object containing `round_id` and `events[]`. Typically obtained from `gamePickGetActiveRound`
|
|
1237
1237
|
* and modified with user predictions. Each event needs: `gp_event_id`, `team1_user_selection`, `team2_user_selection`
|
|
1238
1238
|
*
|
|
1239
1239
|
* **Response** `GamesApiResponse<GamePickRound>`:
|
|
@@ -1243,7 +1243,7 @@ export class WSAPI {
|
|
|
1243
1243
|
*
|
|
1244
1244
|
* **Example**:
|
|
1245
1245
|
* ```
|
|
1246
|
-
* _smartico.api.
|
|
1246
|
+
* _smartico.api.gamePickGetActiveRound({
|
|
1247
1247
|
* saw_template_id: 1190,
|
|
1248
1248
|
* round_id: 38665,
|
|
1249
1249
|
* }).then((roundData) => {
|
|
@@ -1253,7 +1253,7 @@ export class WSAPI {
|
|
|
1253
1253
|
* team1_user_selection: 1,
|
|
1254
1254
|
* team2_user_selection: 0,
|
|
1255
1255
|
* }));
|
|
1256
|
-
* _smartico.api.
|
|
1256
|
+
* _smartico.api.gamePickSubmitSelection({
|
|
1257
1257
|
* saw_template_id: 1190,
|
|
1258
1258
|
* round: round,
|
|
1259
1259
|
* }).then((result) => {
|
|
@@ -1264,7 +1264,7 @@ export class WSAPI {
|
|
|
1264
1264
|
*
|
|
1265
1265
|
* **Visitor mode: not supported**
|
|
1266
1266
|
*/
|
|
1267
|
-
public async
|
|
1267
|
+
public async gamePickSubmitSelection(props: GamePickRequestParams & { round: Partial<GamePickRound> }): Promise<GamesApiResponse<GamePickRound>> {
|
|
1268
1268
|
if (!props.saw_template_id) {
|
|
1269
1269
|
throw new Error('saw_template_id is required');
|
|
1270
1270
|
}
|
|
@@ -1282,7 +1282,7 @@ export class WSAPI {
|
|
|
1282
1282
|
* Answers can be edited until each match starts (if `allow_edit_answers` is enabled on the round).
|
|
1283
1283
|
*
|
|
1284
1284
|
* @param props.saw_template_id - The ID of the Quiz game template
|
|
1285
|
-
* @param props.round - Round object containing `round_id` and `events[]`. Typically obtained from `
|
|
1285
|
+
* @param props.round - Round object containing `round_id` and `events[]`. Typically obtained from `gamePickGetActiveRound`
|
|
1286
1286
|
* and modified with user answers. Each event needs: `gp_event_id`, `user_selection`
|
|
1287
1287
|
*
|
|
1288
1288
|
* **Response** `GamesApiResponse<GamePickRound>`:
|
|
@@ -1292,7 +1292,7 @@ export class WSAPI {
|
|
|
1292
1292
|
*
|
|
1293
1293
|
* **Example**:
|
|
1294
1294
|
* ```
|
|
1295
|
-
* _smartico.api.
|
|
1295
|
+
* _smartico.api.gamePickGetActiveRound({
|
|
1296
1296
|
* saw_template_id: 1183,
|
|
1297
1297
|
* round_id: 37974,
|
|
1298
1298
|
* }).then((roundData) => {
|
|
@@ -1301,7 +1301,7 @@ export class WSAPI {
|
|
|
1301
1301
|
* gp_event_id: e.gp_event_id,
|
|
1302
1302
|
* user_selection: 'x',
|
|
1303
1303
|
* }));
|
|
1304
|
-
* _smartico.api.
|
|
1304
|
+
* _smartico.api.gamePickSubmitSelectionQuiz({
|
|
1305
1305
|
* saw_template_id: 1183,
|
|
1306
1306
|
* round: round,
|
|
1307
1307
|
* }).then((result) => {
|
|
@@ -1312,7 +1312,7 @@ export class WSAPI {
|
|
|
1312
1312
|
*
|
|
1313
1313
|
* **Visitor mode: not supported**
|
|
1314
1314
|
*/
|
|
1315
|
-
public async
|
|
1315
|
+
public async gamePickSubmitSelectionQuiz(props: GamePickRequestParams & { round: Partial<GamePickRound> }): Promise<GamesApiResponse<GamePickRound>> {
|
|
1316
1316
|
if (!props.saw_template_id) {
|
|
1317
1317
|
throw new Error('saw_template_id is required');
|
|
1318
1318
|
}
|
|
@@ -1344,7 +1344,7 @@ export class WSAPI {
|
|
|
1344
1344
|
*
|
|
1345
1345
|
* **Example**:
|
|
1346
1346
|
* ```
|
|
1347
|
-
* _smartico.api.
|
|
1347
|
+
* _smartico.api.gamePickGetUserInfo({
|
|
1348
1348
|
* saw_template_id: 1083,
|
|
1349
1349
|
* }).then((result) => {
|
|
1350
1350
|
* console.log(result.data.public_username, result.data.ach_points_balance);
|
|
@@ -1353,7 +1353,7 @@ export class WSAPI {
|
|
|
1353
1353
|
*
|
|
1354
1354
|
* **Visitor mode: not supported**
|
|
1355
1355
|
*/
|
|
1356
|
-
public async
|
|
1356
|
+
public async gamePickGetUserInfo(props: GamePickRequestParams): Promise<GamesApiResponse<GamePickUserInfo>> {
|
|
1357
1357
|
if (!props.saw_template_id) {
|
|
1358
1358
|
throw new Error('saw_template_id is required');
|
|
1359
1359
|
}
|
|
@@ -1383,7 +1383,7 @@ export class WSAPI {
|
|
|
1383
1383
|
*
|
|
1384
1384
|
* **Example**:
|
|
1385
1385
|
* ```
|
|
1386
|
-
* _smartico.api.
|
|
1386
|
+
* _smartico.api.gamePickGetGameInfo({
|
|
1387
1387
|
* saw_template_id: 1189,
|
|
1388
1388
|
* }).then((result) => {
|
|
1389
1389
|
* console.log(result.data.sawTemplate.saw_template_ui_definition.name);
|
|
@@ -1394,7 +1394,7 @@ export class WSAPI {
|
|
|
1394
1394
|
*
|
|
1395
1395
|
* **Visitor mode: not supported**
|
|
1396
1396
|
*/
|
|
1397
|
-
public async
|
|
1397
|
+
public async gamePickGetGameInfo(props: GamePickRequestParams): Promise<GamesApiResponse<GamePickGameInfo>> {
|
|
1398
1398
|
if (!props.saw_template_id) {
|
|
1399
1399
|
throw new Error('saw_template_id is required');
|
|
1400
1400
|
}
|
|
@@ -1404,7 +1404,7 @@ export class WSAPI {
|
|
|
1404
1404
|
/**
|
|
1405
1405
|
* Returns round data with events and picks for a specific user (identified by their internal user ID).
|
|
1406
1406
|
* Useful for viewing another user's predictions from the leaderboard.
|
|
1407
|
-
* The `int_user_id` can be obtained from the `
|
|
1407
|
+
* The `int_user_id` can be obtained from the `gamePickGetBoard` response (`users[].int_user_id`).
|
|
1408
1408
|
*
|
|
1409
1409
|
* @param props.saw_template_id - The ID of the MatchX or Quiz game template
|
|
1410
1410
|
* @param props.round_id - The round to get info for
|
|
@@ -1413,13 +1413,13 @@ export class WSAPI {
|
|
|
1413
1413
|
* **Response** `GamesApiResponse<GamePickRound>`:
|
|
1414
1414
|
* - `errCode` - 0 on success
|
|
1415
1415
|
* - `data` - Round object with the target user's selections.
|
|
1416
|
-
* Same structure as `
|
|
1416
|
+
* Same structure as `gamePickGetActiveRound`, but `user_selection`/`team1_user_selection`/`team2_user_selection`
|
|
1417
1417
|
* fields on events reflect the specified user's picks instead of the current user's.
|
|
1418
1418
|
* Events also include `resolution_type_id` (0=None, 2=Lost, 3=PartialWin, 4=FullWin) showing how each prediction was scored
|
|
1419
1419
|
*
|
|
1420
1420
|
* **Example**:
|
|
1421
1421
|
* ```
|
|
1422
|
-
* _smartico.api.
|
|
1422
|
+
* _smartico.api.gamePickGetRoundInfoForUser({
|
|
1423
1423
|
* saw_template_id: 1083,
|
|
1424
1424
|
* round_id: 31652,
|
|
1425
1425
|
* int_user_id: 65653810,
|
|
@@ -1432,7 +1432,7 @@ export class WSAPI {
|
|
|
1432
1432
|
*
|
|
1433
1433
|
* **Visitor mode: not supported**
|
|
1434
1434
|
*/
|
|
1435
|
-
public async
|
|
1435
|
+
public async gamePickGetRoundInfoForUser(props: GamePickRoundRequestParams & { int_user_id: number }): Promise<GamesApiResponse<GamePickRound>> {
|
|
1436
1436
|
if (!props.saw_template_id) {
|
|
1437
1437
|
throw new Error('saw_template_id is required');
|
|
1438
1438
|
}
|