@battle-racing/br-common-lib 1.0.0

package/src/types/hardware/ModuleStatus.ts

@@ -0,0 +1,18 @@
+import type { BallSensorDiskThrowerModuleStatus } from './ballSensor';
+import type { DiskSensorBallShooterModuleStatus } from './diskSensor';
+import type { EmergencyModuleStatus } from './emergency';
+import type { FlagModuleStatus } from './flag';
+import type { RGBModuleStatus } from './rgb';
+import type { SpeedModuleStatus } from './speed';
+import type { StarLaserModuleStatus } from './star-laser';
+import type { SteeringWheelModuleStatus } from './steering-wheel';
+
+export type ModuleStatus =
+  | SpeedModuleStatus
+  | RGBModuleStatus
+  | FlagModuleStatus
+  | DiskSensorBallShooterModuleStatus
+  | BallSensorDiskThrowerModuleStatus
+  | StarLaserModuleStatus
+  | SteeringWheelModuleStatus
+  | EmergencyModuleStatus;

package/src/types/hardware/ballSensor/BallSensorCommand.ts

@@ -0,0 +1 @@
+export type BallSensorCommand = 'Deactivate Sensor' | 'Activate Sensor' | 'Configure Module';

package/src/types/hardware/ballSensor/BallSensorDiskThrowerModuleStatus.ts

@@ -0,0 +1,5 @@
+import type { BallSensorStatus } from './BallSensorStatus';
+
+export interface BallSensorDiskThrowerModuleStatus {
+  ballSensorStatus: BallSensorStatus;
+}

package/src/types/hardware/ballSensor/BallSensorStatus.ts

@@ -0,0 +1 @@
+export type BallSensorStatus = 'Sensor Standby' | 'Sensor Deactivated' | 'Sensor Activated' | 'Sensor Hit' | 'Unknown';

package/src/types/hardware/ballSensor/ConfigureBallSensorDiskThrowerModuleOptions.ts

@@ -0,0 +1,4 @@
+export type ConfigureBallSensorDiskThrowerModuleOptions = {
+  /** Time in seconds (between 1 - 25) */
+  waitTimeAfterHit: number;
+};

package/src/types/hardware/ballSensor/index.ts

@@ -0,0 +1,4 @@
+export * from './BallSensorCommand';
+export * from './BallSensorDiskThrowerModuleStatus';
+export * from './BallSensorStatus';
+export * from './ConfigureBallSensorDiskThrowerModuleOptions';

package/src/types/hardware/ballShooter/BallShooterCommand.ts

@@ -0,0 +1 @@
+export type BallShooterCommand = 'Shooter Off' | 'Shooter Ready' | 'Shooter Attack';

package/src/types/hardware/ballShooter/BallShooterStatus.ts

@@ -0,0 +1,6 @@
+export type BallShooterStatus =
+  | 'Shooter Deactivated'
+  | 'Shooter Preparing Engines'
+  | 'Shooter Accelerating Engines'
+  | 'Shooting Ball'
+  | 'Unknown';

package/src/types/hardware/ballShooter/index.ts

@@ -0,0 +1,2 @@
+export * from './BallShooterCommand';
+export * from './BallShooterStatus';

package/src/types/hardware/diskSensor/ConfigDiskSensorBallShooterModuleOptions.ts

@@ -0,0 +1,8 @@
+export type ConfigDiskSensorBallShooterModuleOptions = {
+  /** This is the % of energy or voltage the engine is going to use (between 0 - 100) */
+  prepareVoltagePercentage?: number;
+  /** This is the % of energy or voltage the engine is going to use (between 0 - 100)  */
+  attackVoltagePercentage?: number;
+  /** Time in seconds (between 1 - 25) */
+  waitTimeAfterHit?: number;
+};

package/src/types/hardware/diskSensor/DiskSensorBallShooterModuleStatus.ts

