iGaming
@getenginex/sdk-igaming traz os fluxos de cassino, bônus, missões, fidelidade, indicações e sportsbook FIRST do EngineX, montados sobre o cliente do core (@getenginex/sdk). O operador instala só o produto que tem: quem não usa cassino não carrega nenhum código de cassino.
| Namespace | O que faz |
|---|---|
casino | catálogo (jogos, categorias, provedores), abrir jogo, sessões, histórico e ranking de ganhadores |
bonus | campanhas de bônus (vitrine, ofertas, opt-in, resgate) e promo codes |
missions | missões ativas do operador (paginadas) e o progresso do jogador |
loyalty | pontos, tier e benefícios do jogador; resgate de pontos |
referrals | código e link de indicação, histórico (e-mail do indicado mascarado) e registro de código |
sportsbook | sessão do sportsbook FIRST (URL com token de operador para o iframe) |
Instalação
npm i @getenginex/sdk @getenginex/sdk-igaming
# or
pnpm add @getenginex/sdk @getenginex/sdk-igamingO core é peer dependency do pacote de iGaming: o app instala o core uma vez e todos os pacotes de produto usam essa mesma cópia. Os requisitos são os do core (veja Instalação).
- Versões do core: o
@getenginex/sdk-igamingdeclara o core como peer>=0.6.0 <1.0.0(a 0.6.0 traz o dinheiro estrito e a idempotência por tentativa que os pacotes usam; a 0.5.0 foi a primeira com oregisterProductClient, que liga o iGaming às fábricas do/query; até a 0.3.x do iGaming,>=0.2.0). Esse range orienta o gerenciador de pacotes; a garantia em tempo de execução é o contrato de transporte do core (a versão internaTRANSPORT_CONTRACT_VERSION, gravada junto de cada cliente): se o cliente vier de uma cópia do core com um contrato incompatível (ex.: duas versões do core instaladas),createIgaminglançaCONFIGURATION_ERRORna hora, em vez de funcionar pela metade. zod: é dependência comum do core e do iGaming (não peer), deduplicada numa cópia só quando as faixas batem. Com umzodfora da faixa no app (ex.:zod@3), podem ficar duas cópias — o SDK funciona, mas o bundle pesa mais; instale um únicozod4 no topo do projeto (veja Instalação).
Crie o cliente de iGaming
Crie o cliente do core como em Primeiros passos e passe-o para 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 não cria sessão, tenant nem transporte próprios e não faz nenhum request. Todo método de iGaming passa pelo cliente do app:
- a mesma sessão e renovação de tokens (login feito com
enginex.auth.loginvale para o cassino); - o mesmo tenant (
X-Original-Host),locale,timeout,hookse validação; - os mesmos erros (
isEnginexError(error, code)); enginex.dispose()desliga também o iGaming: depois dele, todo método rejeita comCONFIGURATION_ERROR.
Crie um cliente de iGaming por cliente do core: no browser, um por app; no servidor, um por request, junto com o cliente. Um valor que não é um cliente criado por createEnginexClient (por exemplo, uma cópia { ...enginex }) é rejeitado com CONFIGURATION_ERROR.
Queries
@getenginex/sdk-igaming/query traz as fábricas de iGaming para o TanStack Query v5, com as convenções da camada de queries: createIgamingQueries(igaming) devolve uma fábrica de query por método de leitura e createIgamingMutations(igaming) uma mutation por método de escrita, com os mesmos nomes e entradas dos namespaces. São objetos simples: o pacote não depende do 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 |
|---|---|
leituras públicas (chave ['enginex', 'public', ...], sem login) | casino.listGames/listCategories/listProviders/getGame, bonus.listPublicOffers |
leituras do jogador (chave ['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/redeemPromoCodeeloyalty.redeeminvalidam o próprio namespace e awalletdo core (o saldo);referrals.registerinvalidareferrals;casino.launchGameinvalidacasino.listSessions.- As idempotentes (
bonus.optIn/claim/redeemPromoCode,loyalty.redeem) aceitam{ idempotencyKey }na fábrica (veja Idempotência). - As que carregam credenciais (promo code, URL do jogo, sessão do sportsbook) têm
gcTime: 0. - Passe o próprio objeto devolvido por
createIgaming: uma cópia{ ...igaming }lançaCONFIGURATION_ERROR.
No React (e no Next.js), useEnginexQueries e useEnginexMutations recebem a fábrica do produto e o cliente de iGaming, e memoizam o 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>
)
}No Vue, o mesmo par vem de @getenginex/sdk-vue; useEnginexQuery recebe um 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>No servidor do Next.js, prefetchEnginex(createIgamingQueries(igaming), (ig) => [ig.casino.listGames()]) faz o prefetch do catálogo com as mesmas chaves (veja Next.js). Svelte, Solid e o TanStack puro usam as fábricas direto (Sem adapter).
Testes
@getenginex/sdk-igaming/testing soma as rotas mock de iGaming ao createMockFetch do core (veja Testes e mocks). As rotas do core continuam valendo e as suas (routes) vencem as 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 montar o objeto de rotas à mão, use createIgamingRoutes(), que devolve rotas novas (com estado próprio) a cada chamada: createMockFetch({ routes: { ...createIgamingRoutes(), ...minhasRotas } }).