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

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

@@ -324,6 +324,10 @@ export declare const tutorialStepConfigSchema: z.ZodObject<{
             }>;
             brightness: z.ZodNumber;
             effectTime: z.ZodNumber;
+            targets: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                readonly FRONT: "front";
+                readonly BACK: "back";
+            }>>>;
         }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
         module: z.ZodLiteral<"rgb">;
@@ -349,6 +353,10 @@ export declare const tutorialStepConfigSchema: z.ZodObject<{
                 readonly EMERGENCY_EFFECT: "Emergency Effect";
                 readonly WAIT_EFFECT: "Wait Effect";
             }>;
+            targets: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                readonly FRONT: "front";
+                readonly BACK: "back";
+            }>>>;
         }, z.core.$strip>;
     }, z.core.$strip>]>, z.ZodUnion<readonly [z.ZodObject<{
         module: z.ZodLiteral<"speed">;
@@ -367,8 +375,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 +1075,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<{
@@ -1362,6 +1371,10 @@ export declare const tutorialPhaseConfigSchema: z.ZodObject<{
                 }>;
                 brightness: z.ZodNumber;
                 effectTime: z.ZodNumber;
+                targets: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                    readonly FRONT: "front";
+                    readonly BACK: "back";
+                }>>>;
             }, z.core.$strip>;
         }, z.core.$strip>, z.ZodObject<{
             module: z.ZodLiteral<"rgb">;
@@ -1387,6 +1400,10 @@ export declare const tutorialPhaseConfigSchema: z.ZodObject<{
                     readonly EMERGENCY_EFFECT: "Emergency Effect";
                     readonly WAIT_EFFECT: "Wait Effect";
                 }>;
+                targets: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                    readonly FRONT: "front";
+                    readonly BACK: "back";
+                }>>>;
             }, z.core.$strip>;
         }, z.core.$strip>]>, z.ZodUnion<readonly [z.ZodObject<{
             module: z.ZodLiteral<"speed">;
@@ -1405,8 +1422,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 +2122,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<{
@@ -2404,6 +2422,10 @@ export declare const tutorialMasterConfigSchema: z.ZodObject<{
                     }>;
                     brightness: z.ZodNumber;
                     effectTime: z.ZodNumber;
+                    targets: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                        readonly FRONT: "front";
+                        readonly BACK: "back";
+                    }>>>;
                 }, z.core.$strip>;
             }, z.core.$strip>, z.ZodObject<{
                 module: z.ZodLiteral<"rgb">;
@@ -2429,6 +2451,10 @@ export declare const tutorialMasterConfigSchema: z.ZodObject<{
                         readonly EMERGENCY_EFFECT: "Emergency Effect";
                         readonly WAIT_EFFECT: "Wait Effect";
                     }>;
+                    targets: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                        readonly FRONT: "front";
+                        readonly BACK: "back";
+                    }>>>;
                 }, z.core.$strip>;
             }, z.core.$strip>]>, z.ZodUnion<readonly [z.ZodObject<{
                 module: z.ZodLiteral<"speed">;
@@ -2447,8 +2473,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 +3173,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/dist/domains/wallet/Wallet.const.d.ts

@@ -0,0 +1,4 @@
+export declare const WALLET_TRANSACTION_TYPE: {
+    readonly ADMIN_ADJUSTMENT: "ADMIN_ADJUSTMENT";
+    readonly ARCADE_SESSION: "ARCADE_SESSION";
+};

package/dist/domains/wallet/Wallet.const.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WALLET_TRANSACTION_TYPE = void 0;
+exports.WALLET_TRANSACTION_TYPE = {
+    ADMIN_ADJUSTMENT: 'ADMIN_ADJUSTMENT',
+    ARCADE_SESSION: 'ARCADE_SESSION',
+};

package/dist/domains/wallet/Wallet.schema.d.ts

@@ -0,0 +1,57 @@
+import { z } from 'zod';
+export declare const walletTransactionTypeSchema: z.ZodEnum<{
+    readonly ADMIN_ADJUSTMENT: "ADMIN_ADJUSTMENT";
+    readonly ARCADE_SESSION: "ARCADE_SESSION";
+}>;
+export declare const coinsAmountSchema: z.ZodNumber;
+export declare const walletSchema: z.ZodObject<{
+    userId: z.ZodUUID;
+    balance: z.ZodNumber;
+    updatedAt: z.ZodDate;
+}, z.core.$strip>;
+export declare const adminAdjustmentTransactionSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    userId: z.ZodUUID;
+    amount: z.ZodNumber;
+    balanceAfter: z.ZodNumber;
+    createdAt: z.ZodDate;
+    type: z.ZodLiteral<"ADMIN_ADJUSTMENT">;
+    adminUserId: z.ZodUUID;
+    reason: z.ZodString;
+}, z.core.$strip>;
+export declare const arcadeSessionTransactionSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    userId: z.ZodUUID;
+    amount: z.ZodNumber;
+    balanceAfter: z.ZodNumber;
+    createdAt: z.ZodDate;
+    type: z.ZodLiteral<"ARCADE_SESSION">;
+    arcadeSessionId: z.ZodUUID;
+}, z.core.$strip>;
+export declare const walletTransactionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    id: z.ZodUUID;
+    userId: z.ZodUUID;
+    amount: z.ZodNumber;
+    balanceAfter: z.ZodNumber;
+    createdAt: z.ZodDate;
+    type: z.ZodLiteral<"ADMIN_ADJUSTMENT">;
+    adminUserId: z.ZodUUID;
+    reason: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodUUID;
+    userId: z.ZodUUID;
+    amount: z.ZodNumber;
+    balanceAfter: z.ZodNumber;
+    createdAt: z.ZodDate;
+    type: z.ZodLiteral<"ARCADE_SESSION">;
+    arcadeSessionId: z.ZodUUID;
+}, z.core.$strip>], "type">;
+export declare const walletTransactionsFilterSchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    cursor: z.ZodOptional<z.ZodISODateTime>;
+}, z.core.$strip>;
+export declare const walletAdjustmentInputSchema: z.ZodObject<{
+    userId: z.ZodUUID;
+    amount: z.ZodNumber;
+    reason: z.ZodString;
+}, z.core.$strip>;