@@ -0,0 +1,5 @@
+import type { DiskSensorStatus } from './DiskSensorStatus';
+
+export interface DiskSensorBallShooterModuleStatus {
+  diskSensorStatus: DiskSensorStatus;
+}

package/src/types/hardware/diskSensor/DiskSensorCommand.ts

@@ -0,0 +1 @@
+export type DiskSensorCommand = 'Deactivate Sensor' | 'Activate Sensor' | 'Calibrate Sensor' | 'Configure Module';

package/src/types/hardware/diskSensor/DiskSensorStatus.ts

@@ -0,0 +1,9 @@
+export type DiskSensorStatus =
+  | 'Sensor Standby'
+  | 'Sensor Deactivated'
+  | 'Sensor Activated'
+  | 'Sensor Hit'
+  | 'Sensor Calibrated'
+  | 'Sensor In Zone'
+  | 'Module In Configuration'
+  | 'Unknown';

package/src/types/hardware/diskSensor/index.ts

@@ -0,0 +1,4 @@
+export * from './ConfigDiskSensorBallShooterModuleOptions';
+export * from './DiskSensorBallShooterModuleStatus';
+export * from './DiskSensorCommand';
+export * from './DiskSensorStatus';

package/src/types/hardware/diskThrower/DiskThrowerCommand.ts

@@ -0,0 +1 @@
+export type DiskThrowerCommand = 'Activate Thrower' | 'Deactivate Thrower' | 'Throw Disk';

package/src/types/hardware/diskThrower/DiskThrowerStatus.ts

@@ -0,0 +1 @@
+export type DiskThrowerStatus = 'Thrower Deactivated' | 'Thrower Activated' | 'Throwing Disk' | 'Unknown';

package/src/types/hardware/diskThrower/index.ts

@@ -0,0 +1,2 @@
+export * from './DiskThrowerCommand';
+export * from './DiskThrowerStatus';

package/src/types/hardware/emergency/EmergencyActionCommand.ts

@@ -0,0 +1 @@
+export type EmergencyActionCommand = 'Activate' | 'Deactivate';

package/src/types/hardware/emergency/EmergencyModuleStatus.ts

@@ -0,0 +1,5 @@
+import type { EmergencyStatus } from './EmergencyStatus';
+
+export type EmergencyModuleStatus = {
+  emergencyStatus: EmergencyStatus;
+};

package/src/types/hardware/emergency/EmergencyStatus.ts

@@ -0,0 +1 @@
+export type EmergencyStatus = 'Standby' | 'Activated' | 'Deactivated' | 'In Emergency' | 'Unknown';

package/src/types/hardware/emergency/index.ts

@@ -0,0 +1,3 @@
+export * from './EmergencyActionCommand';
+export * from './EmergencyModuleStatus';
+export * from './EmergencyStatus';

package/src/types/hardware/flag/FlagActionCommand.ts

@@ -0,0 +1,6 @@
+export type FlagActionCommand =
+  | 'Activate'
+  | 'Deactivate'
+  | 'Show Media Indefinitely'
+  | 'Show Media Temporarily'
+  | 'Configure';

package/src/types/hardware/flag/FlagConfigurationOptions.ts

@@ -0,0 +1,11 @@
+import type { ColorName } from '../../color';
+
+export interface FlagConfigurationOptions {
+  kartId: number;
+  kartNumber: number;
+  kartColor: ColorName;
+  /** % Of Brightness (0 - 100) */
+  screenBrightness: number;
+  /** Time in seconds (between 1 - 25) */
+  animationTime: number;
+}

package/src/types/hardware/flag/FlagMediaName.ts

