Esta versión (v0.7) todavía no se publicó en npm.
Ir al contenido

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.

NamespaceQué hace
casinocatálogo (juegos, categorías, proveedores), abrir un juego, sesiones, historial y ranking de ganadores
bonuscampañas de bonos (vitrina, ofertas, opt-in, canje) y promo codes
missionsmisiones activas del operador (paginadas) y el progreso del jugador
loyaltypuntos, nivel y beneficios del jugador; canje de puntos
referralscódigo y enlace de referido, historial (correo del referido enmascarado) y registro de código
sportsbooksesión del sportsbook FIRST (URL con token de operador para el iframe)

Instalación ​

bash
npm i @getenginex/sdk @getenginex/sdk-igaming
# or
pnpm add @getenginex/sdk @getenginex/sdk-igaming

El 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-igaming declara 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 con registerProductClient, 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 interna TRANSPORT_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), createIgaming lanza CONFIGURATION_ERROR de 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 un zod fuera de rango en la app (p. ej., zod@3), pueden quedar dos copias: el SDK funciona, pero el bundle pesa más; instala un único zod 4 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:

ts
// 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.login vale para el casino);
  • el mismo tenant (X-Original-Host), locale, timeout, hooks y validación;
  • los mismos errores (isEnginexError(error, code));
  • enginex.dispose() apaga también iGaming: después de él, todo método se rechaza con CONFIGURATION_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.

ts
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 }
TipoFá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
mutationscasino.launchGame, bonus.optIn/claim/redeemPromoCode/resolvePromoCode, loyalty.redeem, referrals.register, sportsbook.createSession
  • bonus.optIn/claim/redeemPromoCode y loyalty.redeem invalidan su propio namespace y la wallet del core (el saldo); referrals.register invalida referrals; casino.launchGame invalida casino.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 } lanza CONFIGURATION_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:

tsx
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:

vue
<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:

ts
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 } }).