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

package/.claude/settings.local.json

@@ -0,0 +1,8 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(npm whoami *)",
+      "Bash(npm config *)"
+    ]
+  }
+}

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/arcade/Arcade.const.d.ts

@@ -0,0 +1,9 @@
+export declare const ARCADE_SESSION_STATUS: {
+    readonly ACTIVE: "ACTIVE";
+    readonly FINISHED: "FINISHED";
+    readonly ABANDONED: "ABANDONED";
+};
+export declare const ARCADE_SESSION_ORIGIN: {
+    readonly QR: "QR";
+    readonly ANONYMOUS: "ANONYMOUS";
+};

package/dist/domains/arcade/Arcade.const.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ARCADE_SESSION_ORIGIN = exports.ARCADE_SESSION_STATUS = void 0;
+exports.ARCADE_SESSION_STATUS = {
+    ACTIVE: 'ACTIVE',
+    FINISHED: 'FINISHED',
+    ABANDONED: 'ABANDONED',
+};
+exports.ARCADE_SESSION_ORIGIN = {
+    QR: 'QR',
+    ANONYMOUS: 'ANONYMOUS',
+};

package/dist/domains/arcade/Arcade.schema.d.ts

@@ -0,0 +1,83 @@
+import { z } from 'zod';
+export declare const arcadeSessionStatusSchema: z.ZodEnum<{
+    readonly ACTIVE: "ACTIVE";
+    readonly FINISHED: "FINISHED";
+    readonly ABANDONED: "ABANDONED";
+}>;
+export declare const arcadeSessionOriginSchema: z.ZodEnum<{
+    readonly QR: "QR";
+    readonly ANONYMOUS: "ANONYMOUS";
+}>;
+/** Readable id printed in the machine QR, e.g. "marble-table-01" */
+export declare const arcadeMachineIdSchema: z.ZodString;
+export declare const arcadeMachineSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    maxCoinsDelta: z.ZodNumber;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+    createdAt: z.ZodDate;
+}, z.core.$strip>;
+export declare const createArcadeMachineInputSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    maxCoinsDelta: z.ZodNumber;
+}, z.core.$strip>;
+export declare const qrArcadeSessionSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    machineId: z.ZodString;
+    status: z.ZodEnum<{
+        readonly ACTIVE: "ACTIVE";
+        readonly FINISHED: "FINISHED";
+        readonly ABANDONED: "ABANDONED";
+    }>;
+    coinsDelta: z.ZodOptional<z.ZodNumber>;
+    startedAt: z.ZodDate;
+    finishedAt: z.ZodOptional<z.ZodDate>;
+    origin: z.ZodLiteral<"QR">;
+    userId: z.ZodUUID;
+    startingBalance: z.ZodNumber;
+}, z.core.$strip>;
+export declare const anonymousArcadeSessionSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    machineId: z.ZodString;
+    status: z.ZodEnum<{
+        readonly ACTIVE: "ACTIVE";
+        readonly FINISHED: "FINISHED";
+        readonly ABANDONED: "ABANDONED";
+    }>;
+    coinsDelta: z.ZodOptional<z.ZodNumber>;
+    startedAt: z.ZodDate;
+    finishedAt: z.ZodOptional<z.ZodDate>;
+    origin: z.ZodLiteral<"ANONYMOUS">;
+}, z.core.$strip>;
+export declare const arcadeSessionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    id: z.ZodUUID;
+    machineId: z.ZodString;
+    status: z.ZodEnum<{
+        readonly ACTIVE: "ACTIVE";
+        readonly FINISHED: "FINISHED";
+        readonly ABANDONED: "ABANDONED";
+    }>;
+    coinsDelta: z.ZodOptional<z.ZodNumber>;
+    startedAt: z.ZodDate;
+    finishedAt: z.ZodOptional<z.ZodDate>;
+    origin: z.ZodLiteral<"QR">;
+    userId: z.ZodUUID;
+    startingBalance: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodUUID;
+    machineId: z.ZodString;
+    status: z.ZodEnum<{
+        readonly ACTIVE: "ACTIVE";
+        readonly FINISHED: "FINISHED";
+        readonly ABANDONED: "ABANDONED";
+    }>;
+    coinsDelta: z.ZodOptional<z.ZodNumber>;
+    startedAt: z.ZodDate;
+    finishedAt: z.ZodOptional<z.ZodDate>;
+    origin: z.ZodLiteral<"ANONYMOUS">;
+}, z.core.$strip>], "origin">;
+export declare const finishArcadeSessionInputSchema: z.ZodObject<{
+    sessionId: z.ZodUUID;
+    coinsDelta: z.ZodNumber;
+}, z.core.$strip>;

