@battle-racing/br-common-lib 4.4.0 → 4.5.0

package/dist/domains/player/Player.schema.d.ts

@@ -41,13 +41,11 @@ export declare const playerSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const createPlayerSchema: z.ZodObject<{
     nickname: z.ZodString;
+    ownerUserId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+    isGuest: z.ZodDefault<z.ZodBoolean>;
     birthDate: z.ZodCoercedDate<unknown>;
 }, z.core.$strip>;
 export declare const signWaiverSchema: z.ZodObject<{
     signature: z.ZodOptional<z.ZodString>;
     accepted: z.ZodLiteral<true>;
 }, z.core.$strip>;
-export declare const createMinorPlayerSchema: z.ZodObject<{
-    nickname: z.ZodString;
-    birthDate: z.ZodCoercedDate<unknown>;
-}, z.core.$strip>;

package/dist/domains/player/Player.schema.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createMinorPlayerSchema = exports.signWaiverSchema = exports.createPlayerSchema = exports.playerSchema = exports.playerStatsSchema = exports.playerWaiverStatusSchema = exports.playerTypeSchema = void 0;
+exports.signWaiverSchema = exports.createPlayerSchema = exports.playerSchema = exports.playerStatsSchema = exports.playerWaiverStatusSchema = exports.playerTypeSchema = void 0;
 const zod_1 = require("zod");
 const Player_const_1 = require("./Player.const");
 exports.playerTypeSchema = zod_1.z.enum(Player_const_1.PLAYER_TYPE);
