@smartico/public-api 0.0.167 → 0.0.168

package/docs/README.md

@@ -32,6 +32,7 @@
 - [JackpotsOptoutResponse](interfaces/JackpotsOptoutResponse.md)
 - [TMiniGamePrize](interfaces/TMiniGamePrize.md)
 - [TMiniGamePlayResult](interfaces/TMiniGamePlayResult.md)
+- [TMiniGamePlayBatchResult](interfaces/TMiniGamePlayBatchResult.md)
 - [TMiniGameTemplate](interfaces/TMiniGameTemplate.md)
 - [TUserProfile](interfaces/TUserProfile.md)
 - [TLevel](interfaces/TLevel.md)

package/docs/classes/WSAPI.md

@@ -435,6 +435,27 @@ Plays the specified by template_id mini-game on behalf of user and returns prize
 
 ___
 
+### playMiniGameBatch
+
+▸ **playMiniGameBatch**(`template_id`, `spin_count`): `Promise`\<[`TMiniGamePlayBatchResult`](../interfaces/TMiniGamePlayBatchResult.md)[]\>
+
+Plays the specified by template_id mini-game on behalf of user {count} times and returns prizes or err_code
+
+**Visitor mode: not supported**
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `template_id` | `number` |
+| `spin_count` | `number` |
+
+#### Returns
+
+`Promise`\<[`TMiniGamePlayBatchResult`](../interfaces/TMiniGamePlayBatchResult.md)[]\>
+
+___
+
 ### requestMissionOptIn
 
 ▸ **requestMissionOptIn**(`mission_id`): `Promise`\<[`TMissionOptInResult`](../interfaces/TMissionOptInResult.md)\>

package/docs/interfaces/TMiniGamePlayBatchResult.md

@@ -0,0 +1,43 @@
+# Interface: TMiniGamePlayBatchResult
+
+TMiniGamePlayBatchResult describes the response of call to _smartico.api.playMiniGameBatch(template_id, spin_count) method
+
+## Properties
+
+### saw\_prize\_id
+
+• **saw\_prize\_id**: `number`
+
+The saw_prize_id that user won, details of the prize can be found in the mini-game definition
+
+___
+
+### errCode
+
+• **errCode**: [`SAWSpinErrorCode`](../enums/SAWSpinErrorCode.md)
+
+Error code that represents outcome of the game play attempt. Game succeed to be played in case err_code is 0
+
+___
+
+### errMessage
+
+• `Optional` **errMessage**: `string`
+
+Optional error message
+
+___
+
+### jackpot\_amount
+
+• `Optional` **jackpot\_amount**: `number`
+
+Jackpot amount what user won
+
+___
+
+### first\_spin\_in\_period
+
+• `Optional` **first\_spin\_in\_period**: `number`
+
+Period in miliseconds from last spin

package/package.json

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

package/src/Base/ClassId.ts

