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

package/.agents/rules/01-naming-and-typing.md

@@ -0,0 +1,14 @@
+---
+trigger: always_on
+---
+
+# Naming Convention & Typing Rules
+
+- **Nomenclatura Exacta:** El nombre del archivo DEBE coincidir con el componente, hook o servicio principal exportado (Ej: `useSearchClientMutation` en `useSearchClientMutation.ts`).
+- **Inglés Obligatorio:** Textos, variables, funciones y UI DEBEN estar en inglés.
+- **Comentarios:** No agregar comentarios en el código a menos que la lógica sea excepcionalmente compleja. Si son estrictamente necesarios, usar JSDoc en inglés.
+- **Componentes:** `PascalCase.tsx`. Separar contenedores (smart) de componentes puros.
+- **Hooks:** `camelCase.ts` con prefijo `use`. Separar queries y mutations.
+- **Servicios/Utils:** `camelCase.ts`.
+- **Tipado (Regla de ORO):** NUNCA usar `any` o `as any`. Usar validaciones, narrowings o `unknown`.
+- **Importaciones compartidas:** Los types vienen de `@battle-racing/br-common-lib`. Si no existen, crearlos allí o en la carpeta `types` si son locales. NUNCA usar `import * as BrCommon`. Importar específicamente.

package/.agents/rules/02-architecture-and-routing.md

@@ -0,0 +1,15 @@
+---
+trigger: always_on
+---
+
+# Module Architecture & Routing
+
+- **Encapsulación por Feature:** Cada módulo en `src/features/{nombre-modulo}` debe contener:
+  - `index.ts`: Public API, exporta solo lo necesario.
+  - `types/`: Definiciones locales.
+  - `services/`: Lógica de API. **SIEMPRE** se debe usar un patrón de objeto para exportar los métodos (Ej: `export const authService = { login: () => {} }`) y realizar las consultas HTTP reusando la instancia de Axios definida en `src/lib/api.ts`. usando la instancia Axios en `src/lib/api.ts`.
+  - `hooks/`: Queries y Mutations usando `@tanstack/react-query`.
+  - `store/`: Estados de Zustand (si aplica).
+- **TanStack Router:** Rutas en `src/routes/` NO deben tener lógica de componentes o UI compleja.
+- **Componentes Page:** Las rutas importan componentes de la carpeta `pages/` de cada feature (Ej: `src/routes/guest-registration.tsx` importa `<GuestRegistrationPage />`).
+- **Semántica:** Nombres basados en la función específica (ej. `ticket-sales`), no usar nombres genéricos abstractos.

package/.agents/rules/03-state-and-data.md

@@ -0,0 +1,10 @@
+---
+trigger: always_on
+---
+
+# Data Management & State
+
+- **TanStack Query:** Usar siempre `@tanstack/react-query` en los hooks, invocando servicios.
+- **Query Key Factory:** Definir constantes de llaves (`userKeys`, `raceKeys`) en cada módulo para invalidación centralizada.
+- **Separación de Hooks:** Mantener Queries (lectura) y Mutations (escritura) en archivos distintos.
+- **Prioridad de Tipos:** Priorizar esquemas de `@battle-racing/br-common-lib` antes de definir locales.

package/.agents/rules/04-ui-and-styling.md

@@ -0,0 +1,10 @@
+---
+trigger: always_on
+---
+
+# UI, UX & Styling
+
+- **ShadCN:** Usar v4.1. Lógica de estilos en CSS, sin `tailwind.config.ts`.
+- **Estructura de Componentes:** Cada componente en su carpeta. Extraer variantes a `*.variants.ts`.
+- **Diseño Atómico:** Separar en Átomos (elementos básicos) y Moléculas (componentes compuestos).
+- **Colores:** NUNCA usar colores puros. Usar la capa semántica de ShadCN. Crear nuevos tokens semánticos si el color no existe para soportar white labels.

package/.agents/rules/05-code-quality-and-practices.md

@@ -0,0 +1,10 @@
+---
+trigger: always_on
+---
+
+# Code Quality & React Best Practices
+
+- **Legibilidad y Mantenimiento:** Priorizar código fácil de leer. Si hay múltiples enfoques para una solución, evaluar ventajas/desventajas antes de implementar.
+- **Variables de Entorno:** Acceder mediante `import.meta.env`. Usar prefijo `VITE_` para públicas.
+- **Rendimiento:** Evitar optimización prematura. Usar `useMemo` y `useCallback` solo con componentes `React.memo` o cálculos costosos demostrables. Usar `React.lazy` y `Suspense` para lazy loading en rutas.
+- **Error Boundaries:** Cada módulo en `src/features/` debe exportar un Error Boundary a nivel de ruta para aislar fallos.

