pokemon-io-core 0.0.101 → 0.0.102

package/dist/api/battle.d.ts

@@ -65,5 +65,17 @@ export interface BattleView {
         player1: boolean;
         player2: boolean;
     };
+    pendingRandomEvent?: {
+        eventName: string;
+        eventDescription: string;
+        imageUrl?: string;
+        effects: Array<{
+            effectType: string;
+            target: string;
+            percentValue?: number;
+            statType?: string;
+            statChange?: number;
+        }>;
+    } | null;
     forcedSwitch: ForcedSwitchView | null;
 }

package/dist/core/battleRuntime.d.ts

@@ -0,0 +1,46 @@
+import { AmuletDefinition } from "./amulets.js";
+import { FighterDefinition } from "./fighters.js";
+import { ItemDefinition } from "./items.js";
+import { MoveDefinition } from "./moves.js";
+import { StatusDefinition } from "./status.js";
+import { TypeDefinition, TypeEffectivenessMatrix } from "./types.js";
+import { ItemId, MoveId, StatusId, TypeId } from "./ids.js";
+export interface BattleRules {
+    baseCritChance: number;
+    critPerStat: number;
+    critMultiplier: number;
+    stabMultiplier: number;
+    randomMinDamageFactor: number;
+    randomMaxDamageFactor: number;
+}
+export interface BattleRuntime {
+    rules: BattleRules;
+    typesById: Record<TypeId, TypeDefinition>;
+    movesById: Record<MoveId, MoveDefinition>;
+    itemsById: Record<ItemId, ItemDefinition>;
+    amuletsById: Record<string, AmuletDefinition>;
+    statusesById: Record<StatusId, StatusDefinition>;
+    typeEffectiveness: TypeEffectivenessMatrix;
+}
+export interface PlayerFighterBattleConfig {
+    fighter: FighterDefinition;
+    maxHp: number;
+    moves: MoveDefinition[];
+    amulet: AmuletDefinition | null;
+}
+export interface PlayerBattleConfig {
+    fighters: PlayerFighterBattleConfig[];
+    items: ItemDefinition[];
+    amulet: AmuletDefinition | null;
+}
+export interface BattleConfig {
+    types: TypeDefinition[];
+    typeEffectiveness: TypeEffectivenessMatrix;
+    moves: MoveDefinition[];
+    items: ItemDefinition[];
+    amulets: AmuletDefinition[];
+    statuses: StatusDefinition[];
+    player1: PlayerBattleConfig;
+    player2: PlayerBattleConfig;
+    rules?: Partial<BattleRules>;
+}

package/dist/core/battleRuntime.js

@@ -0,0 +1 @@
+export {};

package/dist/core/battleState.d.ts

