iGaming
@getenginex/sdk-igaming trae los flujos de casino, bonos, misiones, fidelización, referidos y sportsbook FIRST de EngineX, montados sobre el cliente del core (@getenginex/sdk). El operador instala solo el producto que tiene: quien no usa casino no carga ningún código de casino.
| Namespace | Qué hace |
|---|---|
casino | catálogo (juegos, categorías, proveedores), abrir un juego, sesiones, historial y ranking de ganadores |
bonus | campañas de bonos (vitrina, ofertas, opt-in, canje) y promo codes |
missions | misiones activas del operador (paginadas) y el progreso del jugador |
loyalty | puntos, nivel y beneficios del jugador; canje de puntos |
referrals | código y enlace de referido, historial (correo del referido enmascarado) y registro de código |
sportsbook | sesión del sportsbook FIRST (URL con token de operador para el iframe) |
Instalación
npm i @getenginex/sdk @getenginex/sdk-igaming
# or
pnpm add @getenginex/sdk @getenginex/sdk-igamingEl core es una peer dependency del paquete de iGaming: la app instala el core una vez y todos los paquetes de producto usan esa misma copia. Los requisitos son los del core (consulta Instalación).
- Versiones del core:
@getenginex/sdk-igamingdeclara el core como peer>=0.6.0 <1.0.0(la 0.6.0 trae el manejo estricto del dinero y la idempotencia por intento que usan los paquetes; la 0.5.0 fue la primera conregisterProductClient, que conecta iGaming con las fábricas de/query; hasta la 0.3.x de iGaming,>=0.2.0). Ese rango orienta al gestor de paquetes; la garantía en tiempo de ejecución es el contrato de transporte del core (la versión internaTRANSPORT_CONTRACT_VERSION, guardada junto con cada cliente): si el cliente viene de una copia del core con un contrato incompatible (p. ej., dos versiones del core instaladas),createIgaminglanzaCONFIGURATION_ERRORde inmediato, en lugar de funcionar a medias. zod: es una dependencia común del core y de iGaming (no peer), deduplicada en una sola copia cuando los rangos coinciden. Con unzodfuera de rango en la app (p. ej.,zod@3), pueden quedar dos copias: el SDK funciona, pero el bundle pesa más; instala un únicozod4 en la raíz del proyecto (consulta Instalación).
Crea el cliente de iGaming
Crea el cliente del core como en Primeros pasos y pásalo a createIgaming:
// enginex.ts
import { createEnginexClient, localStorageTokenStore } from '@getenginex/sdk'
import { createIgaming } from '@getenginex/sdk-igaming'
export const enginex = createEnginexClient({
locale: 'pt-BR',
tokenStore: localStorageTokenStore(),
})
export const igaming = createIgaming(enginex)createIgaming no crea sesión, tenant ni transporte propios y no hace ningún request. Todo método de iGaming pasa por el cliente de la app:
- la misma sesión y renovación de tokens (un login hecho con
enginex.auth.loginvale para el casino); - el mismo tenant (
X-Original-Host),locale,timeout,hooksy validación; - los mismos errores (
isEnginexError(error, code)); enginex.dispose()apaga también iGaming: después de él, todo método se rechaza conCONFIGURATION_ERROR.
Crea un cliente de iGaming por cliente del core: en el navegador, uno por app; en el servidor, uno por request, junto con el cliente. Un valor que no sea un cliente creado por createEnginexClient (por ejemplo, una copia { ...enginex }) se rechaza con CONFIGURATION_ERROR.
Queries
@getenginex/sdk-igaming/query incluye las fábricas de iGaming para TanStack Query v5, con las convenciones de la capa de queries: createIgamingQueries(igaming) devuelve una fábrica de query por cada método de lectura y createIgamingMutations(igaming) una mutation por cada método de escritura, con los mismos nombres y entradas que los namespaces. Son objetos simples: el paquete no depende de TanStack.
import { createIgamingMutations, createIgamingQueries } from '@getenginex/sdk-igaming/query'
const ig = createIgamingQueries(igaming)
ig.casino.listGames({ page: 1 }) // { queryKey: ['enginex', 'public', 'casino', 'listGames', { page: 1 }], queryFn }
ig.loyalty.get() // { queryKey: ['enginex', 'user', userId, 'loyalty', 'get'], queryFn }
const im = createIgamingMutations(igaming)
im.loyalty.redeem() // { mutationKey: ['enginex', 'loyalty', 'redeem'], mutationFn, invalidates }| Tipo | Fábricas |
|---|---|
lecturas públicas (clave ['enginex', 'public', ...], sin sesión) | casino.listGames/listCategories/listProviders/getGame, bonus.listPublicOffers |
lecturas del jugador (clave ['enginex', 'user', userId, ...]) | casino.listSessions/getHistory/getBiggestWinners, bonus.listOffers/getOffer/listParticipations/getParticipation, missions.list/listMine, loyalty.get, referrals.get/listHistory |
| mutations | casino.launchGame, bonus.optIn/claim/redeemPromoCode/resolvePromoCode, loyalty.redeem, referrals.register, sportsbook.createSession |
bonus.optIn/claim/redeemPromoCodeyloyalty.redeeminvalidan su propio namespace y lawalletdel core (el saldo);referrals.registerinvalidareferrals;casino.launchGameinvalidacasino.listSessions.- Las idempotentes (
bonus.optIn/claim/redeemPromoCode,loyalty.redeem) aceptan{ idempotencyKey }en la fábrica (consulta Idempotencia). - Las que llevan credenciales (promo code, URL del juego, sesión del sportsbook) tienen
gcTime: 0. - Pasa el mismo objeto que devuelve
createIgaming: una copia{ ...igaming }lanzaCONFIGURATION_ERROR.
En React (y en Next.js), useEnginexQueries y useEnginexMutations reciben la fábrica del producto y el cliente de iGaming, y memoizan el resultado:
import { createIgamingMutations, createIgamingQueries } from '@getenginex/sdk-igaming/query'
import { useEnginexMutation, useEnginexMutations, useEnginexQueries, useEnginexQuery } from '@getenginex/sdk-react'
import { igaming } from './enginex'
function LoyaltyCard() {
const ig = useEnginexQueries(createIgamingQueries, igaming)
const im = useEnginexMutations(createIgamingMutations, igaming)
const loyalty = useEnginexQuery(ig.loyalty.get())
const redeem = useEnginexMutation(im.loyalty.redeem())
return (
<button disabled={redeem.isPending} onClick={() => redeem.mutate({ points: 500, redemptionType: 'bonus' })}>
Redeem 500 of {loyalty.data?.currentPoints ?? 0} points
</button>
)
}En Vue, el mismo par viene de @getenginex/sdk-vue; useEnginexQuery recibe un getter:
<script setup lang="ts">
import { createIgamingQueries } from '@getenginex/sdk-igaming/query'
import { useEnginexQueries, useEnginexQuery } from '@getenginex/sdk-vue'
import { igaming } from './enginex'
const ig = useEnginexQueries(createIgamingQueries, igaming)
const games = useEnginexQuery(() => ig.casino.listGames({ page: 1 }), { select: (page) => page.items })
</script>
<template>
<GameCard v-for="game in games.data.value ?? []" :key="game.id" :game="game" />
</template>En el servidor de Next.js, prefetchEnginex(createIgamingQueries(igaming), (ig) => [ig.casino.listGames()]) hace el prefetch del catálogo con las mismas claves (consulta Next.js). Svelte, Solid y TanStack sin adapter usan las fábricas directamente (Sin adapter).
Pruebas
@getenginex/sdk-igaming/testing suma las rutas mock de iGaming al createMockFetch del core (consulta Pruebas y mocks). Las rutas del core siguen valiendo y las tuyas (routes) ganan sobre las de iGaming:
import { createEnginexClient } from '@getenginex/sdk'
import { createMockFetch } from '@getenginex/sdk/testing'
import { createIgaming } from '@getenginex/sdk-igaming'
import { withIgamingRoutes } from '@getenginex/sdk-igaming/testing'
const enginex = createEnginexClient({
baseUrl: 'https://gateway.test', // in Node: absolute baseUrl + tenantHost (optional in the browser)
tenantHost: 'casino.test',
fetch: createMockFetch(withIgamingRoutes({ withdrawalOtp: true })),
})
const igaming = createIgaming(enginex)Para armar el objeto de rutas a mano, usa createIgamingRoutes(), que devuelve rutas nuevas (con estado propio) en cada llamada: createMockFetch({ routes: { ...createIgamingRoutes(), ...misRutas } }).