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

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

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tutorialMasterConfigSchema = exports.tutorialPhaseConfigSchema = exports.tutorialStepConfigSchema = exports.tutorialListenEventSchema = exports.tutorialCheckpointListenEventSchema = exports.tutorialWheelButtonListenEventSchema = exports.tutorialTimeoutListenEventSchema = void 0;
+const zod_1 = require("zod");
+const Command_schema_1 = require("../command/Command.schema");
+const Tutorial_const_1 = require("./Tutorial.const");
+const Tutorial_schema_1 = require("./Tutorial.schema");
+exports.tutorialTimeoutListenEventSchema = zod_1.z.object({
+    on: zod_1.z.literal(Tutorial_const_1.TUTORIAL_LISTEN_EVENT_ON.TIMEOUT),
+    durationMs: zod_1.z.number().int().positive(),
+});
+exports.tutorialWheelButtonListenEventSchema = zod_1.z.object({
+    on: zod_1.z.literal(Tutorial_const_1.TUTORIAL_LISTEN_EVENT_ON.WHEEL_BUTTON),
+    button: Tutorial_schema_1.tutorialSteeringWheelButtonSchema,
+});
+exports.tutorialCheckpointListenEventSchema = zod_1.z.object({
+    on: zod_1.z.literal(Tutorial_const_1.TUTORIAL_LISTEN_EVENT_ON.CHECKPOINT),
+    checkpoint: Tutorial_schema_1.tutorialLogicalCheckpointSchema,
+});
+exports.tutorialListenEventSchema = zod_1.z.discriminatedUnion('on', [
+    exports.tutorialTimeoutListenEventSchema,
+    exports.tutorialWheelButtonListenEventSchema,
+    exports.tutorialCheckpointListenEventSchema,
+]);
+exports.tutorialStepConfigSchema = zod_1.z.object({
+    id: zod_1.z.string().min(1),
+    index: zod_1.z.number().int().nonnegative(),
+    name: zod_1.z.string().min(1),
+    screenStep: Tutorial_schema_1.tutorialScreenStepSchema,
+    listenEvent: exports.tutorialListenEventSchema,
+    triggerCommands: zod_1.z.array(Command_schema_1.allCommandsConfigSchema),
+});
+exports.tutorialPhaseConfigSchema = zod_1.z.object({
+    id: Tutorial_schema_1.tutorialPhaseIdSchema,
+    name: zod_1.z.string().min(1),
+    index: zod_1.z.number().int().nonnegative(),
+    steps: zod_1.z.array(exports.tutorialStepConfigSchema).min(1),
+});
+exports.tutorialMasterConfigSchema = zod_1.z.object({
+    id: zod_1.z.string().min(1),
+    name: zod_1.z.string().min(1),
+    phases: zod_1.z.array(exports.tutorialPhaseConfigSchema).min(1),
+});

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

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+import { tutorialCheckpointListenEventSchema, tutorialListenEventSchema, tutorialMasterConfigSchema, tutorialPhaseConfigSchema, tutorialStepConfigSchema, tutorialTimeoutListenEventSchema, tutorialWheelButtonListenEventSchema } from './TutorialConfig.schema';
+export type TutorialTimeoutListenEvent = z.infer<typeof tutorialTimeoutListenEventSchema>;
+export type TutorialWheelButtonListenEvent = z.infer<typeof tutorialWheelButtonListenEventSchema>;
+export type TutorialCheckpointListenEvent = z.infer<typeof tutorialCheckpointListenEventSchema>;
+export type TutorialListenEvent = z.infer<typeof tutorialListenEventSchema>;
+export type TutorialStepConfig = z.infer<typeof tutorialStepConfigSchema>;
+export type TutorialPhaseConfig = z.infer<typeof tutorialPhaseConfigSchema>;
+export type TutorialMasterConfig = z.infer<typeof tutorialMasterConfigSchema>;

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

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

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

@@ -1,3 +1,5 @@
 export * from './Tutorial.const';
 export * from './Tutorial.schema';
 export * from './Tutorial.types';