@@ -1,4 +1,4 @@
-import { BattleRuntime } from "../engine/rules.js";
+import { BattleRuntime } from "./battleRuntime.js";
 import type { FighterId, TypeId, MoveId, ItemId, AmuletId, StatusId } from "./ids";
 import type { FighterStats } from "./types.js";
 export interface EquippedMove {
@@ -62,5 +62,5 @@ export interface BattleState {
     player1: PlayerBattleState;
     player2: PlayerBattleState;
     runtime: BattleRuntime;
-    forcedSwitch: ForcedSwitchState;
+    forcedSwitch?: ForcedSwitchState;
 }

package/dist/core/events.d.ts

@@ -18,6 +18,7 @@ export interface StatsChangedEvent extends BaseBattleEvent {
         accuracy?: number;
         evasion?: number;
     };
+    source?: "move" | "status" | "item" | "random_event";
 }
 export interface ActionDeclaredEvent extends BaseBattleEvent {
     kind: "action_declared";
@@ -49,12 +50,14 @@ export interface DamageEvent extends BaseBattleEvent {
     targetId: FighterId;
     amount: number;
     isCritical: boolean;
+    source?: "move" | "status" | "item" | "random_event";
 }
 export interface HealEvent extends BaseBattleEvent {
     kind: "heal";
     actorId: FighterId;
     targetId: FighterId;
     amount: number;
+    source?: "move" | "status" | "item" | "random_event";
 }
 export interface StatusAppliedEvent extends BaseBattleEvent {
     kind: "status_applied";
@@ -98,6 +101,15 @@ export interface RandomEventTriggeredEvent extends BaseBattleEvent {
     eventId: string;
     eventName: string;
     eventDescription: string;
+    eventRarity: "common" | "rare" | "epic" | "legendary";
+    imageUrl?: string;
+    effects: Array<{
+        effectType: string;
+        target: string;
+        percentValue?: number;
+        statType?: string;
+        statChange?: number;
+    }>;
 }
 export interface RandomEventEffectEvent extends BaseBattleEvent {
     kind: "random_event_effect";

package/dist/core/index.d.ts

@@ -1,13 +1,16 @@
 export * from "./actions.js";
-export * from "./amulets.js";
-export * from "./battleState.js";
+export * from "./randomEvents.js";
+export { CORE_RANDOM_EVENTS, POKEMON_RANDOM_EVENTS } from "./randomEventsList.js";
 export * from "./emotes.js";
 export * from "./events.js";
+export * from "./events.js";
 export * from "./fighters.js";
 export * from "./ids.js";
 export * from "./items.js";
 export * from "./moves.js";
 export * from "./status.js";
-export * from "./types.js";
-export * from "./randomEvents.js";
 export * from "./randomEventsList.js";
+export * from "./battleRuntime.js";
+export * from "./battleState.js";
+export * from "./amulets.js";
+export * from "./types.js";

package/dist/core/index.js

@@ -1,13 +1,16 @@
 export * from "./actions.js";
-export * from "./amulets.js";
-export * from "./battleState.js";
+export * from "./randomEvents.js";
+export { CORE_RANDOM_EVENTS, POKEMON_RANDOM_EVENTS } from "./randomEventsList.js";
 export * from "./emotes.js";
 export * from "./events.js";
+export * from "./events.js";
 export * from "./fighters.js";
 export * from "./ids.js";
 export * from "./items.js";
 export * from "./moves.js";
 export * from "./status.js";
-export * from "./types.js";
-export * from "./randomEvents.js";
 export * from "./randomEventsList.js";
+export * from "./battleRuntime.js";
+export * from "./battleState.js";
+export * from "./amulets.js";
+export * from "./types.js";

package/dist/core/randomEventsList.d.ts

@@ -1,6 +1,11 @@
 import type { RandomEventDefinition } from "./randomEvents.js";
 /**
  * CORE Random Events - Generic events that work with any skin
- * Phase 1: Initial 4 events for MVP
+ * Phase 1 + Phase 2: 9 total CORE events
  */
 export declare const CORE_RANDOM_EVENTS: RandomEventDefinition[];
+/**
+ * POKEMON-SPECIFIC Random Events
+ * These only appear when using the Pokemon skin
+ */
+export declare const POKEMON_RANDOM_EVENTS: RandomEventDefinition[];

package/dist/core/randomEventsList.js

@@ -1,10 +1,10 @@
 // @pokemon-io/combat-core/src/core/randomEventsList.ts
 /**
  * CORE Random Events - Generic events that work with any skin
- * Phase 1: Initial 4 events for MVP
+ * Phase 1 + Phase 2: 9 total CORE events
  */
 export const CORE_RANDOM_EVENTS = [
-    // ==================== COMMON ====================
+    // ==================== COMMON (4 events) ====================
     {
         id: "fatigue",
         name: "💤 Cansancio General",
@@ -32,7 +32,35 @@ export const CORE_RANDOM_EVENTS = [
             },
         ],
     },
-    // ==================== RARE ====================
+    {
+        id: "adrenaline_rush",
+        name: "⚡ Adrenalina",
+        description: "Una inyección de adrenalina aumenta la velocidad de ambos.",
+        rarity: "common",
+        effects: [
+            {
+                effectType: "stat_change",
+                target: "both",
+                statType: "speed",
+                statChange: 1,
+            },
+        ],
+    },
+    {
+        id: "intimidation",
+        name: "😨 Intimidación Mutua",
+        description: "Ambos luchadores se sienten intimidados.",
+        rarity: "common",
+        effects: [
+            {
+                effectType: "stat_change",
+                target: "both",
+                statType: "offense",
+                statChange: -1,
+            },
+        ],
+    },
+    // ==================== RARE (3 events) ====================
     {
         id: "police_raid",
         name: "🚨 Redada Policial",
@@ -50,7 +78,34 @@ export const CORE_RANDOM_EVENTS = [
             },
         ],
     },
-    // ==================== EPIC ====================
+    {
+        id: "meteor_shower",
+        name: "☄️ Lluvia de Meteoritos",
+        description: "¡Meteoritos caen del cielo dañando a ambos!",
+        rarity: "rare",
+        effects: [
+            {
+                effectType: "damage_percent",
+                target: "both",
+                percentValue: 10,
+            },
+        ],
+    },
+    {
+        id: "lucky_charm",
+        name: "🍀 Amuleto de la Suerte",
+        description: "Un luchador aleatorio se siente afortunado.",
+        rarity: "rare",
+        effects: [
+            {
+                effectType: "stat_change",
+                target: "random_one",
+                statType: "crit",
+                statChange: 2,
+            },
+        ],
+    },
+    // ==================== EPIC (2 events) ====================
     {
         id: "casino",
         name: "🎰 Casino",
@@ -77,4 +132,171 @@ export const CORE_RANDOM_EVENTS = [
             },
         ],
     },
+    {
+        id: "reset_button",
+        name: "🔄 Botón de Reinicio",
+        description: "Todas las estadísticas vuelven a la normalidad.",
+        rarity: "epic",
+        effects: [
+            {
+                effectType: "reset_stats",
+                target: "both",
+            },
+        ],
+    },
+];
+/**
+ * POKEMON-SPECIFIC Random Events
+ * These only appear when using the Pokemon skin
+ */
+export const POKEMON_RANDOM_EVENTS = [
+    // ==================== COMMON (3 events) ====================
+    {
+        id: "pokemon_center",
+        name: "🏥 Centro Pokémon Móvil",
+        description: "Una enfermera Joy aparece y cura a ambos Pokémon.",
+        rarity: "common",
+        effects: [
+            {
+                effectType: "heal_percent",
+                target: "both",
+                percentValue: 15,
+            },
+        ],
+    },
+    {
+        id: "team_rocket",
+        name: "🚀 ¡Equipo Rocket!",
+        description: "¡Preparaos para los problemas! El ataque de ambos baja.",
+        rarity: "common",
+        effects: [
+            {
+                effectType: "stat_change",
+                target: "both",
+                statType: "offense",
+                statChange: -1,
+            },
+        ],
+    },
+    {
+        id: "rare_candy",
+        name: "🍬 Caramelo Raro",
+        description: "Un Pokémon aleatorio encuentra un caramelo y se fortalece.",
+        rarity: "common",
+        effects: [
+            {
+                effectType: "stat_change",
+                target: "random_one",
+                statType: "offense",
+                statChange: 1,
+            },
+            {
+                effectType: "stat_change",
+                target: "random_one",
+                statType: "defense",
+                statChange: 1,
+            },
+        ],
+    },
+    // ==================== RARE (4 events) ====================
+    {
+        id: "sandstorm",
+        name: "🌪️ Tormenta de Arena",
+        description: "Una tormenta de arena daña a todos los Pokémon.",
+        rarity: "rare",
+        effects: [
+            {
+                effectType: "damage_percent",
+                target: "both",
+                percentValue: 8,
+            },
+        ],
+    },
+    {
+        id: "professor_oak",
+        name: "👴 Profesor Oak",
+        description: "¡El Profesor Oak anima a tu Pokémon!",
+        rarity: "rare",
+        effects: [
+            {
+                effectType: "stat_change",
+                target: "random_one",
+                statType: "offense",
+                statChange: 2,
+            },
+            {
+                effectType: "stat_change",
+                target: "random_one",
+                statType: "speed",
+                statChange: 1,
+            },
+        ],
+    },
+    {
+        id: "dawn_stone",
+        name: "💎 Piedra Alba",
+        description: "Una piedra evolutiva aumenta la defensa de un Pokémon.",
+        rarity: "rare",
+        effects: [
+            {
+                effectType: "stat_change",
+                target: "random_one",
+                statType: "defense",
+                statChange: 3,
+            },
+        ],
+    },
+    {
+        id: "potion_spray",
+        name: "💊 Lluvia de Pociones",
+        description: "Pociones caen del cielo curando a ambos Pokémon.",
+        rarity: "rare",
+        effects: [
+            {
+                effectType: "heal_percent",
+                target: "both",
+                percentValue: 12,
+            },
+        ],
+    },
+    // ==================== EPIC (2 events) ====================
+    {
+        id: "legendary_appearance",
+        name: "✨ Aparición Legendaria",
+        description: "Un Pokémon legendario otorga poder a un luchador aleatorio.",
+        rarity: "epic",
+        effects: [
+            {
+                effectType: "stat_change",
+                target: "random_one",
+                statType: "offense",
+                statChange: 3,
+            },
+            {
+                effectType: "stat_change",
+                target: "random_one",
+                statType: "defense",
+                statChange: 2,
+            },
+            {
+                effectType: "stat_change",
+                target: "random_one",
+                statType: "speed",
+                statChange: 2,
+            },
+        ],
+    },
+    {
+        id: "max_revive",
+        name: "⚡ Revivir Máximo",
+        description: "El Pokémon con menos vida recupera un 30% de HP.",
+        rarity: "epic",
+        effects: [
+            {
+                effectType: "heal_percent",
+                target: "random_one", // TODO: Cambiar a "lowest_hp" cuando se implemente
+                percentValue: 30,
+            },
+        ],
+    },
 ];