@@ -32,6 +32,8 @@ exports.playerSchema = zod_1.z.object({
 exports.createPlayerSchema = exports.playerSchema
     .pick({
     nickname: true,
+    ownerUserId: true,
+    isGuest: true,
 })
     .extend({
     birthDate: zod_1.z.coerce.date(),
@@ -40,8 +42,3 @@ exports.signWaiverSchema = zod_1.z.object({
     signature: zod_1.z.string().optional(), // Base64 or simply a boolean acceptance. Let's make it flexible.
     accepted: zod_1.z.literal(true), // They must explicitly pass accepted: true
 });
-exports.createMinorPlayerSchema = zod_1.z.object({
-    nickname: zod_1.z.string().min(2).max(20),
-    birthDate: zod_1.z.coerce.date(),
-    // For a minor, the signature is implicitly granted by the tutor calling this endpoint
-});

package/dist/domains/racingTeam/RacingTeam.schema.d.ts

@@ -61,7 +61,7 @@ export declare const paginatedRacingTeamSummarySchema: z.ZodObject<{
 export declare const joinRequestSchema: z.ZodObject<{
     id: z.ZodString;
     racingTeamId: z.ZodString;
-    userId: z.ZodString;
+    playerId: z.ZodString;
     status: z.ZodEnum<{
         readonly PENDING: "PENDING";
         readonly ACCEPTED: "ACCEPTED";
@@ -71,19 +71,93 @@ export declare const joinRequestSchema: z.ZodObject<{
     updatedAt: z.ZodDate;
 }, z.core.$strip>;
 export declare const teamMemberSchema: z.ZodObject<{
+    id: z.ZodString;
     racingTeamId: z.ZodString;
-    userId: z.ZodString;
+    playerId: z.ZodString;
     role: z.ZodEnum<{
         readonly PILOT: "PILOT";
         readonly TECHNICIAN: "TECHNICIAN";
     }>;
     joinedAt: z.ZodDate;
 }, z.core.$strip>;
+export declare const teamMemberWithPlayerSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    nickname: z.ZodString;
+    avatarUrl: z.ZodOptional<z.ZodURL>;
+    birthDate: z.ZodDate;
+    type: z.ZodDefault<z.ZodEnum<{
+        readonly ADULT: "ADULT";
+        readonly MINOR: "MINOR";
+    }>>;
+    ownerUserId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+    isGuest: z.ZodDefault<z.ZodBoolean>;
+    waiver: z.ZodObject<{
+        isSigned: z.ZodDefault<z.ZodBoolean>;
+        waiverId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+        templateVersion: z.ZodOptional<z.ZodString>;
+        expiresAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+    }, z.core.$strip>;
+    stats: z.ZodNullable<z.ZodOptional<z.ZodObject<{
+        totalRaces: z.ZodDefault<z.ZodNumber>;
+        bestTimeMs: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        xp: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    createdAt: z.ZodDate;
+    updatedAt: z.ZodDate;
+    role: z.ZodEnum<{
+        readonly PILOT: "PILOT";
+        readonly TECHNICIAN: "TECHNICIAN";
+    }>;
+    joinedAt: z.ZodDate;
+}, z.core.$strip>;
+export declare const racingTeamWithMembersSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    imageUrl: z.ZodOptional<z.ZodURL>;
+    adminUserId: z.ZodString;
+    createdAt: z.ZodDate;
+    updatedAt: z.ZodDate;
+    members: z.ZodArray<z.ZodObject<{
+        id: z.ZodUUID;
+        nickname: z.ZodString;
+        avatarUrl: z.ZodOptional<z.ZodURL>;
+        birthDate: z.ZodDate;
+        type: z.ZodDefault<z.ZodEnum<{
+            readonly ADULT: "ADULT";
+            readonly MINOR: "MINOR";
+        }>>;
+        ownerUserId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+        isGuest: z.ZodDefault<z.ZodBoolean>;
+        waiver: z.ZodObject<{
+            isSigned: z.ZodDefault<z.ZodBoolean>;
+            waiverId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+            templateVersion: z.ZodOptional<z.ZodString>;
+            expiresAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+        }, z.core.$strip>;
+        stats: z.ZodNullable<z.ZodOptional<z.ZodObject<{
+            totalRaces: z.ZodDefault<z.ZodNumber>;
+            bestTimeMs: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            xp: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>>;
+        createdAt: z.ZodDate;
+        updatedAt: z.ZodDate;
+        role: z.ZodEnum<{
+            readonly PILOT: "PILOT";
+            readonly TECHNICIAN: "TECHNICIAN";
+        }>;
+        joinedAt: z.ZodDate;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 export declare const createJoinRequestSchema: z.ZodObject<{
     racingTeamId: z.ZodString;
+    playerId: z.ZodString;
 }, z.core.$strip>;
 export declare const answerJoinRequestSchema: z.ZodObject<{
     racingTeamId: z.ZodString;
-    targetUserId: z.ZodString;
+    targetPlayerId: z.ZodString;
     accepted: z.ZodBoolean;
 }, z.core.$strip>;
+export declare const addTeamMemberSchema: z.ZodObject<{
+    nickname: z.ZodString;
+    birthDate: z.ZodCoercedDate<unknown>;
+}, z.core.$strip>;

package/dist/domains/racingTeam/RacingTeam.schema.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.answerJoinRequestSchema = exports.createJoinRequestSchema = exports.teamMemberSchema = exports.joinRequestSchema = exports.paginatedRacingTeamSummarySchema = exports.paginatedRacingTeamSchema = exports.racingTeamSummarySchema = exports.filterRacingTeamSchema = exports.updateRacingTeamSchema = exports.createRacingTeamSchema = exports.racingTeamSchema = void 0;
+exports.addTeamMemberSchema = exports.answerJoinRequestSchema = exports.createJoinRequestSchema = exports.racingTeamWithMembersSchema = exports.teamMemberWithPlayerSchema = exports.teamMemberSchema = exports.joinRequestSchema = exports.paginatedRacingTeamSummarySchema = exports.paginatedRacingTeamSchema = exports.racingTeamSummarySchema = exports.filterRacingTeamSchema = exports.updateRacingTeamSchema = exports.createRacingTeamSchema = exports.racingTeamSchema = void 0;
 const zod_1 = require("zod");
 const pagination_1 = require("../pagination");
 const RacingTeam_const_1 = require("./RacingTeam.const");
+const Player_schema_1 = require("../player/Player.schema");
 // --- Team Schemas ---
 exports.racingTeamSchema = zod_1.z.object({
     id: zod_1.z.string(),
@@ -38,22 +39,35 @@ exports.paginatedRacingTeamSummarySchema = (0, pagination_1.paginatedResponseSch
 exports.joinRequestSchema = zod_1.z.object({
     id: zod_1.z.string(),
     racingTeamId: zod_1.z.string(),
-    userId: zod_1.z.string(),
+    playerId: zod_1.z.string(),
     status: zod_1.z.enum(RacingTeam_const_1.JOIN_REQUEST_STATUS),
     createdAt: zod_1.z.date(),
     updatedAt: zod_1.z.date(),
 });
 exports.teamMemberSchema = zod_1.z.object({
+    id: zod_1.z.string(),
     racingTeamId: zod_1.z.string(),
-    userId: zod_1.z.string(),
+    playerId: zod_1.z.string(),
+    role: zod_1.z.enum(RacingTeam_const_1.RACING_TEAM_ROLE),
+    joinedAt: zod_1.z.date(),
+});
+exports.teamMemberWithPlayerSchema = Player_schema_1.playerSchema.extend({
     role: zod_1.z.enum(RacingTeam_const_1.RACING_TEAM_ROLE),
     joinedAt: zod_1.z.date(),
 });
+exports.racingTeamWithMembersSchema = exports.racingTeamSchema.extend({
+    members: zod_1.z.array(exports.teamMemberWithPlayerSchema),
+});
 exports.createJoinRequestSchema = zod_1.z.object({
     racingTeamId: zod_1.z.string(),
+    playerId: zod_1.z.string(),
 });
 exports.answerJoinRequestSchema = zod_1.z.object({
     racingTeamId: zod_1.z.string(),
-    targetUserId: zod_1.z.string(),
+    targetPlayerId: zod_1.z.string(),
     accepted: zod_1.z.boolean(),
 });
+exports.addTeamMemberSchema = zod_1.z.object({
+    nickname: zod_1.z.string().min(2).max(20),
+    birthDate: zod_1.z.coerce.date(),
+});

package/dist/domains/racingTeam/RacingTeam.types.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { answerJoinRequestSchema, createJoinRequestSchema, createRacingTeamSchema, joinRequestSchema, paginatedRacingTeamSchema, paginatedRacingTeamSummarySchema, racingTeamSchema, racingTeamSummarySchema, teamMemberSchema, updateRacingTeamSchema } from './RacingTeam.schema';
+import { answerJoinRequestSchema, createJoinRequestSchema, createRacingTeamSchema, joinRequestSchema, paginatedRacingTeamSchema, paginatedRacingTeamSummarySchema, racingTeamWithMembersSchema, racingTeamSchema, racingTeamSummarySchema, teamMemberWithPlayerSchema, teamMemberSchema, updateRacingTeamSchema, addTeamMemberSchema } from './RacingTeam.schema';
 export type RacingTeam = z.infer<typeof racingTeamSchema>;
 export type CreateRacingTeamInput = z.infer<typeof createRacingTeamSchema>;
 export type UpdateRacingTeamInput = z.infer<typeof updateRacingTeamSchema>;
@@ -10,3 +10,6 @@ export type JoinRequest = z.infer<typeof joinRequestSchema>;
 export type TeamMember = z.infer<typeof teamMemberSchema>;
 export type CreateJoinRequest = z.infer<typeof createJoinRequestSchema>;
 export type AnswerJoinRequest = z.infer<typeof answerJoinRequestSchema>;
+export type TeamMemberWithPlayer = z.infer<typeof teamMemberWithPlayerSchema>;
+export type RacingTeamWithMembers = z.infer<typeof racingTeamWithMembersSchema>;
+export type AddTeamMember = z.infer<typeof addTeamMemberSchema>;

package/dist/domains/session/Session.schema.d.ts

@@ -166,6 +166,9 @@ export declare const joinSessionSchema: z.ZodObject<{
     nickname: z.ZodString;
     birthDate: z.ZodCoercedDate<unknown>;
 }, z.core.$strip>;
+export declare const addExistingPlayersSchema: z.ZodObject<{
+    playerIds: z.ZodArray<z.ZodUUID>;
+}, z.core.$strip>;
 export declare const updateSessionStatusSchema: z.ZodObject<{
     status: z.ZodEnum<{
         readonly REGISTRATION: "REGISTRATION";

package/dist/domains/session/Session.schema.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.bulkCreateGameTurnSchema = exports.assignSessionTicketsInputSchema = exports.createGameTurnInputSchema = exports.updateSessionStatusSchema = exports.joinSessionSchema = exports.createSessionInputSchema = exports.gameSessionWithPlayersSchema = exports.gameSessionSchema = exports.sessionTicketSchema = exports.sessionStatusSchema = void 0;
+exports.bulkCreateGameTurnSchema = exports.assignSessionTicketsInputSchema = exports.createGameTurnInputSchema = exports.updateSessionStatusSchema = exports.addExistingPlayersSchema = exports.joinSessionSchema = exports.createSessionInputSchema = exports.gameSessionWithPlayersSchema = exports.gameSessionSchema = exports.sessionTicketSchema = exports.sessionStatusSchema = void 0;
 const zod_1 = require("zod");
 const Session_const_1 = require("./Session.const");
 const Game_schema_1 = require("../game/Game.schema");
@@ -36,6 +36,9 @@ exports.joinSessionSchema = zod_1.z.object({
     nickname: zod_1.z.string().min(2),
     birthDate: zod_1.z.coerce.date(),
 });
+exports.addExistingPlayersSchema = zod_1.z.object({
+    playerIds: zod_1.z.array(zod_1.z.uuidv4()).min(1),
+});
 exports.updateSessionStatusSchema = zod_1.z.object({
     status: exports.sessionStatusSchema,
 });

package/dist/domains/user/User.schema.d.ts

@@ -4,12 +4,13 @@ export declare const userTypeSchema: z.ZodEnum<{
     readonly PLAYER: "PLAYER";
 }>;
 export declare const PHONE_REGEX: RegExp;
+export declare const emailOrPhoneSchema: z.ZodString;
 export declare const userSchema: z.ZodObject<{
     id: z.ZodUUID;
     name: z.ZodString;
     lastName: z.ZodString;
-    email: z.ZodOptional<z.ZodEmail>;
-    phoneNumber: z.ZodOptional<z.ZodString>;
+    email: z.ZodNullable<z.ZodOptional<z.ZodEmail>>;
+    phoneNumber: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     role: z.ZodEnum<{
         readonly SUPER_ADMIN: "SUPER_ADMIN";
         readonly OPERATOR: "OPERATOR";
@@ -27,12 +28,39 @@ export declare const userSchema: z.ZodObject<{
     createdAt: z.ZodDate;
     lastLoginAt: z.ZodOptional<z.ZodDate>;
 }, z.core.$strip>;
+/**
+ * The schema for the user returned on login
+ */
+export declare const authUserSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    name: z.ZodString;
+    lastName: z.ZodString;
+    email: z.ZodNullable<z.ZodOptional<z.ZodEmail>>;
+    phoneNumber: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    role: z.ZodEnum<{
+        readonly SUPER_ADMIN: "SUPER_ADMIN";
+        readonly OPERATOR: "OPERATOR";
+        readonly PLAYER: "PLAYER";
+        readonly CASHIER: "CASHIER";
+    }>;
+    type: z.ZodEnum<{
+        readonly STAFF: "STAFF";
+        readonly PLAYER: "PLAYER";
+    }>;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+    isEmailVerified: z.ZodDefault<z.ZodBoolean>;
+    isPhoneVerified: z.ZodDefault<z.ZodBoolean>;
+    defaultPlayerId: z.ZodOptional<z.ZodUUID>;
+    createdAt: z.ZodDate;
+    lastLoginAt: z.ZodOptional<z.ZodDate>;
+    authToken: z.ZodString;
+}, z.core.$strip>;
 export declare const userWithPasswordSchema: z.ZodIntersection<z.ZodObject<{
     id: z.ZodUUID;
     name: z.ZodString;
     lastName: z.ZodString;
-    email: z.ZodOptional<z.ZodEmail>;
-    phoneNumber: z.ZodOptional<z.ZodString>;
+    email: z.ZodNullable<z.ZodOptional<z.ZodEmail>>;
+    phoneNumber: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     role: z.ZodEnum<{
         readonly SUPER_ADMIN: "SUPER_ADMIN";
         readonly OPERATOR: "OPERATOR";
@@ -52,11 +80,27 @@ export declare const userWithPasswordSchema: z.ZodIntersection<z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
     password: z.ZodString;
 }, z.core.$strip>>;
+export declare const userInitialRegistrationSchema: z.ZodObject<{
+    emailOrPhone: z.ZodString;
+    password: z.ZodString;
+}, z.core.$strip>;
+export declare const userVerifySchema: z.ZodObject<{
+    emailOrPhone: z.ZodString;
+    code: z.ZodString;
+}, z.core.$strip>;
+export declare const userCompleteProfileSchema: z.ZodObject<{
+    name: z.ZodString;
+    lastName: z.ZodOptional<z.ZodString>;
+    nickname: z.ZodString;
+    birthDate: z.ZodCoercedDate<unknown>;
+    waiverSignature: z.ZodBoolean;
+    teamName: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 export declare const userRegistrationInputSchema: z.ZodObject<{
     name: z.ZodString;
+    email: z.ZodNullable<z.ZodOptional<z.ZodEmail>>;
     lastName: z.ZodString;
-    email: z.ZodOptional<z.ZodEmail>;
-    phoneNumber: z.ZodOptional<z.ZodString>;
+    phoneNumber: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     password: z.ZodString;
     nickname: z.ZodString;
     birthDate: z.ZodCoercedDate<unknown>;

package/dist/domains/user/User.schema.js

@@ -1,18 +1,26 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.userLoginInputSchema = exports.userRegistrationInputSchema = exports.userWithPasswordSchema = exports.userSchema = exports.PHONE_REGEX = exports.userTypeSchema = void 0;
+exports.userLoginInputSchema = exports.userRegistrationInputSchema = exports.userCompleteProfileSchema = exports.userVerifySchema = exports.userInitialRegistrationSchema = exports.userWithPasswordSchema = exports.authUserSchema = exports.userSchema = exports.emailOrPhoneSchema = exports.PHONE_REGEX = exports.userTypeSchema = void 0;
 const zod_1 = require("zod");
 const role_1 = require("../role");
 const User_const_1 = require("./User.const");
 exports.userTypeSchema = zod_1.z.enum(User_const_1.USER_TYPE);
 exports.PHONE_REGEX = /^([+]?[\\s0-9]+)?(\\d{3}|[(]?[0-9]+[)])?([-]?[\\s]?[0-9])+$/;
 const MIN_PASSWORD_LENGTH = 6;
+exports.emailOrPhoneSchema = zod_1.z
+    .string()
+    .min(1, 'Email or phone is required')
+    .refine((val) => {
+    const isEmail = zod_1.z.email().safeParse(val).success;
+    const isPhone = exports.PHONE_REGEX.test(val);
+    return isEmail || isPhone;
+}, { message: 'Must be a valid email or phone number' });
 const baseUserObj = zod_1.z.object({
     id: zod_1.z.uuidv4(),
     name: zod_1.z.string(),
     lastName: zod_1.z.string(),
-    email: zod_1.z.email().toLowerCase().optional(),
-    phoneNumber: zod_1.z.string().regex(exports.PHONE_REGEX, 'Invalid phone number format').optional(),
+    email: zod_1.z.email().toLowerCase().optional().nullable(),
+    phoneNumber: zod_1.z.string().regex(exports.PHONE_REGEX, 'Invalid phone number format').optional().nullable(),
     // --- ACCESS CONTROL ---
     role: role_1.userRoleSchema,
     type: exports.userTypeSchema,
@@ -28,9 +36,37 @@ exports.userSchema = baseUserObj.refine((data) => data.email || data.phoneNumber
     message: 'User must have either an email or a phone number',
     path: ['email', 'phoneNumber'],
 });
+/**
+ * The schema for the user returned on login
+ */
+exports.authUserSchema = baseUserObj.extend({
+    authToken: zod_1.z.string(),
+});
 exports.userWithPasswordSchema = exports.userSchema.and(zod_1.z.object({
     password: zod_1.z.string().min(MIN_PASSWORD_LENGTH),
 }));
+exports.userInitialRegistrationSchema = zod_1.z.object({
+    emailOrPhone: exports.emailOrPhoneSchema,
+    password: zod_1.z.string().min(MIN_PASSWORD_LENGTH, `Password must be at least ${MIN_PASSWORD_LENGTH} characters`),
+});
+exports.userVerifySchema = zod_1.z.object({
+    emailOrPhone: exports.emailOrPhoneSchema,
+    code: zod_1.z.string().min(6, 'Code must be at least 6 characters').max(10, 'Code is too long'),
+});
+exports.userCompleteProfileSchema = baseUserObj
+    .pick({
+    name: true,
+})
+    .extend({
+    lastName: zod_1.z.string().optional(),
+    nickname: zod_1.z.string().min(2),
+    birthDate: zod_1.z.coerce.date(),
+    waiverSignature: zod_1.z.boolean().refine((val) => val === true, {
+        message: 'You must accept the waiver signature',
+    }),
+    teamName: zod_1.z.string().optional(),
+});
+// Deprecated in favor of multi-step registration
 exports.userRegistrationInputSchema = baseUserObj
     .pick({
     name: true,
@@ -48,13 +84,6 @@ exports.userRegistrationInputSchema = baseUserObj
     path: ['email', 'phoneNumber'],
 });
 exports.userLoginInputSchema = zod_1.z.object({
-    emailOrPhone: zod_1.z
-        .string()
-        .min(1, 'Email or phone is required')
-        .refine((val) => {
-        const isEmail = zod_1.z.email().safeParse(val).success;
-        const isPhone = exports.PHONE_REGEX.test(val);
-        return isEmail || isPhone;
-    }, { message: 'Must be a valid email or phone number' }),
+    emailOrPhone: exports.emailOrPhoneSchema,
     password: zod_1.z.string().min(MIN_PASSWORD_LENGTH, `Password must be at least ${MIN_PASSWORD_LENGTH} characters`),
 });

package/dist/domains/user/User.types.d.ts

@@ -1,5 +1,10 @@
 import { z } from 'zod';
-import { userSchema, userTypeSchema, userWithPasswordSchema } from './User.schema';
+import { userSchema, userTypeSchema, userWithPasswordSchema, userInitialRegistrationSchema, userVerifySchema, userCompleteProfileSchema, userLoginInputSchema, authUserSchema } from './User.schema';
 export type UserType = z.infer<typeof userTypeSchema>;
 export type User = z.infer<typeof userSchema>;
 export type UserWithPassword = z.infer<typeof userWithPasswordSchema>;
+export type AuthUser = z.infer<typeof authUserSchema>;
+export type UserInitialRegistration = z.infer<typeof userInitialRegistrationSchema>;
+export type UserVerify = z.infer<typeof userVerifySchema>;
+export type UserCompleteProfile = z.infer<typeof userCompleteProfileSchema>;
+export type UserLogin = z.infer<typeof userLoginInputSchema>;

package/docs/TICKETING_AND_PURCHASE_FLOW.md

@@ -0,0 +1,110 @@
+# Flujo de Compra de Tickets y Separación User/Player
+
+Este documento explica de forma detallada cómo está estructurado el flujo de compra de tickets en **Battle Racing**, cómo se separa la entidad que paga (User) de la entidad que corre (Player), qué hemos implementado hasta ahora y qué nos hace falta por implementar.
+
+---
+
+## 👥 1. Separación: Users vs. Players
+
+Para asegurar "cero fricción" en el entorno físico de la pista, hemos separado estrictamente el concepto de la cuenta (quien paga) del corredor (quien se sube al Kart).
+
+### `User` (La Cuenta / El Pagador)
+
+- **Propósito:** La persona física que se registra, gestiona un método de pago y posee el historial transaccional de compras.
+- **Autenticación:** Usa `email` o `phoneNumber` (sin `username`), contraseña y roles (`SUPER_ADMIN`, `CASHIER`, `PLAYER`).
+- **Relaciones:**
+  - Tiene un `defaultPlayerId` que apunta a su propio perfil de corredor.
+  - Puede ser tutor y ser "dueño" (`ownerUserId`) de múltiples `Players` menores de edad (`MINOR`).
+
+### `Player` (El Corredor / Perfil Gamificado)
+
+- **Propósito:** Es la entidad gamificada que se asigna físicamente a un Kart y cuyo nombre sale en las pantallas.
+- **Identificador (`nickname`):** No son únicos en la base de datos. Varios corredores pueden llamarse "Maverick" al mismo tiempo para no generar errores al registrarse rápidamente en el POS.
+- **Waivers:** Contiene el estado de la firma del documento de exención de responsabilidad (`waiver`).
+- **Relaciones:** Si es un invitado anónimo (`isGuest`), no está atado a ningún `User`. Si es un menor, su firma (`waiver`) es implícitamente otorgada por el `User` tutor.
+
+---
+
+## 🎟️ 2. Flujo de Compras (Purchases y Tickets)
+
+La adquisición de carreras sigue un ciclo de vida de tres grandes capas:
+
+### Capa 1: La Compra (`Purchase`)
+
+1. **Creación:** Se crea un `Purchase` agrupando varios ítems de compra (ej. 3 tickets de tipo `RACE`).
+   - Se crea en el endpoint: `POST /ticketing/purchases`
+   - Si el cliente está logueado en la Web App, se asocia su `buyerUserId`.
+   - Si la compra es 100% anónima en la sucursal (POS), `buyerUserId` es `null` y se usan `guestName` y `guestContact`.
+2. **Pago:** El pago se confirma asíncronamente vía Webhooks (`POST /ticketing/webhook/payment`) o manualmente en caja registradora (`POST /ticketing/purchases/:id/manual-payment`).
+3. **Generación de GameTickets:** Una vez confirmada y pagada la compra, esta se _desfragmenta_ y la base de datos genera los `GameTicket` individuales correspondientes (con estado `CREATED`).
+
+### Capa 2: La Sesión (`Game Session`)
+
+Dado que una persona puede comprar 10 tickets, pero a la pista se van a subir sus 5 amigos 2 veces, se usa una **Session**.
+
+1. **Creación:** Se agrupan tickets recién comprados bajo un código alfanumérico corto (ej. `A1B2C3`).
+2. **Unión:** Los amigos escanean un QR o dictan el código para unirse a la sesión (`POST /sessions/:code/join`). Aquí sus `Players` ingresan a la sesión.
+3. **Asignación:** Se asigna cada `GameTicket` disponible en la sesión a un `playerId` específico (`POST /sessions/:code/tickets/assign`).
+
+### Capa 3: El Turno Físico en Pista (`Game Turn`)
+
+1. **Cola de Carrera:** Cuando el grupo de la sesión está listo (o el operador del POS organiza la carrera), se crea un `GameTurn`.
+   - Endpoint: `POST /game-turns` o `POST /game-turns/bulk`.
+2. **Vinculación Final:** El `GameTurn` toma los `GameTickets` asignados y los `playerIds` correspondientes, bloqueándolos para esta carrera específica.
+3. **Ejecución y Hardware:** El hardware vincula a los jugadores con sus respectivos Karts y avanza las tareas de la carrera (preparación, en sus marcas, carrera, meta).
+   - El progreso se guarda mediante: `POST /game-turns/:id/tasks/:taskId/complete`
+
+---
+
+## ✅ 3. ¿Qué tenemos implementado hasta ahora?
+
+### En `br-common-lib` (Schemas)
+
+- Zod schemas altamente detallados para `User`, `Player`, `Session`, `Ticketing` (Purchase y Tickets) y `Payment`.
+- Control absoluto y fuente de verdad centralizada para la validación de estos modelos.
+
+### En `game-manager-backend` (REST API)
+
+- **Módulo `ticketing`:**
+  - Creación de compras.
+  - Procesamiento manual de pagos (para POS/Cashiers).
+  - Cancelación de compras.
+  - Recepción de webhooks de pasarelas de pago.
+  - Listado mis compras y resumen de mis tickets (`my-purchases`, `my-tickets`).
+- **Módulo `session`:**
+  - Obtener sesión por código corto.
+  - Unirse (y unirse en bulk) a una sesión.
+  - Asignar tickets a jugadores dentro de la sesión.
+- **Módulo `game-turn`:**
+  - Listado general de turnos (`GET /game-turns`).
+  - Creación de turnos y turnos en bloque.
+  - Avance de etapas (tasks) dentro del turno (`completeTask`).
+  - Capacidad para avanzar (`/advance`) o posponer (`/postpone`) el turno en la fila.
+- **Módulo `player` & `user`:**
+  - Estructuras en DB/Repositorios y controladores listos para manipular estos perfiles.
+
+---
+
+## 🚧 4. ¿Qué nos hace falta implementar? (Faltantes / TODOs)
+
+1. **Autenticación Severa (Guards):**
+   - Varios enpoints importantes como la creación de compras y modificación de sesiones todavía usan `request.user?.id` asumiendo que el usuario está inyectado, pero faltan **Guards** (e.g., JWT Guards) sólidos y globales para denegar acceso a usuarios no autorizados de forma segura o están marcados como `@Public()`.
+
+2. **Validación de Identidad de Email/Teléfono (`User`):**
+   - Aunque la base de datos soporta `isEmailVerified` e `isPhoneVerified`, el mecanismo de envío de OTP / SMS / Enlace Mágico para confirmar la propiedad aún no está programado.
+
+3. **Verificación de Seguridad de Asignación de Tickets:**
+   - Comprobar que un User no pueda asignar tickets de un Purchase que NO le pertenece (cuando la abstracción de sesión permita saltos de seguridad).
+   - Actualmente falta un "Ownership Check" robusto en varios GET de compras y lectura de turnos.
+
+4. **Actualización Automática de Estadísticas del Player:**
+   - Actualmente la base de datos de Players tiene sub-schemas listos para Stats (`totalRaces`, `bestTimeMs`, `xp`). Sin embargo, una vez que el `GameTurn` se completa en la pista, falta implementar el webhook o servicio que **calcule los resultados finales y actualice estos stats** dentro de cada `Player` que participó.
+
+5. **Flujos de Error de Pagos y Reembolsos Avanzados:**
+   - Manejo exhaustivo de reembolsos desde Stripe hacia el sistema para revocar `GameTickets` si una persona pide chargeback manual.
+
+6. **Integración Completa con POS (Front-end UI):**
+   - Falta validar en el frontend de POS que estos flujos asíncronos (como el crear compra en cash, asignar players de forma anónima) no se bloqueen por dependencias de cuentas "Guest". Asegurarse de que el frontend POS pueda transitar estas 3 capas sin recargar.
+
+7. **Asociación Dinámica de Hardware (Karts ↔ Players) en el GameTurn:**
+   - Hay que madurar la lógica donde un `playerId` que entra a un `GameTurn` es asignado al IP / Socket / ID Hardware específico del Kart en el que se acaba de sentar.

package/package.json

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

package/src/domains/player/Player.schema.ts

@@ -37,6 +37,8 @@ export const playerSchema = z.object({
 export const createPlayerSchema = playerSchema
   .pick({
     nickname: true,
+    ownerUserId: true,
+    isGuest: true,
   })
   .extend({
     birthDate: z.coerce.date(),
@@ -46,9 +48,3 @@ export const signWaiverSchema = z.object({
   signature: z.string().optional(), // Base64 or simply a boolean acceptance. Let's make it flexible.
   accepted: z.literal(true), // They must explicitly pass accepted: true
 });
-
-export const createMinorPlayerSchema = z.object({
-  nickname: z.string().min(2).max(20),
-  birthDate: z.coerce.date(),
-  // For a minor, the signature is implicitly granted by the tutor calling this endpoint
-});

package/src/domains/racingTeam/RacingTeam.schema.ts

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { paginatedResponseSchema } from '../pagination';
 import { JOIN_REQUEST_STATUS, RACING_TEAM_ROLE } from './RacingTeam.const';
+import { playerSchema } from '../player/Player.schema';
 
 // --- Team Schemas ---
 
@@ -44,25 +45,41 @@ export const paginatedRacingTeamSummarySchema = paginatedResponseSchema(racingTe
 export const joinRequestSchema = z.object({
   id: z.string(),
   racingTeamId: z.string(),
-  userId: z.string(),
+  playerId: z.string(),
   status: z.enum(JOIN_REQUEST_STATUS),
   createdAt: z.date(),
   updatedAt: z.date(),
 });
 
 export const teamMemberSchema = z.object({
+  id: z.string(),
   racingTeamId: z.string(),
-  userId: z.string(),
+  playerId: z.string(),
+  role: z.enum(RACING_TEAM_ROLE),
+  joinedAt: z.date(),
+});
+
+export const teamMemberWithPlayerSchema = playerSchema.extend({
   role: z.enum(RACING_TEAM_ROLE),
   joinedAt: z.date(),
 });
 
+export const racingTeamWithMembersSchema = racingTeamSchema.extend({
+  members: z.array(teamMemberWithPlayerSchema),
+});
+
 export const createJoinRequestSchema = z.object({
   racingTeamId: z.string(),
+  playerId: z.string(),
 });
 
 export const answerJoinRequestSchema = z.object({
   racingTeamId: z.string(),
-  targetUserId: z.string(),
+  targetPlayerId: z.string(),
   accepted: z.boolean(),
 });
+
+export const addTeamMemberSchema = z.object({
+  nickname: z.string().min(2).max(20),
+  birthDate: z.coerce.date(),
+});

package/src/domains/racingTeam/RacingTeam.types.ts

@@ -6,10 +6,13 @@ import {
   joinRequestSchema,
   paginatedRacingTeamSchema,
   paginatedRacingTeamSummarySchema,
+  racingTeamWithMembersSchema,
   racingTeamSchema,
   racingTeamSummarySchema,
+  teamMemberWithPlayerSchema,
   teamMemberSchema,
   updateRacingTeamSchema,
+  addTeamMemberSchema,
 } from './RacingTeam.schema';
 
 export type RacingTeam = z.infer<typeof racingTeamSchema>;
@@ -23,3 +26,7 @@ export type JoinRequest = z.infer<typeof joinRequestSchema>;
 export type TeamMember = z.infer<typeof teamMemberSchema>;
 export type CreateJoinRequest = z.infer<typeof createJoinRequestSchema>;
 export type AnswerJoinRequest = z.infer<typeof answerJoinRequestSchema>;
+
+export type TeamMemberWithPlayer = z.infer<typeof teamMemberWithPlayerSchema>;
+export type RacingTeamWithMembers = z.infer<typeof racingTeamWithMembersSchema>;
+export type AddTeamMember = z.infer<typeof addTeamMemberSchema>;

package/src/domains/session/Session.schema.ts

@@ -43,6 +43,10 @@ export const joinSessionSchema = z.object({
   birthDate: z.coerce.date(),
 });
 
+export const addExistingPlayersSchema = z.object({
+  playerIds: z.array(z.uuidv4()).min(1),
+});
+
 export const updateSessionStatusSchema = z.object({
   status: sessionStatusSchema,
 });

package/src/domains/user/User.schema.ts

@@ -7,15 +7,27 @@ export const userTypeSchema = z.enum(USER_TYPE);
 export const PHONE_REGEX = /^([+]?[\\s0-9]+)?(\\d{3}|[(]?[0-9]+[)])?([-]?[\\s]?[0-9])+$/;
 const MIN_PASSWORD_LENGTH = 6;
 
+export const emailOrPhoneSchema = z
+  .string()
+  .min(1, 'Email or phone is required')
+  .refine(
+    (val) => {
+      const isEmail = z.email().safeParse(val).success;
+      const isPhone = PHONE_REGEX.test(val);
+      return isEmail || isPhone;
+    },
+    { message: 'Must be a valid email or phone number' },
+  );
+
 const baseUserObj = z.object({
   id: z.uuidv4(),
 
   name: z.string(),
   lastName: z.string(),
 
-  email: z.email().toLowerCase().optional(),
+  email: z.email().toLowerCase().optional().nullable(),
 
-  phoneNumber: z.string().regex(PHONE_REGEX, 'Invalid phone number format').optional(),
+  phoneNumber: z.string().regex(PHONE_REGEX, 'Invalid phone number format').optional().nullable(),
 
   // --- ACCESS CONTROL ---
   role: userRoleSchema,
@@ -37,12 +49,44 @@ export const userSchema = baseUserObj.refine((data) => data.email || data.phoneN
   path: ['email', 'phoneNumber'],
 });
 
+/**
+ * The schema for the user returned on login
+ */
+export const authUserSchema = baseUserObj.extend({
+  authToken: z.string(),
+});
+
 export const userWithPasswordSchema = userSchema.and(
   z.object({
     password: z.string().min(MIN_PASSWORD_LENGTH),
   }),
 );
 
+export const userInitialRegistrationSchema = z.object({
+  emailOrPhone: emailOrPhoneSchema,
+  password: z.string().min(MIN_PASSWORD_LENGTH, `Password must be at least ${MIN_PASSWORD_LENGTH} characters`),
+});
+
+export const userVerifySchema = z.object({
+  emailOrPhone: emailOrPhoneSchema,
+  code: z.string().min(6, 'Code must be at least 6 characters').max(10, 'Code is too long'),
+});
+
+export const userCompleteProfileSchema = baseUserObj
+  .pick({
+    name: true,
+  })
+  .extend({
+    lastName: z.string().optional(),
+    nickname: z.string().min(2),
+    birthDate: z.coerce.date(),
+    waiverSignature: z.boolean().refine((val) => val === true, {
+      message: 'You must accept the waiver signature',
+    }),
+    teamName: z.string().optional(),
+  });
+
+// Deprecated in favor of multi-step registration
 export const userRegistrationInputSchema = baseUserObj
   .pick({
     name: true,
@@ -61,16 +105,6 @@ export const userRegistrationInputSchema = baseUserObj
   });
 
 export const userLoginInputSchema = z.object({
-  emailOrPhone: z
-    .string()
-    .min(1, 'Email or phone is required')
-    .refine(
-      (val) => {
-        const isEmail = z.email().safeParse(val).success;
-        const isPhone = PHONE_REGEX.test(val);
-        return isEmail || isPhone;
-      },
-      { message: 'Must be a valid email or phone number' },
-    ),
+  emailOrPhone: emailOrPhoneSchema,
   password: z.string().min(MIN_PASSWORD_LENGTH, `Password must be at least ${MIN_PASSWORD_LENGTH} characters`),
 });

package/src/domains/user/User.types.ts

@@ -1,6 +1,20 @@
 import { z } from 'zod';
-import { userSchema, userTypeSchema, userWithPasswordSchema } from './User.schema';
+import {
+  userSchema,
+  userTypeSchema,
+  userWithPasswordSchema,
+  userInitialRegistrationSchema,
+  userVerifySchema,
+  userCompleteProfileSchema,
+  userLoginInputSchema,
+  authUserSchema,
+} from './User.schema';
 
 export type UserType = z.infer<typeof userTypeSchema>;
 export type User = z.infer<typeof userSchema>;
 export type UserWithPassword = z.infer<typeof userWithPasswordSchema>;
+export type AuthUser = z.infer<typeof authUserSchema>;
+export type UserInitialRegistration = z.infer<typeof userInitialRegistrationSchema>;
+export type UserVerify = z.infer<typeof userVerifySchema>;
+export type UserCompleteProfile = z.infer<typeof userCompleteProfileSchema>;
+export type UserLogin = z.infer<typeof userLoginInputSchema>;