@@ -0,0 +1,87 @@
+export enum FlagMediaName {
+  // Cyan Numbers
+  NUMBER_0_CYAN = 'number_0_cyan',
+  NUMBER_1_CYAN = 'number_1_cyan',
+  NUMBER_2_CYAN = 'number_2_cyan',
+  NUMBER_3_CYAN = 'number_3_cyan',
+  NUMBER_4_CYAN = 'number_4_cyan',
+  NUMBER_5_CYAN = 'number_5_cyan',
+  NUMBER_6_CYAN = 'number_6_cyan',
+  NUMBER_7_CYAN = 'number_7_cyan',
+  NUMBER_8_CYAN = 'number_8_cyan',
+  NUMBER_9_CYAN = 'number_9_cyan',
+
+  // Pink Numbers
+  NUMBER_0_PINK = 'number_0_pink',
+  NUMBER_1_PINK = 'number_1_pink',
+  NUMBER_2_PINK = 'number_2_pink',
+  NUMBER_3_PINK = 'number_3_pink',
+  NUMBER_4_PINK = 'number_4_pink',
+  NUMBER_5_PINK = 'number_5_pink',
+  NUMBER_6_PINK = 'number_6_pink',
+  NUMBER_7_PINK = 'number_7_pink',
+  NUMBER_8_PINK = 'number_8_pink',
+  NUMBER_9_PINK = 'number_9_pink',
+
+  // Hearts
+  HEART_00 = 'heart_00',
+  HEART_01 = 'heart_01',
+  HEART_02 = 'heart_02',
+  HEART_03 = 'heart_03',
+  HEART_04 = 'heart_04',
+  HEART_05 = 'heart_05',
+  HEART_06 = 'heart_06',
+  HEART_07 = 'heart_07',
+  HEART_08 = 'heart_08',
+  HEART_09 = 'heart_09',
+  HEART_10 = 'heart_10',
+  HEART_11 = 'heart_11',
+  HEART_12 = 'heart_12',
+
+  // Emojis
+  SMILE = 'smile',
+  POOP = 'poop',
+  HEART = 'heart',
+  LAUGH_WITH_TONGUE_FACE = 'laugh_with_tonge_face',
+  LAUGH_WITH_TONGUE_AND_GLASSES_FACE = 'laugh_with_tonge_and_glases_face',
+  WINK_TO_SMILE_FACE = 'wink_to_smile_face',
+  LAUGH_WITH_TONGUE_AND_HELMET = 'laugh_with_tonge_and_helmet',
+  BLUE_SMILE_FACE = 'blue_smile_face',
+  BLUE_SMILE_FACE_TO_PINK = 'blue_smile_face_to_pink',
+  PINK_FACE_WITH_GLASSES_TO_BLUE = 'pink_face_with_glases_to_blue',
+  BLUE_CRYING_FACE = 'blue_crying_face',
+  BLUSH_SMILE_FACE_TO_SMILE = 'blush_smile_face_to_smile',
+  CRYING_FACE = 'crying_face',
+  ANGRY_FACE = 'angry_face',
+  IN_LOVE_FACE = 'in_love_face',
+  FACE_WITH_GLASSES = 'face_with_glases',
+  DEVIL = 'devil',
+  GHOST = 'ghost',
+  SKULL = 'skull',
+  LIKE = 'like',
+
+  // Flag Power-Ups
+  RANDOM_EFFECT = 'random_effect',
+  HELMET_BLACK_BACKGROUND = 'helmet_black_background',
+  THUNDER_EXPLOSION = 'thunder_explosion',
+  SHIELD_BLUE_TO_PINK = 'shield_blue_to_pink',
+  FALLING_OIL_DROP = 'falling_oil_drop',
+  OIL_DROP_COLORS = 'oil_drop_colors',
+  TURBO = 'turbo',
+  FIREBALL = 'fireball',
+  HIT_EFFECT = 'hit_effect',
+  SLOW_SNAIL = 'slow_snail',
+  NITRO_BOTTLE = 'nitro_bottle',
+  ROCKET_LAUNCHING = 'rocket_launching',
+
+  // Game Effects
+  SPEED_METER_INCREASING = 'speed_meter_increasing',
+  THREE_TWO_ONE_RACE_START = 'three_two_one_race_start',
+  VICTORY = 'victory',
+  DANGER_YELLOW_AND_RED = 'danger_yellow_and_red',
+  DANGER_RED_AND_WHITE_RED = 'danger_red_and_white_red',
+  REPAIR_TOOLS = 'repair_tools',
+
+  // Logos
+  BR_CHANGE_COLOR = 'br_change_color',
+}