package/dist/engine/events/randomEventTrigger.d.ts

@@ -1,13 +1,16 @@
-import type { RandomEventDefinition } from "../../core/randomEvents.js";
+import { type RandomEventDefinition } from "../../core/randomEvents.js";
 /**
- * Check if a random event should trigger
- * @param turnNumber Current turn number
- * @returns true if event should trigger (50% chance every 2 turns)
+ * Determina si debe dispararse un evento aleatorio en este turno
+ *
+ * @param turnNumber - Número del turno actual
+ * @returns true si debe ocurrir un evento
  */
-export declare const shouldTriggerRandomEvent: (turnNumber: number) => boolean;
+export declare function shouldTriggerRandomEvent(turnNumber: number): boolean;
 /**
- * Select a random event from available events based on rarity weights
- * @param availableEvents List of available events
- * @returns Selected event
+ * Selecciona un evento aleatorio basado en los pesos de rareza
+ * Usa "weighted random selection" para dar más probabilidad a eventos comunes
+ *
+ * @param events - Array de eventos disponibles
+ * @returns Evento seleccionado
  */
-export declare const selectRandomEvent: (availableEvents: RandomEventDefinition[]) => RandomEventDefinition;
+export declare function selectRandomEvent(events: RandomEventDefinition[]): RandomEventDefinition;

