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

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

@@ -0,0 +1,65 @@
+import { z } from 'zod';
+export declare const sessionStatusSchema: z.ZodEnum<{
+    readonly CREATED: "CREATED";
+    readonly READY: "READY";
+    readonly STARTED: "STARTED";
+    readonly FINISHED: "FINISHED";
+    readonly CANCELLED: "CANCELLED";
+}>;
+export declare const sessionTicketSchema: z.ZodObject<{
+    quantity: z.ZodNumber;
+    type: z.ZodEnum<{
+        readonly Race: "Race";
+        readonly Battle: "Battle";
+    }>;
+}, z.core.$strip>;
+export declare const gameSessionSchema: z.ZodObject<{
+    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";
+        }>;
+    }, z.core.$strip>>;
+    playerIds: z.ZodArray<z.ZodUUID>;
+    linkedPurchaseId: z.ZodOptional<z.ZodString>;
+    status: z.ZodDefault<z.ZodEnum<{
+        readonly CREATED: "CREATED";
+        readonly READY: "READY";
+        readonly STARTED: "STARTED";
+        readonly FINISHED: "FINISHED";
+        readonly CANCELLED: "CANCELLED";
+    }>>;
+    createdAt: z.ZodDate;
+    updatedAt: z.ZodDate;
+}, z.core.$strip>;
+export declare const createSessionInputSchema: z.ZodObject<{
+    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";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const joinSessionSchema: z.ZodObject<{
+    nickname: z.ZodString;
+    birthDate: z.ZodCoercedDate<unknown>;
+}, z.core.$strip>;
+export declare const createGameTurnInputSchema: z.ZodObject<{
+    assignments: z.ZodArray<z.ZodObject<{
+        ticketId: z.ZodString;
+        playerId: z.ZodUUID;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const assignSessionTicketsInputSchema: z.ZodObject<{
+    assignments: z.ZodArray<z.ZodObject<{
+        ticketId: z.ZodString;
+        playerId: z.ZodUUID;
+    }, z.core.$strip>>;
+}, z.core.$strip>;

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

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assignSessionTicketsInputSchema = exports.createGameTurnInputSchema = exports.joinSessionSchema = exports.createSessionInputSchema = 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");
+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({
+    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),
+    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),
+    createdAt: zod_1.z.date(),
+    updatedAt: zod_1.z.date(),
+});
+exports.createSessionInputSchema = zod_1.z.object({
+    contactPhone: zod_1.z.string().optional(),
+    userId: zod_1.z.string().optional().nullable(),
+    tickets: zod_1.z.array(exports.sessionTicketSchema).min(1),
+});
+exports.joinSessionSchema = zod_1.z.object({
+    nickname: zod_1.z.string().min(2),
+    birthDate: zod_1.z.coerce.date(),
+});
+exports.createGameTurnInputSchema = zod_1.z.object({
+    assignments: zod_1.z
+        .array(zod_1.z.object({
+        ticketId: zod_1.z.string(),
+        playerId: zod_1.z.uuidv4(),
+    }))
+        .min(1),
+});
+exports.assignSessionTicketsInputSchema = zod_1.z.object({
+    assignments: zod_1.z
+        .array(zod_1.z.object({
+        ticketId: zod_1.z.string(),
+        playerId: zod_1.z.uuidv4(),
+    }))
+        .min(1),
+});

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

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+import { assignSessionTicketsInputSchema, createSessionInputSchema, gameSessionSchema, 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 CreateSessionInput = z.infer<typeof createSessionInputSchema>;
+export type AssignSessionTicketsInput = z.infer<typeof assignSessionTicketsInputSchema>;

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

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

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

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

package/dist/domains/session/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./Session.const"), exports);
+__exportStar(require("./Session.schema"), exports);
+__exportStar(require("./Session.types"), exports);

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

@@ -36,3 +36,8 @@ export declare const GAME_TURN_TASK_STATUS: {
     readonly PENDING: "pending";
     readonly COMPLETED: "completed";
 };
+export declare const PURCHASE_STATUS: {
+    readonly PENDING: "pending";
+    readonly PAID: "paid";
+    readonly CANCELLED: "cancelled";
+};

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GAME_TURN_TASK_STATUS = exports.GAME_TURN_TASK_TYPE = exports.GAME_TURN_CHECK = exports.GAME_TURN_STATUS = exports.TICKET_TYPE = exports.TICKET_USER_TYPE = exports.GAME_TICKET_STATUS = void 0;
+exports.PURCHASE_STATUS = exports.GAME_TURN_TASK_STATUS = exports.GAME_TURN_TASK_TYPE = exports.GAME_TURN_CHECK = exports.GAME_TURN_STATUS = exports.TICKET_TYPE = exports.TICKET_USER_TYPE = exports.GAME_TICKET_STATUS = void 0;
 exports.GAME_TICKET_STATUS = {
     CREATED: 'created',
     ASSIGNED: 'assigned',
@@ -39,3 +39,8 @@ exports.GAME_TURN_TASK_STATUS = {
     PENDING: 'pending',
     COMPLETED: 'completed',
 };
+exports.PURCHASE_STATUS = {
+    PENDING: 'pending',
+    PAID: 'paid',
+    CANCELLED: 'cancelled',
+};

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

@@ -22,16 +22,11 @@ export declare const ticketSummarySchema: z.ZodRecord<z.ZodEnum<{
     readonly SOCCER: "soccer";
 }>, z.ZodNumber>;
 export declare const gameTicketSchema: z.ZodObject<{
-    id: z.ZodString;
+    id: z.ZodUUID;
     purchaseId: z.ZodString;
-    gameTurnId: z.ZodString;
-    ownerUsername: z.ZodString;
-    userType: z.ZodEnum<{
-        readonly LEADER: "leader";
-        readonly SUB_USER: "sub-user";
-        readonly EXISTING: "existing";
-        readonly GUEST: "guest";
-    }>;
+    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";
@@ -47,13 +42,39 @@ export declare const gameTicketSchema: z.ZodObject<{
     updatedAt: z.ZodDate;
     completedAt: z.ZodOptional<z.ZodDate>;
 }, z.core.$strip>;
+export declare const purchaseStatusSchema: z.ZodEnum<{
+    readonly PENDING: "pending";
+    readonly PAID: "paid";
+    readonly CANCELLED: "cancelled";
+}>;
+export declare const purchaseItemSchema: z.ZodObject<{
+    ticketType: z.ZodEnum<{
+        readonly Race: "Race";
+        readonly Battle: "Battle";
+    }>;
+    quantity: z.ZodNumber;
+    priceCents: z.ZodNumber;
+}, z.core.$strip>;
 export declare const purchaseSchema: z.ZodObject<{
-    id: z.ZodString;
+    id: z.ZodUUID;
     purchaseNumber: z.ZodNumber;
-    buyerUserId: z.ZodString;
-    totalTickets: z.ZodNumber;
-    purchaseDate: z.ZodDate;
-    ticketType: z.ZodDefault<z.ZodEnum<{
+    buyerUserId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    items: z.ZodArray<z.ZodObject<{
+        ticketType: z.ZodEnum<{
+            readonly Race: "Race";
+            readonly Battle: "Battle";
+        }>;
+        quantity: z.ZodNumber;
+        priceCents: z.ZodNumber;
+    }, z.core.$strip>>;
+    totalAmountCents: z.ZodNumber;
+    status: z.ZodDefault<z.ZodEnum<{
+        readonly PENDING: "pending";
+        readonly PAID: "paid";
+        readonly CANCELLED: "cancelled";
+    }>>;
+    totalTickets: z.ZodOptional<z.ZodNumber>;
+    ticketType: z.ZodOptional<z.ZodEnum<{
         readonly RACE: "race";
         readonly BATTLE: "battle";
         readonly SOCCER: "soccer";
@@ -62,22 +83,16 @@ export declare const purchaseSchema: z.ZodObject<{
     createdAt: z.ZodDate;
     updatedAt: z.ZodDate;
 }, z.core.$strip>;
-export declare const createPurchasePublicSchema: z.ZodObject<{
-    ticketType: z.ZodDefault<z.ZodEnum<{
-        readonly RACE: "race";
-        readonly BATTLE: "battle";
-        readonly SOCCER: "soccer";
-    }>>;
-    ticketCount: z.ZodNumber;
-}, z.core.$strip>;
-export declare const createPurchaseInternalSchema: z.ZodObject<{
-    buyerUserId: z.ZodString;
-    ticketType: z.ZodDefault<z.ZodEnum<{
-        readonly RACE: "race";
-        readonly BATTLE: "battle";
-        readonly SOCCER: "soccer";
-    }>>;
-    ticketCount: z.ZodNumber;
+export declare const createPurchaseInputSchema: z.ZodObject<{
+    buyerUserId: z.ZodOptional<z.ZodString>;
+    items: z.ZodArray<z.ZodObject<{
+        ticketType: z.ZodEnum<{
+            readonly Race: "Race";
+            readonly Battle: "Battle";
+        }>;
+        quantity: z.ZodNumber;
+        priceCents: z.ZodNumber;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const gameTurnStatusSchema: z.ZodEnum<{
     readonly CREATED: "created";
@@ -118,9 +133,9 @@ export declare const gameTurnTaskSchema: z.ZodObject<{
 export declare const gameTurnSchema: z.ZodObject<{
     id: z.ZodString;
     purchaseId: z.ZodString;
-    leaderUsername: z.ZodString;
+    leaderPlayerId: z.ZodString;
     gameTickets: z.ZodArray<z.ZodString>;
-    usernames: z.ZodArray<z.ZodString>;
+    playerIds: z.ZodArray<z.ZodString>;
     status: z.ZodEnum<{
         readonly CREATED: "created";
         readonly IN_QUEUE: "in_queue";
@@ -151,9 +166,9 @@ export declare const gameTurnSchema: z.ZodObject<{
 export declare const gameTurnQueueItemSchema: z.ZodObject<{
     id: z.ZodString;
     purchaseId: z.ZodString;
-    leaderUsername: z.ZodString;
+    leaderPlayerId: z.ZodString;
     gameTickets: z.ZodArray<z.ZodString>;
-    usernames: z.ZodArray<z.ZodString>;
+    playerIds: z.ZodArray<z.ZodString>;
     status: z.ZodEnum<{
         readonly CREATED: "created";
         readonly IN_QUEUE: "in_queue";

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

@@ -1,49 +1,49 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.gameTurnQueueItemSchema = exports.gameTurnSchema = exports.gameTurnTaskSchema = exports.gameTurnTaskStatusSchema = exports.gameTurnTaskTypeSchema = exports.gameTurnCheckSchema = exports.gameTurnStatusSchema = exports.createPurchaseInternalSchema = exports.createPurchasePublicSchema = exports.purchaseSchema = exports.gameTicketSchema = exports.ticketSummarySchema = exports.ticketTypeSchema = exports.ticketUserTypeSchema = exports.gameTicketStatusSchema = void 0;
+exports.gameTurnQueueItemSchema = exports.gameTurnSchema = exports.gameTurnTaskSchema = exports.gameTurnTaskStatusSchema = exports.gameTurnTaskTypeSchema = exports.gameTurnCheckSchema = exports.gameTurnStatusSchema = exports.createPurchaseInputSchema = exports.purchaseSchema = exports.purchaseItemSchema = exports.purchaseStatusSchema = exports.gameTicketSchema = exports.ticketSummarySchema = exports.ticketTypeSchema = exports.ticketUserTypeSchema = exports.gameTicketStatusSchema = void 0;
 const zod_1 = require("zod");
 const Ticketing_const_1 = require("./Ticketing.const");
+const game_1 = require("../game");
 exports.gameTicketStatusSchema = zod_1.z.enum(Ticketing_const_1.GAME_TICKET_STATUS);
 exports.ticketUserTypeSchema = zod_1.z.enum(Ticketing_const_1.TICKET_USER_TYPE);
 exports.ticketTypeSchema = zod_1.z.enum(Ticketing_const_1.TICKET_TYPE);
 exports.ticketSummarySchema = zod_1.z.record(exports.ticketTypeSchema, zod_1.z.number());
 exports.gameTicketSchema = zod_1.z.object({
-    id: zod_1.z.string(),
+    id: zod_1.z.uuidv4(),
     purchaseId: zod_1.z.string(),
-    gameTurnId: zod_1.z.string(),
-    ownerUsername: zod_1.z.string(),
-    userType: exports.ticketUserTypeSchema,
+    sessionId: zod_1.z.string().optional().nullable(),
+    gameTurnId: zod_1.z.string().optional().nullable(),
+    playerId: zod_1.z.uuidv4().optional().nullable(),
     status: exports.gameTicketStatusSchema,
     type: exports.ticketTypeSchema.default(Ticketing_const_1.TICKET_TYPE.RACE),
     createdAt: zod_1.z.date(),
     updatedAt: zod_1.z.date(),
     completedAt: zod_1.z.date().optional(),
 });
+exports.purchaseStatusSchema = zod_1.z.enum(Ticketing_const_1.PURCHASE_STATUS);
+exports.purchaseItemSchema = zod_1.z.object({
+    ticketType: game_1.gameTypeSchema,
+    quantity: zod_1.z.number().int().positive(),
+    priceCents: zod_1.z.number().int().nonnegative(),
+});
 exports.purchaseSchema = zod_1.z.object({
-    id: zod_1.z.string(),
+    id: zod_1.z.uuidv4(),
     purchaseNumber: zod_1.z.number(),
-    buyerUserId: zod_1.z.string(),
-    totalTickets: zod_1.z.number(),
-    purchaseDate: zod_1.z.date(),
-    ticketType: exports.ticketTypeSchema.default(Ticketing_const_1.TICKET_TYPE.RACE),
+    // Buyer can be null for Guest/On-Site purchases
+    buyerUserId: 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),
+    // Deprecated fields (kept for backward compatibility if needed, or remove if safe)
+    totalTickets: zod_1.z.number().optional(),
+    ticketType: exports.ticketTypeSchema.optional(),
     paymentData: zod_1.z.any().optional(),
     createdAt: zod_1.z.date(),
     updatedAt: zod_1.z.date(),
 });
-exports.createPurchasePublicSchema = exports.purchaseSchema
-    .pick({
-    ticketType: true,
-})
-    .extend({
-    ticketCount: zod_1.z.number(),
-});
-exports.createPurchaseInternalSchema = exports.purchaseSchema
-    .pick({
-    ticketType: true,
-    buyerUserId: true,
-})
-    .extend({
-    ticketCount: zod_1.z.number(),
+exports.createPurchaseInputSchema = zod_1.z.object({
+    buyerUserId: 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);
 exports.gameTurnCheckSchema = zod_1.z.enum(Ticketing_const_1.GAME_TURN_CHECK);
@@ -60,9 +60,9 @@ exports.gameTurnTaskSchema = zod_1.z.object({
 exports.gameTurnSchema = zod_1.z.object({
     id: zod_1.z.string(),
     purchaseId: zod_1.z.string(),
-    leaderUsername: zod_1.z.string(),
+    leaderPlayerId: zod_1.z.string(),
     gameTickets: zod_1.z.array(zod_1.z.string()),
-    usernames: zod_1.z.array(zod_1.z.string()),
+    playerIds: zod_1.z.array(zod_1.z.string()),
     status: exports.gameTurnStatusSchema,
     tasks: zod_1.z.array(exports.gameTurnTaskSchema),
     createdAt: zod_1.z.date(),

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

@@ -1,12 +1,11 @@
 import { z } from 'zod';
-import { createPurchaseInternalSchema, createPurchasePublicSchema, gameTicketSchema, gameTicketStatusSchema, gameTurnCheckSchema, gameTurnQueueItemSchema, gameTurnSchema, gameTurnStatusSchema, gameTurnTaskSchema, gameTurnTaskStatusSchema, gameTurnTaskTypeSchema, purchaseSchema, ticketSummarySchema, ticketTypeSchema, ticketUserTypeSchema } from './Ticketing.schema';
+import { createPurchaseInputSchema, gameTicketSchema, gameTicketStatusSchema, gameTurnCheckSchema, gameTurnQueueItemSchema, gameTurnSchema, gameTurnStatusSchema, gameTurnTaskSchema, gameTurnTaskStatusSchema, gameTurnTaskTypeSchema, purchaseSchema, ticketSummarySchema, ticketTypeSchema, ticketUserTypeSchema } from './Ticketing.schema';
 export type TicketType = z.infer<typeof ticketTypeSchema>;
 export type GameTicketStatus = z.infer<typeof gameTicketStatusSchema>;
 export type TicketUserType = z.infer<typeof ticketUserTypeSchema>;
 export type TicketSummary = z.infer<typeof ticketSummarySchema>;
 export type Purchase = z.infer<typeof purchaseSchema>;
-export type CreatePurchasePublicInput = z.infer<typeof createPurchasePublicSchema>;
-export type CreatePurchaseInternalInput = z.infer<typeof createPurchaseInternalSchema>;
+export type CreatePurchaseInput = z.infer<typeof createPurchaseInputSchema>;
 export type GameTicket = z.infer<typeof gameTicketSchema>;
 export type GameTurnStatus = z.infer<typeof gameTurnStatusSchema>;
 export type GameTurnCheck = z.infer<typeof gameTurnCheckSchema>;

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

@@ -3,36 +3,60 @@ export declare const userTypeSchema: z.ZodEnum<{
     readonly STAFF: "STAFF";
     readonly PLAYER: "PLAYER";
 }>;
+export declare const PHONE_REGEX: RegExp;
 export declare const userSchema: z.ZodObject<{
-    id: z.ZodString;
-    name: z.ZodString;
-    username: z.ZodString;
-    email: z.ZodEmail;
-    phone: z.ZodOptional<z.ZodString>;
+    id: z.ZodUUID;
+    email: z.ZodOptional<z.ZodEmail>;
+    phoneNumber: 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>;
 }, z.core.$strip>;
-export declare const userWithPasswordSchema: z.ZodObject<{
-    id: z.ZodString;
-    name: z.ZodString;
-    username: z.ZodString;
-    email: z.ZodEmail;
-    phone: z.ZodOptional<z.ZodString>;
+export declare const userWithPasswordSchema: z.ZodIntersection<z.ZodObject<{
+    id: z.ZodUUID;
+    email: z.ZodOptional<z.ZodEmail>;
+    phoneNumber: 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>;
+}, z.core.$strip>, z.ZodObject<{
+    password: z.ZodString;
+}, z.core.$strip>>;
+export declare const userRegistrationInputSchema: z.ZodObject<{
+    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>;
+}, z.core.$strip>;
+export declare const userLoginInputSchema: z.ZodObject<{
+    emailOrPhone: z.ZodString;
     password: z.ZodString;
 }, z.core.$strip>;

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

@@ -1,19 +1,57 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.userWithPasswordSchema = exports.userSchema = exports.userTypeSchema = void 0;
+exports.userLoginInputSchema = exports.userRegistrationInputSchema = exports.userWithPasswordSchema = exports.userSchema = 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.userSchema = zod_1.z.object({
-    id: zod_1.z.string(),
-    name: zod_1.z.string(),
-    username: zod_1.z.string(),
-    email: zod_1.z.email(),
-    phone: zod_1.z.string().optional(),
+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(),
+    email: zod_1.z.email().toLowerCase().optional(),
+    phoneNumber: zod_1.z.string().regex(exports.PHONE_REGEX, 'Invalid phone number format').optional(),
+    // --- ACCESS CONTROL ---
     role: role_1.userRoleSchema,
     type: exports.userTypeSchema,
+    isActive: zod_1.z.boolean().default(true),
+    // TODO: Implement mechanism to validate users later by email or phone
+    isEmailVerified: zod_1.z.boolean().default(false),
+    isPhoneVerified: zod_1.z.boolean().default(false),
+    defaultPlayerId: zod_1.z.uuidv4().optional(),
+    createdAt: zod_1.z.date(),
+    lastLoginAt: zod_1.z.date().optional(),
 });
-exports.userWithPasswordSchema = exports.userSchema.extend({
-    password: zod_1.z.string(),
+exports.userSchema = baseUserObj.refine((data) => data.email || data.phoneNumber, {
+    message: 'User must have either an email or a phone number',
+    path: ['email', 'phoneNumber'],
+});
+exports.userWithPasswordSchema = exports.userSchema.and(zod_1.z.object({
+    password: zod_1.z.string().min(MIN_PASSWORD_LENGTH),
+}));
+exports.userRegistrationInputSchema = baseUserObj
+    .pick({
+    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(),
+})
+    .refine((data) => data.email || data.phoneNumber, {
+    message: 'User must have either an email or a phone number',
+    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' }),
+    password: zod_1.z.string().min(MIN_PASSWORD_LENGTH, `Password must be at least ${MIN_PASSWORD_LENGTH} characters`),
 });

package/docs/USER_VS_PLAYER.md

@@ -0,0 +1,87 @@
+# Battle Racing Common Library (`br-common-lib`)
+
+Este repositorio contiene los esquemas de validación Zod, los tipos TypeScript, y las constantes compartidas de domino que actúan como la **fuente única de verdad (Single Source of Truth)** para los microservicios y clientes del ecosistema de Battle Racing (POS, Game Manager Backend, y Web Apps).
+
+Para asegurar la coherencia arquitectónica y facilitar la integración con futuras herramientas de IA (agentes), **todas las modificaciones al ecosistema deben respetar las siguientes convenciones y flujos**.
+
+---
+
+## 🏗️ 1. Modelo de Dominio Crítico: `User` vs `Player`
+
+La decisión arquitectónica más importante del sistema es la inyección de **cero fricción** en el entorno físico de la pista. Para ello, se ha separado estrictamente el concepto de "Cuenta" (quien paga y se loguea) del concepto de "Corredor" (quien sale en la pantalla y maneja el Kart).
+
+### `User` (La Cuenta / El Pagador)
+
+- **Propósito:** Representa a la persona física que se registra en la app, gestiona un método de pago, y posee un historial transaccional.
+- **Autenticación (Email o Teléfono):** En lugar de utilizar un `username` de foros antiguos, **la autenticación se realiza estrictamente a través de `email` o `phoneNumber`**. Esto asegura un proceso de on-boarding sin fricción y previene cuellos de botella en los puntos de venta (POS) donde un cajero o totém no puede adivinar qué `username` no está registrado.
+- **Propiedades Clave:** `password`, `role` (SUPER_ADMIN, CASHIER, PLAYER), `type`.
+- **Relación:** Un `User` siempre tiene asignado automáticamente un `defaultPlayerId` (su perfil de corredor). Sin embargo, un `User` (tutor o papá) puede administrar y poseer múltiples `Players` hijos (`MINOR`).
+
+### `Player` (El Corredor)
+
+- **Propósito:** Es la entidad gamificada. Representa los datos que ven los espectadores en la pantalla del líder, en la pista, y lo que se le asigna físicamente a un Kart.
+- **Identificador (`nickname`):** Los jugadores se identifican por su `nickname` (ej. "Maverick 🏎️💨").
+- **Regla de Oro (No Unicidad):** **Los `nicknames` NO son únicos en la base de datos**. Diferentes jugadores pueden llamarse "Juan" para evitar fricción en un sábado por la noche lleno de clientes registrándose. El sistema interno los diferencia mediante su `UUID` o vinculándolos temporalmente al número de Kart en la carrera activa.
+- **Waivers:** Los `Players` deben firmar (o sus tutores deben firmar por ellos) un documento de exención de responsabilidad (`waiver`).
+
+---
+
+## 🛡️ 2. Práctica de Validación (Zod First)
+
+Nuestra arquitectura delega TODA la validación de negocio y seguridad a **Zod**. En lugar de duplicar lógicas de validación en frontend, backend, y bases de datos, los moldes residen aquí en `br-common-lib`.
+
+### Organización de Archivos (Arquitectura de Dominio)
+
+Dentro de `src/domains/{domainName}/`:
+
+- `*.schema.ts`: Aquí residen todos los objetos Zod (ej. `userSchema`, `userLoginInputSchema`).
+- `*.types.ts`: Tipos estáticos autogenerados mediante `z.infer<typeof schema>`. Nunca se debe escribir un `interface` manualmente si ya existe un esquema de validación.
+- `*.const.ts`: Enums, literales y variables constantes.
+
+### DTOs en NestJS (`nestjs-zod`)
+
+En el ecosistema Backend (`game-manager-backend`), está **estrictamente prohibido** usar decoradores de `class-validator` (como `@IsString()`).
+En su lugar, los DTOs heredan del esquema Zod importado de esta librería utilizando la función `createZodDto`:
+
+```typescript
+// En game-manager-backend: src/modules/auth/dto/login.dto.ts
+import { createZodDto } from 'nestjs-zod';
+import { userLoginInputSchema } from '@battle-racing/br-common-lib';
+
+export class LoginInputDto extends createZodDto(userLoginInputSchema) {}
+```
+
+Cualquier cambio a los endpoints o al pipeline de registro DEBE comenzar por actualizar el `.schema.ts` dentro de `br-common-lib` y recompilar la librería (`npm run build`).
+
+---
+
+## 🎟️ 3. Flujo Transaccional: Compras y Turnos de Juego (Ticketing)
+
+### The `Purchase` (Compra)
+
+- Agrupa múltiples "Items" de juegos bajo una misma transacción de pago con un `buyerUserId` (que puede ser Null si la compra se hace 100% anónima como Guest en el POS).
+- La creación de compras asíncronas es un proceso validado por Webhooks (ej. una vez liquidado el pago en el gateway, se genera legalmente la compra).
+
+### The `GameTicket` (El Boleto individual)
+
+- Una compra de "3 Carreras" se desfragmenta en 3 `GameTicket` separados en la base de datos.
+- Los Boletos nacen en estado `CREATED`.
+- Un boleto es asignado a un corredor físico mediante el `playerId`. **Ya no se usa `ownerUsername`**.
+
+### The `GameTurn` (El Turno Físico en Pista)
+
+- Cuando un grupo de amigos se acerca a la fila, el operador (o el sistema automático) los agrupa en un `GameTurn`.
+- El `GameTurn` toma un conjunto de `GameTickets` válidos (de cualquier compra anterior) y un conjunto de `playerIds` participantes.
+- Enlaza la lógica del hardware, controlando qué `Kart` se le asigna a cada integrante para la carrera real y las misiones/tareas (`tasks`) escaneadas por QR.
+
+---
+
+## 🔄 4. Flujo de Trabajo para Inteligencias Múltiples (Agentes)
+
+Si eres un modelo de IA leyendo este archivo para continuar con el desarrollo de Battle Racing:
+
+1. **Nunca añadas `username`** ni regreses a prácticas de validación por foros.
+2. Si un endpoint o componente frontend necesita una regla de UI o validación nueva, módificala **primero** en los schemas de `br-common-lib` y recompila con `npm run build`.
+3. Evita las dependencias circulares usando los archivos de mapeo de barril (`index.ts`) y organizando siempre el código en `/domains`.
+4. Todos los identificadores (ID's) a través del sistema están diseñados con `z.uuidv4()`. Mantén ese estándar para migraciones futuras a bases de datos escalables.
+5. Emplea variables `emailOrPhone` cuando realices un flujo de acceso. No dupliques ni requieras ambas salvo expresamente configurado.

package/package.json

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

package/src/__deprecated__/constants/hardware/index.ts

@@ -0,0 +1,9 @@
+export * from './base-hardware-status';
+export * from './damage';
+export * from './flag-media-name';
+export * from './flag-status';
+export * from './lights-effect';
+export * from './rgb-status';
+export * from './screen-status';
+export * from './screen-view';
+export * from './speed-status';