Instalación

El SDK está disponible en tres formatos para que puedas usarlo con cualquier stack.

---

Opción A — Script tag (recomendado para empezar)

La más sencilla: añade una sola línea en tu HTML.

index.html

<!-- Siempre antes de tu código de juego -->
<script src="https://sdk-ecotic.ced.com.co/ecotic-sdk.js"></script>

<script>
  // EcoticSDK ya está disponible como variable global
  const sdk = EcoticSDK.init({ gameSlug: 'mi-juego', ... });
</script>

Cuándo usarla: proyectos HTML/CSS/JS sin bundler, juegos con Phaser, Three.js, o cualquier librería cargada con <script>.

---

Opción B — ES Module (import)

Si tu proyecto usa un bundler (Vite, Webpack, Parcel):

Descargar el archivo

1. Descarga ecotic-sdk.js y colócalo en tu proyecto, por ejemplo en src/lib/.
2. Importa:

game.js

import EcoticSDK from './lib/ecotic-sdk.js';

const sdk = EcoticSDK.init({ gameSlug: 'mi-juego', ... });

Desde URL (sin descarga)

game.js

// Funciona en proyectos Vite o con import maps
import EcoticSDK from 'https://sdk-ecotic.ced.com.co/ecotic-sdk.js';

const sdk = EcoticSDK.init({ gameSlug: 'mi-juego', ... });

---

Opción C — TypeScript

Si usas TypeScript, descarga también el archivo de tipos:

1. Descarga ecotic-sdk.js y ecotic-sdk.d.ts.
2. Coloca ambos archivos en la misma carpeta (p. ej. src/lib/).
3. Importa:

game.ts

import EcoticSDK, { type EcoticGameConfig, type GameReward } from './lib/ecotic-sdk.js';

const config: EcoticGameConfig = {
  gameSlug: 'mi-juego',
  onReady:  () => iniciarMenu(),
  onReward: (reward: GameReward) => mostrarRecompensa(reward),
};

const sdk = EcoticSDK.init(config);

Tendrás autocompletado completo para todos los métodos y opciones de configuración.

---

Verificar la instalación

Abre la consola del navegador (F12) y escribe:

EcoticSDK.version  // → "1.0.0"

Si ves la versión, el SDK se cargó correctamente.

¿Qué versión usar?

Siempre usa la URL https://sdk-ecotic.ced.com.co/ecotic-sdk.js — apunta a la versión estable más reciente. Si necesitas fijar una versión específica para un proyecto crítico, descarga el archivo localmente.

---

Requisitos del navegador

El SDK usa APIs modernas ampliamente soportadas:

API	Soporte
fetch	Chrome 42+, Firefox 39+, Edge 14+
navigator.sendBeacon	Chrome 39+, Firefox 31+, Edge 14+
window.postMessage	Todos los navegadores modernos
Promise	Chrome 32+, Firefox 29+, Edge 12+

En la práctica, cualquier navegador lanzado después de 2016 funciona correctamente.