package/dist/domains/arcade/Arcade.schema.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.finishArcadeSessionInputSchema = exports.arcadeSessionSchema = exports.anonymousArcadeSessionSchema = exports.qrArcadeSessionSchema = exports.createArcadeMachineInputSchema = exports.arcadeMachineSchema = exports.arcadeMachineIdSchema = exports.arcadeSessionOriginSchema = exports.arcadeSessionStatusSchema = void 0;
+const zod_1 = require("zod");
+const wallet_1 = require("../wallet");
+const Arcade_const_1 = require("./Arcade.const");
+exports.arcadeSessionStatusSchema = zod_1.z.enum(Arcade_const_1.ARCADE_SESSION_STATUS);
+exports.arcadeSessionOriginSchema = zod_1.z.enum(Arcade_const_1.ARCADE_SESSION_ORIGIN);
+/** Readable id printed in the machine QR, e.g. "marble-table-01" */
+exports.arcadeMachineIdSchema = zod_1.z
+    .string()
+    .regex(/^[a-z0-9]+(-[a-z0-9]+)*$/, 'Machine id must use lowercase letters, numbers and dashes');
+exports.arcadeMachineSchema = zod_1.z.object({
+    id: exports.arcadeMachineIdSchema,
+    name: zod_1.z.string().min(1),
+    maxCoinsDelta: wallet_1.coinsAmountSchema.positive(),
+    isActive: zod_1.z.boolean().default(true),
+    createdAt: zod_1.z.date(),
+});
+exports.createArcadeMachineInputSchema = exports.arcadeMachineSchema.pick({
+    id: true,
+    name: true,
+    maxCoinsDelta: true,
+});
+const baseArcadeSessionSchema = zod_1.z.object({
+    id: zod_1.z.uuidv4(),
+    machineId: exports.arcadeMachineIdSchema,
+    status: exports.arcadeSessionStatusSchema,
+    coinsDelta: wallet_1.coinsAmountSchema.optional(),
+    startedAt: zod_1.z.date(),
+    finishedAt: zod_1.z.date().optional(),
+});
+exports.qrArcadeSessionSchema = baseArcadeSessionSchema.extend({
+    origin: zod_1.z.literal(Arcade_const_1.ARCADE_SESSION_ORIGIN.QR),
+    userId: zod_1.z.uuidv4(),
+    startingBalance: wallet_1.coinsAmountSchema.nonnegative(),
+});
+exports.anonymousArcadeSessionSchema = baseArcadeSessionSchema.extend({
+    origin: zod_1.z.literal(Arcade_const_1.ARCADE_SESSION_ORIGIN.ANONYMOUS),
+});
+exports.arcadeSessionSchema = zod_1.z.discriminatedUnion('origin', [
+    exports.qrArcadeSessionSchema,
+    exports.anonymousArcadeSessionSchema,
+]);
+exports.finishArcadeSessionInputSchema = zod_1.z.object({
+    sessionId: zod_1.z.uuidv4(),
+    coinsDelta: wallet_1.coinsAmountSchema,
+});

package/dist/domains/arcade/Arcade.types.d.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+import { anonymousArcadeSessionSchema, arcadeMachineIdSchema, arcadeMachineSchema, arcadeSessionOriginSchema, arcadeSessionSchema, arcadeSessionStatusSchema, createArcadeMachineInputSchema, finishArcadeSessionInputSchema, qrArcadeSessionSchema } from './Arcade.schema';
+export type ArcadeSessionStatus = z.infer<typeof arcadeSessionStatusSchema>;
+export type ArcadeSessionOrigin = z.infer<typeof arcadeSessionOriginSchema>;
+export type ArcadeMachineId = z.infer<typeof arcadeMachineIdSchema>;
+export type ArcadeMachine = z.infer<typeof arcadeMachineSchema>;
+export type CreateArcadeMachineInput = z.infer<typeof createArcadeMachineInputSchema>;
+export type QrArcadeSession = z.infer<typeof qrArcadeSessionSchema>;
+export type AnonymousArcadeSession = z.infer<typeof anonymousArcadeSessionSchema>;
+export type ArcadeSession = z.infer<typeof arcadeSessionSchema>;
+export type FinishArcadeSessionInput = z.infer<typeof finishArcadeSessionInputSchema>;

package/dist/domains/arcade/Arcade.types.js

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

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

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

package/dist/domains/arcade/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("./Arcade.const"), exports);
+__exportStar(require("./Arcade.schema"), exports);
+__exportStar(require("./Arcade.types"), exports);

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<{
@@ -332,6 +336,10 @@ export declare const rgbModuleCommandSchema: z.ZodUnion<readonly [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">;
@@ -357,6 +365,10 @@ export declare const rgbModuleCommandSchema: z.ZodUnion<readonly [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>]>;
 export declare const leftStarBackLaserModuleCommandSchema: z.ZodUnion<readonly [z.ZodObject<{
@@ -1267,6 +1279,10 @@ export declare const allCommandsConfigSchema: z.ZodIntersection<z.ZodUnion<reado
         }>;
         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">;
@@ -1292,6 +1308,10 @@ export declare const allCommandsConfigSchema: z.ZodIntersection<z.ZodUnion<reado
             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">;
@@ -1310,8 +1330,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

@@ -244,6 +244,10 @@ export declare const flowSchema: 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">;
@@ -269,6 +273,10 @@ export declare const flowSchema: 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">;
@@ -287,8 +295,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/hardware/KartHardwareState.schema.d.ts

@@ -13,7 +13,10 @@ export declare const kartHardwareStateSchema: z.ZodObject<{
         current: z.ZodNumber;
         configured: z.ZodNumber;
     }, z.core.$strip>>;
-    rgb: z.ZodNullable<z.ZodEnum<{
+    rgb: z.ZodRecord<z.ZodEnum<{
+        readonly FRONT: "front";
+        readonly BACK: "back";
+    }> & z.core.$partial, z.ZodEnum<{
         readonly SHOWING_COLOR: "Showing Color";
         readonly NOT_CONFIGURED: "Not Configured";
         readonly CONFIGURING_RGB: "Configuring RGB";

package/dist/domains/hardware/KartHardwareState.schema.js

@@ -16,7 +16,8 @@ exports.kartHardwareStateSchema = zod_1.z.object({
         configured: zod_1.z.number(),
     })
         .nullable(),
-    rgb: rgb_1.rgbStatusSchema.nullable(),
+    // Only the configured RGB modules have a key
+    rgb: zod_1.z.partialRecord(rgb_1.rgbModuleLabelSchema, rgb_1.rgbStatusSchema),
     flag: zod_1.z
         .object({
         status: flag_1.flagStatusSchema,