/**
 * Ecotic Game SDK v1.0.0
 * Tipos TypeScript para autocompletado y verificación estática.
 *
 * Uso con <script src>:
 *   declare const EcoticSDK: typeof import('./ecotic-sdk');
 *
 * Uso con bundler (Vite, Webpack, etc.):
 *   import EcoticSDK from './ecotic-sdk';
 */

export interface EcoticGameConfig {
    /** Slug del juego tal como está registrado en la tabla `games`. Obligatorio. */
    gameSlug: string;
    /**
     * Origin del GameCenter en producción: 'https://ecotic.cuc.edu.co'.
     * Dejar vacío ('') en desarrollo local para desactivar la validación de origin.
     */
    parentOrigin?: string;
    /** Override del endpoint base de la API. Normalmente se recibe vía postMessage. */
    apiBase?: string;
    /** Activa mensajes de depuración en la consola del navegador. */
    debug?: boolean;
    /** Llamado cuando el token llega del GameCenter y el SDK está listo para enviar eventos. */
    onReady?: (token: string, apiBase: string) => void;
    /** Llamado ante cualquier error de API o de validación. */
    onError?: (error: Error) => void;
    /** Llamado tras un complete() exitoso con las recompensas otorgadas. */
    onReward?: (reward: GameReward) => void;
}

export interface GameReward {
    xp: number;
    coins: number;
    wallet_balance?: number;
}

export interface EventResult {
    event_id?: string | number | null;
    reward?: GameReward | null;
    wallet_balance?: number | null;
    /** true si el evento fue enviado vía relay postMessage (fallback CORS). */
    relayed?: boolean;
    /** true si el evento fue omitido por idempotencia (start/complete ya enviados). */
    skipped?: boolean;
}

export declare class EcoticGame {
    /**
     * Notifica al servidor que el jugador inició la partida (primer gesto real).
     * Solo se envía una vez por sesión; llamadas posteriores se ignoran.
     * @param payload  Datos opcionales (mode, difficulty, etc.)
     */
    start(payload?: Record<string, unknown>): Promise<EventResult>;

    /**
     * Envía progreso intermedio (racha, nivel alcanzado, precisión parcial…).
     * El GameCenter lo usa para actualizar el indicador de misión en tiempo real.
     * @param payload  Datos del checkpoint (streak, level, moves, etc.)
     */
    checkpoint(payload: Record<string, unknown>): Promise<EventResult>;

    /**
     * Finaliza la partida y activa las recompensas (XP + monedas).
     * Solo se puede llamar una vez por sesión — idempotente.
     * @param score    Puntuación entera entre 0 y 10 000.
     * @param payload  Datos adicionales (accuracy, mode, duration_seconds, etc.)
     */
    complete(score: number, payload?: Record<string, unknown>): Promise<EventResult>;

    /**
     * Envía un evento personalizado sin lógica de recompensa automática.
     * Útil para telemetría específica del juego.
     */
    custom(payload: Record<string, unknown>): Promise<EventResult>;

    /**
     * Cierra el juego limpiamente:
     * - Envía `abandoned` vía sendBeacon si la sesión no fue completada.
     * - Envía `ECOTIC_GAME_EXIT` al GameCenter para cerrar el iframe.
     */
    exit(): void;

    /** @returns true si el token ya fue recibido. */
    isReady(): boolean;

    /** @returns El token de sesión actual (vacío si aún no se recibió). */
    getToken(): string;

    /**
     * Elimina el listener de mensajes.
     * Solo necesario si gestionas el ciclo de vida manualmente.
     */
    destroy(): void;
}

declare const EcoticSDK: {
    /** Versión actual del SDK. */
    readonly version: string;

    /**
     * Crea e inicializa una sesión de juego Ecotic.
     * @example
     * const sdk = EcoticSDK.init({
     *   gameSlug:     'mi-juego',
     *   parentOrigin: 'https://ecotic.cuc.edu.co',
     *   onReady:      () => { startGame(); },
     *   onReward:     (r) => { showRewardBanner(r.xp, r.coins); },
     * });
     */
    init(config: EcoticGameConfig): EcoticGame;
};

export default EcoticSDK;
export { EcoticSDK };