package/dist/engine/events/randomEventTrigger.js

@@ -1,35 +1,67 @@
 // @pokemon-io/combat-core/src/engine/events/randomEventTrigger.ts
-import { RARITY_WEIGHTS } from "../../core/randomEvents.js";
+import { RARITY_WEIGHTS, } from "../../core/randomEvents.js";
 /**
- * Check if a random event should trigger
- * @param turnNumber Current turn number
- * @returns true if event should trigger (50% chance every 2 turns)
+ * 🎲 LÓGICA DE PROBABILIDAD DE EVENTOS ALEATORIOS
+ *
+ * 1. TRIGGER (¿Ocurre un evento?):
+ *    - Se revisa cada 2 turnos (turno 2, 4, 6, etc.)
+ *    - Probabilidad: 50% (0.5) en producción
+ *    - DEBUG MODE: 100% para pruebas (línea 27)
+ *
+ * 2. SELECCIÓN (¿Qué evento ocurre?):
+ *    - Se usa "weighted random selection" basado en rareza
+ *    - Pesos definidos en RARITY_WEIGHTS:
+ *      • Common: 60% de probabilidad
+ *      • Rare: 25% de probabilidad
+ *      • Epic: 12% de probabilidad
+ *      • Legendary: 3% de probabilidad
  */