package/src/types/hardware/flag/FlagModuleStatus.ts

@@ -0,0 +1,8 @@
+import type { CheckpointType } from '../../checkpoint';
+import type { FlagStatus } from './FlagStatus';
+
+export type FlagModuleStatus = {
+  flagStatus: FlagStatus;
+  lastCheckpointAddress: number;
+  lastCheckpointType: CheckpointType;
+};

package/src/types/hardware/flag/FlagShowMediaOptions.ts

@@ -0,0 +1,15 @@
+import type { FlagMediaName } from './FlagMediaName';
+
+export type FlagShowMediaOptions = {
+  screens: {
+    /** Bit 0 */
+    left: boolean;
+    /** Bit 1 */
+    right: boolean;
+    /** Bit 2 */
+    front: boolean;
+    /** Bit 3 */
+    back: boolean;
+  };
+  mediaSourceName: FlagMediaName;
+};

package/src/types/hardware/flag/FlagStatus.ts

@@ -0,0 +1,8 @@
+export type FlagStatus =
+  | 'Standby'
+  | 'Deactivated'
+  | 'Activated'
+  | 'Hit'
+  | 'Showing Image'
+  | 'Showing Animation'
+  | 'Unknown';

package/src/types/hardware/flag/index.ts

@@ -0,0 +1,6 @@
+export * from './FlagActionCommand';
+export * from './FlagConfigurationOptions';
+export * from './FlagMediaName';
+export * from './FlagModuleStatus';
+export * from './FlagShowMediaOptions';
+export * from './FlagStatus';

package/src/types/hardware/index.ts

@@ -0,0 +1,15 @@
+export * from './ballSensor';
+export * from './ballShooter';
+export * from './diskSensor';
+export * from './diskThrower';
+export * from './emergency';
+export * from './flag';
+export * from './KartEffect';
+export * from './ModuleName';
+export * from './ModuleStatus';
+export * from './rgb';
+export * from './screen';
+export * from './sound';
+export * from './speed';
+export * from './star-laser';
+export * from './steering-wheel';

package/src/types/hardware/rgb/RGBActionCommand.ts

@@ -0,0 +1 @@
+export type RGBActionCommand = 'Configure' | 'Exec';

package/src/types/hardware/rgb/RGBConfigurationOptions.ts

@@ -0,0 +1,9 @@
+import type { ColorName } from '../../color';
+
+export interface RGBConfigurationOptions {
+  kartColor: ColorName;
+  /** % Of Brightness (0 - 100) */
+  brightness: number;
+  /** Time in seconds (between 1 - 25) */
+  effectTime: number;
+}

package/src/types/hardware/rgb/RGBModuleStatus.ts

@@ -0,0 +1,7 @@
+import type { ColorName } from '../../color';
+import type { RGBStatus } from './RGBStatus';
+
+export type RGBModuleStatus = {
+  rgbStatus: RGBStatus;
+  kartColor: ColorName;
+};

package/src/types/hardware/rgb/RGBShowEffectOptions.ts

@@ -0,0 +1,5 @@
+import type { KartEffect } from '../KartEffect';
+
+export interface RGBShowEffectOptions {
+  effect: KartEffect;
+}

package/src/types/hardware/rgb/RGBStatus.ts

@@ -0,0 +1 @@
+export type RGBStatus = 'Showing Color' | 'Not Configured' | 'Configuring RGB' | 'Showing Effect' | 'Unknown';

package/src/types/hardware/rgb/index.ts

@@ -0,0 +1,5 @@
+export * from './RGBActionCommand';
+export * from './RGBShowEffectOptions';
+export * from './RGBModuleStatus';
+export * from './RGBConfigurationOptions';
+export * from './RGBStatus';