package/dist/__deprecated__/types/ticketing/GameTurn.schema.d.ts

@@ -12,8 +12,8 @@ export declare const GAME_TURN_CHECK: {
     readonly TERMS_ACCEPTANCE: "terms_acceptance";
 };
 export declare const GameTurnStatusSchema: z.ZodEnum<{
-    completed: "completed";
     created: "created";
+    completed: "completed";
     in_queue: "in_queue";
     ready: "ready";
     playing: "playing";
@@ -30,8 +30,8 @@ export declare const GameTurnSchema: z.ZodObject<{
     gameTickets: z.ZodArray<z.ZodString>;
     playerIds: z.ZodArray<z.ZodString>;
     status: z.ZodEnum<{
-        completed: "completed";
         created: "created";
+        completed: "completed";
         in_queue: "in_queue";
         ready: "ready";
         playing: "playing";
@@ -44,8 +44,8 @@ export declare const GameTurnSchema: z.ZodObject<{
             link_accept: "link_accept";
         }>;
         status: z.ZodEnum<{
-            pending: "pending";
             completed: "completed";
+            pending: "pending";
         }>;
         label: z.ZodString;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
@@ -63,8 +63,8 @@ export declare const GameTurnQueueItemSchema: z.ZodObject<{
     gameTickets: z.ZodArray<z.ZodString>;
     playerIds: z.ZodArray<z.ZodString>;
     status: z.ZodEnum<{
-        completed: "completed";
         created: "created";
+        completed: "completed";
         in_queue: "in_queue";
         ready: "ready";
         playing: "playing";
@@ -77,8 +77,8 @@ export declare const GameTurnQueueItemSchema: z.ZodObject<{
             link_accept: "link_accept";
         }>;
         status: z.ZodEnum<{
-            pending: "pending";
             completed: "completed";
+            pending: "pending";
         }>;
         label: z.ZodString;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;

package/dist/__deprecated__/types/ticketing/GameTurnTask.schema.d.ts

@@ -14,8 +14,8 @@ export declare const GameTurnTaskTypeSchema: z.ZodEnum<{
     link_accept: "link_accept";
 }>;
 export declare const GameTurnTaskStatusSchema: z.ZodEnum<{
-    pending: "pending";
     completed: "completed";
+    pending: "pending";
 }>;
 export declare const GameTurnTaskSchema: z.ZodObject<{
     id: z.ZodString;
@@ -25,8 +25,8 @@ export declare const GameTurnTaskSchema: z.ZodObject<{
         link_accept: "link_accept";
     }>;
     status: z.ZodEnum<{
-        pending: "pending";
         completed: "completed";
+        pending: "pending";
     }>;
     label: z.ZodString;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;

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

@@ -40,10 +40,6 @@ export declare const playerSchema: z.ZodObject<{
     updatedAt: z.ZodDate;
 }, z.core.$strip>;
 export declare const createPlayerSchema: z.ZodObject<{
-    type: z.ZodDefault<z.ZodEnum<{
-        readonly ADULT: "ADULT";
-        readonly MINOR: "MINOR";
-    }>>;
     nickname: z.ZodString;
     birthDate: z.ZodCoercedDate<unknown>;
 }, z.core.$strip>;

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

@@ -32,7 +32,6 @@ exports.playerSchema = zod_1.z.object({
 exports.createPlayerSchema = exports.playerSchema
     .pick({
     nickname: true,
-    type: true,
 })
     .extend({
     birthDate: zod_1.z.coerce.date(),

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

@@ -1,5 +1,6 @@
 export declare const SESSION_STATUS: {
-    readonly CREATED: "CREATED";
+    readonly REGISTRATION: "REGISTRATION";
+    readonly TURN_CREATION: "TURN_CREATION";
     readonly READY: "READY";
     readonly STARTED: "STARTED";
     readonly FINISHED: "FINISHED";

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

@@ -2,7 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SESSION_STATUS = void 0;
 exports.SESSION_STATUS = {
-    CREATED: 'CREATED',
+    REGISTRATION: 'REGISTRATION',
+    TURN_CREATION: 'TURN_CREATION',
     READY: 'READY',
     STARTED: 'STARTED',
     FINISHED: 'FINISHED',

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

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 export declare const sessionStatusSchema: z.ZodEnum<{
-    readonly CREATED: "CREATED";
+    readonly REGISTRATION: "REGISTRATION";
+    readonly TURN_CREATION: "TURN_CREATION";
     readonly READY: "READY";
     readonly STARTED: "STARTED";
     readonly FINISHED: "FINISHED";
@@ -14,20 +15,36 @@ export declare const sessionTicketSchema: z.ZodObject<{
     }>;
 }, z.core.$strip>;
 export declare const gameSessionSchema: z.ZodObject<{
+    id: z.ZodUUID;
     code: z.ZodString;
     contactPhone: z.ZodOptional<z.ZodString>;
     userId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
-    tickets: z.ZodArray<z.ZodObject<{
-        quantity: z.ZodNumber;
-        type: z.ZodEnum<{
-            readonly Race: "Race";
-            readonly Battle: "Battle";
+    tickets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodUUID;
+        purchaseId: z.ZodString;
+        sessionId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        gameTurnId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        playerId: z.ZodNullable<z.ZodOptional<z.ZodUUID>>;
+        status: z.ZodEnum<{
+            readonly CREATED: "created";
+            readonly ASSIGNED: "assigned";
+            readonly ACTIVE: "active";
+            readonly COMPLETED: "completed";
         }>;
-    }, z.core.$strip>>;
+        type: z.ZodDefault<z.ZodEnum<{
+            readonly RACE: "race";
+            readonly BATTLE: "battle";
+            readonly SOCCER: "soccer";
+        }>>;
+        createdAt: z.ZodDate;
+        updatedAt: z.ZodDate;
+        completedAt: z.ZodOptional<z.ZodDate>;
+    }, z.core.$strip>>>;
     playerIds: z.ZodArray<z.ZodUUID>;
     linkedPurchaseId: z.ZodOptional<z.ZodString>;
     status: z.ZodDefault<z.ZodEnum<{
-        readonly CREATED: "CREATED";
+        readonly REGISTRATION: "REGISTRATION";
+        readonly TURN_CREATION: "TURN_CREATION";
         readonly READY: "READY";
         readonly STARTED: "STARTED";
         readonly FINISHED: "FINISHED";
@@ -36,6 +53,104 @@ export declare const gameSessionSchema: z.ZodObject<{
     createdAt: z.ZodDate;
     updatedAt: z.ZodDate;
 }, z.core.$strip>;
+export declare const gameSessionWithPlayersSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    code: z.ZodString;
+    contactPhone: z.ZodOptional<z.ZodString>;
+    userId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    tickets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodUUID;
+        purchaseId: z.ZodString;
+        sessionId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        gameTurnId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        playerId: z.ZodNullable<z.ZodOptional<z.ZodUUID>>;
+        status: z.ZodEnum<{
+            readonly CREATED: "created";
+            readonly ASSIGNED: "assigned";
+            readonly ACTIVE: "active";
+            readonly COMPLETED: "completed";
+        }>;
+        type: z.ZodDefault<z.ZodEnum<{
+            readonly RACE: "race";
+            readonly BATTLE: "battle";
+            readonly SOCCER: "soccer";
+        }>>;
+        createdAt: z.ZodDate;
+        updatedAt: z.ZodDate;
+        completedAt: z.ZodOptional<z.ZodDate>;
+    }, z.core.$strip>>>;
+    playerIds: z.ZodArray<z.ZodUUID>;
+    linkedPurchaseId: z.ZodOptional<z.ZodString>;
+    status: z.ZodDefault<z.ZodEnum<{
+        readonly REGISTRATION: "REGISTRATION";
+        readonly TURN_CREATION: "TURN_CREATION";
+        readonly READY: "READY";
+        readonly STARTED: "STARTED";
+        readonly FINISHED: "FINISHED";
+        readonly CANCELLED: "CANCELLED";
+    }>>;
+    createdAt: z.ZodDate;
+    updatedAt: z.ZodDate;
+    players: 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;
+    }, z.core.$strip>>;
+    turns: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        purchaseId: z.ZodString;
+        sessionId: z.ZodOptional<z.ZodString>;
+        leaderPlayerId: z.ZodString;
+        gameTickets: z.ZodArray<z.ZodString>;
+        playerIds: z.ZodArray<z.ZodString>;
+        status: z.ZodEnum<{
+            readonly CREATED: "created";
+            readonly IN_QUEUE: "in_queue";
+            readonly READY: "ready";
+            readonly PLAYING: "playing";
+            readonly COMPLETED: "completed";
+        }>;
+        tasks: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodEnum<{
+                readonly QR_SCAN: "qr_scan";
+                readonly MANUAL_CHECK: "manual_check";
+                readonly LINK_ACCEPT: "link_accept";
+            }>;
+            status: z.ZodEnum<{
+                readonly PENDING: "pending";
+                readonly COMPLETED: "completed";
+            }>;
+            label: z.ZodString;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            completedAt: z.ZodOptional<z.ZodDate>;
+        }, z.core.$strip>>;
+        createdAt: z.ZodDate;
+        updatedAt: z.ZodDate;
+        startedAt: z.ZodOptional<z.ZodDate>;
+        completedAt: z.ZodOptional<z.ZodDate>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
 export declare const createSessionInputSchema: z.ZodObject<{
     contactPhone: z.ZodOptional<z.ZodString>;
     userId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
@@ -51,6 +166,16 @@ export declare const joinSessionSchema: z.ZodObject<{
     nickname: z.ZodString;
     birthDate: z.ZodCoercedDate<unknown>;
 }, z.core.$strip>;
+export declare const updateSessionStatusSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        readonly REGISTRATION: "REGISTRATION";
+        readonly TURN_CREATION: "TURN_CREATION";
+        readonly READY: "READY";
+        readonly STARTED: "STARTED";
+        readonly FINISHED: "FINISHED";
+        readonly CANCELLED: "CANCELLED";
+    }>;
+}, z.core.$strip>;
 export declare const createGameTurnInputSchema: z.ZodObject<{
     assignments: z.ZodArray<z.ZodObject<{
         ticketId: z.ZodString;
@@ -63,3 +188,11 @@ export declare const assignSessionTicketsInputSchema: z.ZodObject<{
         playerId: z.ZodUUID;
     }, z.core.$strip>>;
 }, z.core.$strip>;
+export declare const bulkCreateGameTurnSchema: z.ZodObject<{
+    turns: z.ZodArray<z.ZodObject<{
+        assignments: z.ZodArray<z.ZodObject<{
+            ticketId: z.ZodString;
+            playerId: z.ZodUUID;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;

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

@@ -1,25 +1,32 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.assignSessionTicketsInputSchema = exports.createGameTurnInputSchema = exports.joinSessionSchema = exports.createSessionInputSchema = exports.gameSessionSchema = exports.sessionTicketSchema = exports.sessionStatusSchema = void 0;
+exports.bulkCreateGameTurnSchema = exports.assignSessionTicketsInputSchema = exports.createGameTurnInputSchema = exports.updateSessionStatusSchema = 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");
+const Player_schema_1 = require("../player/Player.schema");
+const Ticketing_schema_1 = require("../ticketing/Ticketing.schema");
 exports.sessionStatusSchema = zod_1.z.enum(Session_const_1.SESSION_STATUS);
 exports.sessionTicketSchema = zod_1.z.object({
     quantity: zod_1.z.number().int().positive(),
     type: Game_schema_1.gameTypeSchema,
 });
 exports.gameSessionSchema = zod_1.z.object({
+    id: zod_1.z.uuidv4(),
     code: zod_1.z.string().length(6), // 6-char alphanumeric
     contactPhone: zod_1.z.string().optional(),
     userId: zod_1.z.string().optional().nullable(),
-    tickets: zod_1.z.array(exports.sessionTicketSchema),
+    tickets: zod_1.z.array(Ticketing_schema_1.gameTicketSchema).optional(),
     playerIds: zod_1.z.array(zod_1.z.uuidv4()),
     linkedPurchaseId: zod_1.z.string().optional(),
-    status: exports.sessionStatusSchema.default(Session_const_1.SESSION_STATUS.CREATED),
+    status: exports.sessionStatusSchema.default(Session_const_1.SESSION_STATUS.REGISTRATION),
     createdAt: zod_1.z.date(),
     updatedAt: zod_1.z.date(),
 });
+exports.gameSessionWithPlayersSchema = exports.gameSessionSchema.extend({
+    players: zod_1.z.array(Player_schema_1.playerSchema),
+    turns: zod_1.z.array(Ticketing_schema_1.gameTurnSchema).optional(),
+});
 exports.createSessionInputSchema = zod_1.z.object({
     contactPhone: zod_1.z.string().optional(),
     userId: zod_1.z.string().optional().nullable(),
@@ -29,6 +36,9 @@ exports.joinSessionSchema = zod_1.z.object({
     nickname: zod_1.z.string().min(2),
     birthDate: zod_1.z.coerce.date(),
 });
+exports.updateSessionStatusSchema = zod_1.z.object({
+    status: exports.sessionStatusSchema,
+});
 exports.createGameTurnInputSchema = zod_1.z.object({
     assignments: zod_1.z
         .array(zod_1.z.object({
@@ -45,3 +55,6 @@ exports.assignSessionTicketsInputSchema = zod_1.z.object({
     }))
         .min(1),
 });
+exports.bulkCreateGameTurnSchema = zod_1.z.object({
+    turns: zod_1.z.array(exports.createGameTurnInputSchema).min(1),
+});

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

@@ -1,7 +1,10 @@
 import { z } from 'zod';
-import { assignSessionTicketsInputSchema, createSessionInputSchema, gameSessionSchema, sessionStatusSchema, sessionTicketSchema } from './Session.schema';
+import { assignSessionTicketsInputSchema, createSessionInputSchema, gameSessionSchema, gameSessionWithPlayersSchema, joinSessionSchema, bulkCreateGameTurnSchema, sessionStatusSchema, sessionTicketSchema } from './Session.schema';
 export type SessionStatus = z.infer<typeof sessionStatusSchema>;
 export type SessionTicket = z.infer<typeof sessionTicketSchema>;
 export type GameSession = z.infer<typeof gameSessionSchema>;
+export type GameSessionWithPlayers = z.infer<typeof gameSessionWithPlayersSchema>;
 export type CreateSessionInput = z.infer<typeof createSessionInputSchema>;
 export type AssignSessionTicketsInput = z.infer<typeof assignSessionTicketsInputSchema>;
+export type JoinSessionInput = z.infer<typeof joinSessionSchema>;
+export type BulkCreateGameTurnInput = z.infer<typeof bulkCreateGameTurnSchema>;

package/dist/domains/ticketing/Ticketing.schema.d.ts

@@ -59,6 +59,8 @@ export declare const purchaseSchema: z.ZodObject<{
     id: z.ZodUUID;
     purchaseNumber: z.ZodNumber;
     buyerUserId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    guestName: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    guestContact: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     items: z.ZodArray<z.ZodObject<{
         ticketType: z.ZodEnum<{
             readonly Race: "Race";
@@ -85,6 +87,8 @@ export declare const purchaseSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const createPurchaseInputSchema: z.ZodObject<{
     buyerUserId: z.ZodOptional<z.ZodString>;
+    guestName: z.ZodOptional<z.ZodString>;
+    guestContact: z.ZodOptional<z.ZodString>;
     items: z.ZodArray<z.ZodObject<{
         ticketType: z.ZodEnum<{
             readonly Race: "Race";
@@ -133,6 +137,7 @@ export declare const gameTurnTaskSchema: z.ZodObject<{
 export declare const gameTurnSchema: z.ZodObject<{
     id: z.ZodString;
     purchaseId: z.ZodString;
+    sessionId: z.ZodOptional<z.ZodString>;
     leaderPlayerId: z.ZodString;
     gameTickets: z.ZodArray<z.ZodString>;
     playerIds: z.ZodArray<z.ZodString>;
@@ -166,6 +171,7 @@ export declare const gameTurnSchema: z.ZodObject<{
 export declare const gameTurnQueueItemSchema: z.ZodObject<{
     id: z.ZodString;
     purchaseId: z.ZodString;
+    sessionId: z.ZodOptional<z.ZodString>;
     leaderPlayerId: z.ZodString;
     gameTickets: z.ZodArray<z.ZodString>;
     playerIds: z.ZodArray<z.ZodString>;

package/dist/domains/ticketing/Ticketing.schema.js

@@ -31,6 +31,8 @@ exports.purchaseSchema = zod_1.z.object({
     purchaseNumber: zod_1.z.number(),
     // Buyer can be null for Guest/On-Site purchases
     buyerUserId: zod_1.z.string().optional().nullable(),
+    guestName: zod_1.z.string().optional().nullable(),
+    guestContact: zod_1.z.string().optional().nullable(),
     items: zod_1.z.array(exports.purchaseItemSchema),
     totalAmountCents: zod_1.z.number().min(0),
     status: exports.purchaseStatusSchema.default(Ticketing_const_1.PURCHASE_STATUS.PENDING),
@@ -43,6 +45,8 @@ exports.purchaseSchema = zod_1.z.object({
 });
 exports.createPurchaseInputSchema = zod_1.z.object({
     buyerUserId: zod_1.z.string().optional(),
+    guestName: zod_1.z.string().optional(),
+    guestContact: zod_1.z.string().optional(),
     items: zod_1.z.array(exports.purchaseItemSchema).min(1),
 });
 exports.gameTurnStatusSchema = zod_1.z.enum(Ticketing_const_1.GAME_TURN_STATUS);
@@ -60,6 +64,7 @@ exports.gameTurnTaskSchema = zod_1.z.object({
 exports.gameTurnSchema = zod_1.z.object({
     id: zod_1.z.string(),
     purchaseId: zod_1.z.string(),
+    sessionId: zod_1.z.string().optional(),
     leaderPlayerId: zod_1.z.string(),
     gameTickets: zod_1.z.array(zod_1.z.string()),
     playerIds: zod_1.z.array(zod_1.z.string()),

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

@@ -6,6 +6,8 @@ export declare const userTypeSchema: z.ZodEnum<{
 export declare const PHONE_REGEX: RegExp;
 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>;
     role: z.ZodEnum<{
@@ -27,6 +29,8 @@ export declare const userSchema: z.ZodObject<{
 }, 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>;
     role: z.ZodEnum<{
@@ -49,9 +53,10 @@ export declare const userWithPasswordSchema: z.ZodIntersection<z.ZodObject<{
     password: z.ZodString;
 }, z.core.$strip>>;
 export declare const userRegistrationInputSchema: z.ZodObject<{
+    name: z.ZodString;
+    lastName: z.ZodString;
     email: z.ZodOptional<z.ZodEmail>;
     phoneNumber: z.ZodOptional<z.ZodString>;
-    name: z.ZodOptional<z.ZodString>;
     password: z.ZodString;
     nickname: z.ZodString;
     birthDate: z.ZodCoercedDate<unknown>;

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

@@ -9,6 +9,8 @@ exports.PHONE_REGEX = /^([+]?[\\s0-9]+)?(\\d{3}|[(]?[0-9]+[)])?([-]?[\\s]?[0-9])
 const MIN_PASSWORD_LENGTH = 6;
 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(),
     // --- ACCESS CONTROL ---
@@ -31,11 +33,12 @@ exports.userWithPasswordSchema = exports.userSchema.and(zod_1.z.object({
 }));
 exports.userRegistrationInputSchema = baseUserObj
     .pick({
+    name: true,
+    lastName: true,
     email: true,
     phoneNumber: true,
 })
     .extend({
-    name: zod_1.z.string().optional(),
     password: zod_1.z.string().min(6),
     nickname: zod_1.z.string().min(2),
     birthDate: zod_1.z.coerce.date(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@battle-racing/br-common-lib",
-  "version": "4.3.0",
+  "version": "4.4.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,7 +37,6 @@ export const playerSchema = z.object({
 export const createPlayerSchema = playerSchema
   .pick({
     nickname: true,
-    type: true,
   })
   .extend({
     birthDate: z.coerce.date(),

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

@@ -1,5 +1,6 @@
 export const SESSION_STATUS = {
-  CREATED: 'CREATED',
+  REGISTRATION: 'REGISTRATION',
+  TURN_CREATION: 'TURN_CREATION',
   READY: 'READY',
   STARTED: 'STARTED',
   FINISHED: 'FINISHED',

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

@@ -1,6 +1,8 @@
 import { z } from 'zod';
 import { SESSION_STATUS } from './Session.const';
 import { gameTypeSchema } from '../game/Game.schema';
+import { playerSchema } from '../player/Player.schema';
+import { gameTicketSchema, gameTurnSchema } from '../ticketing/Ticketing.schema';
 
 export const sessionStatusSchema = z.enum(SESSION_STATUS);
 
@@ -10,20 +12,26 @@ export const sessionTicketSchema = z.object({
 });
 
 export const gameSessionSchema = z.object({
+  id: z.uuidv4(),
   code: z.string().length(6), // 6-char alphanumeric
   contactPhone: z.string().optional(),
   userId: z.string().optional().nullable(),
 
-  tickets: z.array(sessionTicketSchema),
+  tickets: z.array(gameTicketSchema).optional(),
   playerIds: z.array(z.uuidv4()),
   linkedPurchaseId: z.string().optional(),
 
-  status: sessionStatusSchema.default(SESSION_STATUS.CREATED),
+  status: sessionStatusSchema.default(SESSION_STATUS.REGISTRATION),
 
   createdAt: z.date(),
   updatedAt: z.date(),
 });
 
+export const gameSessionWithPlayersSchema = gameSessionSchema.extend({
+  players: z.array(playerSchema),
+  turns: z.array(gameTurnSchema).optional(),
+});
+
 export const createSessionInputSchema = z.object({
   contactPhone: z.string().optional(),
   userId: z.string().optional().nullable(),
@@ -35,6 +43,10 @@ export const joinSessionSchema = z.object({
   birthDate: z.coerce.date(),
 });
 
+export const updateSessionStatusSchema = z.object({
+  status: sessionStatusSchema,
+});
+
 export const createGameTurnInputSchema = z.object({
   assignments: z
     .array(
@@ -56,3 +68,7 @@ export const assignSessionTicketsInputSchema = z.object({
     )
     .min(1),
 });
+
+export const bulkCreateGameTurnSchema = z.object({
+  turns: z.array(createGameTurnInputSchema).min(1),
+});

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

@@ -3,6 +3,9 @@ import {
   assignSessionTicketsInputSchema,
   createSessionInputSchema,
   gameSessionSchema,
+  gameSessionWithPlayersSchema,
+  joinSessionSchema,
+  bulkCreateGameTurnSchema,
   sessionStatusSchema,
   sessionTicketSchema,
 } from './Session.schema';
@@ -10,5 +13,8 @@ import {
 export type SessionStatus = z.infer<typeof sessionStatusSchema>;
 export type SessionTicket = z.infer<typeof sessionTicketSchema>;
 export type GameSession = z.infer<typeof gameSessionSchema>;
+export type GameSessionWithPlayers = z.infer<typeof gameSessionWithPlayersSchema>;
 export type CreateSessionInput = z.infer<typeof createSessionInputSchema>;
 export type AssignSessionTicketsInput = z.infer<typeof assignSessionTicketsInputSchema>;
+export type JoinSessionInput = z.infer<typeof joinSessionSchema>;
+export type BulkCreateGameTurnInput = z.infer<typeof bulkCreateGameTurnSchema>;

package/src/domains/ticketing/Ticketing.schema.ts

@@ -43,6 +43,8 @@ export const purchaseSchema = z.object({
 
   // Buyer can be null for Guest/On-Site purchases
   buyerUserId: z.string().optional().nullable(),
+  guestName: z.string().optional().nullable(),
+  guestContact: z.string().optional().nullable(),
 
   items: z.array(purchaseItemSchema),
   totalAmountCents: z.number().min(0),
@@ -59,6 +61,8 @@ export const purchaseSchema = z.object({
 
 export const createPurchaseInputSchema = z.object({
   buyerUserId: z.string().optional(),
+  guestName: z.string().optional(),
+  guestContact: z.string().optional(),
   items: z.array(purchaseItemSchema).min(1),
 });
 
@@ -82,6 +86,7 @@ export const gameTurnTaskSchema = z.object({
 export const gameTurnSchema = z.object({
   id: z.string(),
   purchaseId: z.string(),
+  sessionId: z.string().optional(),
   leaderPlayerId: z.string(),
   gameTickets: z.array(z.string()),
   playerIds: z.array(z.string()),

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

@@ -10,6 +10,9 @@ const MIN_PASSWORD_LENGTH = 6;
 const baseUserObj = z.object({
   id: z.uuidv4(),
 
+  name: z.string(),
+  lastName: z.string(),
+
   email: z.email().toLowerCase().optional(),
 
   phoneNumber: z.string().regex(PHONE_REGEX, 'Invalid phone number format').optional(),
@@ -42,11 +45,12 @@ export const userWithPasswordSchema = userSchema.and(
 
 export const userRegistrationInputSchema = baseUserObj
   .pick({
+    name: true,
+    lastName: true,
     email: true,
     phoneNumber: true,
   })
   .extend({
-    name: z.string().optional(),
     password: z.string().min(6),
     nickname: z.string().min(2),
     birthDate: z.coerce.date(),