+export * from './TutorialConfig.schema';
+export * from './TutorialConfig.types';

package/dist/domains/tutorial/index.js

@@ -17,3 +17,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./Tutorial.const"), exports);
 __exportStar(require("./Tutorial.schema"), exports);
 __exportStar(require("./Tutorial.types"), exports);
+__exportStar(require("./TutorialConfig.schema"), exports);
+__exportStar(require("./TutorialConfig.types"), exports);

package/package.json

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

package/src/__deprecated__/constants/hardware/screen-view.ts

@@ -4,6 +4,7 @@ export const SCREEN_VIEW = {
   RACE: 'Race',
   GAME_SUMMARY: 'GameSummary',
   INSTRUCTION_VIDEO: 'InstructionVideo',
+  TUTORIAL: 'Tutorial',
   BATTLE: 'Battle',
   DEBUG: 'Debug',
 } as const;

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

@@ -0,0 +1,388 @@
+import {
+  POWER_UP_NAME,
+  ScreenTutorialHud,
+  TUTORIAL_LISTEN_EVENT_ON,
+  TUTORIAL_LOGICAL_CHECKPOINT,
+  TUTORIAL_PHASE_ID,
+  TUTORIAL_SCREEN_STEP,
+  TUTORIAL_STEERING_WHEEL_BUTTON,
+  TutorialMasterConfig,
+} from '../domains';
+
+const defaultTutorialHud: ScreenTutorialHud = {
+  position: { current: 1, total: 6 },
+  coins: 0,
+  gameTimeLeft: { minutes: 3, seconds: 0 },
+  laps: { current: 1, total: 1 },
+  powerUp: null,
+  powerUpAnimationTimeSeconds: null,
+};
+
+const nitroTutorialHud: ScreenTutorialHud = {
+  ...defaultTutorialHud,
+  powerUp: POWER_UP_NAME.BATTLE_NITRO,
+};
+
+export const allTutorialConfig: TutorialMasterConfig = {
+  id: 'tutorial-master-v1',
+  name: 'Standard Circuit Induction Tutorial',
+  phases: [
+    {
+      id: TUTORIAL_PHASE_ID.STARTING_POINT,
+      name: 'Starting Point',
+      index: 0,
+      steps: [
+        {
+          id: 'step_welcome',
+          index: 0,
+          name: 'Welcome Screen',
+          screenStep: TUTORIAL_SCREEN_STEP.WELCOME,
+          listenEvent: {
+            on: TUTORIAL_LISTEN_EVENT_ON.TIMEOUT,
+            durationMs: 5000,
+          },
+          triggerCommands: [
+            {
+              module: 'screen',
+              action: 'showTutorialView',
+              params: {
+                step: TUTORIAL_SCREEN_STEP.WELCOME,
+              },
+            },
+          ],
+        },
+        {
+          id: 'step_personal_items',
+          index: 1,
+          name: 'Personal Items Safety',
+          screenStep: TUTORIAL_SCREEN_STEP.PERSONAL_ITEMS,
+          listenEvent: {
+            on: TUTORIAL_LISTEN_EVENT_ON.TIMEOUT,
+            durationMs: 5000,
+          },
+          triggerCommands: [
+            {
+              module: 'screen',
+              action: 'showTutorialView',
+              params: {
+                step: TUTORIAL_SCREEN_STEP.PERSONAL_ITEMS,
+              },
+            },
+          ],
+        },
+        {
+          id: 'step_seat_belt',
+          index: 2,
+          name: 'Seat Belt Fastening',
+          screenStep: TUTORIAL_SCREEN_STEP.SEAT_BELT,
+          listenEvent: {
+            on: TUTORIAL_LISTEN_EVENT_ON.TIMEOUT,
+            durationMs: 5000,
+          },
+          triggerCommands: [
+            {
+              module: 'screen',
+              action: 'showTutorialView',
+              params: {
+                step: TUTORIAL_SCREEN_STEP.SEAT_BELT,
+              },
+            },
+          ],
+        },
+        {
+          id: 'step_pedal',
+          index: 3,
+          name: 'Pedal Acceleration Check',
+          screenStep: TUTORIAL_SCREEN_STEP.PEDAL,
+          listenEvent: {
+            on: TUTORIAL_LISTEN_EVENT_ON.CHECKPOINT,
+            checkpoint: TUTORIAL_LOGICAL_CHECKPOINT.CHECKPOINT_1,
+          },
+          triggerCommands: [
+            {
+              module: 'screen',
+              action: 'showTutorialView',
+              params: {
+                step: TUTORIAL_SCREEN_STEP.PEDAL,
+              },
+            },
+          ],
+        },
+      ],
+    },
+    {
+      id: TUTORIAL_PHASE_ID.CHECKPOINT_1,
+      name: 'Checkpoint 1 - Controls and HUD',
+      index: 1,
+      steps: [
+        {
+          id: 'step_wheel_0_of_2',
+          index: 0,
+          name: 'Wheel Button Right Check',
+          screenStep: TUTORIAL_SCREEN_STEP.WHEEL_CONTROLS_0_OF_2,
+          listenEvent: {
+            on: TUTORIAL_LISTEN_EVENT_ON.WHEEL_BUTTON,
+            button: TUTORIAL_STEERING_WHEEL_BUTTON.RIGHT,
+          },
+          triggerCommands: [
+            {
+              module: 'screen',
+              action: 'showTutorialView',
+              params: {
+                step: TUTORIAL_SCREEN_STEP.WHEEL_CONTROLS_0_OF_2,
+              },
+            },
+          ],
+        },
+        {
+          id: 'step_wheel_1_of_2',
+          index: 1,
+          name: 'Wheel Button Left Check',
+          screenStep: TUTORIAL_SCREEN_STEP.WHEEL_CONTROLS_1_OF_2,
+          listenEvent: {
+            on: TUTORIAL_LISTEN_EVENT_ON.WHEEL_BUTTON,
+            button: TUTORIAL_STEERING_WHEEL_BUTTON.LEFT,
+          },
+          triggerCommands: [
+            {
+              module: 'screen',
+              action: 'showTutorialView',
+              params: {
+                step: TUTORIAL_SCREEN_STEP.WHEEL_CONTROLS_1_OF_2,
+              },
+            },
+          ],
+        },
+        {
+          id: 'step_wheel_completed',
+          index: 2,
+          name: 'Wheel Controls Success',
+          screenStep: TUTORIAL_SCREEN_STEP.WHEEL_CONTROLS_COMPLETED,
+          listenEvent: {
+            on: TUTORIAL_LISTEN_EVENT_ON.TIMEOUT,
+            durationMs: 5000,
+          },
+          triggerCommands: [
+            {
+              module: 'screen',
+              action: 'showTutorialView',
+              params: {
+                step: TUTORIAL_SCREEN_STEP.WHEEL_CONTROLS_COMPLETED,
+              },
+            },
+          ],
+        },
+        {
+          id: 'step_hud_overview',
+          index: 3,
+          name: 'HUD Overview Explanation',
+          screenStep: TUTORIAL_SCREEN_STEP.HUD_OVERVIEW,
+          listenEvent: {
+            on: TUTORIAL_LISTEN_EVENT_ON.WHEEL_BUTTON,
+            button: TUTORIAL_STEERING_WHEEL_BUTTON.ANY,
+          },
+          triggerCommands: [
+            {
+              module: 'screen',
+              action: 'showTutorialView',
+              params: {
+                step: TUTORIAL_SCREEN_STEP.HUD_OVERVIEW,
+                hud: defaultTutorialHud,
+              },
+            },
+          ],
+        },
+        {
+          id: 'step_hud_position',
+          index: 4,
+          name: 'HUD Position Indicator',
+          screenStep: TUTORIAL_SCREEN_STEP.HUD_POSITION,
+          listenEvent: {
+            on: TUTORIAL_LISTEN_EVENT_ON.WHEEL_BUTTON,
+            button: TUTORIAL_STEERING_WHEEL_BUTTON.ANY,
+          },
+          triggerCommands: [
+            {
+              module: 'screen',
+              action: 'showTutorialView',
+              params: {
+                step: TUTORIAL_SCREEN_STEP.HUD_POSITION,
+                hud: defaultTutorialHud,
+              },
+            },
+          ],
+        },
+        {
+          id: 'step_hud_laps',
+          index: 5,
+          name: 'HUD Lap Counter',
+          screenStep: TUTORIAL_SCREEN_STEP.HUD_LAPS,
+          listenEvent: {
+            on: TUTORIAL_LISTEN_EVENT_ON.WHEEL_BUTTON,
+            button: TUTORIAL_STEERING_WHEEL_BUTTON.ANY,
+          },
+          triggerCommands: [
+            {
+              module: 'screen',
+              action: 'showTutorialView',
+              params: {
+                step: TUTORIAL_SCREEN_STEP.HUD_LAPS,
+                hud: defaultTutorialHud,
+              },
+            },
+          ],
+        },
+        {
+          id: 'step_hud_time_left',
+          index: 6,
+          name: 'HUD Time Left',
+          screenStep: TUTORIAL_SCREEN_STEP.HUD_TIME_LEFT,
+          listenEvent: {
+            on: TUTORIAL_LISTEN_EVENT_ON.WHEEL_BUTTON,
+            button: TUTORIAL_STEERING_WHEEL_BUTTON.ANY,
+          },
+          triggerCommands: [
+            {
+              module: 'screen',
+              action: 'showTutorialView',
+              params: {
+                step: TUTORIAL_SCREEN_STEP.HUD_TIME_LEFT,
+                hud: defaultTutorialHud,
+              },
+            },
+          ],
+        },
+        {
+          id: 'step_hud_coins',
+          index: 7,
+          name: 'HUD Coins and Checkpoint 2 Target',
+          screenStep: TUTORIAL_SCREEN_STEP.HUD_COINS,
+          listenEvent: {
+            on: TUTORIAL_LISTEN_EVENT_ON.CHECKPOINT,
+            checkpoint: TUTORIAL_LOGICAL_CHECKPOINT.CHECKPOINT_2,
+          },
+          triggerCommands: [
+            {
+              module: 'screen',
+              action: 'showTutorialView',
+              params: {
+                step: TUTORIAL_SCREEN_STEP.HUD_COINS,
+                hud: defaultTutorialHud,
+              },
+            },
+          ],
+        },
+      ],
+    },
+    {
+      id: TUTORIAL_PHASE_ID.CHECKPOINT_2,
+      name: 'Checkpoint 2 - Power Up Preview',
+      index: 2,
+      steps: [
+        {
+          id: 'step_power_up_waiting',
+          index: 0,
+          name: 'Power Up Allocation Trigger',
+          screenStep: TUTORIAL_SCREEN_STEP.POWER_UP_WAITING,
+          listenEvent: {
+            on: TUTORIAL_LISTEN_EVENT_ON.TIMEOUT,
+            durationMs: 1000,
+          },
+          triggerCommands: [
+            {
+              module: 'screen',
+              action: 'showTutorialView',
+              params: {
+                step: TUTORIAL_SCREEN_STEP.POWER_UP_WAITING,
+              },
+            },
+          ],
+        },
+        {
+          id: 'step_power_up_roulette',
+          index: 1,
+          name: 'Power Up Roulette Animation',
+          screenStep: TUTORIAL_SCREEN_STEP.POWER_UP_ROULETTE,
+          listenEvent: {
+            on: TUTORIAL_LISTEN_EVENT_ON.TIMEOUT,
+            durationMs: 3000,
+          },
+          triggerCommands: [
+            {
+              module: 'screen',
+              action: 'showTutorialView',
+              params: {
+                step: TUTORIAL_SCREEN_STEP.POWER_UP_ROULETTE,
+              },
+            },
+          ],
+        },
+        {
+          id: 'step_power_up_nitro_ready',
+          index: 2,
+          name: 'Power Up Nitro Ready To Fire',
+          screenStep: TUTORIAL_SCREEN_STEP.POWER_UP_NITRO_READY,
+          listenEvent: {
+            on: TUTORIAL_LISTEN_EVENT_ON.WHEEL_BUTTON,
+            button: TUTORIAL_STEERING_WHEEL_BUTTON.ANY,
+          },
+          triggerCommands: [
+            {
+              module: 'screen',
+              action: 'showTutorialView',
+              params: {
+                step: TUTORIAL_SCREEN_STEP.POWER_UP_NITRO_READY,
+              },
+            },
+          ],
+        },
+        {
+          id: 'step_power_up_return_to_hud',
+          index: 3,
+          name: 'Nitro Fired - Return to HUD',
+          screenStep: TUTORIAL_SCREEN_STEP.POWER_UP_RETURN_TO_HUD,
+          listenEvent: {
+            on: TUTORIAL_LISTEN_EVENT_ON.CHECKPOINT,
+            checkpoint: TUTORIAL_LOGICAL_CHECKPOINT.CHECKPOINT_3_FINISH,
+          },
+          triggerCommands: [
+            {
+              module: 'screen',
+              action: 'showTutorialView',
+              params: {
+                step: TUTORIAL_SCREEN_STEP.POWER_UP_RETURN_TO_HUD,
+                hud: nitroTutorialHud,
+              },
+            },
+          ],
+        },
+      ],
+    },
+    {
+      id: TUTORIAL_PHASE_ID.LAP_COMPLETION,
+      name: 'Lap Completion',
+      index: 3,
+      steps: [
+        {
+          id: 'step_tutorial_completed',
+          index: 0,
+          name: 'Tutorial Completed Screen',
+          screenStep: TUTORIAL_SCREEN_STEP.TUTORIAL_COMPLETED,
+          listenEvent: {
+            on: TUTORIAL_LISTEN_EVENT_ON.TIMEOUT,
+            durationMs: 5000,
+          },
+          triggerCommands: [
+            {
+              module: 'screen',
+              action: 'showTutorialView',
+              params: {
+                step: TUTORIAL_SCREEN_STEP.TUTORIAL_COMPLETED,
+              },
+            },
+          ],
+        },
+      ],
+    },
+  ],
+};