package/src/types/hardware/screen/ScreenBattleViewConfig.ts

@@ -0,0 +1,5 @@
+import type { ScreenViewBaseConfig } from './ScreenViewBaseConfig';
+
+export type ScreenBattleViewConfig = ScreenViewBaseConfig & {
+  lives?: number | null;
+};

package/src/types/hardware/screen/ScreenCountdownParams.ts

@@ -0,0 +1,14 @@
+import type { ScreenBattleViewConfig } from './ScreenBattleViewConfig';
+import type { ScreenRaceViewConfig } from './ScreenRaceViewConfig';
+
+export interface CountDownNextViewRace {
+  nextView: 'Race';
+  config: ScreenRaceViewConfig;
+}
+
+export interface CountDownNextViewBattle {
+  nextView: 'Battle';
+  config: ScreenBattleViewConfig;
+}
+
+export type ScreenCountdownParams = CountDownNextViewRace | CountDownNextViewBattle;

package/src/types/hardware/screen/ScreenFinishViewInput.ts

@@ -0,0 +1,7 @@
+export type ScreenFinishViewInput = {
+  kartPosition: {
+    currentPosition: number;
+    totalKarts: number;
+  };
+  coins: number;
+};

package/src/types/hardware/screen/ScreenGameTimeLeft.ts

@@ -0,0 +1,4 @@
+export type ScreenGameTimeLeft = {
+  minutes?: number | null;
+  seconds?: number | null;
+};

package/src/types/hardware/screen/ScreenKartPosition.ts

@@ -0,0 +1,4 @@
+export type ScreenKartPosition = {
+  currentPosition: number | null;
+  totalKarts: number | null;
+};

package/src/types/hardware/screen/ScreenRaceLaps.ts

@@ -0,0 +1,4 @@
+export type ScreenRaceLaps = {
+  currentLap: number | null;
+  totalLaps: number | null;
+};

package/src/types/hardware/screen/ScreenRaceViewConfig.ts

@@ -0,0 +1,6 @@
+import type { ScreenRaceLaps } from './ScreenRaceLaps';
+import type { ScreenViewBaseConfig } from './ScreenViewBaseConfig';
+
+export type ScreenRaceViewConfig = ScreenViewBaseConfig & {
+  laps?: ScreenRaceLaps;
+};

package/src/types/hardware/screen/ScreenUpdateGameViewInput.ts

@@ -0,0 +1,14 @@
+import type { ScreenBattleViewConfig } from './ScreenBattleViewConfig';
+import type { ScreenRaceViewConfig } from './ScreenRaceViewConfig';
+
+export interface UpdateRaceViewInput {
+  view: 'Race';
+  config: ScreenRaceViewConfig;
+}
+
+export interface UpdateBattleViewInput {
+  view: 'Battle';
+  config: ScreenBattleViewConfig;
+}
+
+export type ScreenUpdateGameViewInput = UpdateRaceViewInput | UpdateBattleViewInput;

package/src/types/hardware/screen/ScreenView.ts

@@ -0,0 +1 @@
+export type ScreenView = 'Home' | 'Countdown' | 'Race' | 'Battle' | 'Victory' | 'Defeat';

package/src/types/hardware/screen/ScreenViewBaseConfig.ts

@@ -0,0 +1,12 @@
+import type { DamageEffectName } from '../../damage';
+import type { PowerUpName } from '../../powerUp';
+import type { ScreenGameTimeLeft } from './ScreenGameTimeLeft';
+import type { ScreenKartPosition } from './ScreenKartPosition';
+
+export type ScreenViewBaseConfig = {
+  position?: ScreenKartPosition;
+  coins?: number | null;
+  gameTimeLeft?: ScreenGameTimeLeft;
+  powerUp?: PowerUpName | 'Clear PowerUp' | null;
+  damageEffect?: DamageEffectName | null;
+};

package/src/types/hardware/screen/index.ts