package/dist/domains/wallet/Wallet.schema.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.walletAdjustmentInputSchema = exports.walletTransactionsFilterSchema = exports.walletTransactionSchema = exports.arcadeSessionTransactionSchema = exports.adminAdjustmentTransactionSchema = exports.walletSchema = exports.coinsAmountSchema = exports.walletTransactionTypeSchema = void 0;
+const zod_1 = require("zod");
+const Wallet_const_1 = require("./Wallet.const");
+exports.walletTransactionTypeSchema = zod_1.z.enum(Wallet_const_1.WALLET_TRANSACTION_TYPE);
+exports.coinsAmountSchema = zod_1.z.number().int();
+exports.walletSchema = zod_1.z.object({
+    userId: zod_1.z.uuidv4(),
+    balance: exports.coinsAmountSchema.nonnegative(),
+    updatedAt: zod_1.z.date(),
+});
+const baseWalletTransactionSchema = zod_1.z.object({
+    id: zod_1.z.uuidv4(),
+    userId: zod_1.z.uuidv4(),
+    /** Positive adds coins, negative removes coins */
+    amount: exports.coinsAmountSchema,
+    balanceAfter: exports.coinsAmountSchema.nonnegative(),
+    createdAt: zod_1.z.date(),
+});
+exports.adminAdjustmentTransactionSchema = baseWalletTransactionSchema.extend({
+    type: zod_1.z.literal(Wallet_const_1.WALLET_TRANSACTION_TYPE.ADMIN_ADJUSTMENT),
+    adminUserId: zod_1.z.uuidv4(),
+    reason: zod_1.z.string().min(1),
+});
+exports.arcadeSessionTransactionSchema = baseWalletTransactionSchema.extend({
+    type: zod_1.z.literal(Wallet_const_1.WALLET_TRANSACTION_TYPE.ARCADE_SESSION),
+    arcadeSessionId: zod_1.z.uuidv4(),
+});
+exports.walletTransactionSchema = zod_1.z.discriminatedUnion('type', [
+    exports.adminAdjustmentTransactionSchema,
+    exports.arcadeSessionTransactionSchema,
+]);
+exports.walletTransactionsFilterSchema = zod_1.z.object({
+    limit: zod_1.z.coerce.number().int().min(1).max(100).default(20),
+    /** `createdAt` of the last item from the previous page */
+    cursor: zod_1.z.iso.datetime().optional(),
+});
+exports.walletAdjustmentInputSchema = zod_1.z.object({
+    userId: zod_1.z.uuidv4(),
+    amount: exports.coinsAmountSchema.refine((value) => value !== 0, { message: 'Amount must not be zero' }),
+    reason: zod_1.z.string().min(1, 'Reason is required'),
+});

package/dist/domains/wallet/Wallet.types.d.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+import { adminAdjustmentTransactionSchema, arcadeSessionTransactionSchema, walletAdjustmentInputSchema, walletSchema, walletTransactionSchema, walletTransactionTypeSchema, walletTransactionsFilterSchema } from './Wallet.schema';
+export type WalletTransactionType = z.infer<typeof walletTransactionTypeSchema>;
+export type Wallet = z.infer<typeof walletSchema>;
+export type AdminAdjustmentTransaction = z.infer<typeof adminAdjustmentTransactionSchema>;
+export type ArcadeSessionTransaction = z.infer<typeof arcadeSessionTransactionSchema>;
+export type WalletTransaction = z.infer<typeof walletTransactionSchema>;
+export type WalletAdjustmentInput = z.infer<typeof walletAdjustmentInputSchema>;
+export type WalletTransactionsFilter = z.infer<typeof walletTransactionsFilterSchema>;