-export const shouldTriggerRandomEvent = (turnNumber) => {
-    // Only check on even turns
+// 🔧 DEBUG: Cambia esto a false para volver a 50% de probabilidad
+const DEBUG_MODE = true;
+const TRIGGER_CHANCE = DEBUG_MODE ? 1.0 : 0.5; // 100% en debug, 50% en producción
+/**
+ * Determina si debe dispararse un evento aleatorio en este turno
+ *
+ * @param turnNumber - Número del turno actual
+ * @returns true si debe ocurrir un evento
+ */
+export function shouldTriggerRandomEvent(turnNumber) {
+    // Solo en turnos pares (2, 4, 6, ...)
     if (turnNumber % 2 !== 0) {
+        console.log(`[Random Events] Turno ${turnNumber}: NO (turno impar)`);
         return false;
     }
-    // 50% chance
-    return Math.random() < 0.5;
-};
+    // Probabilidad de trigger
+    const roll = Math.random();
+    const triggered = roll < TRIGGER_CHANCE;
+    console.log(`[Random Events] Turno ${turnNumber}: ${triggered ? '✅ SÍ' : '❌ NO'} ` +
+        `(roll=${roll.toFixed(3)}, threshold=${TRIGGER_CHANCE})`);
+    return triggered;
+}
 /**
- * Select a random event from available events based on rarity weights
- * @param availableEvents List of available events
- * @returns Selected event
+ * Selecciona un evento aleatorio basado en los pesos de rareza
+ * Usa "weighted random selection" para dar más probabilidad a eventos comunes
+ *
+ * @param events - Array de eventos disponibles
+ * @returns Evento seleccionado
  */
-export const selectRandomEvent = (availableEvents) => {
-    // Calculate total weight
-    const totalWeight = availableEvents.reduce((sum, event) => sum + RARITY_WEIGHTS[event.rarity], 0);
-    // Roll random number
-    let roll = Math.random() * totalWeight;
-    // Select event based on weight
-    for (const event of availableEvents) {
-        roll -= RARITY_WEIGHTS[event.rarity];
-        if (roll <= 0) {
+export function selectRandomEvent(events) {
+    // Calcular peso total
+    let totalWeight = 0;
+    for (const event of events) {
+        totalWeight += RARITY_WEIGHTS[event.rarity];
+    }
+    // Selección ponderada
+    let random = Math.random() * totalWeight;
+    console.log(`[Random Events] Seleccionando evento (totalWeight=${totalWeight}, roll=${random.toFixed(2)})`);
+    for (const event of events) {
+        random -= RARITY_WEIGHTS[event.rarity];
+        if (random <= 0) {
+            console.log(`[Random Events] Evento seleccionado: "${event.name}" (${event.rarity})`);
             return event;
         }
     }
-    // Fallback (shouldn't happen)
-    return availableEvents[0];
-};
+    // Fallback (no debería ocurrir)
+    console.warn("[Random Events] Fallback al primer evento");
+    return events[0];
+}

package/dist/engine/rules.d.ts

@@ -1,43 +1,5 @@
-import { AmuletDefinition, BattleState, FighterDefinition, ItemDefinition, ItemId, MoveDefinition, MoveId, StatusDefinition, StatusId, TypeDefinition, TypeEffectivenessMatrix, TypeId } from "../core/index.js";
-export interface BattleRules {
-    baseCritChance: number;
-    critPerStat: number;
-    critMultiplier: number;
-    stabMultiplier: number;
-    randomMinDamageFactor: number;
-    randomMaxDamageFactor: number;
-}
-export interface BattleRuntime {
-    rules: BattleRules;
-    typesById: Record<TypeId, TypeDefinition>;
-    movesById: Record<MoveId, MoveDefinition>;
-    itemsById: Record<ItemId, ItemDefinition>;
-    amuletsById: Record<string, AmuletDefinition>;
-    statusesById: Record<StatusId, StatusDefinition>;
-    typeEffectiveness: TypeEffectivenessMatrix;
-}
-export interface PlayerFighterBattleConfig {
-    fighter: FighterDefinition;
-    maxHp: number;
-    moves: MoveDefinition[];
-    amulet: AmuletDefinition | null;
-}
-export interface PlayerBattleConfig {
-    fighters: PlayerFighterBattleConfig[];
-    items: ItemDefinition[];
-    amulet: AmuletDefinition | null;
-}
-export interface BattleConfig {
-    types: TypeDefinition[];
-    typeEffectiveness: TypeEffectivenessMatrix;
-    moves: MoveDefinition[];
-    items: ItemDefinition[];
-    amulets: AmuletDefinition[];
-    statuses: StatusDefinition[];
-    player1: PlayerBattleConfig;
-    player2: PlayerBattleConfig;
-    rules?: Partial<BattleRules>;
-}
+import { BattleState, BattleRules, BattleRuntime } from "../core/index.js";
+export type { BattleRules, BattleRuntime, BattleConfig, PlayerBattleConfig, PlayerFighterBattleConfig, } from "../core/index.js";
 export interface RuntimeBattleState extends BattleState {
     runtime: BattleRuntime;
 }

package/dist/engine/turn/resolveTurn.js

@@ -10,6 +10,9 @@ import { recomputeEffectiveStatsForFighter } from "../fighters/fighter.js";
 import { getOpponentAndSelf } from "../fighters/selectors.js";
 import { applyEndOfTurnStatuses } from "../status/endOfTurn.js";
 import { hasHardCc } from "../status/hardCc.js";
+import { shouldTriggerRandomEvent, selectRandomEvent } from "../events/randomEventTrigger.js";
+import { applyRandomEvent } from "../events/applyRandomEvent.js";
+import { CORE_RANDOM_EVENTS } from "../../core/index.js";
 // ------------------------------------------------------
 // Helpers KO -> forced switch (estilo Pokémon real)
 // ------------------------------------------------------
@@ -267,6 +270,46 @@ export const resolveTurn = (state, actions) => {
             winner: winnerAtEnd,
         });
     }