@@ -0,0 +1,10 @@
+export * from './ScreenBattleViewConfig';
+export * from './ScreenCountdownParams';
+export * from './ScreenFinishViewInput';
+export * from './ScreenGameTimeLeft';
+export * from './ScreenKartPosition';
+export * from './ScreenRaceLaps';
+export * from './ScreenRaceViewConfig';
+export * from './ScreenUpdateGameViewInput';
+export * from './ScreenView';
+export * from './ScreenViewBaseConfig';

package/src/types/hardware/sound/PlaySoundOptions.ts

@@ -0,0 +1,5 @@
+import type { SoundName } from '../../sounds';
+
+export interface PlaySoundOptions {
+  soundName: SoundName;
+}

package/src/types/hardware/sound/index.ts

@@ -0,0 +1 @@
+export * from './PlaySoundOptions';

package/src/types/hardware/speed/SpeedActionCommand.ts

@@ -0,0 +1 @@
+export type SpeedActionCommand = 'Activate' | 'Deactivate' | 'ChangeSpeed' | 'Configure';

package/src/types/hardware/speed/SpeedChangeOptions.ts

@@ -0,0 +1,6 @@
+export interface SpeedChangeOptions {
+  /** % of Speed. Value between 0 - 100 */
+  speed: number;
+  /** If the speed is infinite */
+  forUnlimitedTime?: boolean;
+}

package/src/types/hardware/speed/SpeedConfiguration.ts

@@ -0,0 +1,6 @@
+export interface SpeedConfiguration {
+  /** % of Speed. Value between 0 - 100 */
+  defaultSpeed: number;
+  /** Duration of the change of the speed in seconds 1 - 25s */
+  timeDuration: number;
+}

package/src/types/hardware/speed/SpeedModuleStatus.ts

@@ -0,0 +1,13 @@
+import type { SpeedStatus } from './SpeedStatus';
+
+export type SpeedModuleStatus = {
+  speedStatus: SpeedStatus;
+  /** The Battery of the Modules */
+  battery12V: number;
+  /** If there is a Speed change, this should return the current value */
+  currentSpeed: number;
+  ADCVoltage: number;
+  DACVoltage: number;
+  /** The current default % speed config (0 - 100) */
+  currentDefaultSpeedConfig: number;
+};

package/src/types/hardware/speed/SpeedStatus.ts

@@ -0,0 +1 @@
+export type SpeedStatus = 'Standby' | 'Deactivated' | 'Activated' | 'Changing Speed' | 'In Emergency' | 'Unknown';

package/src/types/hardware/speed/index.ts

@@ -0,0 +1,5 @@
+export * from './SpeedActionCommand';
+export * from './SpeedChangeOptions';
+export * from './SpeedConfiguration';
+export * from './SpeedModuleStatus';
+export * from './SpeedStatus';

package/src/types/hardware/star-laser/StarLaserCommand.ts

@@ -0,0 +1 @@
+export type StarLaserCommand = 'Activate' | 'Deactivate' | 'Init Attack' | 'Configure' | 'None';

package/src/types/hardware/star-laser/StarLaserConfigureModuleOptions.ts

@@ -0,0 +1,7 @@
+export interface StarLaserConfigureModuleOptions {
+  kartId: number;
+  /** Time in seconds (between 1 - 25) */
+  starAttackTime: number;
+  /** Time in seconds (between 1 - 25) */
+  laserAttackTime: number;
+}

package/src/types/hardware/star-laser/StarLaserModuleStatus.ts

@@ -0,0 +1,10 @@
+import type { StarLaserStatus } from './StarLaserStatus';
+
+export interface StarLaserModuleStatus {
+  starStatus: StarLaserStatus;
+  laserStatus: StarLaserStatus;
+  // ID of the kart that hit the star
+  starHitByKartId: number | null;
+  // ID of the kart that hit the laser
+  laserHitByKartId: number | null;
+}

package/src/types/hardware/star-laser/StarLaserSendActionsOptions.ts