package/dist/domains/wallet/Wallet.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/domains/wallet/index.d.ts

@@ -0,0 +1,3 @@
+export * from './Wallet.const';
+export * from './Wallet.schema';
+export * from './Wallet.types';

package/dist/domains/wallet/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./Wallet.const"), exports);
+__exportStar(require("./Wallet.schema"), exports);
+__exportStar(require("./Wallet.types"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@battle-racing/br-common-lib",
-  "version": "6.2.0-rc.8",
+  "version": "6.2.0",
   "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/hardware/KartHardwareState.schema.ts

@@ -1,6 +1,6 @@
 import { checkpointTypeSchema } from '../checkpoint/Checkpoint.schema';
 import { flagStatusSchema } from './flag';
-import { rgbStatusSchema } from './rgb';
+import { rgbModuleLabelSchema, rgbStatusSchema } from './rgb';
 import { steeringWheelModuleStatusSchema } from './steering-wheel';
 import { screenStatusSchema } from './screen';
 import { speedStatusSchema } from './speed';
@@ -14,7 +14,8 @@ export const kartHardwareStateSchema = z.object({
       configured: z.number(),
     })
     .nullable(),
-  rgb: rgbStatusSchema.nullable(),
+  // Only the configured RGB modules have a key
+  rgb: z.partialRecord(rgbModuleLabelSchema, rgbStatusSchema),
   flag: z
     .object({
       status: flagStatusSchema,

package/src/domains/hardware/rgb/RGB.const.ts

@@ -11,3 +11,8 @@ export const RGB_ACTION_COMMANDS = {
   EXEC: 'Exec',
   CONFIGURE: 'Configure',
 } as const;
+
+export const RGB_MODULE_LABEL = {
+  FRONT: 'front',
+  BACK: 'back',
+} as const;

package/src/domains/hardware/rgb/RGB.schema.ts

@@ -1,13 +1,20 @@
 import { z } from 'zod';
 import { colorNameSchema } from '../../color';
 import { kartEffectSchema } from '../../hardware/kart-effect';
-import { RGB_STATUS, RGB_ACTION_COMMANDS } from './RGB.const';
+import { RGB_STATUS, RGB_ACTION_COMMANDS, RGB_MODULE_LABEL } from './RGB.const';
 
 export const rgbStatusSchema = z.enum(RGB_STATUS);
 
 export const rgbActionCommandSchema = z.enum(RGB_ACTION_COMMANDS);
 
+export const rgbModuleLabelSchema = z.enum(RGB_MODULE_LABEL);
+
+// When targets is missing the command goes to every configured RGB module
+export const rgbTargetsSchema = z.array(rgbModuleLabelSchema).min(1).optional();
+
 export const rgbModuleStatusSchema = z.object({
+  label: rgbModuleLabelSchema,
+  address: z.number(),
   rgbStatus: rgbStatusSchema,
   kartColor: colorNameSchema,
 });
@@ -16,8 +23,10 @@ export const rgbConfigurationOptionsSchema = z.object({
   kartColor: colorNameSchema,
   brightness: z.number().min(0).max(100),
   effectTime: z.number().min(1).max(25),
+  targets: rgbTargetsSchema,
 });
 
 export const rgbShowEffectOptionsSchema = z.object({
   effect: kartEffectSchema,
+  targets: rgbTargetsSchema,
 });

package/src/domains/hardware/rgb/RGB.types.ts

@@ -2,9 +2,11 @@ import { z } from 'zod';
 import {
   rgbActionCommandSchema,
   rgbConfigurationOptionsSchema,
+  rgbModuleLabelSchema,
   rgbModuleStatusSchema,
   rgbShowEffectOptionsSchema,
   rgbStatusSchema,
+  rgbTargetsSchema,
 } from './RGB.schema';
 
 export type RGBStatus = z.infer<typeof rgbStatusSchema>;
@@ -12,3 +14,5 @@ export type RGBModuleStatus = z.infer<typeof rgbModuleStatusSchema>;
 export type RGBConfigurationOptions = z.infer<typeof rgbConfigurationOptionsSchema>;
 export type RGBShowEffectOptions = z.infer<typeof rgbShowEffectOptionsSchema>;
 export type RGBActionCommand = z.infer<typeof rgbActionCommandSchema>;
+export type RGBModuleLabel = z.infer<typeof rgbModuleLabelSchema>;
+export type RGBTargets = z.infer<typeof rgbTargetsSchema>;