@battle-racing/br-common-lib 6.2.0-rc.8 → 6.2.0-rc.9

package/dist/data/all-tutorial-steps.js

@@ -14,6 +14,23 @@ const nitroTutorialHud = {
     ...defaultTutorialHud,
     powerUp: domains_1.POWER_UP_NAME.BATTLE_NITRO,
 };
+const startDrivingCommands = [
+    { module: 'speed', action: 'activate' },
+    { module: 'speed', action: 'change', params: { speed: '$kart.tutorialSpeed', forUnlimitedTime: true } },
+];
+const stopKartCommands = [
+    { module: 'speed', action: 'change', params: { speed: 0, forUnlimitedTime: true } },
+    { module: 'speed', action: 'deactivate' },
+];
+// The step fires the nitro, after it ends the speed module goes back to its default speed
+const returnToFinishCommands = [
+    {
+        module: 'speed',
+        action: 'configure',
+        params: { defaultSpeed: '$kart.tutorialReturnSpeed', timeDuration: '$kart.powerUpTime' },
+    },
+    { module: 'speed', action: 'activate' },
+];
 exports.allTutorialConfig = {
     id: 'tutorial-master-v1',
     name: 'Standard Circuit Induction Tutorial',
@@ -33,6 +50,7 @@ exports.allTutorialConfig = {
                         durationMs: 5000,
                     },
                     triggerCommands: [
+                        ...stopKartCommands,
                         {
                             module: 'screen',
                             action: 'showTutorialView',
@@ -52,6 +70,7 @@ exports.allTutorialConfig = {
                         durationMs: 6000,
                     },
                     triggerCommands: [
+                        ...stopKartCommands,
                         {
                             module: 'screen',
                             action: 'showTutorialView',
@@ -78,6 +97,7 @@ exports.allTutorialConfig = {
                         durationMs: 4000,
                     },
                     triggerCommands: [
+                        ...stopKartCommands,
                         {
                             module: 'screen',
                             action: 'showTutorialView',
@@ -97,6 +117,7 @@ exports.allTutorialConfig = {
                         durationMs: 5000,
                     },
                     triggerCommands: [
+                        ...stopKartCommands,
                         {
                             module: 'screen',
                             action: 'showTutorialView',
@@ -116,6 +137,7 @@ exports.allTutorialConfig = {
                         durationMs: 6000,
                     },
                     triggerCommands: [
+                        ...startDrivingCommands,
                         {
                             module: 'screen',
                             action: 'showTutorialView',
@@ -142,6 +164,7 @@ exports.allTutorialConfig = {
                         target: domains_1.TUTORIAL_CHECKPOINT_TARGET.POWER_UP,
                     },
                     triggerCommands: [
+                        ...startDrivingCommands,
                         {
                             module: 'screen',
                             action: 'showTutorialView',
@@ -169,6 +192,7 @@ exports.allTutorialConfig = {
                         button: domains_1.TUTORIAL_STEERING_WHEEL_BUTTON.RIGHT,
                     },
                     triggerCommands: [
+                        ...stopKartCommands,
                         {
                             module: 'screen',
                             action: 'showTutorialView',
@@ -188,6 +212,7 @@ exports.allTutorialConfig = {
                         button: domains_1.TUTORIAL_STEERING_WHEEL_BUTTON.LEFT,
                     },
                     triggerCommands: [
+                        ...stopKartCommands,
                         {
                             module: 'screen',
                             action: 'showTutorialView',
@@ -207,6 +232,7 @@ exports.allTutorialConfig = {
                         durationMs: 4000,
                     },
                     triggerCommands: [
+                        ...stopKartCommands,
                         {
                             module: 'screen',
                             action: 'showTutorialView',
@@ -226,6 +252,7 @@ exports.allTutorialConfig = {
                         target: domains_1.TUTORIAL_CHECKPOINT_TARGET.POWER_UP,
                     },
                     triggerCommands: [
+                        ...startDrivingCommands,
                         {
                             module: 'screen',
                             action: 'showTutorialView',
@@ -246,6 +273,7 @@ exports.allTutorialConfig = {
                         button: domains_1.TUTORIAL_STEERING_WHEEL_BUTTON.ANY,
                     },
                     triggerCommands: [
+                        ...stopKartCommands,
                         {
                             module: 'screen',
                             action: 'showTutorialView',
@@ -266,6 +294,7 @@ exports.allTutorialConfig = {
                         button: domains_1.TUTORIAL_STEERING_WHEEL_BUTTON.ANY,
                     },
                     triggerCommands: [
+                        ...stopKartCommands,
                         {
                             module: 'screen',
                             action: 'showTutorialView',
@@ -286,6 +315,7 @@ exports.allTutorialConfig = {
                         button: domains_1.TUTORIAL_STEERING_WHEEL_BUTTON.ANY,
                     },
                     triggerCommands: [
+                        ...stopKartCommands,
                         {
                             module: 'screen',
                             action: 'showTutorialView',
@@ -306,6 +336,7 @@ exports.allTutorialConfig = {
                         button: domains_1.TUTORIAL_STEERING_WHEEL_BUTTON.ANY,
                     },
                     triggerCommands: [
+                        ...stopKartCommands,
                         {
                             module: 'screen',
                             action: 'showTutorialView',
@@ -333,6 +364,7 @@ exports.allTutorialConfig = {
                         target: domains_1.TUTORIAL_CHECKPOINT_TARGET.POWER_UP,
                     },
                     triggerCommands: [
+                        ...startDrivingCommands,
                         {
                             module: 'screen',
                             action: 'showTutorialView',
@@ -353,6 +385,7 @@ exports.allTutorialConfig = {
                         button: domains_1.TUTORIAL_STEERING_WHEEL_BUTTON.ANY,
                     },
                     triggerCommands: [
+                        ...stopKartCommands,
                         {
                             module: 'screen',
                             action: 'showTutorialView',
@@ -373,6 +406,7 @@ exports.allTutorialConfig = {
                         button: domains_1.TUTORIAL_STEERING_WHEEL_BUTTON.ANY,
                     },
                     triggerCommands: [
+                        ...startDrivingCommands,
                         {
                             module: 'screen',
                             action: 'showTutorialView',
@@ -388,11 +422,13 @@ exports.allTutorialConfig = {
                     index: 3,
                     name: 'Nitro Fired - Return to HUD',
                     screenStep: domains_1.TUTORIAL_SCREEN_STEP.POWER_UP_RETURN_TO_HUD,
+                    executePowerUpId: 'battle-nitro',
                     listenEvent: {
                         on: domains_1.TUTORIAL_LISTEN_EVENT_ON.CHECKPOINT,
                         target: domains_1.TUTORIAL_CHECKPOINT_TARGET.FINISH,
                     },
                     triggerCommands: [
+                        ...returnToFinishCommands,
                         {
                             module: 'screen',
                             action: 'showTutorialView',
@@ -420,6 +456,7 @@ exports.allTutorialConfig = {
                         durationMs: 5000,
                     },
                     triggerCommands: [
+                        ...stopKartCommands,
                         {
                             module: 'screen',
                             action: 'showTutorialView',

package/dist/domains/command/Command.schema.d.ts

@@ -3,6 +3,10 @@ export declare const changeSpeedActionCommandOptionsSchema: z.ZodObject<{
     forUnlimitedTime: z.ZodOptional<z.ZodBoolean>;
     speed: z.ZodUnion<readonly [z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodString]>]>;
 }, z.core.$strip>;
+export declare const configureSpeedActionCommandOptionsSchema: z.ZodObject<{
+    defaultSpeed: z.ZodUnion<readonly [z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodString]>]>;
+    timeDuration: z.ZodUnion<readonly [z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodString]>]>;
+}, z.core.$strip>;
 export declare const speedModuleCommandSchema: z.ZodUnion<readonly [z.ZodObject<{
     module: z.ZodLiteral<"speed">;
     action: z.ZodLiteral<"activate">;
@@ -20,8 +24,8 @@ export declare const speedModuleCommandSchema: z.ZodUnion<readonly [z.ZodObject<
     module: z.ZodLiteral<"speed">;
     action: z.ZodLiteral<"configure">;
     params: z.ZodObject<{
-        defaultSpeed: z.ZodNumber;
-        timeDuration: z.ZodNumber;
+        defaultSpeed: z.ZodUnion<readonly [z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodString]>]>;
+        timeDuration: z.ZodUnion<readonly [z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodString]>]>;
     }, z.core.$strip>;
 }, z.core.$strip>]>;
 export declare const playSoundActionCommandOptionsSchema: z.ZodObject<{
@@ -1310,8 +1314,8 @@ export declare const allCommandsConfigSchema: z.ZodIntersection<z.ZodUnion<reado
     module: z.ZodLiteral<"speed">;
     action: z.ZodLiteral<"configure">;
     params: z.ZodObject<{
-        defaultSpeed: z.ZodNumber;
-        timeDuration: z.ZodNumber;
+        defaultSpeed: z.ZodUnion<readonly [z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodString]>]>;
+        timeDuration: z.ZodUnion<readonly [z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodString]>]>;
     }, z.core.$strip>;
 }, z.core.$strip>]>, z.ZodUnion<readonly [z.ZodObject<{
     module: z.ZodLiteral<"leftStarBackLaser">;

package/dist/domains/command/Command.schema.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.allCommandsConfigSchema = exports.lightsModuleCommandSchema = exports.emergencyModuleCommandSchema = exports.steeringWheelModuleCommandSchema = exports.screenModuleCommandSchema = exports.rightStarFrontLaserModuleCommandSchema = exports.leftStarBackLaserModuleCommandSchema = exports.rgbModuleCommandSchema = exports.flagModuleCommandSchema = exports.diskSensorBallShooterModuleCommandSchema = exports.ballSensorDiskThrowerModuleCommandSchema = exports.soundModuleCommandSchema = exports.playSoundActionCommandOptionsSchema = exports.speedModuleCommandSchema = exports.changeSpeedActionCommandOptionsSchema = void 0;
+exports.allCommandsConfigSchema = exports.lightsModuleCommandSchema = exports.emergencyModuleCommandSchema = exports.steeringWheelModuleCommandSchema = exports.screenModuleCommandSchema = exports.rightStarFrontLaserModuleCommandSchema = exports.leftStarBackLaserModuleCommandSchema = exports.rgbModuleCommandSchema = exports.flagModuleCommandSchema = exports.diskSensorBallShooterModuleCommandSchema = exports.ballSensorDiskThrowerModuleCommandSchema = exports.soundModuleCommandSchema = exports.playSoundActionCommandOptionsSchema = exports.speedModuleCommandSchema = exports.configureSpeedActionCommandOptionsSchema = exports.changeSpeedActionCommandOptionsSchema = void 0;
 const zod_1 = require("zod");
 const hardware_1 = require("../hardware");
 const utils_1 = require("../utils");
@@ -10,11 +10,19 @@ const arithmeticOrNumberSchema = zod_1.z.union([zod_1.z.number(), utils_1.arithm
 exports.changeSpeedActionCommandOptionsSchema = hardware_1.speedChangeOptionsSchema.omit({ speed: true }).extend({
     speed: arithmeticOrNumberSchema,
 });
+exports.configureSpeedActionCommandOptionsSchema = zod_1.z.object({
+    defaultSpeed: arithmeticOrNumberSchema,
+    timeDuration: arithmeticOrNumberSchema,
+});
 exports.speedModuleCommandSchema = zod_1.z.union([
     zod_1.z.object({ module: zod_1.z.literal('speed'), action: zod_1.z.literal('activate') }),
     zod_1.z.object({ module: zod_1.z.literal('speed'), action: zod_1.z.literal('deactivate') }),
     zod_1.z.object({ module: zod_1.z.literal('speed'), action: zod_1.z.literal('change'), params: exports.changeSpeedActionCommandOptionsSchema }),
-    zod_1.z.object({ module: zod_1.z.literal('speed'), action: zod_1.z.literal('configure'), params: hardware_1.speedConfigurationSchema }),
+    zod_1.z.object({
+        module: zod_1.z.literal('speed'),
+        action: zod_1.z.literal('configure'),
+        params: exports.configureSpeedActionCommandOptionsSchema,
+    }),
 ]);
 // --- Sound Commands ---
 exports.playSoundActionCommandOptionsSchema = hardware_1.playSoundOptionsSchema.omit({ durationMs: true }).extend({

package/dist/domains/flow/Flow.schema.d.ts

@@ -287,8 +287,8 @@ export declare const flowSchema: z.ZodObject<{
         module: z.ZodLiteral<"speed">;
         action: z.ZodLiteral<"configure">;
         params: z.ZodObject<{
-            defaultSpeed: z.ZodNumber;
-            timeDuration: z.ZodNumber;
+            defaultSpeed: z.ZodUnion<readonly [z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodString]>]>;
+            timeDuration: z.ZodUnion<readonly [z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodString]>]>;
         }, z.core.$strip>;
     }, z.core.$strip>]>, z.ZodUnion<readonly [z.ZodObject<{
         module: z.ZodLiteral<"leftStarBackLaser">;

package/dist/domains/game/Game.schema.d.ts

@@ -69,7 +69,7 @@ export declare const gameSchema: z.ZodObject<{
         position: z.ZodNumber;
         time: z.ZodNumber;
     }, z.core.$strip>>;
-    tutorialConfigId: z.ZodOptional<z.ZodString>;
+    tutorialConfigId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 export declare const assignKartSchema: z.ZodObject<{
     playerId: z.ZodString;

package/dist/domains/game/Game.schema.js

@@ -34,7 +34,7 @@ exports.gameSchema = zod_1.z.object({
     finishedReason: exports.gameFinishedReasonSchema.optional(),
     kartsState: zod_1.z.record(zod_1.z.string(), exports.gameKartStateSchema),
     gameRanking: zod_1.z.array(exports.kartRankingItemSchema),
-    tutorialConfigId: zod_1.z.string().optional(),
+    tutorialConfigId: zod_1.z.string().nullable().optional(),
 });
 exports.assignKartSchema = zod_1.z.object({
     playerId: zod_1.z.string(),

package/dist/domains/game/battle/Battle.schema.d.ts

@@ -36,7 +36,7 @@ export declare const battleSchema: z.ZodObject<{
         position: z.ZodNumber;
         time: z.ZodNumber;
     }, z.core.$strip>>;
-    tutorialConfigId: z.ZodOptional<z.ZodString>;
+    tutorialConfigId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     type: z.ZodLiteral<"Battle">;
     lives: z.ZodNumber;
     kartsState: z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -57,5 +57,4 @@ export declare const createBattleSchema: z.ZodObject<{
     gameTrackId: z.ZodString;
     gameTurnId: z.ZodOptional<z.ZodString>;
     isOfficial: z.ZodOptional<z.ZodBoolean>;
-    tutorialConfigId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;

package/dist/domains/game/battle/Battle.schema.js

@@ -27,5 +27,4 @@ exports.createBattleSchema = zod_1.z.object({
     gameTrackId: zod_1.z.string(),
     gameTurnId: zod_1.z.string().optional(),
     isOfficial: zod_1.z.boolean().optional(),
-    tutorialConfigId: zod_1.z.string().optional(),
 });

package/dist/domains/game/race/Race.schema.d.ts

@@ -106,7 +106,7 @@ export declare const raceSchema: z.ZodObject<{
         readonly EMERGENCY: "EMERGENCY";
         readonly BY_CONTROLLER: "BY_CONTROLLER";
     }>>;
-    tutorialConfigId: z.ZodOptional<z.ZodString>;
+    tutorialConfigId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     type: z.ZodLiteral<"Race">;
     laps: z.ZodNumber;
     kartsState: z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -166,7 +166,7 @@ export declare const raceWithDetailedRankingSchema: z.ZodObject<{
         readonly EMERGENCY: "EMERGENCY";
         readonly BY_CONTROLLER: "BY_CONTROLLER";
     }>>;
-    tutorialConfigId: z.ZodOptional<z.ZodString>;
+    tutorialConfigId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     type: z.ZodLiteral<"Race">;
     laps: z.ZodNumber;
     kartsState: z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -235,5 +235,4 @@ export declare const createRaceSchema: z.ZodObject<{
     gameTrackId: z.ZodString;
     gameTurnId: z.ZodOptional<z.ZodString>;
     isOfficial: z.ZodOptional<z.ZodBoolean>;
-    tutorialConfigId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;

package/dist/domains/game/race/Race.schema.js

@@ -70,5 +70,4 @@ exports.createRaceSchema = exports.startRaceSchema.partial().extend({
     gameTrackId: zod_1.z.string(),
     gameTurnId: zod_1.z.string().optional(),
     isOfficial: zod_1.z.boolean().optional(),
-    tutorialConfigId: zod_1.z.string().optional(),
 });

package/dist/domains/gameTrack/GameTrack.schema.d.ts

@@ -17,6 +17,8 @@ export declare const gameTrackKartsConfigSchema: z.ZodObject<{
         waitTimeAfterHit: z.ZodNumber;
     }, z.core.$strip>;
     lowSpeed: z.ZodNumber;
+    tutorialSpeed: z.ZodNumber;
+    tutorialReturnSpeed: z.ZodNumber;
 }, z.core.$strip>;
 export declare const gameTrackKartConfigSchema: z.ZodObject<{
     gameTrackId: z.ZodString;
@@ -72,6 +74,8 @@ export declare const gameTrackSchema: z.ZodObject<{
             waitTimeAfterHit: z.ZodNumber;
         }, z.core.$strip>;
         lowSpeed: z.ZodNumber;
+        tutorialSpeed: z.ZodNumber;
+        tutorialReturnSpeed: z.ZodNumber;
     }, z.core.$strip>;
     macAddress: z.ZodOptional<z.ZodString>;
     isConnected: z.ZodBoolean;

package/dist/domains/gameTrack/GameTrack.schema.js

@@ -18,6 +18,8 @@ exports.gameTrackKartsConfigSchema = zod_1.z.object({
     diskSensorBallShooter: hardware_1.configDiskSensorBallShooterModuleOptionsSchema,
     ballSensorDiskThrower: hardware_1.configureBallSensorDiskThrowerModuleOptionsSchema,
     lowSpeed: zod_1.z.number().min(0).max(100),
+    tutorialSpeed: zod_1.z.number().min(0).max(100),
+    tutorialReturnSpeed: zod_1.z.number().min(0).max(100),
 });
 exports.gameTrackKartConfigSchema = zod_1.z.object({
     gameTrackId: zod_1.z.string(),

package/dist/domains/powerUp/PowerUp.schema.d.ts

@@ -283,8 +283,8 @@ export declare const powerUpCommandSchema: z.ZodIntersection<z.ZodUnion<readonly
     module: z.ZodLiteral<"speed">;
     action: z.ZodLiteral<"configure">;
     params: z.ZodObject<{
-        defaultSpeed: z.ZodNumber;
-        timeDuration: z.ZodNumber;
+        defaultSpeed: z.ZodUnion<readonly [z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodString]>]>;
+        timeDuration: z.ZodUnion<readonly [z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodString]>]>;
     }, z.core.$strip>;
 }, z.core.$strip>]>, z.ZodUnion<readonly [z.ZodObject<{
     module: z.ZodLiteral<"leftStarBackLaser">;
@@ -1287,8 +1287,8 @@ export declare const powerUpSchema: z.ZodObject<{
         module: z.ZodLiteral<"speed">;
         action: z.ZodLiteral<"configure">;
         params: z.ZodObject<{
-            defaultSpeed: z.ZodNumber;
-            timeDuration: z.ZodNumber;
+            defaultSpeed: z.ZodUnion<readonly [z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodString]>]>;
+            timeDuration: z.ZodUnion<readonly [z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodString]>]>;
         }, z.core.$strip>;
     }, z.core.$strip>]>, z.ZodUnion<readonly [z.ZodObject<{
         module: z.ZodLiteral<"leftStarBackLaser">;
@@ -2271,8 +2271,8 @@ export declare const powerUpSchema: z.ZodObject<{
         module: z.ZodLiteral<"speed">;
         action: z.ZodLiteral<"configure">;
         params: z.ZodObject<{
-            defaultSpeed: z.ZodNumber;
-            timeDuration: z.ZodNumber;
+            defaultSpeed: z.ZodUnion<readonly [z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodString]>]>;
+            timeDuration: z.ZodUnion<readonly [z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodString]>]>;
         }, z.core.$strip>;
     }, z.core.$strip>]>, z.ZodUnion<readonly [z.ZodObject<{
         module: z.ZodLiteral<"leftStarBackLaser">;

package/dist/domains/socket/serverToClient/SocketWebAppServerToClientEventsParams.d.ts

@@ -3,6 +3,7 @@ import type { GameTrack } from '../../gameTrack';
 import type { Kart } from '../../kart';
 import type { CheckpointEvent } from '../../kartTracking';
 import type { Response } from '../../response';
+import type { TutorialSession } from '../../tutorial';
 import type { MacAddressGameTrackConnections } from '../inputs';
 import type { SocketHardwareOnDataEventsParams } from '../SocketHardwareOnDataEventsParams';
 export interface SocketWebAppServerToClientEventsParams {
@@ -20,6 +21,9 @@ export interface SocketWebAppServerToClientEventsParams {
     'game:changed': {
         game: Game;
     };
+    'tutorial:session:changed': {
+        session: TutorialSession;
+    };
     'gameTracks:onGameTrackUpdated': GameTrack[];
     'gameTracks:connectedRasperries': {
         macAddress: string;

package/dist/domains/tutorial/Tutorial.const.d.ts

@@ -51,5 +51,3 @@ export declare const TUTORIAL_CHECKPOINT_TARGET: {
 export declare const TUTORIAL_INPUT_SIGNAL_TYPE: {
     readonly STEERING_WHEEL_BUTTON_PRESSED: "SteeringWheelButtonPressed";
 };
-export declare const DRIVING_TUTORIAL_STEPS: readonly ["Pedal", "DriveToControls", "HudOverview", "PowerUpWaiting", "PowerUpNitroReady", "PowerUpReturnToHud"];
-export declare const isDrivingTutorialStep: (step?: string | null) => boolean;

package/dist/domains/tutorial/Tutorial.const.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isDrivingTutorialStep = exports.DRIVING_TUTORIAL_STEPS = exports.TUTORIAL_INPUT_SIGNAL_TYPE = exports.TUTORIAL_CHECKPOINT_TARGET = exports.TUTORIAL_STEERING_WHEEL_BUTTON = exports.TUTORIAL_LISTEN_EVENT_ON = exports.TUTORIAL_PHASE_ID = exports.TUTORIAL_STATUS = exports.TUTORIAL_SCREEN_STEP = void 0;
+exports.TUTORIAL_INPUT_SIGNAL_TYPE = exports.TUTORIAL_CHECKPOINT_TARGET = exports.TUTORIAL_STEERING_WHEEL_BUTTON = exports.TUTORIAL_LISTEN_EVENT_ON = exports.TUTORIAL_PHASE_ID = exports.TUTORIAL_STATUS = exports.TUTORIAL_SCREEN_STEP = void 0;
 exports.TUTORIAL_SCREEN_STEP = {
     COUNTDOWN: 'Countdown',
     WELCOME: 'Welcome',
@@ -54,18 +54,3 @@ exports.TUTORIAL_CHECKPOINT_TARGET = {
 exports.TUTORIAL_INPUT_SIGNAL_TYPE = {
     STEERING_WHEEL_BUTTON_PRESSED: 'SteeringWheelButtonPressed',
 };
-exports.DRIVING_TUTORIAL_STEPS = [
-    exports.TUTORIAL_SCREEN_STEP.PEDAL,
-    exports.TUTORIAL_SCREEN_STEP.DRIVE_TO_CONTROLS,
-    exports.TUTORIAL_SCREEN_STEP.HUD_OVERVIEW,
-    exports.TUTORIAL_SCREEN_STEP.POWER_UP_WAITING,
-    exports.TUTORIAL_SCREEN_STEP.POWER_UP_NITRO_READY,
-    exports.TUTORIAL_SCREEN_STEP.POWER_UP_RETURN_TO_HUD,
-];
-const isDrivingTutorialStep = (step) => {
-    if (!step) {
-        return false;
-    }
-    return exports.DRIVING_TUTORIAL_STEPS.includes(step);
-};
-exports.isDrivingTutorialStep = isDrivingTutorialStep;

package/dist/domains/tutorial/Tutorial.schema.d.ts

@@ -43,6 +43,10 @@ export declare const tutorialSteeringWheelButtonSchema: z.ZodEnum<{
     left: "left";
     right: "right";
 }>;
+export declare const tutorialInputButtonSchema: z.ZodEnum<{
+    left: "left";
+    right: "right";
+}>;
 export declare const tutorialCheckpointTargetSchema: z.ZodEnum<{
     TRACK: "TRACK";
     POWER_UP: "POWER_UP";
@@ -124,7 +128,7 @@ export declare const tutorialKartSnapshotSchema: z.ZodObject<{
     }>>>;
     latestCheckpointId: z.ZodOptional<z.ZodString>;
     latestCheckpointProgress: z.ZodOptional<z.ZodNumber>;
-    updatedAtISO: z.ZodString;
+    updatedAtISO: z.ZodISODateTime;
 }, z.core.$strip>;
 export declare const tutorialInputSignalTypeSchema: z.ZodEnum<{
     SteeringWheelButtonPressed: "SteeringWheelButtonPressed";
@@ -134,17 +138,16 @@ export declare const tutorialKartEventBaseSchema: z.ZodObject<{
     deviceId: z.ZodString;
     revision: z.ZodNumber;
     sequence: z.ZodNumber;
-    originTimestampISO: z.ZodString;
+    originTimestampISO: z.ZodISODateTime;
 }, z.core.$strip>;
 export declare const tutorialSteeringWheelButtonPressedSchema: z.ZodObject<{
     tutorialSessionId: z.ZodString;
     deviceId: z.ZodString;
     revision: z.ZodNumber;
     sequence: z.ZodNumber;
-    originTimestampISO: z.ZodString;
+    originTimestampISO: z.ZodISODateTime;
     type: z.ZodLiteral<"SteeringWheelButtonPressed">;
     button: z.ZodEnum<{
-        any: "any";
         left: "left";
         right: "right";
     }>;
@@ -154,10 +157,9 @@ export declare const tutorialInputSignalSchema: z.ZodDiscriminatedUnion<[z.ZodOb
     deviceId: z.ZodString;
     revision: z.ZodNumber;
     sequence: z.ZodNumber;
-    originTimestampISO: z.ZodString;
+    originTimestampISO: z.ZodISODateTime;
     type: z.ZodLiteral<"SteeringWheelButtonPressed">;
     button: z.ZodEnum<{
-        any: "any";
         left: "left";
         right: "right";
     }>;
@@ -169,7 +171,7 @@ export declare const tutorialConfigurationSchema: z.ZodObject<{
     speedConfig: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export declare const tutorialParticipantSchema: z.ZodObject<{
-    deviceId: z.ZodString;
+    kartGuid: z.ZodString;
     playerId: z.ZodOptional<z.ZodString>;
     status: z.ZodEnum<{
         COMPLETED: "COMPLETED";
@@ -217,13 +219,17 @@ export declare const tutorialParticipantSchema: z.ZodObject<{
         total: z.ZodNumber;
     }, z.core.$strip>>;
     totalDurationSeconds: z.ZodDefault<z.ZodNumber>;
-    startedAtISO: z.ZodOptional<z.ZodString>;
-    updatedAtISO: z.ZodString;
+    startedAtISO: z.ZodOptional<z.ZodISODateTime>;
+    updatedAtISO: z.ZodISODateTime;
 }, z.core.$strip>;
 export declare const tutorialSessionSchema: z.ZodObject<{
     id: z.ZodString;
     gameTurnId: z.ZodOptional<z.ZodString>;
-    gameId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    gameId: z.ZodNumber;
+    gameType: z.ZodEnum<{
+        readonly Race: "Race";
+        readonly Battle: "Battle";
+    }>;
     status: z.ZodEnum<{
         COMPLETED: "COMPLETED";
         PENDING: "PENDING";
@@ -232,7 +238,7 @@ export declare const tutorialSessionSchema: z.ZodObject<{
         SKIPPED: "SKIPPED";
     }>;
     participants: z.ZodArray<z.ZodObject<{
-        deviceId: z.ZodString;
+        kartGuid: z.ZodString;
         playerId: z.ZodOptional<z.ZodString>;
         status: z.ZodEnum<{
             COMPLETED: "COMPLETED";
@@ -280,29 +286,37 @@ export declare const tutorialSessionSchema: z.ZodObject<{
             total: z.ZodNumber;
         }, z.core.$strip>>;
         totalDurationSeconds: z.ZodDefault<z.ZodNumber>;
-        startedAtISO: z.ZodOptional<z.ZodString>;
-        updatedAtISO: z.ZodString;
+        startedAtISO: z.ZodOptional<z.ZodISODateTime>;
+        updatedAtISO: z.ZodISODateTime;
     }, z.core.$strip>>;
-    createdAtISO: z.ZodString;
-    updatedAtISO: z.ZodString;
+    createdAtISO: z.ZodISODateTime;
+    updatedAtISO: z.ZodISODateTime;
 }, z.core.$strip>;
-export declare const startOperatorTutorialSchema: z.ZodObject<{
-    gameId: z.ZodNumber;
-    gameType: z.ZodEnum<{
-        Race: "Race";
-        Battle: "Battle";
-    }>;
+export declare const startRaceTutorialSchema: z.ZodObject<{
+    laps: z.ZodNumber;
+    coins: z.ZodNumber;
+    kartsGuids: z.ZodArray<z.ZodString>;
+    powerUpsIds: z.ZodArray<z.ZodString>;
+    time: z.ZodNumber;
+    speedConfig: z.ZodNumber;
+    playerKartMap: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    tutorialConfigId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    tutorialParams: z.ZodOptional<z.ZodObject<{
+        laps: z.ZodDefault<z.ZodNumber>;
+        coins: z.ZodDefault<z.ZodNumber>;
+        time: z.ZodDefault<z.ZodNumber>;
+        speedConfig: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const startBattleTutorialSchema: z.ZodObject<{
+    lives: z.ZodNumber;
+    coins: z.ZodNumber;
+    kartsGuids: z.ZodArray<z.ZodString>;
+    powerUpsIds: z.ZodArray<z.ZodString>;
+    time: z.ZodNumber;
+    speedConfig: z.ZodNumber;
+    playerKartMap: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     tutorialConfigId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    params: z.ZodObject<{
-        laps: z.ZodOptional<z.ZodNumber>;
-        lives: z.ZodOptional<z.ZodNumber>;
-        coins: z.ZodNumber;
-        kartsGuids: z.ZodArray<z.ZodString>;
-        powerUpsIds: z.ZodArray<z.ZodString>;
-        time: z.ZodNumber;
-        speedConfig: z.ZodNumber;
-        playerKartMap: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, z.core.$strip>;
     tutorialParams: z.ZodOptional<z.ZodObject<{
         laps: z.ZodDefault<z.ZodNumber>;
         coins: z.ZodDefault<z.ZodNumber>;

package/dist/domains/tutorial/Tutorial.schema.js

@@ -1,7 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.startOperatorTutorialSchema = exports.tutorialSessionSchema = exports.tutorialParticipantSchema = exports.tutorialConfigurationSchema = exports.tutorialInputSignalSchema = exports.tutorialSteeringWheelButtonPressedSchema = exports.tutorialKartEventBaseSchema = exports.tutorialInputSignalTypeSchema = exports.tutorialKartSnapshotSchema = exports.tutorialCheckpointTargetSchema = exports.tutorialSteeringWheelButtonSchema = exports.tutorialListenEventOnSchema = exports.tutorialPhaseIdSchema = exports.tutorialStatusSchema = exports.tutorialScreenStepSchema = void 0;
+exports.startBattleTutorialSchema = exports.startRaceTutorialSchema = exports.tutorialSessionSchema = exports.tutorialParticipantSchema = exports.tutorialConfigurationSchema = exports.tutorialInputSignalSchema = exports.tutorialSteeringWheelButtonPressedSchema = exports.tutorialKartEventBaseSchema = exports.tutorialInputSignalTypeSchema = exports.tutorialKartSnapshotSchema = exports.tutorialCheckpointTargetSchema = exports.tutorialInputButtonSchema = exports.tutorialSteeringWheelButtonSchema = exports.tutorialListenEventOnSchema = exports.tutorialPhaseIdSchema = exports.tutorialStatusSchema = exports.tutorialScreenStepSchema = void 0;
 const zod_1 = require("zod");
+const Battle_schema_1 = require("../game/battle/Battle.schema");
+const Game_schema_1 = require("../game/Game.schema");
+const Race_schema_1 = require("../game/race/Race.schema");
 const ScreenTutorial_schema_1 = require("../hardware/screen/ScreenTutorial.schema");
 const Tutorial_const_1 = require("./Tutorial.const");
 exports.tutorialScreenStepSchema = zod_1.z.enum([
@@ -48,6 +51,10 @@ exports.tutorialSteeringWheelButtonSchema = zod_1.z.enum([
     Tutorial_const_1.TUTORIAL_STEERING_WHEEL_BUTTON.LEFT,
     Tutorial_const_1.TUTORIAL_STEERING_WHEEL_BUTTON.ANY,
 ]);
+exports.tutorialInputButtonSchema = zod_1.z.enum([
+    Tutorial_const_1.TUTORIAL_STEERING_WHEEL_BUTTON.RIGHT,
+    Tutorial_const_1.TUTORIAL_STEERING_WHEEL_BUTTON.LEFT,
+]);
 exports.tutorialCheckpointTargetSchema = zod_1.z.enum([
     Tutorial_const_1.TUTORIAL_CHECKPOINT_TARGET.TRACK,
     Tutorial_const_1.TUTORIAL_CHECKPOINT_TARGET.POWER_UP,
@@ -67,7 +74,7 @@ exports.tutorialKartSnapshotSchema = zod_1.z.object({
     awaitingCheckpointTarget: exports.tutorialCheckpointTargetSchema.nullable().optional(),
     latestCheckpointId: zod_1.z.string().optional(),
     latestCheckpointProgress: zod_1.z.number().optional(),
-    updatedAtISO: zod_1.z.string().datetime(),
+    updatedAtISO: zod_1.z.iso.datetime(),
 });
 exports.tutorialInputSignalTypeSchema = zod_1.z.enum([Tutorial_const_1.TUTORIAL_INPUT_SIGNAL_TYPE.STEERING_WHEEL_BUTTON_PRESSED]);
 exports.tutorialKartEventBaseSchema = zod_1.z.object({
@@ -75,11 +82,11 @@ exports.tutorialKartEventBaseSchema = zod_1.z.object({
     deviceId: zod_1.z.string().min(1),
     revision: zod_1.z.number().int().nonnegative(),
     sequence: zod_1.z.number().int().nonnegative(),
-    originTimestampISO: zod_1.z.string().datetime(),
+    originTimestampISO: zod_1.z.iso.datetime(),
 });
 exports.tutorialSteeringWheelButtonPressedSchema = exports.tutorialKartEventBaseSchema.extend({
     type: zod_1.z.literal(Tutorial_const_1.TUTORIAL_INPUT_SIGNAL_TYPE.STEERING_WHEEL_BUTTON_PRESSED),
-    button: exports.tutorialSteeringWheelButtonSchema,
+    button: exports.tutorialInputButtonSchema,
 });
 exports.tutorialInputSignalSchema = zod_1.z.discriminatedUnion('type', [exports.tutorialSteeringWheelButtonPressedSchema]);
 exports.tutorialConfigurationSchema = zod_1.z.object({
@@ -89,7 +96,7 @@ exports.tutorialConfigurationSchema = zod_1.z.object({
     speedConfig: zod_1.z.number().int().min(20).max(100).optional(),
 });
 exports.tutorialParticipantSchema = zod_1.z.object({
-    deviceId: zod_1.z.string().min(1),
+    kartGuid: zod_1.z.string().min(1),
     playerId: zod_1.z.string().optional(),
     status: exports.tutorialStatusSchema,
     currentPhaseId: exports.tutorialPhaseIdSchema,
@@ -108,31 +115,22 @@ exports.tutorialParticipantSchema = zod_1.z.object({
     })
         .optional(),
     totalDurationSeconds: zod_1.z.number().int().default(180),
-    startedAtISO: zod_1.z.string().optional(),
-    updatedAtISO: zod_1.z.string(),
+    startedAtISO: zod_1.z.iso.datetime().optional(),
+    updatedAtISO: zod_1.z.iso.datetime(),
 });
 exports.tutorialSessionSchema = zod_1.z.object({
     id: zod_1.z.string().min(1),
     gameTurnId: zod_1.z.string().optional(),
-    gameId: zod_1.z.union([zod_1.z.string(), zod_1.z.number()]).optional(),
+    gameId: zod_1.z.number().int(),
+    gameType: Game_schema_1.gameTypeSchema,
     status: exports.tutorialStatusSchema,
     participants: zod_1.z.array(exports.tutorialParticipantSchema),
-    createdAtISO: zod_1.z.string(),
-    updatedAtISO: zod_1.z.string(),
+    createdAtISO: zod_1.z.iso.datetime(),
+    updatedAtISO: zod_1.z.iso.datetime(),
 });
-exports.startOperatorTutorialSchema = zod_1.z.object({
-    gameId: zod_1.z.number().int(),
-    gameType: zod_1.z.enum(['Race', 'Battle']),
+const startTutorialOptionsSchema = zod_1.z.object({
     tutorialConfigId: zod_1.z.string().optional().default('BR_TUTORIAL_DEFAULT'),
-    params: zod_1.z.object({
-        laps: zod_1.z.number().int().optional(),
-        lives: zod_1.z.number().int().optional(),
-        coins: zod_1.z.number().int().min(0).max(254),
-        kartsGuids: zod_1.z.array(zod_1.z.string()).min(1),
-        powerUpsIds: zod_1.z.array(zod_1.z.string()).min(1),
-        time: zod_1.z.number().int().min(30).max(1200),
-        speedConfig: zod_1.z.number().int().min(20).max(100),
-        playerKartMap: zod_1.z.record(zod_1.z.string(), zod_1.z.string()).optional(),
-    }),
     tutorialParams: exports.tutorialConfigurationSchema.optional(),
 });
+exports.startRaceTutorialSchema = Race_schema_1.startRaceSchema.extend(startTutorialOptionsSchema.shape);
+exports.startBattleTutorialSchema = Battle_schema_1.startBattleSchema.extend(startTutorialOptionsSchema.shape);

package/dist/domains/tutorial/Tutorial.types.d.ts

@@ -1,10 +1,11 @@
 import { z } from 'zod';
-import { tutorialInputSignalSchema, tutorialInputSignalTypeSchema, tutorialKartSnapshotSchema, tutorialListenEventOnSchema, tutorialCheckpointTargetSchema, tutorialPhaseIdSchema, tutorialScreenStepSchema, tutorialStatusSchema, tutorialSteeringWheelButtonPressedSchema, tutorialSteeringWheelButtonSchema, tutorialConfigurationSchema, tutorialParticipantSchema, tutorialSessionSchema, startOperatorTutorialSchema } from './Tutorial.schema';
+import { tutorialInputSignalSchema, tutorialInputSignalTypeSchema, tutorialKartSnapshotSchema, tutorialListenEventOnSchema, tutorialCheckpointTargetSchema, tutorialPhaseIdSchema, tutorialScreenStepSchema, tutorialStatusSchema, tutorialSteeringWheelButtonPressedSchema, tutorialSteeringWheelButtonSchema, tutorialInputButtonSchema, tutorialConfigurationSchema, tutorialParticipantSchema, tutorialSessionSchema, startRaceTutorialSchema, startBattleTutorialSchema } from './Tutorial.schema';
 export type TutorialScreenStep = z.infer<typeof tutorialScreenStepSchema>;
 export type TutorialStatus = z.infer<typeof tutorialStatusSchema>;
 export type TutorialPhaseId = z.infer<typeof tutorialPhaseIdSchema>;
 export type TutorialListenEventOn = z.infer<typeof tutorialListenEventOnSchema>;
 export type TutorialSteeringWheelButton = z.infer<typeof tutorialSteeringWheelButtonSchema>;
+export type TutorialInputButton = z.infer<typeof tutorialInputButtonSchema>;
 export type TutorialCheckpointTarget = z.infer<typeof tutorialCheckpointTargetSchema>;
 export type TutorialKartSnapshot = z.infer<typeof tutorialKartSnapshotSchema>;
 export type TutorialInputSignalType = z.infer<typeof tutorialInputSignalTypeSchema>;
@@ -13,4 +14,5 @@ export type TutorialInputSignal = z.infer<typeof tutorialInputSignalSchema>;
 export type TutorialConfiguration = z.infer<typeof tutorialConfigurationSchema>;
 export type TutorialParticipant = z.infer<typeof tutorialParticipantSchema>;
 export type TutorialSession = z.infer<typeof tutorialSessionSchema>;
-export type StartOperatorTutorial = z.infer<typeof startOperatorTutorialSchema>;
+export type StartRaceTutorial = z.infer<typeof startRaceTutorialSchema>;
+export type StartBattleTutorial = z.infer<typeof startBattleTutorialSchema>;

package/dist/domains/tutorial/TutorialConfig.schema.d.ts

@@ -367,8 +367,8 @@ export declare const tutorialStepConfigSchema: z.ZodObject<{
         module: z.ZodLiteral<"speed">;
         action: z.ZodLiteral<"configure">;
         params: z.ZodObject<{
-            defaultSpeed: z.ZodNumber;
-            timeDuration: z.ZodNumber;
+            defaultSpeed: z.ZodUnion<readonly [z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodString]>]>;
+            timeDuration: z.ZodUnion<readonly [z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodString]>]>;
         }, z.core.$strip>;
     }, z.core.$strip>]>, z.ZodUnion<readonly [z.ZodObject<{
         module: z.ZodLiteral<"leftStarBackLaser">;
@@ -1067,6 +1067,7 @@ export declare const tutorialStepConfigSchema: z.ZodObject<{
     }, z.core.$strip>]>]>, z.ZodObject<{
         params: z.ZodOptional<z.ZodUnknown>;
     }, z.core.$strip>>>;
+    executePowerUpId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const tutorialPhaseConfigSchema: z.ZodObject<{
     id: z.ZodEnum<{
@@ -1405,8 +1406,8 @@ export declare const tutorialPhaseConfigSchema: z.ZodObject<{
             module: z.ZodLiteral<"speed">;
             action: z.ZodLiteral<"configure">;
             params: z.ZodObject<{
-                defaultSpeed: z.ZodNumber;
-                timeDuration: z.ZodNumber;
+                defaultSpeed: z.ZodUnion<readonly [z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodString]>]>;
+                timeDuration: z.ZodUnion<readonly [z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodString]>]>;
             }, z.core.$strip>;
         }, z.core.$strip>]>, z.ZodUnion<readonly [z.ZodObject<{
             module: z.ZodLiteral<"leftStarBackLaser">;
@@ -2105,6 +2106,7 @@ export declare const tutorialPhaseConfigSchema: z.ZodObject<{
         }, z.core.$strip>]>]>, z.ZodObject<{
             params: z.ZodOptional<z.ZodUnknown>;
         }, z.core.$strip>>>;
+        executePowerUpId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const tutorialMasterConfigSchema: z.ZodObject<{
@@ -2447,8 +2449,8 @@ export declare const tutorialMasterConfigSchema: z.ZodObject<{
                 module: z.ZodLiteral<"speed">;
                 action: z.ZodLiteral<"configure">;
                 params: z.ZodObject<{
-                    defaultSpeed: z.ZodNumber;
-                    timeDuration: z.ZodNumber;
+                    defaultSpeed: z.ZodUnion<readonly [z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodString]>]>;
+                    timeDuration: z.ZodUnion<readonly [z.ZodNumber, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodString]>]>;
                 }, z.core.$strip>;
             }, z.core.$strip>]>, z.ZodUnion<readonly [z.ZodObject<{
                 module: z.ZodLiteral<"leftStarBackLaser">;
@@ -3147,6 +3149,7 @@ export declare const tutorialMasterConfigSchema: z.ZodObject<{
             }, z.core.$strip>]>]>, z.ZodObject<{
                 params: z.ZodOptional<z.ZodUnknown>;
             }, z.core.$strip>>>;
+            executePowerUpId: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;

package/dist/domains/tutorial/TutorialConfig.schema.js

@@ -29,6 +29,7 @@ exports.tutorialStepConfigSchema = zod_1.z.object({
     screenStep: Tutorial_schema_1.tutorialScreenStepSchema,
     listenEvent: exports.tutorialListenEventSchema,
     triggerCommands: zod_1.z.array(Command_schema_1.allCommandsConfigSchema),
+    executePowerUpId: zod_1.z.string().optional(),
 });
 exports.tutorialPhaseConfigSchema = zod_1.z.object({
     id: Tutorial_schema_1.tutorialPhaseIdSchema,

package/dist/domains/utils/Utils.schema.d.ts

@@ -9,6 +9,8 @@ export declare const simpleArithmeticStringSchema: z.ZodString;
 export declare const kartContextVariableSchema: z.ZodEnum<{
     "$kart.configuredSpeed": "$kart.configuredSpeed";
     "$kart.powerUpTime": "$kart.powerUpTime";
+    "$kart.tutorialSpeed": "$kart.tutorialSpeed";
+    "$kart.tutorialReturnSpeed": "$kart.tutorialReturnSpeed";
 }>;
 export declare const contextArithmeticStringSchema: z.ZodString;
 export declare const arithmeticExpressionSchema: z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodString]>;

package/dist/domains/utils/Utils.schema.js

@@ -5,9 +5,14 @@ const zod_1 = require("zod");
 exports.arithmeticOperatorSchema = zod_1.z.enum(['+', '-', '*', '/']);
 // Regex for SimpleArithmeticString: check for operator followed by numbers
 exports.simpleArithmeticStringSchema = zod_1.z.string().regex(/^[\+\-\*\/]-?\d+(\.\d+)?$/);
-// Regex for ContextArithmeticString: $variable operator number
-exports.kartContextVariableSchema = zod_1.z.enum(['$kart.configuredSpeed', '$kart.powerUpTime']);
-exports.contextArithmeticStringSchema = zod_1.z.string().regex(/^\$[a-zA-Z0-9\.]+\s[\+\-\*\/]\s-?\d+(\.\d+)?$/);
+// Regex for ContextArithmeticString: $variable, optionally followed by operator number
+exports.kartContextVariableSchema = zod_1.z.enum([
+    '$kart.configuredSpeed',
+    '$kart.powerUpTime',
+    '$kart.tutorialSpeed',
+    '$kart.tutorialReturnSpeed',
+]);
+exports.contextArithmeticStringSchema = zod_1.z.string().regex(/^\$[a-zA-Z0-9\.]+(\s[\+\-\*\/]\s-?\d+(\.\d+)?)?$/);
 exports.arithmeticExpressionSchema = zod_1.z.union([
     zod_1.z.number(),
     exports.simpleArithmeticStringSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@battle-racing/br-common-lib",
-  "version": "6.2.0-rc.8",
+  "version": "6.2.0-rc.9",
   "description": "Common library for all Battle Racing Repositorios",
   "main": "dist/index.js",
   "module": "dist/index.js",

package/src/data/all-tutorial-steps.ts

@@ -1,4 +1,5 @@
 import {
+  AllCommandsConfig,
   POWER_UP_NAME,
   SOUND_NAME,
   ScreenTutorialHud,
@@ -24,6 +25,26 @@ const nitroTutorialHud: ScreenTutorialHud = {
   powerUp: POWER_UP_NAME.BATTLE_NITRO,
 };
 
+const startDrivingCommands: AllCommandsConfig[] = [
+  { module: 'speed', action: 'activate' },
+  { module: 'speed', action: 'change', params: { speed: '$kart.tutorialSpeed', forUnlimitedTime: true } },
+];
+
+const stopKartCommands: AllCommandsConfig[] = [
+  { module: 'speed', action: 'change', params: { speed: 0, forUnlimitedTime: true } },
+  { module: 'speed', action: 'deactivate' },
+];
+
+// The step fires the nitro, after it ends the speed module goes back to its default speed
+const returnToFinishCommands: AllCommandsConfig[] = [
+  {
+    module: 'speed',
+    action: 'configure',
+    params: { defaultSpeed: '$kart.tutorialReturnSpeed', timeDuration: '$kart.powerUpTime' },
+  },
+  { module: 'speed', action: 'activate' },
+];
+
 export const allTutorialConfig: TutorialMasterConfig = {
   id: 'tutorial-master-v1',
   name: 'Standard Circuit Induction Tutorial',
@@ -43,6 +64,7 @@ export const allTutorialConfig: TutorialMasterConfig = {
             durationMs: 5000,
           },
           triggerCommands: [
+            ...stopKartCommands,
             {
               module: 'screen',
               action: 'showTutorialView',
@@ -62,6 +84,7 @@ export const allTutorialConfig: TutorialMasterConfig = {
             durationMs: 6000,
           },
           triggerCommands: [
+            ...stopKartCommands,
             {
               module: 'screen',
               action: 'showTutorialView',
@@ -88,6 +111,7 @@ export const allTutorialConfig: TutorialMasterConfig = {
             durationMs: 4000,
           },
           triggerCommands: [
+            ...stopKartCommands,
             {
               module: 'screen',
               action: 'showTutorialView',
@@ -107,6 +131,7 @@ export const allTutorialConfig: TutorialMasterConfig = {
             durationMs: 5000,
           },
           triggerCommands: [
+            ...stopKartCommands,
             {
               module: 'screen',
               action: 'showTutorialView',
@@ -126,6 +151,7 @@ export const allTutorialConfig: TutorialMasterConfig = {
             durationMs: 6000,
           },
           triggerCommands: [
+            ...startDrivingCommands,
             {
               module: 'screen',
               action: 'showTutorialView',
@@ -152,6 +178,7 @@ export const allTutorialConfig: TutorialMasterConfig = {
             target: TUTORIAL_CHECKPOINT_TARGET.POWER_UP,
           },
           triggerCommands: [
+            ...startDrivingCommands,
             {
               module: 'screen',
               action: 'showTutorialView',
@@ -179,6 +206,7 @@ export const allTutorialConfig: TutorialMasterConfig = {
             button: TUTORIAL_STEERING_WHEEL_BUTTON.RIGHT,
           },
           triggerCommands: [
+            ...stopKartCommands,
             {
               module: 'screen',
               action: 'showTutorialView',
@@ -198,6 +226,7 @@ export const allTutorialConfig: TutorialMasterConfig = {
             button: TUTORIAL_STEERING_WHEEL_BUTTON.LEFT,
           },
           triggerCommands: [
+            ...stopKartCommands,
             {
               module: 'screen',
               action: 'showTutorialView',
@@ -217,6 +246,7 @@ export const allTutorialConfig: TutorialMasterConfig = {
             durationMs: 4000,
           },
           triggerCommands: [
+            ...stopKartCommands,
             {
               module: 'screen',
               action: 'showTutorialView',
@@ -236,6 +266,7 @@ export const allTutorialConfig: TutorialMasterConfig = {
             target: TUTORIAL_CHECKPOINT_TARGET.POWER_UP,
           },
           triggerCommands: [
+            ...startDrivingCommands,
             {
               module: 'screen',
               action: 'showTutorialView',
@@ -256,6 +287,7 @@ export const allTutorialConfig: TutorialMasterConfig = {
             button: TUTORIAL_STEERING_WHEEL_BUTTON.ANY,
           },
           triggerCommands: [
+            ...stopKartCommands,
             {
               module: 'screen',
               action: 'showTutorialView',
@@ -276,6 +308,7 @@ export const allTutorialConfig: TutorialMasterConfig = {
             button: TUTORIAL_STEERING_WHEEL_BUTTON.ANY,
           },
           triggerCommands: [
+            ...stopKartCommands,
             {
               module: 'screen',
               action: 'showTutorialView',
@@ -296,6 +329,7 @@ export const allTutorialConfig: TutorialMasterConfig = {
             button: TUTORIAL_STEERING_WHEEL_BUTTON.ANY,
           },
           triggerCommands: [
+            ...stopKartCommands,
             {
               module: 'screen',
               action: 'showTutorialView',
@@ -316,6 +350,7 @@ export const allTutorialConfig: TutorialMasterConfig = {
             button: TUTORIAL_STEERING_WHEEL_BUTTON.ANY,
           },
           triggerCommands: [
+            ...stopKartCommands,
             {
               module: 'screen',
               action: 'showTutorialView',
@@ -343,6 +378,7 @@ export const allTutorialConfig: TutorialMasterConfig = {
             target: TUTORIAL_CHECKPOINT_TARGET.POWER_UP,
           },
           triggerCommands: [
+            ...startDrivingCommands,
             {
               module: 'screen',
               action: 'showTutorialView',
@@ -363,6 +399,7 @@ export const allTutorialConfig: TutorialMasterConfig = {
             button: TUTORIAL_STEERING_WHEEL_BUTTON.ANY,
           },
           triggerCommands: [
+            ...stopKartCommands,
             {
               module: 'screen',
               action: 'showTutorialView',
@@ -383,6 +420,7 @@ export const allTutorialConfig: TutorialMasterConfig = {
             button: TUTORIAL_STEERING_WHEEL_BUTTON.ANY,
           },
           triggerCommands: [
+            ...startDrivingCommands,
             {
               module: 'screen',
               action: 'showTutorialView',
@@ -398,11 +436,13 @@ export const allTutorialConfig: TutorialMasterConfig = {
           index: 3,
           name: 'Nitro Fired - Return to HUD',
           screenStep: TUTORIAL_SCREEN_STEP.POWER_UP_RETURN_TO_HUD,
+          executePowerUpId: 'battle-nitro',
           listenEvent: {
             on: TUTORIAL_LISTEN_EVENT_ON.CHECKPOINT,
             target: TUTORIAL_CHECKPOINT_TARGET.FINISH,
           },
           triggerCommands: [
+            ...returnToFinishCommands,
             {
               module: 'screen',
               action: 'showTutorialView',
@@ -430,6 +470,7 @@ export const allTutorialConfig: TutorialMasterConfig = {
             durationMs: 5000,
           },
           triggerCommands: [
+            ...stopKartCommands,
             {
               module: 'screen',
               action: 'showTutorialView',

package/src/domains/command/Command.schema.ts

@@ -14,7 +14,6 @@ import {
   showLightsColorParamsSchema,
   showLightsEffectParamsSchema,
   speedChangeOptionsSchema,
-  speedConfigurationSchema,
   starLaserConfigureModuleOptionsSchema,
   starLaserSendActionsOptionsSchema,
 } from '../hardware';
@@ -28,11 +27,20 @@ export const changeSpeedActionCommandOptionsSchema = speedChangeOptionsSchema.om
   speed: arithmeticOrNumberSchema,
 });
 
+export const configureSpeedActionCommandOptionsSchema = z.object({
+  defaultSpeed: arithmeticOrNumberSchema,
+  timeDuration: arithmeticOrNumberSchema,
+});
+
 export const speedModuleCommandSchema = z.union([
   z.object({ module: z.literal('speed'), action: z.literal('activate') }),
   z.object({ module: z.literal('speed'), action: z.literal('deactivate') }),
   z.object({ module: z.literal('speed'), action: z.literal('change'), params: changeSpeedActionCommandOptionsSchema }),
-  z.object({ module: z.literal('speed'), action: z.literal('configure'), params: speedConfigurationSchema }),
+  z.object({
+    module: z.literal('speed'),
+    action: z.literal('configure'),
+    params: configureSpeedActionCommandOptionsSchema,
+  }),
 ]);
 
 // --- Sound Commands ---

package/src/domains/game/Game.schema.ts

@@ -38,7 +38,7 @@ export const gameSchema = z.object({
   finishedReason: gameFinishedReasonSchema.optional(),
   kartsState: z.record(z.string(), gameKartStateSchema),
   gameRanking: z.array(kartRankingItemSchema),
-  tutorialConfigId: z.string().optional(),
+  tutorialConfigId: z.string().nullable().optional(),
 });
 
 export const assignKartSchema = z.object({

package/src/domains/game/battle/Battle.schema.ts

@@ -30,5 +30,4 @@ export const createBattleSchema = z.object({
   gameTrackId: z.string(),
   gameTurnId: z.string().optional(),
   isOfficial: z.boolean().optional(),
-  tutorialConfigId: z.string().optional(),
 });

package/src/domains/game/race/Race.schema.ts

@@ -80,5 +80,4 @@ export const createRaceSchema = startRaceSchema.partial().extend({
   gameTrackId: z.string(),
   gameTurnId: z.string().optional(),
   isOfficial: z.boolean().optional(),
-  tutorialConfigId: z.string().optional(),
 });

package/src/domains/gameTrack/GameTrack.schema.ts

@@ -20,6 +20,8 @@ export const gameTrackKartsConfigSchema = z.object({
   diskSensorBallShooter: configDiskSensorBallShooterModuleOptionsSchema,
   ballSensorDiskThrower: configureBallSensorDiskThrowerModuleOptionsSchema,
   lowSpeed: z.number().min(0).max(100),
+  tutorialSpeed: z.number().min(0).max(100),
+  tutorialReturnSpeed: z.number().min(0).max(100),
 });
 
 export const gameTrackKartConfigSchema = z.object({

package/src/domains/socket/serverToClient/SocketWebAppServerToClientEventsParams.ts

@@ -3,6 +3,7 @@ import type { GameTrack } from '../../gameTrack';
 import type { Kart } from '../../kart';
 import type { CheckpointEvent } from '../../kartTracking';
 import type { Response } from '../../response';
+import type { TutorialSession } from '../../tutorial';
 import type { MacAddressGameTrackConnections } from '../inputs';
 import type { SocketHardwareOnDataEventsParams } from '../SocketHardwareOnDataEventsParams';
 
@@ -19,6 +20,7 @@ export interface SocketWebAppServerToClientEventsParams {
     checkpointEvent: CheckpointEvent;
   };
   'game:changed': { game: Game };
+  'tutorial:session:changed': { session: TutorialSession };
   'gameTracks:onGameTrackUpdated': GameTrack[];
   'gameTracks:connectedRasperries': { macAddress: string }[];
   'gameTracks:list:response': Response<MacAddressGameTrackConnections>;

package/src/domains/tutorial/Tutorial.const.ts

@@ -61,19 +61,3 @@ export const TUTORIAL_CHECKPOINT_TARGET = {
 export const TUTORIAL_INPUT_SIGNAL_TYPE = {
   STEERING_WHEEL_BUTTON_PRESSED: 'SteeringWheelButtonPressed',
 } as const;
-
-export const DRIVING_TUTORIAL_STEPS = [
-  TUTORIAL_SCREEN_STEP.PEDAL,
-  TUTORIAL_SCREEN_STEP.DRIVE_TO_CONTROLS,
-  TUTORIAL_SCREEN_STEP.HUD_OVERVIEW,
-  TUTORIAL_SCREEN_STEP.POWER_UP_WAITING,
-  TUTORIAL_SCREEN_STEP.POWER_UP_NITRO_READY,
-  TUTORIAL_SCREEN_STEP.POWER_UP_RETURN_TO_HUD,
-] as const;
-
-export const isDrivingTutorialStep = (step?: string | null): boolean => {
-  if (!step) {
-    return false;
-  }
-  return (DRIVING_TUTORIAL_STEPS as readonly string[]).includes(step);
-};

package/src/domains/tutorial/Tutorial.schema.ts

@@ -1,4 +1,7 @@
 import { z } from 'zod';
+import { startBattleSchema } from '../game/battle/Battle.schema';
+import { gameTypeSchema } from '../game/Game.schema';
+import { startRaceSchema } from '../game/race/Race.schema';
 import { screenTutorialHudSchema } from '../hardware/screen/ScreenTutorial.schema';
 import {
   TUTORIAL_INPUT_SIGNAL_TYPE,
@@ -59,6 +62,11 @@ export const tutorialSteeringWheelButtonSchema = z.enum([
   TUTORIAL_STEERING_WHEEL_BUTTON.ANY,
 ]);
 
+export const tutorialInputButtonSchema = z.enum([
+  TUTORIAL_STEERING_WHEEL_BUTTON.RIGHT,
+  TUTORIAL_STEERING_WHEEL_BUTTON.LEFT,
+]);
+
 export const tutorialCheckpointTargetSchema = z.enum([
   TUTORIAL_CHECKPOINT_TARGET.TRACK,
   TUTORIAL_CHECKPOINT_TARGET.POWER_UP,
@@ -79,7 +87,7 @@ export const tutorialKartSnapshotSchema = z.object({
   awaitingCheckpointTarget: tutorialCheckpointTargetSchema.nullable().optional(),
   latestCheckpointId: z.string().optional(),
   latestCheckpointProgress: z.number().optional(),
-  updatedAtISO: z.string().datetime(),
+  updatedAtISO: z.iso.datetime(),
 });
 
 export const tutorialInputSignalTypeSchema = z.enum([TUTORIAL_INPUT_SIGNAL_TYPE.STEERING_WHEEL_BUTTON_PRESSED]);
@@ -89,12 +97,12 @@ export const tutorialKartEventBaseSchema = z.object({
   deviceId: z.string().min(1),
   revision: z.number().int().nonnegative(),
   sequence: z.number().int().nonnegative(),
-  originTimestampISO: z.string().datetime(),
+  originTimestampISO: z.iso.datetime(),
 });
 
 export const tutorialSteeringWheelButtonPressedSchema = tutorialKartEventBaseSchema.extend({
   type: z.literal(TUTORIAL_INPUT_SIGNAL_TYPE.STEERING_WHEEL_BUTTON_PRESSED),
-  button: tutorialSteeringWheelButtonSchema,
+  button: tutorialInputButtonSchema,
 });
 
 export const tutorialInputSignalSchema = z.discriminatedUnion('type', [tutorialSteeringWheelButtonPressedSchema]);
@@ -107,7 +115,7 @@ export const tutorialConfigurationSchema = z.object({
 });
 
 export const tutorialParticipantSchema = z.object({
-  deviceId: z.string().min(1),
+  kartGuid: z.string().min(1),
   playerId: z.string().optional(),
   status: tutorialStatusSchema,
   currentPhaseId: tutorialPhaseIdSchema,
@@ -126,34 +134,26 @@ export const tutorialParticipantSchema = z.object({
     })
     .optional(),
   totalDurationSeconds: z.number().int().default(180),
-  startedAtISO: z.string().optional(),
-  updatedAtISO: z.string(),
+  startedAtISO: z.iso.datetime().optional(),
+  updatedAtISO: z.iso.datetime(),
 });
 
 export const tutorialSessionSchema = z.object({
   id: z.string().min(1),
   gameTurnId: z.string().optional(),
-  gameId: z.union([z.string(), z.number()]).optional(),
+  gameId: z.number().int(),
+  gameType: gameTypeSchema,
   status: tutorialStatusSchema,
   participants: z.array(tutorialParticipantSchema),
-  createdAtISO: z.string(),
-  updatedAtISO: z.string(),
+  createdAtISO: z.iso.datetime(),
+  updatedAtISO: z.iso.datetime(),
 });
 
-export const startOperatorTutorialSchema = z.object({
-  gameId: z.number().int(),
-  gameType: z.enum(['Race', 'Battle']),
+const startTutorialOptionsSchema = z.object({
   tutorialConfigId: z.string().optional().default('BR_TUTORIAL_DEFAULT'),
-  params: z.object({
-    laps: z.number().int().optional(),
-    lives: z.number().int().optional(),
-    coins: z.number().int().min(0).max(254),
-    kartsGuids: z.array(z.string()).min(1),
-    powerUpsIds: z.array(z.string()).min(1),
-    time: z.number().int().min(30).max(1200),
-    speedConfig: z.number().int().min(20).max(100),
-    playerKartMap: z.record(z.string(), z.string()).optional(),
-  }),
   tutorialParams: tutorialConfigurationSchema.optional(),
 });
 
+export const startRaceTutorialSchema = startRaceSchema.extend(startTutorialOptionsSchema.shape);
+
+export const startBattleTutorialSchema = startBattleSchema.extend(startTutorialOptionsSchema.shape);

package/src/domains/tutorial/Tutorial.types.ts

@@ -10,10 +10,12 @@ import {
   tutorialStatusSchema,
   tutorialSteeringWheelButtonPressedSchema,
   tutorialSteeringWheelButtonSchema,
+  tutorialInputButtonSchema,
   tutorialConfigurationSchema,
   tutorialParticipantSchema,
   tutorialSessionSchema,
-  startOperatorTutorialSchema,
+  startRaceTutorialSchema,
+  startBattleTutorialSchema,
 } from './Tutorial.schema';
 
 export type TutorialScreenStep = z.infer<typeof tutorialScreenStepSchema>;
@@ -21,6 +23,7 @@ export type TutorialStatus = z.infer<typeof tutorialStatusSchema>;
 export type TutorialPhaseId = z.infer<typeof tutorialPhaseIdSchema>;
 export type TutorialListenEventOn = z.infer<typeof tutorialListenEventOnSchema>;
 export type TutorialSteeringWheelButton = z.infer<typeof tutorialSteeringWheelButtonSchema>;
+export type TutorialInputButton = z.infer<typeof tutorialInputButtonSchema>;
 export type TutorialCheckpointTarget = z.infer<typeof tutorialCheckpointTargetSchema>;
 export type TutorialKartSnapshot = z.infer<typeof tutorialKartSnapshotSchema>;
 export type TutorialInputSignalType = z.infer<typeof tutorialInputSignalTypeSchema>;
@@ -29,5 +32,5 @@ export type TutorialInputSignal = z.infer<typeof tutorialInputSignalSchema>;
 export type TutorialConfiguration = z.infer<typeof tutorialConfigurationSchema>;
 export type TutorialParticipant = z.infer<typeof tutorialParticipantSchema>;
 export type TutorialSession = z.infer<typeof tutorialSessionSchema>;
-export type StartOperatorTutorial = z.infer<typeof startOperatorTutorialSchema>;
-
+export type StartRaceTutorial = z.infer<typeof startRaceTutorialSchema>;
+export type StartBattleTutorial = z.infer<typeof startBattleTutorialSchema>;

package/src/domains/tutorial/TutorialConfig.schema.ts

@@ -36,6 +36,7 @@ export const tutorialStepConfigSchema = z.object({
   screenStep: tutorialScreenStepSchema,
   listenEvent: tutorialListenEventSchema,
   triggerCommands: z.array(allCommandsConfigSchema),
+  executePowerUpId: z.string().optional(),
 });
 
 export const tutorialPhaseConfigSchema = z.object({

package/src/domains/utils/Utils.schema.ts

@@ -5,10 +5,15 @@ export const arithmeticOperatorSchema = z.enum(['+', '-', '*', '/']);
 // Regex for SimpleArithmeticString: check for operator followed by numbers
 export const simpleArithmeticStringSchema = z.string().regex(/^[\+\-\*\/]-?\d+(\.\d+)?$/);
 
-// Regex for ContextArithmeticString: $variable operator number
-export const kartContextVariableSchema = z.enum(['$kart.configuredSpeed', '$kart.powerUpTime']);
+// Regex for ContextArithmeticString: $variable, optionally followed by operator number
+export const kartContextVariableSchema = z.enum([
+  '$kart.configuredSpeed',
+  '$kart.powerUpTime',
+  '$kart.tutorialSpeed',
+  '$kart.tutorialReturnSpeed',
+]);
 
-export const contextArithmeticStringSchema = z.string().regex(/^\$[a-zA-Z0-9\.]+\s[\+\-\*\/]\s-?\d+(\.\d+)?$/);
+export const contextArithmeticStringSchema = z.string().regex(/^\$[a-zA-Z0-9\.]+(\s[\+\-\*\/]\s-?\d+(\.\d+)?)?$/);
 
 export const arithmeticExpressionSchema = z.union([
   z.number(),