@@ -0,0 +1,6 @@
+import type { StarLaserCommand } from './StarLaserCommand';
+
+export interface StarLaserSendActionsOptions {
+  starAction?: StarLaserCommand;
+  laserAction?: StarLaserCommand;
+}

package/src/types/hardware/star-laser/StarLaserStatus.ts

@@ -0,0 +1 @@
+export type StarLaserStatus = 'Standby' | 'Activated' | 'Deactivated' | 'Attacking' | 'Hit' | 'Unknown';

package/src/types/hardware/star-laser/index.ts

@@ -0,0 +1,5 @@
+export * from './StarLaserCommand';
+export * from './StarLaserConfigureModuleOptions';
+export * from './StarLaserModuleStatus';
+export * from './StarLaserSendActionsOptions';
+export * from './StarLaserStatus';

package/src/types/hardware/steering-wheel/SteeringWheelModuleStatus.ts

@@ -0,0 +1,4 @@
+export interface SteeringWheelModuleStatus {
+  isLeftButtonPressed: boolean;
+  isRightButtonPressed: boolean;
+}

package/src/types/hardware/steering-wheel/index.ts

@@ -0,0 +1 @@
+export * from './SteeringWheelModuleStatus';

package/src/types/index.ts

@@ -0,0 +1,21 @@
+/**
+ * This types are shared wihin the 3 Repositories
+ * Webapp, Backend and Raspberry
+ */
+
+export * from './checkpoint';
+export * from './color';
+export * from './command';
+export * from './damage';
+export * from './flow';
+export * from './game';
+export * from './gameTrack';
+export * from './hardware';
+export * from './kart';
+export * from './kartTracking';
+export * from './powerUp';
+export * from './response';
+export * from './socket';
+export * from './sounds';
+export * from './user';
+export * from './utils';

package/src/types/kart/Kart.ts

@@ -0,0 +1,31 @@
+import type { ColorName } from '../color';
+import type { GameType } from '../game';
+import type { GameTrack } from '../gameTrack';
+import type { KartShield } from './KartShield';
+import type { KartStatus } from './KartStatus';
+
+interface KartGame {
+  id: number;
+  type: GameType;
+}
+
+export interface Kart {
+  /** Unique ID by kart */
+  guid: string;
+  /** kartGuid assigned by Game Track (multiple karts could have the same Id) */
+  id: number;
+  mac: string;
+  isConnected: boolean;
+  status: KartStatus;
+  shield: KartShield;
+  // If a Kart is not assigned to a game, the default gane track should be "TEST"
+  gameTrackId: GameTrack['id'];
+  color: ColorName;
+  number: number;
+  currentGame?: KartGame | null;
+  description?: string | null;
+  /**
+   * In testing Mode, the kart should be listening to the hardware status
+   */
+  isSubscribedToHardwareStatus: boolean;
+}

package/src/types/kart/KartShield.ts

@@ -0,0 +1,4 @@
+export interface KartShield {
+  isActive: boolean;
+  duration: number;
+}

package/src/types/kart/KartStatus.ts

@@ -0,0 +1,2 @@
+export const kartStatus = ['standBy', 'in-game', 'yellow-flag', 'emergency', 'pits', 'eliminated'] as const;
+export type KartStatus = (typeof kartStatus)[number];

package/src/types/kart/index.ts

@@ -0,0 +1,2 @@
+export * from './Kart';
+export * from './KartStatus';

package/src/types/kartTracking/CheckpointEvent.ts

@@ -0,0 +1,9 @@
+import type { Checkpoint } from '../checkpoint';
+
+export interface CheckpointEvent extends Checkpoint {
+  index: number;
+  timestampISO: {
+    origin: string;
+    server: string;
+  };
+}

package/src/types/kartTracking/KartTracking.ts

@@ -0,0 +1,6 @@
+import type { CheckpointEvent } from './CheckpointEvent';
+
+export interface KartTracking {
+  macAddress: string;
+  checkpointsEvents?: CheckpointEvent[];
+}