package/src/data/index.ts

@@ -1,4 +1,4 @@
 export * from './all-damages';
 export * from './all-power-ups';
+export * from './all-tutorial-steps';
 export * from './role-definitions';
-

package/src/domains/hardware/screen/Screen.const.ts

@@ -12,6 +12,7 @@ export const SCREEN_VIEW = {
   RACE: 'Race',
   GAME_SUMMARY: 'GameSummary',
   INSTRUCTION_VIDEO: 'InstructionVideo',
+  TUTORIAL: 'Tutorial',
   BATTLE: 'Battle',
   DEBUG: 'Debug',
 } as const;

package/src/domains/socket/clientToServer/SocketKartClientToServerEventsParams.ts

@@ -1,10 +1,13 @@
 import type { DamageEffectName } from '../../damage';
 import type { Kart } from '../../kart';
+import type { TutorialInputSignal } from '../../tutorial';
 import type { SocketInitKartInput, SocketRegisterKartCheckpointInput } from '../inputs';
 
 export interface SocketKartClientToServerEventsParams {
   'kart:init': SocketInitKartInput;
   'kart:checkpoint': SocketRegisterKartCheckpointInput;
+  /** Report tutorial input signal from Kart (e.g. steering wheel button) */
+  'kart:tutorial:input': TutorialInputSignal;
   /** Activate the damage of a powerUp  */
   'kart:damage:sent': { damageName: DamageEffectName };
   /** The Kart received damage  */

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

@@ -3,6 +3,7 @@ import type { GameTrack, GameTrackKartConfig, GameTrackKartsConfig } from '../..
 import type { Kart, KartStatus } from '../../kart';
 import type { Response } from '../../response';
 import type { SocketPowerUpEventsParams } from '../SocketPowerUpEventsParams';
+import type { TutorialKartSnapshot } from '../../tutorial';
 
 interface BaseGameEventParams {
   gameId: Game['id'];
@@ -25,6 +26,8 @@ export interface SocketKartEventsParams {
   'kart:gameTrack:emergency:stopped': undefined;
   /** Force kart to change status */
   'kart:status:change': { status: KartStatus };
+  /** Synchronize authoritative tutorial state snapshot to Kart */
+  'kart:tutorial:sync': TutorialKartSnapshot;
 }
 
 export interface SocketGameEventParams {

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

@@ -21,3 +21,39 @@ export const TUTORIAL_SCREEN_STEP = {
 
   TUTORIAL_COMPLETED: 'TutorialCompleted',
 } as const;
+
+export const TUTORIAL_STATUS = {
+  PENDING: 'PENDING',
+  IN_PROGRESS: 'IN_PROGRESS',
+  COMPLETED: 'COMPLETED',
+  SKIPPED: 'SKIPPED',
+} as const;
+
+export const TUTORIAL_PHASE_ID = {
+  STARTING_POINT: 'starting_point',
+  CHECKPOINT_1: 'checkpoint_1',
+  CHECKPOINT_2: 'checkpoint_2',
+  LAP_COMPLETION: 'lap_completion',
+} as const;
+
+export const TUTORIAL_LISTEN_EVENT_ON = {
+  TIMEOUT: 'timeout',
+  WHEEL_BUTTON: 'wheelButton',
+  CHECKPOINT: 'checkpoint',
+} as const;
+
+export const TUTORIAL_STEERING_WHEEL_BUTTON = {
+  RIGHT: 'right',
+  LEFT: 'left',
+  ANY: 'any',
+} as const;
+
+export const TUTORIAL_LOGICAL_CHECKPOINT = {
+  CHECKPOINT_1: 'checkpoint_1',
+  CHECKPOINT_2: 'checkpoint_2',
+  CHECKPOINT_3_FINISH: 'checkpoint_3_finish',
+} as const;
+
+export const TUTORIAL_INPUT_SIGNAL_TYPE = {
+  STEERING_WHEEL_BUTTON_PRESSED: 'SteeringWheelButtonPressed',
+} as const;

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

@@ -1,5 +1,14 @@
 import { z } from 'zod';
-import { TUTORIAL_SCREEN_STEP } from './Tutorial.const';
+import { screenTutorialHudSchema } from '../hardware/screen/ScreenTutorial.schema';
+import {
+  TUTORIAL_INPUT_SIGNAL_TYPE,
+  TUTORIAL_LISTEN_EVENT_ON,
+  TUTORIAL_LOGICAL_CHECKPOINT,
+  TUTORIAL_PHASE_ID,
+  TUTORIAL_SCREEN_STEP,
+  TUTORIAL_STATUS,
+  TUTORIAL_STEERING_WHEEL_BUTTON,
+} from './Tutorial.const';
 
 export const tutorialScreenStepSchema = z.enum([
   TUTORIAL_SCREEN_STEP.WELCOME,
@@ -20,3 +29,67 @@ export const tutorialScreenStepSchema = z.enum([
   TUTORIAL_SCREEN_STEP.POWER_UP_RETURN_TO_HUD,
   TUTORIAL_SCREEN_STEP.TUTORIAL_COMPLETED,
 ]);
+
+export const tutorialStatusSchema = z.enum([
+  TUTORIAL_STATUS.PENDING,
+  TUTORIAL_STATUS.IN_PROGRESS,
+  TUTORIAL_STATUS.COMPLETED,
+  TUTORIAL_STATUS.SKIPPED,
+]);
+
+export const tutorialPhaseIdSchema = z.enum([
+  TUTORIAL_PHASE_ID.STARTING_POINT,
+  TUTORIAL_PHASE_ID.CHECKPOINT_1,
+  TUTORIAL_PHASE_ID.CHECKPOINT_2,
+  TUTORIAL_PHASE_ID.LAP_COMPLETION,
+]);
+
+export const tutorialListenEventOnSchema = z.enum([
+  TUTORIAL_LISTEN_EVENT_ON.TIMEOUT,
+  TUTORIAL_LISTEN_EVENT_ON.WHEEL_BUTTON,
+  TUTORIAL_LISTEN_EVENT_ON.CHECKPOINT,
+]);
+
+export const tutorialSteeringWheelButtonSchema = z.enum([
+  TUTORIAL_STEERING_WHEEL_BUTTON.RIGHT,
+  TUTORIAL_STEERING_WHEEL_BUTTON.LEFT,
+  TUTORIAL_STEERING_WHEEL_BUTTON.ANY,
+]);
+
+export const tutorialLogicalCheckpointSchema = z.enum([
+  TUTORIAL_LOGICAL_CHECKPOINT.CHECKPOINT_1,
+  TUTORIAL_LOGICAL_CHECKPOINT.CHECKPOINT_2,
+  TUTORIAL_LOGICAL_CHECKPOINT.CHECKPOINT_3_FINISH,
+]);
+
+export const tutorialKartSnapshotSchema = z.object({
+  tutorialSessionId: z.string().min(1),
+  deviceId: z.string().min(1),
+  playerId: z.string().min(1).optional(),
+  status: tutorialStatusSchema,
+  currentPhaseId: tutorialPhaseIdSchema,
+  currentStep: tutorialScreenStepSchema,
+  revision: z.number().int().nonnegative(),
+  presentationRevision: z.number().int().nonnegative(),
+  hud: screenTutorialHudSchema.optional(),
+  awaitingCheckpoint: tutorialLogicalCheckpointSchema.nullable().optional(),
+  completedCheckpoints: z.array(tutorialLogicalCheckpointSchema).optional(),
+  updatedAtISO: z.string().datetime(),
+});
+
+export const tutorialInputSignalTypeSchema = z.enum([TUTORIAL_INPUT_SIGNAL_TYPE.STEERING_WHEEL_BUTTON_PRESSED]);
+
+export const tutorialKartEventBaseSchema = z.object({
+  tutorialSessionId: z.string().min(1),
+  deviceId: z.string().min(1),
+  revision: z.number().int().nonnegative(),
+  sequence: z.number().int().nonnegative(),
+  originTimestampISO: z.string().datetime(),
+});
+
+export const tutorialSteeringWheelButtonPressedSchema = tutorialKartEventBaseSchema.extend({
+  type: z.literal(TUTORIAL_INPUT_SIGNAL_TYPE.STEERING_WHEEL_BUTTON_PRESSED),
+  button: tutorialSteeringWheelButtonSchema,
+});
+
+export const tutorialInputSignalSchema = z.discriminatedUnion('type', [tutorialSteeringWheelButtonPressedSchema]);

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

@@ -1,4 +1,24 @@
 import { z } from 'zod';
-import { tutorialScreenStepSchema } from './Tutorial.schema';
+import {
+  tutorialInputSignalSchema,
+  tutorialInputSignalTypeSchema,
+  tutorialKartSnapshotSchema,
+  tutorialListenEventOnSchema,
+  tutorialLogicalCheckpointSchema,
+  tutorialPhaseIdSchema,
+  tutorialScreenStepSchema,
+  tutorialStatusSchema,
+  tutorialSteeringWheelButtonPressedSchema,
+  tutorialSteeringWheelButtonSchema,
+} 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 TutorialLogicalCheckpoint = z.infer<typeof tutorialLogicalCheckpointSchema>;
+export type TutorialKartSnapshot = z.infer<typeof tutorialKartSnapshotSchema>;
+export type TutorialInputSignalType = z.infer<typeof tutorialInputSignalTypeSchema>;
+export type TutorialSteeringWheelButtonPressed = z.infer<typeof tutorialSteeringWheelButtonPressedSchema>;
+export type TutorialInputSignal = z.infer<typeof tutorialInputSignalSchema>;