+    // ✅ RANDOM EVENTS - Check and apply after forced switch and before turn_end
+    const shouldCheckRandomEvent = !currentState.forcedSwitch && // Skip if forced switch pending
+        winnerAtEnd === "none"; // Skip if battle ended
+    if (shouldCheckRandomEvent && shouldTriggerRandomEvent(currentState.turnNumber)) {
+        // Select random event
+        const availableEvents = [
+            ...CORE_RANDOM_EVENTS,
+            // TODO: Add skin-specific events (POKEMON_RANDOM_EVENTS)
+        ];
+        const randomEvent = selectRandomEvent(availableEvents);
+        // Emit banner event
+        events.push({
+            ...createBaseEvent(currentState.turnNumber, "random_event_triggered", randomEvent.description),
+            eventId: randomEvent.id,
+            eventName: randomEvent.name,
+            eventDescription: randomEvent.description,
+            eventRarity: randomEvent.rarity,
+            imageUrl: randomEvent.imageUrl,
+            effects: randomEvent.effects.map((effect) => ({
+                effectType: effect.effectType,
+                target: effect.target,
+                percentValue: effect.percentValue,
+                statType: effect.statType,
+                statChange: effect.statChange,
+            })),
+        });
+        // Apply random event effects
+        const effectsResult = applyRandomEvent(currentState, randomEvent);
+        currentState = effectsResult.state;
+        // Add effect events with source="random_event" marker
+        const markedEvents = effectsResult.events.map((event) => {
+            if (event.kind === "damage" ||
+                event.kind === "heal" ||
+                event.kind === "stats_changed") {
+                return { ...event, source: "random_event" };
+            }
+            return event;
+        });
+        events.push(...markedEvents);
+    }
     events.push({
         ...createBaseEvent(currentState.turnNumber, "turn_end", `Termina el turno ${currentState.turnNumber}`),
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pokemon-io-core",
-  "version": "0.0.101",
+  "version": "0.0.102",
   "description": "",
   "main": "index.js",
   "type": "module",