@@ -121,6 +121,10 @@ export enum ClassId {
 	SAW_PRIZE_DROP_WIN_AKNOWLEDGE_REQUEST = 709,
 	SAW_PRIZE_DROP_WIN_AKNOWLEDGE_RESPONSE = 710,
 	SAW_AKNOWLEDGE_SPIN_PUSH = 711,
+	SAW_DO_SPIN_BATCH_REQUEST = 712,
+	SAW_DO_SPIN_BATCH_RESPONSE = 713,
+	SAW_AKNOWLEDGE_BATCH_REQUEST = 714,
+	SAW_AKNOWLEDGE_BATCH_RESPONSE = 715,
 
 	/*
         !Important, if adding new messages that are 'acting' on behalf of the client,

package/src/MiniGames/SAWDoAcknowledgeBatchRequest.ts

@@ -0,0 +1,5 @@
+import { ProtocolRequest } from '../Base/ProtocolRequest';
+
+export interface SAWDoAcknowledgeBatchRequest extends ProtocolRequest {
+	request_ids: string[];
+}

package/src/MiniGames/SAWDoAcknowledgeBatchResponse.ts

@@ -0,0 +1,5 @@
+import { ProtocolRequest } from '../Base/ProtocolRequest';
+
+export interface SAWDoAcknowledgeBatchResponse extends ProtocolRequest {
+	results: Array<{ request_id: string, errCode: number, errMessage?: string }>;
+}

package/src/MiniGames/SAWDoSpinBatchRequest.ts

@@ -0,0 +1,5 @@
+import { ProtocolMessage } from 'src/SmarticoLib';
+
+export interface SAWDoSpinBatchRequest extends ProtocolMessage {
+	spins: Array<{ request_id: string, saw_template_id: number }>;
+}

package/src/MiniGames/SAWDoSpinBatchResponse.ts

@@ -0,0 +1,8 @@
+import { ProtocolResponse } from '../Base/ProtocolResponse';
+import { SAWDoSpinResponse } from './SAWDoSpinResponse';
+import { SAWSpinErrorCode } from './SAWSpinErrorCode';
+
+export interface SAWDoSpinBatchResponse extends ProtocolResponse {
+	results: SAWDoSpinResponse[];
+	errCode: SAWSpinErrorCode,
+}

package/src/SmarticoAPI.ts

@@ -109,6 +109,10 @@ import {
 import { GetCustomSectionsRequest, GetCustomSectionsResponse, UICustomSectionTransform } from './CustomSections';
 import { BonusItemsTransform, ClaimBonusRequest, ClaimBonusResponse, GetBonusesResponse } from './Bonuses';
 import { GetBonusesRequest } from './Bonuses/GetBonusesRequest';
+import { SAWDoSpinBatchResponse } from './MiniGames/SAWDoSpinBatchResponse';
+import { SAWDoSpinBatchRequest } from './MiniGames/SAWDoSpinBatchRequest';
+import { SAWDoAcknowledgeBatchRequest } from './MiniGames/SAWDoAcknowledgeBatchRequest';
+import { SAWDoAcknowledgeBatchResponse } from './MiniGames/SAWDoAcknowledgeBatchResponse';
 import { GetRelatedAchTourRequest } from './Missions/GetRelatedAchTourRequest';
 import { GetRelatedAchTourResponse } from './Missions/GetRelatedAchTourResponse';
 
@@ -539,6 +543,47 @@ class SmarticoAPI {
 		return { ...spinAttemptResponse, request_id };
 	}
 
+
+	public async doAcknowledgeBatchRequest(user_ext_id: string, request_ids: string[]): Promise<SAWDoAcknowledgeBatchResponse> {
+		const message = this.buildMessage<SAWDoAcknowledgeBatchRequest, SAWDoAcknowledgeBatchResponse>(
+			user_ext_id,
+			ClassId.SAW_AKNOWLEDGE_REQUEST,
+			{
+				request_ids,
+			},
+		);
+
+		return await this.send<SAWDoAcknowledgeBatchResponse>(message, ClassId.SAW_AKNOWLEDGE_BATCH_RESPONSE);
+	}
+
+	public async sawSpinBatchRequest(user_ext_id: string, saw_template_id: number, spins_count: number): Promise<SAWDoSpinBatchResponse> {
+
+		const spins = [];
+		for (let i = 0; i < spins_count; i++) {
+			const request_id = IntUtils.uuid();
+			spins.push({ request_id, saw_template_id })
+		}
+
+		const message = this.buildMessage<SAWDoSpinBatchRequest, SAWDoSpinBatchResponse>(user_ext_id, ClassId.SAW_DO_SPIN_BATCH_REQUEST, { spins });
+		const spinAttemptResponse = await this.send<SAWDoSpinBatchResponse>(message, ClassId.SAW_DO_SPIN_BATCH_RESPONSE);
+
+		// If one response is 'OK' we consider that whole result is 'OK'
+		const result = spinAttemptResponse.results.find((res) => res.errCode === 0);
+
+		let status = 'OK';
+		if (!result) {
+			status = 'BATCH FAIL';
+		}
+
+		await this.coreReportCustomEvent(user_ext_id, 'minigame_attempt', {
+			saw_template_id,
+			status,
+			spins_count,
+		});
+
+		return { ...spinAttemptResponse };
+	}
+
 	public async missionOptIn(user_ext_id: string, mission_id: number) {
 		if (!mission_id) {
 			throw new Error('Missing mission id');

package/src/WSAPI/WSAPI.ts

@@ -26,7 +26,8 @@ import {
 	TUICustomSection,
 	TUserProfile,
 	UserLevelExtraCountersT,TBonus,
-	TClaimBonusResult
+	TClaimBonusResult,
+	TMiniGamePlayBatchResult
 } from './WSAPITypes';
 import { LeaderBoardPeriodType } from '../Leaderboard';
 import {
@@ -471,6 +472,28 @@ export class WSAPI {
 		return o;
 	}
 
+	/**
+	 * Plays the specified by template_id mini-game on behalf of user {count} times and returns prizes or err_code
+	 *
+	 * **Visitor mode: not supported**
+	 */
+	public async playMiniGameBatch(template_id: number, spin_count: number): Promise<TMiniGamePlayBatchResult[]> {
+		const response = await this.api.sawSpinBatchRequest(null, template_id, spin_count);
+
+		const request_ids = response.results.map((result) => result.request_id);
+		this.api.doAcknowledgeBatchRequest(null, request_ids);
+
+		const o: TMiniGamePlayBatchResult[] = response.results.map((result) => ({
+			errCode: result.errCode,
+			errMessage: result.errMsg,
+			saw_prize_id: result.saw_prize_id,
+			jackpot_amount: result.jackpot_amount,
+			first_spin_in_period: result.first_spin_in_period,
+		}));
+
+		return o;
+	}
+
 	/**
 	 * Requests an opt-in for the specified mission_id. Returns the err_code.
 	 *

package/src/WSAPI/WSAPITypes.ts

@@ -55,6 +55,22 @@ export interface TMiniGamePlayResult {
 	prize_id: number;
 }
 
+/**
+ * TMiniGamePlayBatchResult describes the response of call to _smartico.api.playMiniGameBatch(template_id, spin_count) method
+ */
+export interface TMiniGamePlayBatchResult {
+	/** The saw_prize_id that user won, details of the prize can be found in the mini-game definition */
+	saw_prize_id: number;
+	/** Error code that represents outcome of the game play attempt. Game succeed to be played in case err_code is 0 */
+	errCode: SAWSpinErrorCode;
+	/** Optional error message */
+	errMessage?: string;
+	/** Jackpot amount what user won */
+	jackpot_amount?: number;
+	/** Period in miliseconds from last spin */
+	first_spin_in_period?: number,
+}
+
 /**
  * TMiniGameTemplate describes the information of mini-games available for the user
  */