• Sistema de remarketing first-party com UUID v4 estável + audience tags do funil, brand-aware via feature flag (app/config/features/remarketing.ts). Vera ativa com cookie rmkvera (365 dias sliding TTL, Domain=.vera.bet.br, SameSite=None, Secure); demais brands fazem opt-in declarando seu próprio cookieName no override.
• Cookie rmkvera_aud armazena tags do funil em JSON (90 dias sliding TTL, cap de 40 tags com eviction de oldest, set-once semantics) — pra ser usado como external_id em Meta CAPI, Google Enhanced Conversions e TikTok Events API. Funciona mesmo sem cookies de terceiros (iOS 14+, ITP, Brave).
• Tags emitidas automaticamente em três eixos: path-based via useLocation brand-aware no Route Registry (viewed_casino, viewed_live_casino, viewed_game_detail, viewed_sports, viewed_promotions), modal-based via Zustand (clicked_register, registered, abandoned_register, viewed_deposit_modal, abandoned_deposit) e FTD-based em useAnalytics.trackDepositConfirmed (ftd_completed, multi_deposit).
• Captura server-side no root loader (captureRemarketingIdFromRequest) — sobrevive a redirects via Set-Cookie na própria response do 302 (mesmo padrão do tracking de UTMs). Client-side RemarketingCapture faz refresh de TTL, publica em window.__rmk e dispara rmk_ready + rmk_audience_tag no dataLayer.
• Regras duras: nome do cookie rejeita termos internos da plataforma (cactus, bluetec) em runtime, bot traffic é skipado no server, validador strict UUID v4 RFC 4122 contra cookies adulterados. 39 unit tests + 16 server-side tests cobrindo capture, Set-Cookie, regenerate em tamper, eviction.

Cache & Deploy​

• Purge proxy worker em paralelo com platform-cache (/api/cache/purge). O endpoint agora forwarda um purge per-brand pro front-service-api via service binding API_SERVICE, em paralelo com o purge local do platform-cache. Antes, o post-deploy purge limpava só os caches do brand worker e o proxy worker (KV API_CACHE_KV + CF Cache API) continuava servindo BFF stale por até 1h — root cause do widget "Pagou Muito" ficando vazio após deploy em vera e 7k. Os dois purges rodam via Promise.allSettled e o originDomain é inferido do hostname pra escopar a limpeza por brand.
• front-ops deploy.yml propaga postDeployPurge segments pro /api/cache/purge. O step "Resolve segments" já computava a lista de recursos (topGames, homeRows, casinoRows, etc.) mas o curl ignorava o output e batia no endpoint nu, caindo em engine.purgeAll() que deixa snapshots de KV intactos. Agora os segments viajam como ?segments=<csv> e engine.purge(segment) roda por recurso — o caminho que deleta tanto o primary tier quanto o snapshot KV.

404 Redirects (CF Analytics)​

• /reward, /rewards, /game-error, /games/category/:slug/popular e prefixos /{locale}/* cobertos no legacy-redirects.ts a partir do relatório de 404 do Cloudflare. Smartico push e ad creatives usam a forma singular de reward; integrações de jogo (Endorphina e família) navegam o iframe pra /game-error quando o launch falha — agora a página existe fora do _layout (full-bleed bg-error, alert + reload em window.top, noindex,nofollow, listada em robots.txt). O catch-all /{locale}/* aceita /en, /es, /pt-br, /hi, /de, /fr, /it, /es-mx (legado Nuxt pré-listava todos esses buckets mesmo com no_prefix em produção).
• /pagina/kyc-policy, /apostas-ao-vivo, /pending adicionados a partir do CF analytics da cassino-bet-br. /pagina/kyc-policy resolve pra legal.page com slug: "kyc" (a string kyc-policy é o apiSlug do BFF, não o slug da URL). /apostas-ao-vivo é alias PT-BR pro sports root brand-aware (/esportes, /deportes, /sports). /pending 301 pra /redirect (a Vue mountava verification iframe ali; o novo stack já trata verification em-app).
• Fix de ordering no legacy-redirect.ts: o handler agora ordena legacyRedirects por contagem de segmentos literais descendente antes de iterar, espelhando a precedência que o React Router usa pra registro de rotas. Sem isso, a entrada genérica /pagina/:slug matchava antes da literal /pagina/kyc-policy e gerava /pagina/undefined. Comportamento idempotente pras entradas que não compartilham prefixo.
• Tail-handling fix em legacy-redirect.ts: ${baseDest}/${tail} produzia barra dupla quando baseDest era exatamente / (destino home dos catch-alls de locale). Strip do trailing slash antes do append.

Landing Pages​

• /download-app portado do legado Vue pra cassino-bet-br (overrides/cassino-bet-br/.../lps/download-app.tsx). Espelha o LP do 7k-bet-br (banner + benefícios + instruções Android/iOS + FAQ accordion) com branding "Cassino.bet", filename cassinopixbetbr.apk, e Android download apontando pro Play Store (id=cassino.bet.br.twa, package confirmado pelo assetlinks.json da brand). Diferente do LP do 7k, todas as cores resolvem via theme tokens (bg-bg-primary, text-titles, border-texts/20, etc.) — o palette navy/cyan do theme/colors.ts é pego automaticamente. Wiring em lps.ts + lp-redirects.ts (visitantes em /download-app 301 pra /lp/download-app).

Brand Overrides​

• Vera (vera-bet-br): opt-in completo no remarketing first-party com cookie rmkvera (overrides/vera-bet-br/app/config/features/remarketing.ts); decoração V do legacy-grid (variant exclusivo da vera) agora visível sem hover — opacity default subiu de 0.07 pra 0.18 no rest state e o boost de hover foi pra 0.28 pra preservar feedback de focused-tile.
• Cassino.bet (cassino-bet-br): ganhou o LP /download-app com assets brand-specific copiados byte-for-byte do legado (md5 verificado: bg-banner-mobile.png, bg-banner-desktop.png, bg-experience.png).

Documentação​

• Marketing Docs publicado — nova surface dedicada pra operadores de marketing/tráfego/CRM/BI, paralela à Internal Docs (dev) e Client Docs. Acessível pelo 4º card na home + navbar "Marketing Docs" + sidebar de 10 categorias. 30 arquivos cobrindo: intro + glossário operacional, atribuição (last-touch + 3 camadas, UTMs canonical/wildcard, 10 clicked-IDs com dual-format payload, affiliate nativo + Clever lastclick), storage (cookies completos da plataforma + headers X-ORIGIN-* e X-LOG-INFO), 13 plataformas (GTM, Facebook Pixel+CAPI roadmap, Google Ads, Kwai, Taboola, TikTok, Clarity, Webtrends com alerta de impacto LCP, Mixpanel, Hotjar, Pendo, AppsFlyer S2S TWA-only, Smartico), eventos GTM/GA4 mapeados por canal, remarketing first-party + audience tags, privacidade (LGPD + GCM v2 com diagrama Mermaid de mapping 4 categorias → 7 sinais), App Mode TWA, config map por brand (4 tabelas focadas com valores reais auditados em vera/7k/cassino/pb/betpontobet/state77), e 3 docs operacionais (testar-campanha passo-a-passo, debug com DevTools/wrangler tail, 30 anti-patterns numerados).
• docs-internal/architecture/marketing-tracking.md (224 linhas desatualizadas — dizia "NÃO captura gclid/fbclid" e "TTL 30 dias" e mencionava ?EnableDebug=1 que foi removido) substituído por stub apontando pra Marketing Docs + reference de código pra dev.
• CSS custom: tabelas com mais de ~5 colunas agora ganham scroll horizontal automático (display:block + overflow-x:auto) — evita overflow visual em config-map e equivalentes.
• ci-deploy.yml (front-cactus-docs): run-name customizado em manual dispatches (<usuario>: Manual deploy → cactus), espelhando o mesmo ajuste já aplicado no front-web-base pra títulos consistentes na lista do GitHub Actions.

• Cluster recíproco de hreflang sem x-default: cada um dos quatro domínios da família 7k declara as outras três variantes como alternates explícitas — 7k.bet.br (pt-BR, self) + cl.bet7k.com (es-CL) + ng.7k.bet (en-NG) + fi.7k.bet (fi-FI). Os três overrides novos (overrides/{cl-bet7k-com,fi-7k-bet,ng-7k-bet}/app/config/seo/hreflang.ts) e a atualização do 7k-bet-br removem o x-default que apontava pro Brasil — cada brand é geo-exclusiva (KYC, regulação e moeda locais), então não existe "world fallback" legítimo. Resultado: o Google só serve a variante quando o idioma/região do usuário matcha um alternate explícito (ex: russo ou alemão não vê nenhum domínio, em vez de cair no 7k.bet.br).
• Schema.org/Organization enriquecida com sinais de país: buildOrganizationJsonLd() (app/utils/seo.ts) agora aceita addressCountry (ISO-3166 alpha-2) + areaServedName (nome do país em inglês) e emite address.addressCountry + areaServed.@type=Country. O _layout.tsx resolve ambos via getCountryByAlpha3 de @cactus-agents/country-config — mesmo catálogo usado pelo api-client pra derivar geo headers, evita duplicar mapping alpha-3 → alpha-2 + nome do país.
• Novo JSON-LD WebSite com inLanguage: segundo blob de Schema.org reforçando o idioma da página de forma independente do <html lang>. Google parseia inLanguage separadamente, então emitir os dois dá ao algoritmo dois sinais redundantes de locale.
• Header HTTP Content-Language injetado em toda response HTML pelo app/entry.server.tsx (text/html only — JSON/JS unaffected). Sourced do define __BRAND_LANGUAGE__ do Vite e mapeado pra forma BCP 47. Adiciona uma terceira camada de sinal de locale (header HTTP + JSON-LD + <html lang>).
• Helper compartilhado app/utils/locale.ts consolida os mapas BRAND_LANGUAGE → BCP 47 (pra <html lang>, Content-Language, inLanguage, hreflang) e BRAND_LANGUAGE → og:locale (pra OpenGraph). Antes os dois mapas ficavam inline em root.tsx e _layout.tsx — havia risco de drift entre <html lang="pt-BR"> e Content-Language: pt. Cobertura: oito códigos ativos (pt-br, pt, en, es, es-mx, es-cl, en-ng, fi-fi) com fallback pra pt-BR.
• useCasinoNomenclature agora é guiado por i18n, não mais por regex country-aware. O hook colapsa qualquer string vinda do BFF (campo casinoNomenclature) num enum de 2 valores ("casino" | "games") e resolve o substantivo traduzido via t("layout:sidebar.casino") / t("layout:sidebar.nomenclature_games"). Adicionar país novo virou uma linha em cada layout.json do core — zero mudança no front. Dependência de useBrand().features.country?.code removida.
• Doc operacional fora-do-código: o sinal mais forte de geo-targeting pra gccTLDs (.com, .bet) continua sendo o Google Search Console → International Targeting → Country, que é manual. Walkthrough escrito em docs/superpowers/specs/2026-05-09-google-search-console-geo-targeting.md pro time de SEO/marketing.

Redirects e cobertura de 404 legados​

• Cross-brand redirects pro grupo 7k (PR #782): novo arquivo base app/config/routes/legacy-redirects-cross-brand.ts (default vazio, brand-overridable) carrega o mapa de redirects entre os domínios 7k. Cada uma das quatro brands (7k-bet-br, cl-bet7k-com, fi-7k-bet, ng-7k-bet) ganha um override idêntico de 242 entradas com os patterns PT-BR / ES / EN — o filtro activeLegacyRedirects dropa entries from === to em runtime, então cada brand só consome o que aponta pra fora do seu próprio path. Resolve o cenário em que o Cloudflare roteia entre brands irmãs (geo mismatch) e o visitor caía num path foreign-shaped (ex: /casino/juego/evolution/fan-tan aterrissando em 7k.bet.br).
• Cobertura ampliada de redirects do legado Vue (PR #784): app/config/routes/legacy-redirects.ts cresceu de poucas dezenas pra cobrir o umbrella inteiro /casino/... (live, category/:slug, providers, providers/:slug, :provider/:game, :provider/:game/faq) — recriando o catchall /casino/[...casino].vue que o Nuxt tinha e o novo stack nunca reproduziu. Inclui ainda variantes localizadas (/cassino/... PT-BR, /casino/{en-vivo,categoria,proveedores,juego/...} ES, /casino/play/... EN), esportes (/esportes, /deportes), help (/ajuda, /ayuda, /help), gamification em todos os locales, área de usuário (/usuario/*, /jugador/*, /player/*), histórico legado (/user/history/{casino,full,poker,sports}), /user/irpf → user.incomeReport, e LPs estáticas (/cassino-online, /cassino-pix, /casa-de-aposta, /poker, etc.). Repro fixado: /casino/live → 301 /cassino/ao-vivo.
• Mitigação dos top 404 do Cloudflare Analytics (PR #786) em três frentes:
  • Filtro de garbage paths no Worker (~30k 404s/dia eliminados): handleMiddlewareRoute() curto-circuita paths com URL/HTML injection ([http://, [https://, ://, <, >, %3a, %2f, %3c, %3e) com 204 No Content + cache imutável de 24h. Bots e marketing tags com macros não-substituídas (ex: /cassino/jogar/evolution/[https://bat.bing.net/bat.js]) param de poluir o Observability — o CF cacheia o body vazio e hits repetidos nem chegam ao Worker. 42 unit tests fixam o regex.
  • Restaura /twa.js para 7k-bet-br e cassino-bet-br (~4.6k 404s/dia + bridge AppsFlyer corrigida): script restaurado byte-a-byte do legado Nuxt (md5 799d7078, idêntico nas três brands BR antigas) bootstrappa window.twa.getPostMessageService() consumido pelo useAppsFlyer.ts dentro do APK Android (br.bet.k.twa, cassino.bet.br.twa). Sem o script, o AppsFlyer caía silenciosamente pro path HTTP S2S.
  • /cassino/category/:slug híbrido PT+EN (~5.9k 404s/dia): paths indexados como /cassino/category/cassino-ao-vivo/popular (PT-prefix + EN-segment + filtro /popular legado) agora redirecionam pra casino.category (/cassino/categoria/:slug).
• Combinado com PR #784, a plataforma mitiga ~46k 404s/dia entre todas as brands.

404 dentro do layout​

• Catch-all splat (app/routes/$.tsx) registrado como último filho de _layout, então URLs não-matched (ex: /asda) preservam header / sidebar / footer / topbar em vez de cair na ErrorBoundary do root com tela cheia "nua".
• ErrorBoundary de layout reusa o loader data via useRouteLoaderData e renderiza <ErrorPage variant="inline"> como children do layout. Aplica também a child routes que dão throw 404 (promotions/$slug, lp/$slug, blog/$slug, recents com flag desligada, etc.).
• ErrorPage ganha variant: "standalone" | "inline" — standalone mantém o full-screen wrapper usado pelo root.tsx em falha catastrófica; inline drop-a o wrapper pra fluir dentro do main do layout. Removidos o CTA verde "Voltar ao início" (as 3 nav pills cobrem) e o label "OU NAVEGUE PARA". Pills encolhem em telas pequenas (gap, padding, font-size, icon size) pra caber em 320px sem wrap.
• Novo bloco ErrorDetails sempre visível abaixo das nav pills: payload copy-pasteable em texto puro (URL, user id, build, timestamp, referrer, full UA) pro suporte triar quando o cliente printar/filmar um 404. Auth-reactive via useAccountsStore com o pattern padrão authHydrated + SSR fallback.
• Status HTTP agora retorna 404 real (era 200 em alguns casos bubbleados) com Cache-Control: no-store pra crawlers e monitoring verem o code certo.
• Bump do @cactus-agents/i18n pra ^0.87.0 pelas novas chaves error_page.details_* (pt-br, pt, es, en).

Sitemap reorganizado​

• Sitemap de jogos splittado por provider sob namespace /sitemap-games/ (PR #781). Estrutura nova:

/sitemap.xml                          (root index)
├── /sitemap-static.xml
├── /sitemap-games/<provider>.xml     (NEW — um urlset por provider)
├── /sitemap-games/categories.xml     (renomeado de /sitemap-categories.xml)
├── /sitemap-games/providers.xml      (renomeado de /sitemap-providers.xml)
├── /sitemap-promotions.xml
├── /sitemap-blog.xml
├── /sitemap-faq.xml
└── /sitemap-legal.xml                (NEW — incorpora PR #743)

• Por que splittar por provider: Search Console reporta indexing status por sitemap → granularidade por provider expõe qual está falhando crawl; invalidação de cache CDN isolada por família (game novo da PG Soft não bust-a o sitemap da Pragmatic); payloads naturalmente abaixo do limite de 50k URLs sem precisar shard. Formato directory-style (/sitemap-games/<provider>.xml) escolhido em vez do dash-style porque o compilePath do React Router 7 só matcha tokens :param precedidos de /.
• Slugs reservados: categories e providers não podem ser claimados por provider real — as rotas literais irmãs vencem por especificidade no RR e o loop do index pula essas keys defensivamente. A rota legada /sitemap-games.xml flat foi removida (404). Recomendação pós-deploy: ressubmeter /sitemap.xml no Search Console pra acelerar reindex.

API e classificação de erros​

• Helper app/utils/proxy-error.server.ts (proxyErrorResponse(err, fallback, init?) + unauthorizedNoToken()) substituiu o envelope { ok: false, error, detail } em 60 rotas internas /api/* (wallet, payments, user, kyc, rewards, income-report, validation, sports, games, address, favorites, auth/{profile,recheck-spa,refresh}). Em 401/403 o body do BFF é passado intacto pro classifier de @cactus-agents/api-client — antes, o top-level error: "wallet_fetch_failed" lockava a lookup e a reason real do BFF (escondida em detail) nunca era avaliada. Resultado: todo 401 colapsava em EM0005 (catch-all), todo 403 em EM0011, perdendo EM0001 no_token, EM0003 expired, EM0006 ip_changed, EM0009 liveness_required. Reportado em 05/2026: usuário cassino.bet.br tomou #EP0710-EM0005 no /api/wallet/refresh mid-game enquanto o log do CF mostrava reason: "wallet_fetch_failed" (o envelope, não a causa).
• Fluxos pre-auth (login, register, recovery, social, validate-document, logout) intencionalmente preservados — não disparam handleUnauthorized e dependem de mapBff*Error / FormErrorCode pra UX form-level.
• 32 testes novos no helper, mais 5 ponta-a-ponta contra o classifier real. Suite total: 71 files / 685 tests passando.

Fix de hidratação dos widgets de Wins​

• Eliminada a flash de skeleton no F5 dos widgets BiggestWinsCarousel, LatestBetsCarousel, WinsCombinedWidget, BiggestWinsListWidget e HomeWinsRightColumn. Duas causas combinadas:
  • Widgets liam topWins / lastWins da Zustand store gated em _isHomeHydrated, que só virava true num useEffect de rota — SSR + primeiro render mostravam skeleton até o mount.
  • Todos estavam atrás de React.lazy() + <Suspense fallback> — mesmo após corrigir #1 via props, o Suspense substituía brevemente o HTML SSR pelo SectionSkeleton enquanto o chunk carregava.
• Fix espelha o pattern do TopGamesSection: widgets recebem topWins / lastWins como props threaded de cada loader → HubRowRenderer → renderWidget. Reads internos da store + gates _isHomeHydrated + skeleton blocks removidos. Wins widgets convertidos de lazy() pra static imports (custo de bundle ~4-6KB gzip — deps compartilhadas como Marquee, WinCard, SectionTitle já residentes). SectionSkeleton mantido pros outros lazy widgets (ProvidersCarousel, RecommendedBanners, FeaturedGame, Tournaments, Missions, MainLeagues) que ficam deep below the fold.
• Casos resolvidos: cassino-bet-br row 2 da home (biggest-wins-today, above-the-fold), todas as 4 brands no row 3 do casino hub & casino live (biggest-wins-and-latest-bets, dentro de EAGER_CASINO_ROW_COUNT=4), e o aside desktop do vera-bet-br (HomeWinsRightColumn).
• Slices topWins / lastWins da Zustand continuam populadas por hydrateHome por backward compat — sem readers agora, safe pra cleanup em follow-up.

Brand Overrides​

• fi-7k-bet (Finlândia): tradução completa pra finlandês das 17 entries de SEO page-descriptions (home, casino, casino.live, casino.category, casino.provider, casino.providers, blog, promotions, vip + 8 sub-páginas VIP, casino.category:todos-os-jogos), usando terminologia domain-aware (kasino, verkkovedonlyönti, kolikkopelit, live-kasino, krash-pelit, talletus, nosto, pelaa vastuullisesti, VIP-ohjelma). Antes era cópia do EN — a brand já roda com BRAND_LANGUAGE=fi-fi, mas o copy above-the-footer ainda renderizava em inglês ("7K: Your trusted online sportsbook"). Recomendado um pass de revisão por nativo antes de qualquer copy regulada (responsible-gambling, KYC, payments) — o Finnish gambling regulation tem fraseologia específica que tradução automática não pega. Nomes de ligas no sidebar-sports.ts padronizados pra PT (Brasileirão Série A, Liga Europa, Copa do Brasil) — antes divergia do home-leagues.ts em três casos. Removido o fallback label: "Store" hardcoded no override de sidebar-buttons — agora intent: "store" resolve pra "Kauppa" via i18n core.
• 7k-bet-br: refactor dos 4 arquivos de analytics (analytics.ts, appsflyer.ts, hotjar.ts, mixpanel.ts) pro pattern isDev() ? DEV_* : PROD_* (consistente com o resto do arquivo). Webtrends desativado (webtrendsAccountId: undefined em dev e prod) — token preservado comentado pra referência caso precise reativar. CSS anti-flicker do Webtrends removido (estava causando deadlock no initial page load).
• 7k-bet-br + cassino-bet-br: /twa.js restaurado em public/twa.js + registro <script src="/twa.js" defer> em app/config/scripts/scripts.ts (parte do PR #786 — bridge AppsFlyer pro APK Android). Vera-bet-br já tinha sua variante e ficou intocada.
• cl-bet7k-com, fi-7k-bet, ng-7k-bet: três brands ganharam override de app/config/seo/hreflang.ts com o cluster recíproco da família 7k (auto-referência + outras 3 sister-domains, sem x-default).

Ops​

• Deploy configs (front-ops): deploy.yml atualizado pra mudar a default branch de cl-bet7k-com, fi-7k-bet e ng-7k-bet pra main-inter e setar BRAND_LANGUAGE correto por env (es-cl, fi-fi, en-ng respectivamente). Mesmas mudanças de BRAND_LANGUAGE aplicadas aos staging equivalentes (stagecl-bet7k-com, stagefi-7k-bet, stageng-7k-bet). stagecl-bet7k-com também trocou default branch de performance pra stage pra alinhar com a strategy de branching atual.
• Default branch do prod-7k-bet-br ajustada em deploy config separado.

Core / SDK​

• @cactus-agents/i18n bumped para ^0.88.0 — ship das novas keys: error_page.details_* (pt-br, pt, es, en) usadas pelo bloco ErrorDetails, layout:sidebar.nomenclature_games consumida pelo useCasinoNomenclature refatorado, e layout:sidebar-buttons.store que destrava a remoção do fallback "Store" hardcoded no fi-7k-bet. Adicionar país novo agora é uma linha em cada layout.json do core, sem mudança no front.
• @cactus-agents/api-client bumped para ^0.14.1.
• Dependências do core estabilizadas (PR #774 + #775): vários @cactus-agents/* saíram de tag beta pra stable em package.json do front-web-base; @cactus-agents/i18n e @cactus-agents/payments bumpados pra stable em commit separado.
• Suite de regressão no core (commit 68d3728 mencionado no PR #779) com 11 cases pinned cobrindo o classifier real contra /api/wallet/refresh, /api/kyc/status, /api/user/login-history etc. — garante que mexer no classifyApiError não regrida a granularidade dos códigos EM*.

Documentação​

• docs-internal/endpoints/error-codes.md: nova seção "Envelope das rotas internas — preservar reason em 401/403" documentando a regra dura, o helper proxyErrorResponse / unauthorizedNoToken, as exceções legítimas (fluxos pre-auth: login, register, recovery, social, validate-document) e o procedimento pra adicionar rotas novas. Worked example baseado no caso real cassino.bet.br #EP0710-EM0005 reportado em 05/2026.

• Limite etário no cadastro (PR #654) — novo app/utils/age.ts calcula idade contra now e bloqueia data de nascimento fora da faixa 18–99 anos direto no RegisterModal antes do POST. Antes o front aceitava qualquer data válida e só o BFF reclamava (round-trip + UX ruim). Erros aparecem inline com chaves i18n já existentes (auth.errors.too_young / too_old), e o parseRegisterFormData em app/modules/register/flow.ts ganhou o mesmo guard pra blindar o pipeline FormData → payload.
• Validação de telefone contra máscaras do país (PR #683) — o RegisterModal agora deriva os digit lengths válidos a partir de availableMasks (ex: BR → [10, 11]) e marca o campo como INVALID_PHONE no blur quando a contagem não bate. Isso afeta automaticamente 7k-bet-br, cassino-bet-br, vera-bet-br (e qualquer brand futuro) sem mudança no override — a validação é mask-derived. Erro limpa assim que o user atinge um length válido; não dispara shake (esse fica reservado pra erros de submit), só border + mensagem inline.

Search — autofill bloqueado + tecla "Buscar" no mobile​

• Autofill leak corrigido (PR #754) — bug reportado em 2026-05-08: após finalizar saque com sucesso e clicar "Finalizar", o user era redirecionado pra /buscar?q=<email>. Causa raiz: HeaderDormantInput era <input type="text"> sem autoComplete, e o Chrome autofillou o campo com email salvo, disparando onChange → navigate(...). Fix aplicado nos 4 inputs de busca shared (header dormant, header active, search-pill, page input): type="search" + name="site-search" + autoComplete/autoCorrect/autoCapitalize="off" + spellCheck={false}.
• Tecla "Buscar" no teclado mobile — mesmo PR adicionou enterKeyHint="search" em todos os inputs de busca (iOS 13.4+, Chrome/Firefox Android mostram lupa em vez do enter genérico) e suprimiu o ✕ nativo do type="search" via [&::-webkit-search-cancel-button]:appearance-none pra não duplicar com o botão X custom.
• Guards defensivos no useSearchTriggerHandlers — handleChange agora descarta eventos cujo nativeEvent.inputType seja undefined ou "insertReplacementText" (padrões de autofill do Chrome/password managers; digitação real é "insertText") e qualquer valor contendo @ (cinto + suspensório). Suite de testes ganhou 4 cenários novos cobrindo autofill, password manager, valor com @ e happy path.

Cassino — top games stacked + categorias mobile​

• Card "Pagou Muito" redesenhado para 228×80 (PR #709) — TopGameCardCompactWatermark da cassino-bet-br ganhou layout stacked: o botão JOGAR saiu da coluna lateral e virou terceira linha full-width abaixo de nome+payout. Padding 8px ao redor + 8px de gap entre thumb e stack. Refactor adicional expôs gameNameText no TopGamesStyleOverrides: brands que adotarem o variant compact-watermark no futuro herdam automaticamente o token titles da brand; cassino-bet-br setou gameNameText: "#C7CCD1" pra preservar o tom legado exato.
• Mobile game card stat layout (PR #690) — GameCardActions reduziu padding lateral de px-2 pra px-1 no bloco de conteúdo + px-1.5 no chip de stats (mais conteúdo cabe sem cortar). GameGrid na variante compact passou de grid-cols-4 pra grid-cols-3 no mobile e gap reduzido (gap-1 em vez de gap-1.5). BalloonIcon shrinkado pra w-3 h-3 em telas pequenas mantendo w-5 h-5 em desktop. GameCardStacked reduziu gap-1 → gap-0.5 no divider mobile.

Stories — swipe nav com close nas bordas (PR #711)​

• Drag-on-card e swipe horizontal navegam stories — o StoriesModal e StoriesModalFullScreen agora detectam swipe lateral pra avançar/voltar, e nas bordas da timeline o gesto fecha o modal em vez de tentar passar pra fora do range. Drag iniciado em qualquer ponto do card (não só nas setas) também dispara nav.

Blog / WP Post Card — aspect-ratio configurável (PR #742)​

• object-contain em todos os presets fixos — WpPostCard substituiu object-cover por object-contain em todos os aspect-ratio presets, então thumbnails de blog/promoções nunca mais são cropadas. Imagens fora da proporção do container ganham letterbox/pillarbox contra bg-bg-secondary (neutro).
• Novo aspect 5/3 + default auto — adicionado preset "5/3" (≈1.67) ao PostCardThumbAspect. Default do base virou "auto" (sem aspect fixo, altura segue a imagem). Brand presets restaurados: 7k-bet-br + cl-bet7k-com + fi-7k-bet + ng-7k-bet → cinema (21:9); cassino-bet-br → ultrawide (5:2); vera-bet-br → novo override 5/3.
• Hardening em blog.server.ts — todos os 4 helpers de fetch WP envelopam o fetch() em .catch(): TypeError: fetch failed (DNS, SSL, endpoint indisponível) degrada pra resultado vazio em vez de quebrar o loader. Cada catch emite log.warn com URL + erro pra diagnóstico.

Security Headers — adição e revert no mesmo dia​

• Adição (PR #292, manhã) — workers/middleware.ts ganhou 5 headers novos no applySecurityHeaders: X-Frame-Options: SAMEORIGIN, X-Content-Type-Options: nosniff, Referrer-Policy: strict-origin-when-cross-origin, Permissions-Policy: geolocation=(), microphone=(), camera=() e Content-Security-Policy-Report-Only (Phase 2 — coletando violações sem bloquear; promove pra Content-Security-Policy enforced após validar em prod sem falsos-positivos).
• Revert (PR #770, hotfix da tarde) — o Permissions-Policy quebrou a permissão de câmera no fluxo de KYC (selfie/liveness). Decisão: reverter os 30 linhas inteiras do middleware.ts pra desbloquear KYC em prod. Próxima iteração precisa relaxar camera=() pra camera=(self) ou whitelist do hostname antes de re-aplicar.

Brand Overrides​

• casateste-com — enriquecimento pra paridade com prod (PR #761) — overrides casateste-com/app/config/** recebem espelho funcional do layout da betpontobet-bet-br pra que a casa de teste exponha as mesmas features que rodam em produção:
  • sections/home-rows.legacy.ts, casino-rows.legacy.ts, casino-live-rows.legacy.ts com favorites-row, recently-played, top-games ("Pagou muito"), main-leagues, biggest-wins-and-latest-bets, tournaments e missions.
  • catalog/categories.personalize.ts (orderBy + displayPriority por slug) e catalog/game-thumbs.ts (efeitos mp4 no hover).
  • widgets/sidebar-buttons.ts no variant gradient (brand-aware sem custom override).
  • features/features.ts ativando favoriteGames, recentlyPlayedApiSeed, rowSuggestionsInEmptyStates, headerNotifications, internalFaq, incomeReport e eagerHomeRowCount=8.
  • features/account.ts ativando accountSetLimits, accountTimeoutLimits e userPreferences.
  • Não replicado: analytics, FAQ/game-details, SEO, LPs, scripts, licenses, referral custom-v2, menu/sidebar com labels da brand. Indique-e-ganhe fica no variant default.
• 7k-bet-br — Webtrends account ID (PR #722) — overrides/7k-bet-br/app/config/analytics/analytics.ts recebe webtrendsAccountId: "251da524-89d9-43b5-a186-8309fea3b93f", portado de front-old/front-web-7k-bet-br/plugins/webtrends.client.ts. Habilita o A/B testing ativo do 7k.bet.br via <WebtrendsLoader /> carregado globalmente em root.tsx.

Infra / CI / Deploy​

• ci-deploy.yml migrado pra matrix fan-out a partir do front-ops (PRs #728, #729, #733, #745, #750, #755) — sequência grande de refactors no workflow do front-web-base: 3 jobs hardcoded substituídos por (1) quality (lint/build, filtra drafts), (2) config-lint (compara dropdown + branch filters do workflow contra scan filesystem do front-ops, falha em drift), (3) resolve-matrix (scaneia front-ops/config/web/environments/*/deploy.yml em runtime, filtra por auto_deploy + default_branch, emite matrix + GH step summary com tabelas "Deploys fan-out" e "Other environments"), (4) deploy (matrix fan-out, um job paralelo por env). Workflow extra list-environments.yml adicionado pra listar inventário sob demanda. Triggers ajustados: pull_request: branches=[main] + filtro de drafts; workflow_dispatch com dropdown alfabético; heredoc fix no glob/anchors.
• Deploy summary table polida + job validate renomeado pra check (front-ops) — UI da matrix do GH Actions ficou mais legível. Auto-deploy desligado em betpontobet-bet-br, cassino-bet-br, prod-7k-bet-br e vera-bet-br (controle manual via dispatch). cl-bet7k-com aponta default branch pra stage-main-ana. react-c4ctus-com com auto_deploy off até a conta CF Teste estar configurada. Cache TTLs do react-casateste-com apertados pra ambiente de teste (rows + wins).
• Ações do GitHub bumpadas pra Node 24-ready (front-ops + front-cactus-docs) — GitHub vai forçar workflows em Node 20 → Node 24 a partir de 02/06/2026. Versões mínimas com suporte explícito: actions/checkout@v4 → @v5, actions/setup-node@v4 → @v5, pnpm/action-setup@v4 → @v5. Aplicado em todos os workflows reutilizáveis do front-ops e no deploy do front-cactus-docs (que também ganhou matrix fan-out idêntica ao base). Config dos envs do docs movida pra front-ops/config/docs/environments/<env>/deploy.yml.

Documentação​

• sdk/auth.md — TwoFactorPayload corrigido (PR docs #27) — campos do payload do 2FA sincronizados com os nomes reais do BFF (code em vez de otp, etc); doc estava descrevendo um shape divergente do que o backend aceita.

Sync​

• main-vera (PR #769) — merge de sincronização do branch main pro vera-bet-br, agregando todos os PRs acima + features que já estavam em main e ainda não tinham chegado na linha vera (Recover KYC steps, Cookie Consent banner, AppsFlyer/Pendo hooks reformados, useRecheckSpa, rotas internas /api/auth/recheck-spa + /api/auth/refresh, RestrictedModeAlert, SessionExpiredBanner, etc.). Conteúdo dessas features já documentado nos changelogs anteriores; este PR só aplica o cherry-pick em massa pro deploy da vera.

• Toggle ?EnableDebug=1 removido em prod. O parâmetro de URL e a chave sessionStorage["debug_enabled"] foram completamente eliminados — não existe mais runtime gate que possa ser ligado por query param, cookie ou storage. O motivador foi um leak no /api/games/start: o endpoint passava debug:true ao ApiClient e ecoava _debug.requestInfo na response, expondo o header cf-worker-key que o Worker usa pra autenticar com o BFF — qualquer um clicando em "Play" em qualquer brand de prod conseguia ler do DevTools. Endpoint corrigido com 6 testes de regressão que travam o contrato (debug:true proibido, _debug ausente em sucesso e erro).
• Painéis DevApiDebug/DevApiExplorer agora gated por import.meta.env.DEV. Novo wrapper DevPanel com React.lazy condicional — em prod, o dynamic import('./DevApiDebug') vira inalcançável e o Vite remove o chunk inteiro do build. Consumers (home, favorites, game detail, wallet, history) trocaram <DevApiDebug> por <DevPanel> envolto em {import.meta.env.DEV && (...)}, garantindo que loader _debug data nunca serializa no SSR stream de prod.
• Rotas /api/dev/*, /dev/ftd-cashback, /debug e /debug/analytics só existem em dev build. O registro em app/router/routes.ts é gated por process.env.NODE_ENV !== 'production' — em prod build esses arquivos são tree-shaken por completo (server e client). Eliminados também app/utils/debug.server.ts (com isDebugRequest/?EnableDebug) e a doc docs/enable-debug/overview.md.
• CI guard pnpm bundle:guard falha se strings proibidas vazarem para o bundle de prod. Novo script scripts/check-prod-bundle.mjs faz grep no build/ após pnpm build e detecta DevApiDebug, DevApiExplorer, activateDebugFromUrl, isDebugActive, EnableDebug, debug_enabled, validation_debug, /api/dev/, /dev/ftd-cashback, debug/analytics e cf-worker-key (no client bundle apenas). Wired via pnpm build:check (= build + bundle:guard). Adicionar nova string secret-adjacent exige atualizar FORBIDDEN_STRINGS no script.
• Bumps no core que sustentam a remoção: @cactus-agents/api-client 0.12.0 (redação regex-based de headers *-key/*-token/*-secret/cf-*/x-api-* no requestInfo em modo debug) e @cactus-agents/utils 1.0.0 major (remove os exports activateDebugFromUrl e isDebugActive — não existe mais API pública pra ligar o toggle em runtime). Defense-in-depth: console.* em ftd-cashback.client.ts, smartico-checkin.client.ts e useOnFirstScrollIntoView.ts agora também passam por import.meta.env.DEV, então mesmo se um caller acidentalmente passar debug:true em prod o output some no build.

Auth — classificação de logout 401 e bridge de beacon​

• Banner SessionExpiredBanner com código de referência #EP0120-EM0003. Após um 401 que força logout, o login modal abre por cima da página atual com o banner "Sua sessão expirou" e um código mono-spaced copiável. O email vem prefilled com o último login conhecido. Em rotas protegidas (/user/*, /vip/*) a saída acontece via SPA navigation, sem full-page reload. 15 novos error codes (EM0001–EM0014) com matchers derivados do BFF Laravel real (wrong_ha, wrong_hf1, wrrong_hf2 typo preservado, wrong_token, ip_changed, device_changed, location_changed, liveness_required, deprecated_version, user_blocked, security_error).
• Beacon estruturado /api/logs/auth-logout agora pousa de fato no Cloudflare Observability. O navigator.sendBeacon() só aceita content-types CORS-safelisted (application/x-www-form-urlencoded, multipart/form-data, text/plain) — passar Blob({ type: "application/json" }) fazia Chrome/Firefox/Safari rejeitarem silenciosamente, perdendo 100% dos payloads em prod. Fix em duas pontas: client troca pra text/plain;charset=UTF-8 e captura o boolean retornado pelo sendBeacon (caindo pra fetch({ keepalive: true }) quando false); server promove o log principal de log.warn → log.error (sobrevive aos filtros default do CF) e adiciona log.warn estruturado em todos os early-returns.
• Refresh-token retry opcional + recheck-spa. createApiClient({ enableRefreshRetry: true, refreshTokenFn }) agora coalesce um refresh único antes do logout — wired nos 5 *.client.ts services com proxy /api/auth/refresh e timeout de 5s. RestrictedModeAlert ganha botão "Verificar meus limites" pra usuários em spa_exclusion, backed pelo novo /api/auth/recheck-spa com cookie rate-limit server-side de 30s (paridade com AlertOnlyWithdraw.verifyLimits do legado Vue). Interceptor global window.fetch 401 agora whitelista same-origin /api/* + origem do BFF — 401s de terceiros (WordPress, Connect, ad tech) não disparam mais logout.
• @cactus-agents/accounts 2.2.0 para de mandar ?check_spa_again=1 em todo /auth/user-profile (era um SIGAP lookup síncrono em todo SSR loader + revalidation + profile sync). Agora é opt-in via { checkSpaAgain: true }. Bumps complementares: @cactus-agents/api-client 0.13.1 (registries de erro + refresh retry) e @cactus-agents/i18n 0.86.2 (15 chaves novas em auth:session_expired_banner.* / auth:session_error.* + 5 em user:protection.recheck_spa_* nos 4 locales).

Recovery de senha — três fixes do fluxo​

• Envelope {success:false} do BFF agora vira erro de verdade. O proxy de confirmReset, sendEmail, sendSms e validateCode tratava qualquer 2xx como sucesso, então a UI renderizava "Senha atualizada com sucesso" mesmo quando o BFF rejeitava semanticamente (ex: KYC com kyc_id ausente/inválido no fluxo de recuperação por KYC). Agora o proxy detecta o envelope de falha e converte para HTTP 400 + mensagem de erro, preserva o cookie recovery_session em falha de confirmReset (usuário pode retentar sem refazer o KYC), e pula a persistência do cookie de código em falha de validateCode.
• Typo source: "recovery_password" → "password_recovery". O fluxo de recovery por KYC mandava source=recovery_password para /bff/users/kyc/recovery — ordem invertida vs todas as brands do legado Nuxt (source=password_recovery). O BFF aceitava o KYC mas nunca associava o correlation_id ao reset, fazendo o /auth/passwords/reset/confirm subsequente falhar com o envelope genérico. Adicionado também o gate em saveKycId pra omitir kyc_id quando vindo de password_recovery_attempt_limit (paridade com ResetForm.vue legado). Typo introduzido em bb2859bc0 (Mar/25/2026, bootstrap do novo fluxo) e nunca pego porque RecoverKycStep não tinha testes.
• Step options nunca mais auto-avança. O useEffect que disparava setStep(options[0].step) quando havia só um método ativo fazia o botão "Voltar" parecer quebrado: Betpontobet (só KYC) voltava pra KYC ao cancelar; Vera (só email) voltava pro código ao apertar "Voltar". Removido o auto-advance — usuário sempre vê a tela de opções e clica, mesmo com um único método. 5 testes novos cobrindo as 4 permutações de método ativo. Comentário do prefixo t2: do Turnstile atualizado: o hardcode é intencional (plataforma tem um único sitekey always-show provisionado), não TODO.

Performance e resiliência​

• Cache topGames reaproveitado para o fetch de high-payers. O refactor 6867beda renomeou o resource de topGames para highPayers mas o nome novo nunca foi adicionado ao defaults.yml do front-ops. Resultado: todo SSR de home/casino fazia bypass total do cache (sem TTL, SWR ou single-flight coalescing) e batia direto no BFF /bff/games/game-high-payers-dl, sobrecarregando upstream e o database de stats. Voltar a usar topGames (que já tem 1h TTL + KV snapshot + post-deploy purge declarados no defaults) restaura o cache imediatamente sem mudança coordenada no front-ops.
• AppsFlyer TWA bridge restaurada para a 7k. Após a virada SSG → SSR, eventos AppsFlyer pararam de chegar pra 7k (Vera e Cassino sobreviveram por terem mais tráfego de mobile browser; 7k é praticamente 100% TWA). O legado useAppsFlyerS2S tinha dois paths: bridge nativa via window.twa.getPostMessageService() quando APK >= postMessageMinVersion (path dominante em prod) e HTTP S2S como fallback. A primeira porta do hook só implementou o HTTP path — e ainda com gate invertido. Solução: dispatcher dual-path com AppsFlyerConfig.postMessageMinVersion?: string novo. TWA + APK no threshold + bridge presente → postMessage; tudo o resto → HTTP S2S. Thresholds legados respeitados: 7k 3.0.0, Cassino 4.0.20, Vera 5.0.0.

Brand Overrides​

• Cassino.bet.br — Pendo habilitado com tracking manual. Override de brand novo ativando o Pendo (token + accountId: "cassino-bet-br", paridade com o runtime config do legado front-web-cassino-bet-br). Hook usePendo estendido pra emitir manualmente os eventos que o agente no-code não consegue observar: app_loaded (uma vez por document load — primeira visita, F5, navegação externa), login (transição isAuthenticated false → true) e logout (true → false). Re-identifica o visitante nas transições via pendo.identify() (fallback para initialize), espelhando stores/auth.ts do legado Nuxt. visitor.id é o user id da plataforma Cactus (AuthUser.id do @cactus-agents/accounts).

Infra (front-ops)​

• Refactor de config por brand: brand.yml agora declara só identidade (repo: <owner>/<name>, singular — cada brand é dona de um repo) e environments/<env>/deploy.yml vira a source of truth para worker_name, cf_account, default_branch, language, origin_domain, worker_url e cf_zone. repos.yml removido das duas brands. Contrato do reusable workflow inalterado (environment + ref), então callers em outras branches continuam funcionando.

Documentação​

• Referência EP/EM de códigos de erro adicionada ao docs-internal. Nova doc docs-internal/endpoints/error-codes.md lista todos os EP (endpoint) e EM (error kind) que o front emite ao classificar 401/403/429/5xx forçando logout — superfície compartilhada com o time de back-end pra triagem de tickets "fui deslogado com #EP0120-EM0003". 13 tabelas de EP por domínio (Auth, User, Wallet, Payments, KYC, Games, Sports, Brand, internal /api/*, Unknown) extraídas verbatim de packages/api-client/src/errors/endpoint-codes.ts; 5 tabelas de EM por status (401 com 13 matchers específicos, 403, 409/429, 5xx, transport, unknown) com cross-reference pro BFF Laravel (User.php, CheckBlocked.php, CheckUserLoggedIn.php). Inclui playbook de triagem com 2 exemplos end-to-end, checklist pra adicionar códigos novos, e schema do beacon estruturado que app/routes/api/logs/auth-logout.ts escreve no CF Workers Observability.

• Novo hook useAfterRegisterFlow (app/hooks/useAfterRegisterFlow.ts) orquestra o pós-registro: abre o modal de depósito uma vez, logo após o cadastro, bypassando o throttle de 12h do useAutoDepositModal. Replica o handleOpenRegisterStrategy → openModal('deposit') do handleSuccessRegister legado em Vue. Suporta o ramo regulatório (espera o LimitsStep do ValidationBlockerOverlay resolver antes de abrir o depósito) e suprime quando há ?deposit=<campaign> na URL, conta restrita ou featuresConfig.autoDepositAfterRegister === false.
• Store app/store/onboarding.ts (Zustand, não persistida) carrega o sinal justRegistered + lastPrudentialLimitActive entre o sucesso do RegisterModal e o próximo render do DefaultLayout. Reset automático no logout.
• Forward de user_prudential_limit_active no payload de signup (/bff/register-simplified, /auth/register): sinaliza ao BFF qual botão regulatório o usuário clicou ("Quero definir meus limites agora" vs "Continuar sem limites"). Nova feature flag autoDepositAfterRegister propagada nos 13 overrides de brand.
• Dedup cross-request de /auth/user-profile em app/services/auth.server.ts: cache token-scoped com TTL de 10s + cap de 100 entradas (chave = SHA-256 hex do token, evita expor token cru em dumps de memória). Resolve o burst pós-login onde POST /api/auth/login, useAuthProfileSync → GET /api/auth/profile e revalidator.revalidate() → _layout loader pegavam três Requests distintos com o mesmo token — o WeakMap<Request> antigo não conseguia deduplicar.
• /api/auth/profile agora consome getAuthForRequest em vez de chamar createAuthFromClient direto, herdando automaticamente o cache acima. PRs touch-up em 20+ componentes (UserSummaryHeader, ValidationContextGate, GameIframe, payments, protection, validation steps) que liam useProfile() ad-hoc.

Pagamentos — refresh de profile e UX Pix​

• refreshProfile() após depósito (PR #674) — opt-in via flag refreshProfileAfterDeposit em 7k-bet-br, cassino-bet-br, vera-bet-br apenas. Faz refetch do profile assim que o depósito fecha pra que ftd_value/ftd_date saiam de 0 imediatamente após o FTD, destravando features gateadas (minigames diários, FTD cashback) sem reload. Disparo do tracking acontece antes do refresh pra preservar o sinal de FTD. Demais brands não recebem a flag (ruído removido dos overrides).
• Botão "Já paguei" oculto no resultado Pix (PR #677) — feature flag hidePixAlreadyPaidButton ativa em 7k-bet-br, cassino-bet-br, vera-bet-br. Usuário fica preso no fluxo "aguardando confirmação real do BFF" em vez de poder forçar o onApproved manualmente.
• Toggle de marketing sincronizado com store (PR #680) — MarketingSection agora deriva accepted direto de useAccountsStore (era useState local que só semeava no mount → mostrava valor stale ao navegar fora e voltar). Adiciona feedback de save via sonner toast e trata erro com extractApiError. Strings novas em pt-br/es/en no namespace user.

Cassino — banner regulamentado, promoções, layout do card​

• Side CTA de "Plataforma Regulamentada" agora rola até o footer em vez de navegar (PR #670). Novo type action: "scroll-to-footer" em HomeBannerSideCta — mutualmente exclusivo com link. SideCtaCard usa <button> em vez de <Link>, faz scrollIntoView({ behavior: "smooth" }) no <footer id="page-footer"> (fallback window.scrollTo(bottom)). Footer agora carrega o id="page-footer" em FooterDefault e FooterStacked. Aplicado em cassino-bet-br via override do home-banner.ts.
• Cards de promoção sem crop em cassino-bet-br (PR #681) — novo override widgets/post-card.ts força thumbAspect: "ultrawide" (5:2), espelhando o precedente do 7k-bet-br. Banners promocionais saem em ~2.44:1 com logo + disclaimer "Aposta não é investimento" no lado direito; o default 16:9 cropava essa região.
• Game card mais denso em mobile (PR #673) — GameCarousel ajusta largura compacta (w-[118px] em mobile) e regular; BalloonIcon reduz pra w-3.5 h-3.5 em mobile (mantém sm:w-5 sm:h-5 em desktop); chip de stat ganha gap-1 em mobile (sm:gap-1.5 em desktop).
• PageDescription permite scroll (PR #682) — quando expandida, vira max-h-[80vh] overflow-y-auto (antes max-h-max sem clamp). Descrições SEO longas na home não estouram mais o viewport.

Tracking & Affiliate​

• Clever-01 — paridade estrita 1:1 com pages/clever.vue legado (PR #672). Cookie lastclick agora:
  • Vai sem sanitizeTrackingValue — lastclick é tratado como ID opaco do parceiro Clever, que pode usar formatos com strings da blocklist (document, appendChild, macros {macro}/__CLICKID__). Sanitizar mutilava IDs e quebrava atribuição.
  • Resolve por params.getAll("utm_source") pegando o último valor (handles ?utm_source=a&utm_source=b), em vez de params.get() que pega o primeiro.
  • Fallback usa último valor da primeira key (paridade com Object.values(searchParams)[0] + Array.isArray ? .last : . do legado).
• Clever-02 — Set-Cookie cross-site + cookies legacy individuais (PR #685, follow-up do clever-01 de 25/04). captureTrackingFromRequest agora retorna setCookies: string[] (plural) com o cookie_tracking + cookies individuais legacy (src, utm_source, utm_campaign, utm_content, utm_medium, gclid, fbclid, etc.) emitidos como Set-Cookie separados. Em HTTPS, todos viram SameSite=None; Secure pra que validators de afiliado/anúncio enxerguem o cookie em chains cross-site (HTTP local cai em SameSite=Lax porque o browser rejeita None sem Secure). Loaders app/root.tsx e app/routes/clever.ts propagam setCookies em vez de setCookie único.
• AppsFlyer S2S restrito a mobile browser fora de TWA (PR #675). Antes disparava em qualquer App Mode (?app=true); agora exige (1) UA de phone + (2) NÃO estar em TWA. Razão: as APKs Android do 7k/cassino/vera já reportam lead/dep/rebill via SDK nativo (InAppEvents.logEvent) — disparar S2S no WebView por cima dobrava todo evento no dashboard AppsFlyer. Captura de appsflyer_id/advertising_id/app_version da URL roda incondicional pra cobrir o caso "usuário sai da APK pro browser mid-session".

Proteção / Limites​

• Autoexclusão permanente: -1 (front) → 99 (BFF) (PR #671). Front novo adotou -1 como convenção interna pra "permanente" (alinhado com SELF_EXCLUSION_MONTHS_OPTIONS em @cactus-agents/accounts e isPermanentExclusion); BFF rejeita 0/negativos com "user exclusion deve ser pelo menos 1" e exige 99 (convenção do legado Vera). Boundary fica no proxy app/routes/api/user/self-exclusion.ts via toBffExclusionValue() — callers podem continuar passando -1 sem precisar lembrar da regra.

Brand Overrides​

• Privacy HTML legado pras brands ANA Gaming (PR #652) — 7k-bet-br, cassino-bet-br, vera-bet-br ganham overrides próprios de app/config/legal/pages.ts com versões terms=5.0, privacy=2.0, demais=4.0 (espelhando o versionText do Terms.vue legado). Brands não-ANA caem no fallback "1.0" do loader (pageConfig.version ?? "1.0"). Tabela de privacy renderiza responsiva em mobile (linhas empilham, sem scroll horizontal). Flag useStaticPrivacyTerm removida das 11 brands não-target (ruído).
• Vera referral — copy persuasiva + CTA pra jogos elegíveis (PR #669). overrides/vera-bet-br/app/config/referral/v1.ts ganha minBetAmount: 200, providerName: "PG Soft", eligibleGamesPath: "/cassino/categoria/indique-amigos". Copy vinda do pt-br.json:608 legado ("girar o mínimo de R$200,00 em jogos selecionados da PG Soft").

Ops​

• Default branch do front-web-base alterado para main-ana na config dos workflows reusáveis (front-ops).

• Novo evento Mixpanel Deposit Requested (useAnalytics.trackDepositRequested) disparado quando /wallet/add-credit retorna 200 OK. Espelha o legado DefaultLayout.vue das brands 7k/cassino/vera (props Amount em unidades inteiras + DepositMethod). Continua complementar ao evento de funil já existente (pix_generated no GTM e PixGenerated no Facebook).
• Bugfix crítico nos eventos S2S do AppsFlyer (sendRegister, sendFTD, sendRebill). Os três estavam dentro do guard if (!shouldLoadTrackers) return do useAnalytics, mas o gate é o inverso do gate do AppsFlyer (shouldLoadTrackers = !isAppMode && !isBot, useAppsFlyer.ready = enabled && isAppMode) — resultado: nenhuma das chamadas server-to-server disparava nem na web (gate externo bloqueia) nem dentro do APK (early return do gate externo cortava o caminho). Agora as três chamadas são disparadas antes do guard e o S2S funciona em produção. Coberto por useAppsFlyer.test.ts (202 linhas) e useAppMode.test.ts (72 linhas).
• useAppMode agora reconhece ?is_twa=true além de ?app=true. Os APKs em produção da família 7k/cassino/vera (publicados antes do rename do query param) continuam injetando o legado em cada landing — sem isso isAppMode ficava false pra users do app e desativava todo o pipeline de tracking S2S silenciosamente.
• Valor do deposit GTM corrigido pra unidades inteiras (amountCents / 100) ao invés de cents puros — paridade com o legado e com a expectativa dos dashboards de BI.

Sitemap — Split Temático e Origem Dinâmica​

• Sitemap monolítico fatiado em sub-sitemaps temáticos (feat/sitemap-split-and-index): sitemap.xml virou índice e aponta pra sitemap-static.xml, sitemap-games.xml, sitemap-categories.xml, sitemap-providers.xml, sitemap-promotions.xml, sitemap-blog.xml e sitemap-faq.xml. Sub-sitemaps só aparecem no índice quando a brand tem conteúdo correspondente — evita Googlebot descobrir filhos vazios. Sharding automático em sitemap-games.xml quando passa de 45k URLs (computeShardCount).
• Origem do <loc> agora vem do request.url ao invés de ORIGIN_DOMAIN (fix/sitemap-origin-from-request-host). A env aponta pro domínio canônico da brand (compartilhado entre prod e stage), então o sitemap de stage estava listando URLs de produção e ficava inútil pra QA. Agora prod aponta pra https://7k.bet.br, stage pra https://stage.7k.bet.br, dev pra http://localhost:5173. Fallback pra ORIGIN_DOMAIN apenas quando request.url falha — caso patológico em workers Cloudflare.
• robots.txt bloqueia indexação em hosts não-prod — stage e dev disparam Disallow: / enquanto o domínio canônico fica liberado.
• Stylesheet XSL (public/sitemap.xsl, 391 linhas) adicionada pra renderizar o sitemap legível em browser.

Performance — Listing de Jogos Híbrido​

• Listing de categoria/provider agora é híbrido (perf/games-listing-infinite-scroll-search-ux): catálogos com total <= 120 jogos (90%+ dos casos) seguem 100% client-side com filter reativo sub-segundo; categorias maiores recebem só a primeira batch via SSR e completam por infinite-scroll usando os novos endpoints /api/games/category/:slug e /api/games/provider/:slug (offset/limit, default 48). Cutoff e batch size centralizados em useHybridGamesList (329 linhas, 287 linhas de teste).
• Hook useStatsBatchHydration + endpoint /api/games/stats-batch alimenta o store reativo de stats sem bloquear a primeira pintura.
• Search com debounce de 250ms server-side quando em modo paginado; folding de diacríticos via foldForSearch do core mantém paridade entre filter local e server.
• NavigationLoader/ProgressBar/Spinner ajustados pra refletir corretamente navegações dentro do mesmo route (filter, infinite-scroll) via novo hook useIsRouteNavigation.

SEO — Landing All-Games + Page Descriptions​

• Página /cassino/categoria/all ganha PageDescription específico via override casino.category:todos-os-jogos (fix/all-games-landing-seo-and-canonical-slug). Antes a SEO copy era pulada (pageDescription = null) só pra "all", deixando a landing órfã. Agora o resolver usa o slug canônico todos-os-jogos como chave do override, valendo tanto pro alias legado /cassino/categoria/all quanto pra URL canônica /cassino/categoria/todos-os-jogos.
• Helpers CANONICAL_ALL_GAMES_SLUG, isAllGamesSlug e resolveCategorySlug centralizados em app/utils/casino-categories.ts — qualquer caller que precise resolver "all games" passa a usar o mesmo trio (filter bar, breadcrumbs, SEO) e os dois slugs (all e todos-os-jogos) ficam cobertos.

Cassino / Sidebar / Footer​

• Item "Regras de Apostas" na seção esportes da sidebar (feat/sidebar-betting-rules-7k-cassino-vera). Aparece somente quando showSidebarBettingRules: true, o user está em rota /sports e o provider ativo é first (CactusSportsbook). Click dispara o evento cactus:show-betting-rules que o SportsIframeFirst escuta e reescreve o src do iframe com #betting-rules — espelha o legado CactusSportsbook.showBettingRules. Ativado em 7k-bet-br, cassino-bet-br e vera-bet-br; flag adicionada (default false) em todas as 14 brands com override pra evitar drift do file-replacement.
• Sidebar variants ganham suporte a actionKey em SidebarMenuItem — quando preenchido, o item renderiza como botão com side-effect handler ao invés de link de navegação. Primeiro consumer é o betting-rules acima.
• Footer com row opcional de links extras (feat/footer-extra-legal-links-7k-cassino-vera): novo tipo ExtraLegalLinksConfig com 3 posições (footer-stacked-bottom-bar, footer-default-after-seals, footer-default-after-legal). 7k, cassino e vera ganham os links Denúncias / Privacidade / Ouvidoria; demais brands continuam com null.

Pagamentos / Conta​

• Métodos pixtopay-global e pixtopay-global-webpay (Payku/CHL) suportados no checkout (feat/chl-pixtopay-global-methods). Render via iframe (altura 750px, mesmo padrão do bank-transfer/khipu). Bump do @cactus-agents/payments na lockfile.
• Valor pre-preenchido do depósito agora é clamped pro mínimo da brand (fix/clamp-prefilled-deposit-min). Antes, ?value=500 num site com mínimo R$ 10 (1000 cents) abria o form com R$ 5 e bloqueava o submit; agora Math.max(initialAmount, minAmount) garante que o form nunca abre abaixo do threshold.
• "Dados Pessoais" virou read-only (fix/readonly-personal-data). Nome, sobrenome, data de nascimento e gênero vêm da validação de documento (CPF/RUT/CURP) no registro e o BFF rejeita updates com VUD001 — manter os inputs editáveis dava falsa impressão de poder editar. Exceção: BirthdateForm ainda aparece quando birth_date é nulo ou 0000-00-00 (raro pra BR, possível pra outros países). Mesma lógica do legado Document.vue.
• Tournament/Mission/MiniGames cards e wins-carousel ganham key props faltantes + miscelâneas de lint (chore/biome-lint-warnings-cleanup, 74 warnings biome saneados em ~35 arquivos sem mudança funcional).

KYC / Validação​

• Race condition no anti-tamper do ValidationBlockerOverlay corrigida (fix/kyc-blocker-logout-anti-tamper-race). Quando o user clicava "Sair" no blocker, o MutationObserver e o setInterval que protegem o overlay disparavam window.location.reload() no momento em que o React desmontava o componente em resposta ao logout — causava reload espúrio. Novo isLoggingOutRef desarma os dois antes de o overlay sumir e o cleanup do effect reseta armed pra evitar re-armar em strict-mode.

Favoritos / Carousel / Logo​

• Sheet de Favoritos hidrata o store no reload (fix/favorites-hydration-on-reload). O gate de fetch era isFavoritesSynced(userId) — flag em sessionStorage que sobrevive ao F5 enquanto o store Zustand não. Resultado: depois de reload o sheet abria vazio porque a flag dizia "já sincronizado" mas o store estava frio. Novo gate é _isFavoritesHydrated (em-memory, morre com o store). markFavoritesSynced permanece exportado pra observabilidade. Cobertura nova em useFavoritesSync.test.ts (149 linhas).
• Carousel ganha arrowStyle="outside" (fix/carousel-outside-arrows-payment-method) — setas como flex siblings do track (não overlay), self-stretch na altura da linha, theme tokens (bg-bg-secondary, border-texts/10). Disabled nos edges mantém espaço (não pula). Nova prop hideArrowsOnMobile esconde abaixo de sm. Aplicado no MethodSelector (depósito/saque) e na GamesFilterBar — nas duas, as setas pequenas competiam por espaço com o conteúdo.
• Modal de Oferta Relâmpago FTD desativado nas brands 7k-bet-br, cassino-bet-br e vera-bet-br (hotfix/disable-ftd-offer-modal-vera-cassino-7k). ftdOffer.enabled = false faz o FtdOfferProvider virar pass-through (não monta hook, modal central, widget flutuante nem story thumb). Config preservada pra reativação rápida quando marketing pedir.
• cassino-bet-br mostra logo compacto (símbolo apenas) no header mobile autenticado (fix/cassino-logo-responsive). Reaproveita o gate showCompactMobileLogo (hydrated && isAuthenticated) que vera-bet-br já usa. Novo asset logo-icon.png (32×32) declarado em theme/sizes.ts via logo.mobile.compactSrc.

Brand Overrides​

• 7k-bet-br, cassino-bet-br, vera-bet-br — ftdOffer.enabled = false (hotfix), showSidebarBettingRules: true, novo extra-legal-links.ts com Denúncias/Privacidade/Ouvidoria.
• cassino-bet-br — theme/sizes.ts ganha logo.mobile.compactSrc apontando pro novo public/assets/brand/logo-icon.png. SEO casino.category:todos-os-jogos adicionado em page-descriptions.server.ts.
• 7k-bet-br, cassino-bet-br, vera-bet-br, state77-com, pt-state77-com, ph-state77-com, fi-7k-bet, ng-7k-bet, pb-bet, rj-bet, betpontobet-bet-br, casateste-com, x2b-bet — flag showSidebarBettingRules adicionada em todas (default false exceto nas três acima) pra acompanhar o file-replacement do features.ts e evitar undefined silencioso. SEO override casino.category:todos-os-jogos propagado em todos os 13 overrides de page-descriptions.server.ts.

Core / SDK​

• @cactus-agents/i18n — chave nova gender em user.json nos 4 locales ativos (pt-br, pt, es, en) — alimenta o display read-only do gênero no novo InfosSection.
• @cactus-agents/api-client e @cactus-agents/platform-cache — 16 warnings pré-existentes do biome saneados (packages/api-client/src/server.ts, packages/platform-cache/src/engine.ts) + ajustes em biome.json. Sem mudança funcional.

Ops / Infra​

• platform-cache — gameListPage adicionado à configuração de cache pra suportar as listagens paginadas do hook híbrido novo (useHybridGamesList consome /api/games/{category,provider}/:slug).
• sitemap cache policy atualizada no front-ops pra acompanhar o split de sub-sitemaps.
• Performance defaults Chile ajustados como configuração padrão da stage.

• D0 e D1 desacoplados — antes, ativar o template vera-legacy do D0 (cashback) ligava implicitamente o modal de anúncio do D1 (check-in). Agora cada brand habilita as três etapas independentemente: ftdCashback.enabled, ftdCheckin.enabled e a flag nova ftdCheckin.announcement.enabled. Quatro combinações possíveis — só D0, só D1, ambos ou nenhum.
• Copy e assets configuráveis por brand no template vera-legacy — FtdCashbackConfig ganhou copy.{firstBonusToastTitle,cashbackModalTitle,cashbackModalDescriptionHtml,cashbackModalCtaText} + templateAssets.{firstBonusToastImage,cashbackModalImage}. FtdCheckinConfig ganhou announcement.copy.{title,descriptionHtml,ctaText} + templateAssets.image. Todos opcionais — fallback é o copy PT-BR + CDN da Vera (zero regressão).
• 16 tokens de tema novos para o template e o toast — ftd-offer.template-{shell-bg,title-text,title-shadow,image-bg-from,image-bg-to,highlight-bg,highlight-border,highlight-text,cta-bg,cta-text} e ftd-offer.toast-{bg-from,bg-to,border,icon-bg-from,icon-bg-to,icon-border}. FtdOfferModalTemplate e FtdOfferInGameToast agora leem essas cores via CSS custom properties inline (Tailwind JIT não consegue gerar classes a partir de tokens dinâmicos).
• 7k-bet-br ativa a jornada completa — D0 cashback, D1 check-in (com modal de anúncio "Garanta sua diversão!") e oferta-relâmpago pré-FTD, todos via template unificado. Quatro assets brand-specific da CDN do 7k substituem os fallbacks da Vera (toast, modal cashback, anúncio D1 e modal de oferta).
• cassino-bet-br ativa a jornada completa — paleta + assets próprios, brand_id: 2 no Dark Verifier/Freedom (paridade com useFtdCashback.ts:52 do legado), kill-switches feFtdD0Cassino / feFtdD1Cassino, tabela bonusTiers de 35 níveis portada verbatim do legado (R$ 5 → R$ 3000+, cap em R$ 800), autoDepositModal abre o drawer de depósito automaticamente no login quando saldo ≤ R$ 0,10. Inclui lista de jogos elegíveis em cashback/eligible-games.ts.
• cl-bet7k-com ativa D0 + D1 com identidade chilena — brandId: 4, kill-switch feFtdD07KCl (compartilhado D0/D1), tabela bonusTiers de 11 níveis em CLP (CLP 850 → CLP 510 000, cap CLP 136 000), 6995 IDs elegíveis portados 1:1 do legado, copy em espanhol chileno ("¡Sigue jugando para ganar un cashback!"). Moeda renderiza sem decimais ($50.000) via useFormatMoney() + CountryConfig.displayDecimalDigits. D1 começa desabilitado no primeiro rollout.
• STT 2 (saldo bônus) com kill-switch remoto — saldoBonus.featureFlags?: { legacy?, configcat? } permite desligar a STT 2 instantaneamente via ConfigCat ou FF legado sem deploy. O hook useFtdCashbackFlow computa saldoBonusRemoteKillSwitchPass (closed-by-default enquanto a API está em voo, mesma semântica do D0/D1). Cassino declara feFtdSaldoBonus + feFtdSaldoBonusCassino.

Vera — Header, Footer e Visual​

• Header reescrito — single-row, scroll-aware, cluster com skew. Novos componentes CtaButtonVera e CtaButtonSecondary, HeaderUserAreaVera, hook useScrolledPast. GameCardVera agora usa CtaButton id="game-card-play" visualOnly em vez de <span> hardcoded — herda variant cta-vera da brand e mantém consistência com Cadastrar/Depositar. Overlay de hover ganhou pointer-events-none para preservar o click do <Link> pai.
• Footer full-width — nova flag structure.footerFullWidth (default false); quando ativa, o footer escapa do contentContainer e renderiza como sibling viewport-wide nos shells header-top e split-shell. Vera ativa a flag para alinhar com o header.
• Tom de verde alinhado entre header e footer — bg-primary da Vera passou de #0e1d21 para #003628 (= header.main-bg), button-bg foi para #026455 (= header.balance-bg) para manter contraste das pílulas mobile.
• Gradient unificado em sidebar e maiores ganhos — SidebarTitledSection e WinsListHeader (Vera) trocaram primary (#06e05b neon) por header-balance-bg (#026455 teal-green), eliminando dissonância visual com os cards do "Pagou Muito". Outras brands não consomem essas surfaces.
• Footer sem grupo "amigos verabet" — campaign API e widget atualizados para remover o grupo descontinuado; widget campaign-widget continua ativo para os demais grupos.
• Indique e Ganhe — porta da página /games/indique-ganhe do legado para o LP system: rota canônica /lp/indique-ganhe com redirect 301 da URL antiga (preserva backlinks externos do Telegram, Instagram e WhatsApp). Inclui banner CDN, hero com CTA "Acessar meu código" → /user/refers, seção "Como funciona" com 3 passos, grid de 6 jogos populares (família Fortune do PG Soft + Touro/Macaco Sortudo da Pragmatic) e CTA secundário no fim.
• Link de download canônico do app — novo override brand.appearance.links aplicado em DefaultLayout antes do BrandProvider montar. Vera força https://play.google.com/store/apps/details?id=br.bet.vera.twa.apk&hl=pt_BR para todos os consumers (FooterBadges, SidebarBottomItems, useAppInstall, InstallAppTooltip) — corrige URLs stale vindas do BFF. Brands sem override têm zero overhead.

Analytics — view_item_list e GTM​

• Tracking GA4 view_item_list no primeiro scroll-into-view — novo hook useOnFirstScrollIntoView instrumenta GameSection, TournamentsSection, WinsCombinedWidget, HomeBannerCarousel, MainLeaguesWidget, RecommendedGamesBento e TopGamesSection. item_list_name segue o título da row (Vera: "Jogos de Cassino Recomendados", fallback "Jogos Recomendados"). Items mapeados pelo banner.action + banner.alt.
• Helpers de métricas centralizados — novo app/utils/metrics/index.ts + ampliação de app/utils/metrics/gtm.ts para suportar o evento.

Cookie Consent — Modo Cosmético​

• Nova flag cookieConsentCosmeticOnly — quando true, o banner continua renderizando visualmente (cumprir compliance), mas NÃO gateia tracking: o initGTM injeta acceptAll como Google Consent Mode v2 default (zero janela cega entre carregamento do GTM e clique), e qualquer caminho de clique (Aceitar / Recusar / Salvar personalizado) converge para acceptAll no cookie cookies_consent e no signal de update. Os toggles do painel "Personalizar" continuam visíveis mas sem efeito real. Pré-requisito: brand.features.cookieConsentPopup (BFF) precisa estar true. Ativada em 7k-bet-br, fi-7k-bet, ng-7k-bet, cl-bet7k-com, cassino-bet-br e vera-bet-br por decisão conjunta de marketing + compliance. Demais brands preservam o comportamento legado (consent real respeitado).

Sports — Gate de Validação Real-Time​

• Novo componente ValidationContextGate — gate que bloqueia o iframe de esportes quando o usuário tem KYC pendente, lendo o contexto sports do fetchAllValidations() em real-time.
• Bottom nav mobile não some mais quando o modal de validação é dispensado — setFullscreenOpen(true) foi movido para dentro de startGameRequest em GameIframe.tsx. Antes, ao clicar em "Jogar" e fechar o modal de KYC sem completar, o estado gameFullscreenOpen ficava preso em true e a bottom nav permanecia escondida até a próxima navegação.

Detail Page de Jogos — Stats Alinhados com a Home​

• high-payers vira fonte autoritativa para valores monetários — o widget "Pagou muito" (home) consome /bff/games/game-high-payers-dl (totalPaid por janela), enquanto o detail page consumia /bff/games/statistics-dl (last24Hours.wins, last1Hour.wins). As duas APIs têm pipelines de cálculo independentes no BI e divergiam sutilmente. Agora o getStats(slug) server-side, depois de buscar stats, consulta getHighPayers() (já cacheado por brand via platform-cache) e sobrescreve last24Hours.wins e last1Hour.wins quando o slug está no top-N. Jogos fora do top-N caem no fallback. Custo zero de chamada extra. Try/catch silencioso garante que o detail page nunca quebra por isso.

Proteção de Conta — Acordeões​

• Botões de "Alternativas à exclusão" agora abrem o acordeão alvo — port do forceOpenAccordion do legado Vera. Antes os 4 botões (Pausar 7d, Pausar 30d, Manter com limite aposta, Manter com limite depósito) só faziam scrollIntoView; o usuário chegava lá e tinha que clicar de novo. Agora um novo store useProtectionStore com forceOpenAccordion(id) é ouvido pelo LimitAccordion, que auto-abre + scrolla quando o id bate. Store reseta em 1s para permitir re-clicar no mesmo botão. Adicionado também o botão "Falar com suporte" quando hasLiveSupport (paridade com legado).

Cassino — Mobile Bottom Nav​

• Variant mobile-nav-fab-center restaurada no cassino-bet-br — após experimento com mobile-nav-illustrated-tabs, o cassino volta para o FAB "Depositar" flutuante no centro. Ordem: Menu · Cassino · [FAB] · Cassino Ao Vivo · Esportes. Ícones herdam INTENT_DEFAULTS (Dices, MonitorPlay, Soccer), paths via routeHref() respeitam overrides da brand.
• Refinamentos no primitive compartilhado — FabButton sai menos do topo da barra (translate-y-1/4 ancorado em -top-2), label "Depositar" em font-bold, pulse suave (animate-promo-pulse) aplicado só no ícone interno. NavTile ganhou gap-1.5 (de gap-0.5) para mais respiro entre ícone e label. Afeta todos os variants do mobile bottom nav.

TWA — Digital Asset Links​

• assetlinks.json restaurado para 7k-bet-br, cassino-bet-br e vera-bet-br — portado dos repos Vue legados para overrides/<brand>/public/.well-known/. Sem esses arquivos os TWAs Android perdem modo url-bar-hidden, Smart Lock (common.get_login_creds) e a permissão common.use_as_origin do Smartico. Placeholders dos 10 repos base-* legados (com package_name vazio) intencionalmente não foram portados — falham na validação DAL do Google e seriam piores que 404. Smoke-tested via pnpm dev --<brand> --port 5185; state77 confirmou 404 como negative control.

Brand Overrides​

• vera-bet-br — campaign API — atualização da configuração do strategy.ts (com testes para Mini Games standalone) e ajuste do trigger de registro do mini-game. Widget campaign-widget permanece ativo após remoção do grupo descontinuado.
• vera-bet-br — promocode — refactor removendo o estado de feedback e mensagens inline da PromocodePageContent em preparação para integração via SDK.
• vera-bet-br — UI tweaks — ajustes no badge dos cards de torneio (TournamentCardClassic/Stacked), label dos top-games, hint de quick-access e visual do gift no campaign-widget.

Core / SDK​

• @cactus-agents/validations — cobertura do gate de esportes — três casos novos em evaluate.test.ts validam contexts.sports = { allowed: false, pendingModule: "kyc" } quando a brand declara sports.active=true, modules=["kyc"] e o usuário não tem KYC aprovado. Inclui também: liberado pós-login com KYC aprovado e undefined quando a brand opta out via sports.active=false. Regressão necessária para o novo ValidationContextGate do base.
• Limpeza de 16 warnings do Biome no core — sem mudança funcional. noNonNullAssertion (13 casos em testes do accounts) silenciado via override de biome.json para **/__tests__/** (! é uso legítimo em tests). noExplicitAny em platform-cache/engine.ts resolvido trocando Map<string, Promise<CacheResult<any>>> por CacheResult<unknown> (call-sites já fazem as Promise<CacheResult<T>>). Suppressions órfãos removidos em api-client/server.ts. Verificado: pnpm lint, pnpm check, pnpm build (20/20) e pnpm test (409+ casos) todos passando.

Ops​

• Branches default padronizadas para main-ana — múltiplos workflows de deploy do front-ops ajustados para consumir main-ana em vários ambientes (paridade da convenção de naming).

• @cactus-agents/games 2.0.0 — CASSINO_MODE=front_custom deixou de existir. Antes desta data havia 3 modes (legacy, api_new, front_custom); agora são apenas 2 (legacy, api_new). O front_custom era usado só pelo sandbox interno stage1 — stage1 migrou pra legacy e nenhuma brand de cliente consumia o mode. Em vez de manter código morto como surface area pública, o package removeu de vez.
• Exports públicos removidos: createCustomCategoriesGamesFromClient, createCustomCategoriesGamesService, CustomCategoriesGamesOptions, CustomCategoryDef, CustomCategoriesConfig, CustomCategorySource, filterExplicitCategory, resolveCategoryGames, customCategoryDefToRaw. Tipo LegacyHomeRowConfig.type deixou de aceitar "custom-category".
• Sobrevive intacto: HomeRow.type runtime ainda inclui "custom-category" / "custom-section" — esses são emitidos pelo BFF page pipeline em legacy e api_new e continuam funcionando. Curadoria por overlay (categories.personalize.ts) também continua válida nos dois modes.
• Refactor interno: src/custom-categories.ts virou src/stats-ordering.ts; orderByStats, CustomCategoryOrderBy, DisplayPriority, StatDisplayKey continuam exportados do root do package (API pública preservada).
• Documentação atualizada em conjunto: docs-internal/template/env-vars.md, docs-internal/template/games.md, docs-internal/forking/override-files.md, docs-external/customization/games.md e docs-external/deployment/environment.md reescritos para descrever apenas os 2 modes restantes. CASSINO_FRONT_CUSTOM_BASE removido das tabelas de env vars; regra de "paridade obrigatória" pra .new.ts/.custom.ts foi droppada (não existem mais). Guia de personalização aponta agora pra categories.personalize.ts em vez de categories.custom.ts.

Busca — Diacritic-insensitive​

• filterGames agora ignora diacríticos simetricamente. Buscar "aviao" (sem acento) retorna "aviãozinho"; "cabeca" bate com "cabeça"; cedilha, til, agudo, grave, circunflexo, trema cobertos sem custo de manutenção por caractere. Cobre português, espanhol, francês, alemão e qualquer diacrítico do bloco combining Unicode.
• Estratégia canônica: normalize("NFD") separa caractere base do diacrítico, regex [\u0300-\u036f] remove os combining marks. normalize é nativo C++ em V8 — overhead de ~5ms pra ~10k normalizações por query (2k jogos × 5 tags), imperceptível.
• Helper foldForSearch(s) exportado pelo package @cactus-agents/games — consumido pelo base nas páginas de categoria/provedor/mini-games onde a busca é client-side local (fora do filterGames), garantindo paridade com a search global.
• 9 testes novos cobrindo: sem acento → com acento, com acento → sem acento, cedilha nos dois lados, til em nome + provider, case + diacrítico combinados, filter tags separado.

Page Rows — Multi-página vindo do BFF​

• Novo método getPageRows(page) na GamesService bate em 3 endpoints canônicos curados por brand via ORIGIN_DOMAIN: GET /casino-games/page/home, /casino-games/page/cassino, /casino-games/page/cassino_live. Substitui a necessidade de hardcoded row configs no base — backend vira fonte única de ordem, widgets e curadoria per-brand.
• PageSlug = "home" | "cassino" | "cassino_live" exportado. createGamesService (api_new) implementa direto; createLegacyGamesService delega "home" pro getHome() legado e dá throw nos outros (rowsConfig[page] cobre os demais em legacy mode).
• Non-breaking em wire-level: bases antigos bumpando o package continuam chamando os mesmos endpoints. getHome() segue intocado e marcado @deprecated com TODO de remoção pra quando dev → main/stage/prod for mergeado.

Tracking de Marketing — Deposit ganha paridade total​

• POST /wallet/add-credit agora forwarda todo o sinal de atribuição que o legado Vue mandava, não só o subset que o Register já enviava:
  • src propagado no deposit (antes era register-only);
  • subid (affiliate sub-id);
  • utmExtras — wildcard utm_* (utm_oferta, utm_term, utm_placement, …) emitido flat no body;
  • cada clicked-id como campo individual: gclid, fbclid, ttclid, gbraid, wbraid, msclkid, mgclid, tclid, kwclid, obclid (paridade 7k/vera-new);
  • par derivado mediaSource / mediaClid (paridade bullsbet/jogao/mcgames).
• Dois schemas em paralelo: os dois shapes (campos individuais E media_source+media_clid) são forwardados juntos porque diferentes BFF handlers de brand leem um ou outro. Garante atribuição independente do handler ativo.
• Backward-compatible: todos os campos novos são opcionais — callers existentes mantêm o payload anterior intacto.

Vera-bet-br — Paridade visual com legado​

• Refatora pesada (vera-layout-legacy-parity) aproxima a vera-bet-br do legado preservando a dinamicidade e reuso por config. Todas as flags novas são opt-in, zero impacto nas outras 13 brands.
• Infra nova reutilizável:
  • SidebarLayoutConfig.scrollBehavior: "sticky" | "page" — sidebar pode rolar junto com a página (vera) ou continuar sticky (default das demais);
  • LayoutStructureConfig.contentContainer: "full" | "contained" — linha sidebar+main+rightPanel centralizada em max-w-content (vera) ou full-width viewport (default);
  • featuresConfig.homeRightPane: "wins-list" | null — home ganha coluna direita em xl+ via HomeWinsRightColumn (não-sticky, dentro do flow);
  • featuresConfig.homeRightPaneAboveSplit: number — quantas rows sobem full-width no topo antes do split 2-col começar (banners fora do split);
  • featuresConfig.showMobileSidebarToggle: boolean — hamburger também no mobile no HeaderDefault (vera=true).
• Novo variant sidebar-sectioned-titled — headers com gradient glow primário + pill "VER TODOS" + items com decoração diagonal + suporte a "titled" style no SidebarBottomItems (Outros Links).
• Cleanup: variante right-panel-winners removida (única consumer era vera, agora usa HomeWinsRightColumn); RightPanelVariantKey vira never mas a slot infra fica intacta pra futuras brands. WinsListHeader + WinListCard extraídos pra components/home/wins-shared.tsx.
• Propagação obrigatória: homeRightPane: null + homeRightPaneAboveSplit: 0 adicionados em todas as 13 outras brands seguindo a regra de overrides file-replacement (sem deep-merge).
• Outros ajustes vera: novo vera SectionTitle variant replicando os títulos de row do legado; logo compacto V-only no mobile pequeno (<640px); GameCard variant vera específico; hamburger movido do header pro bottom-nav (drop V spike); top-games card com 2 linhas mínimas reservadas pro título evitar reflow.

Cassino-bet-br — Header + sidebar repaginados​

• sidebar-tabbed — novo variant com tabs casino/sports no topo, auto-seleção route-aware, e square colapsável que alterna tabs no clique (ícones mdi/cards + mdi/soccer + dots indicator). SidebarPillItem + SidebarBottomItems ganham prop opt-in hideChevron (default mantido nos outros variants). Brand activa via composition.ts em split-shell + sidebar-tabbed, matchando a macro-arquitetura do 7k.
• header-split-bar + header-secondary-flat — dois headers genéricos novos. O split-bar tem logo+hamburger à esquerda da row centralizada, busca compacta 320px borderless à direita (h-9 igual aos botões, expande pra 380px no focus via focus-within), quick-access menu (+), 68px desktop height. O secondary-flat é uma submenu row transparente com hairline bottom border full-width, pills com fill sutil em rest e bg-primary/20 no active (sem ring/glow), isSecondaryNavLinkActive com longest-prefix-wins dedup.
• Wiring cassino-bet-br: topbar notification desligada; widget search-field removido das home rows (header agora owna a busca); botões Entrar (ghost cyan) e Cadastrar (filled blue) com hierarquia clara; novo header-secondary-nav.ts (5 casino + 6 sports) + quick-access-menu.ts (6 intents, paridade 7k); theme sidebar.button-bg migra de gray #3f4142 pra navy #18436e.
• Mobile-nav illustrated tabs: novo variant mobile-nav-illustrated-tabs com tabs ilustradas, ativado na cassino-bet-br.
• Sidebar-buttons CTA Mini Games Diários — colored variant ganha emoji icon slot e nova strategy específica.
• Pix — bancos individuais: disable Pix grouping na cassino-bet-br pra mostrar cards individuais por banco em vez de agrupar.
• Login modal: texto legal específico cassino-bet-br adicionado.
• Top Ganhos: seção migrada do legado com card style brand-configurable.
• Fix /buscar: InternalNavBar movido pra fora do max-w-content wrapper em /buscar e /buscar/all — antes ficava clipped (bottom border full-width recortada). Fix é brand-agnostic, beneficia todas as brands.

Vera FTD — Paridade total com legado​

• Anúncio "Garanta sua diversão!" (variant checkin) — novo FtdCheckinAnnouncementProvider global, gated por ftdCashback.modalVariant === "vera-legacy" + useFtdCheckinAccess().canAccess. Once-per-session via sessionStorage; logout limpa flag; CTA "FAZER CHECK-IN" abre o panel diário existente.
• Flash-offer com visual legacy vera (flash-offer) — FtdOfferConfig.modalVariant?: "default" | "vera-legacy" opt-in pra renderizar FtdOfferModalContainer + thumb/trigger paridade pixel-perfect. Ports 1:1 do legado: FtdOfferFloatingTrigger (de FloatingTrigger.vue) e FtdOfferStoryThumbLegacy (cronômetro CDN + pill verde sobreposta) usado em widgetMode: "stories-first".
• Config vera 1:1 com Login.vue legado: ftdOffer enabled + vera-legacy + stories-first + storyThumb CDN; autoDepositModal: { minBalanceCents: 10, intervalMs: 0 } replicando walletReal < 0.1 + sessionStorage showDepositModalHome.
• Util app/utils/ftd-offer.ts — port de resolveOfferVariant, OFFER_EVENT_MAP e formatOfferCountdown pra orchestrator unificado futuro.

Outras Features​

• Página /promocode portada do legado vera/7k.
• Mobile-nav auth-gate — itens user-specific (rewards, missions, etc.) abrem o login modal em vez de navegar quando o usuário está deslogado.
• SEO hreflang ativado pra 7k-bet-br, cassino-bet-br e vera-bet-br + brands adicionais (compliance SEO geral).
• Favicon Google-compliant — sizes em múltiplos de 48 pra renderizar corretamente nos resultados de busca do Google.
• Diamond Stories — suporte ao variant diamond-neon no widget de stories da home.

Fixes​

• VerticalMarquee — container clamped pro setHeight pra loop infinito ficar seamless (antes "pulava" ao reciclar).
• Sidebar titled-section — gradient escopado só pro header (antes vazava); spacing tweaks (mb-4, w-full no gradient, mt-2 no content).
• Wins trophy — top offset reduzido pra impedir crop do troféu no card.

Brand Overrides​

• vera-bet-br: repaginação completa (vide seção dedicada acima) — composition sidebar-sectioned-titled + scrollBehavior: "page" + contentContainer: "contained", widths 230/70px, rightPanel removido, FTD legacy parity, GameCard variant próprio, logo compacto mobile, hamburger no bottom-nav, section-title variant próprio.
• cassino-bet-br: split-shell + sidebar-tabbed + header-split-bar + header-secondary-flat + mobile-nav-illustrated-tabs, theme sidebar.button-bg migrado pra navy, sidebar-buttons unificado em gradient navy (#2a74bd → #0a2140) com pattern fade-to-near-black-same-hue, Pix banks individuais, Top Ganhos card brand-configurable, login legal text.
• 7k-bet-br: SEO hreflang ativado.
• Demais 13 brands: homeRightPane: null + homeRightPaneAboveSplit: 0 propagados (regra file-replacement de overrides — Critical Rules).

Core / SDK​

• @cactus-agents/games 2.0.0 — breaking: remove CASSINO_MODE=front_custom; non-breaking: getPageRows(page) + foldForSearch + busca diacritic-insensitive em filterGames. Documentação cleanup em paralelo no front-cactus-docs (commit f675d0c).
• @cactus-agents/payments — buildDepositPayload agora forwarda src, subid, utmExtras wildcard, todos os clicked-ids individuais e o par derivado mediaSource/mediaClid. Backward-compatible: campos novos opcionais.

Gamificação — Revamp 7k​

• Cards de missão e torneio completamente revisados nas variantes classic e stacked para 7k-bet-br/fi-7k-bet/ng-7k-bet, com novos visuais, badges de status e progresso refinado.
• Modal de detalhe da missão (MissionDetailModal) ganhou layout novo com seção de prêmios, regras de elegibilidade e CTA de inscrição/reivindicação.
• Tela de torneio (tournaments.$id.tsx) reescrita: novo TournamentHero, RegistrationCTA com estados expandidos, TournamentStatsCarousel e tournament-internals consolidados.
• LevelsSection ajustada e página vip/levels.tsx reorganizada para refletir a hierarquia de níveis VIP do 7k.
• Smartico Initializer atualizado para integrar com o novo fluxo de claim e pending_claim exposto pelo SDK.
• Configs de brand (gamification.ts, widgets/mission-card.ts, widgets/tournament-card.ts) propagadas nos três overrides 7k para refletir o novo visual.

Brand Overrides — Vera-bet-br (paridade visual com legado)​

• Home Vera ganhou painel de "biggest wins", menu horizontal com imagens, menu de acesso rápido e bloco de conteúdo SEO — replicando o layout do legado Nuxt (PRs #517–#520).
• Top games e mobile nav com tweaks de tiles em grid e ajustes nos thumbs do destaque (PRs #523–#524); banner do meio em mobile removido (#531).
• Topbar notifications desativadas para a Vera via flag de brand (#521); CDN legado configurado para servir assets de imagem da brand (#525).
• Fluxo FTD completo portado do 7k para a Vera: oferta de FTD, modais de cashback legados, check-in de bônus com mock + flags e autoDeposit integrado ao Smartico (PRs #530, #532, #534).
• Pagamentos Vera — exibição dos bancos suportados na tela de saque/depósito ajustada à identidade visual da brand (#544).

Brand Overrides — Cassino-bet-br​

• Top games com watermark compacto — variante visual mais discreta que reaproveita melhor o espaço do thumb (#526).
• Banner da home com side CTAs — slides aceitam botões laterais opcionais e tipografia ajustada para destaque do CTA principal (#529).
• GameCardActions — ações inline no card (favoritar, jogar, info) com layout dedicado ao tema cassino (#539).
• Section title neon — variante de título de seção com efeito neon, alinhada à identidade visual (#540).
• Home leagues circle gradient — widget de ligas esportivas com fundo circular em gradient (#543).

Brand Overrides — 7k-bet-br​

• Sidebar Spaceman — botão dedicado ao jogo Spaceman adicionado à sidebar do 7k (#533).
• Botão de promoções no header controlado por feature flag, permitindo brands ligar/desligar individualmente (#522).

Cassino / Jogos​

• Mini-games iframe — pontos de acesso novos (rotas/links) para o iframe de mini-games em stage (#546).
• game-stats-resolve — fallback adicional na resolução de estatísticas para evitar valores zerados quando tags chegam em formato inesperado (PR #562 / main-fix).

Proteção de Conta​

• Cache de limites revalidado após alteração — ao salvar um novo limite a UI agora reflete o estado correto sem exigir reload manual (#541).
• Mensagem de erro de proteção ajustada para exibir o motivo do BFF de forma legível em vez de fallback genérico (#551).
• Auto-exclusão via chat de suporte — fluxo dedicado que encaminha o usuário ao atendimento humano em casos de timeout/self-exclusion (#536).
• Salvar dados pessoais — feedback de sucesso/erro corrigido na tela de conta (#557).

Performance e Layout​

• Bundle size audit — auditoria de tamanho de bundle aplicada em rotas críticas, com remoção de imports redundantes e ajustes de code-splitting (#549).
• Service worker cache 206 + RA reputation race — corrige resposta parcial (HTTP 206) sendo cacheada pelo SW e race condition na inicialização do RA reputation script (#554).

Core / SDK​

• @cactus-agents/games — High Payers (#162): novo recurso de jogos "que mais pagam" com tipos, transforms e métodos no service/legacy-service/custom-service. 128 linhas de testes em transform.test.ts.
• @cactus-agents/games — Normalize tags (#165): normalização de tags de jogo + melhorias na resolução de métricas (game.metric), exposto novo helper no index.ts.
• @cactus-agents/gamification (#164): novos utilitários level-utils, mission-utils e tournament-utils, além de pending_claim e expansão dos i18n keys de gamificação nos 4 idiomas (pt-br, pt, es, en) — base do revamp 7k no front.
• @cactus-agents/platform-cache (#163): removido o structured log cache_decision do engine — reduz volume de logs em produção sem perder o single-flight test essencial.

Infra / CI​

• Sync de assets para R2 — script scripts/sync-assets-r2.mjs adicionado ao base (via main-7k-merge) para envio de assets via API S3-compatible da Cloudflare R2; complementado no front-ops com workflow de envio + assets bluetec no R2.
• wrangler.toml atualizado para expor o binding do bucket R2 no Worker, e workers/middleware.ts ganhou rota para servir assets do R2 quando aplicável.
• front-ops — branch de performance ativada em testes para state77-com antes do rollout completo.

Maior entregável do dia. A branch stage-ftd aterrissou três fluxos completos de retenção/conversão D0, todos brand-configuráveis e cobertos por testes:

• FTD Offer ("Oferta Relâmpago") — modal + floating widget + story thumb com Quick Deposit embutido. Componentes em app/components/ftd-offer/ (Provider, Modal, FloatingWidget, StoryThumb), storage isolado por marca em ftd-offer-storage.ts e analytics em ftd-offer-analytics.ts.
• FTD Cashback — fluxo D0 com modal de oferta inicial (FtdCashbackFirstModal), modal de prêmio (FtdCashbackPrizeModal), Provider, dev panel, scaffolding de tiers (ftd-cashback-tiers.ts) e persistência local (ftd-cashback-storage.ts). Testes cobrem storage e cálculo de tiers.
• FTD Check-in — daily check-in com mock fixture, logs diagnósticos, special offers, label "done today" e kill switch via feature flag remota da brand 7k (feat/ftd-checkin-7k-feature-flags). Componentes Checkin, CheckinTrigger, CheckinStoreOffers.
• Loop de reabertura corrigido — useFtdCashbackFlow ganha guard pra não reabrir o first-modal logo depois do close (PR #485, fix/ftd-cashback-first-modal-loop).

Busca Unificada (feat/search-unified-refactor)​

Refatoração grande da busca: header e página passam a compartilhar input + estado, com nova rota de resultados completos:

• HeaderSearchInput novo (substitui HeaderSearchTrigger) embeded direto no header, com hook useHeaderHasEmbeddedSearch pra evitar duplicação.
• Estados IdleState e ResultsState isolados em app/components/search/, alimentados por novo store Zustand (app/store/search.ts) com testes dedicados.
• useRecentSearches novo hook com persistência client-side e suíte de testes.
• Rota /search/all nova pra full results, separada da busca interativa.
• Idle rows turbinadas com popular-terms configurável e chips reaproveitáveis.
• Sync de query param via useSearchParamSync mantém a URL coerente com o input.

Cassino / Jogos​

• Refac de cents nas estatísticas (#461 + #473) — novo hook useStatsFormatMoney, feature flag hideStatsCents propagada pra todas as 13 brands, e refinamento posterior restringindo o opt-in apenas aos componentes menores (GameStats, GameWinners, GameIframe, LazyWinnersSection, WinsCarousel). 7k-bet-br ativa o flag.
• Padronização de páginas de catálogo (#476) — GamesPageHeader, GamesFilterBar e ProvidersGrid passam a compartilhar header + container entre category.$slug, providers.$slug e providers._index.
• Top Games legacy-grid (vera-bet-br) (#400) — nova variante TopGameCardLegacyGrid no widget de top-games, mais um bento RecommendedGamesBento, registry expandido e config dedicada em overrides/vera-bet-br/app/config/widgets/top-games.ts.
• Linhas vazias colapsam (#474) — DeferredHomeRow agora detecta widgets que retornam null e remove o wrapper, eliminando phantom flex gap nas páginas /, /games e /games/live.
• Favoritos e recents on-demand (#479) — fim das requests globais no _layout.tsx. useFavorites busca por contexto (home, sheets, search), novo hook useFavoritesAuthSync, novo recents.server.ts e useRecentlyPlayedSeed simplificado. Reduz overhead de cold-start em todas as páginas.

Pagamentos​

• PIX random-key: EVP → RANDOM (#472) — nome canônico corrigido em PixKeySelector, PixSection, tipo account-features e propagado pras 13 brands. Kanban 14a0b719.
• Bancos explícitos no 7k-bet-br (#483) — desativada a agregação "Pix" no methods.ts da 7k; cada banco aparece individualmente.
• Deposit modal polish (#475) — banner do FirstDepositBonusBanner ganha cor consistente e CTA do CtaButtonSignature desabilitado quando o estado é inválido.

Auth e Telefone​

• Textos legais config-driven no LoginModal (#491) — novo componente AuthLegalTexts lê de app/config/auth/legal-texts.ts (override em overrides/7k-bet-br/), substituindo strings hardcoded.
• Phone save desabilitado quando não há mudança (#503) — PhoneSection e PhoneStep comparam state inicial vs atual antes de habilitar o save.
• lockDdiSelection honrado em todos os fluxos de telefone (#506) — flag finalmente respeitada também no edit de account e no step de validação. Brand fi-7k-bet ativa.

UI / Mobile / Carousels​

• Edge-to-edge mobile + lateral fade (#489 + #509) — Carousel e Marquee ganham scroll edge-to-edge no mobile e a borda de fade lateral vira opt-in. A relação entre os dois flags foi consolidada: edge-to-edge só aplica quando o fade está desabilitado, evitando combinações estranhas.
• Lateral fade desligado nos 7k variants (#512) — cl-bet7k-com, fi-7k-bet e ng-7k-bet desativam o fade no mobile.
• Modal mobile sem botão de fechar (#486) — Modal esconde o close-button no mobile (gesture-driven), preservando-o no desktop.
• Sidebar dos 7k: "Aviator" → "Aviator Crash" (#490) — label corrigido no override da 7k-bet-br.
• Minigames sidebar/strategy (#513) — StrategyOverlay e useStrategyAuthTrigger ganham flag hasFtd propagada pelo store; novo helper ftd-encrypted-id.ts substitui parte de campaign-widget-url.ts.
• Refac do CampaignWidget (#515) — iframe handling agora roda via strategy nomeada (app/utils/strategy/iframe.ts); app/utils/campaign-widget-url.ts deletado, lógica e testes migrados pro namespace de strategy. Override da cassino-bet-br e vera-bet-br ganham app/config/strategy/strategy.ts. Limpeza líquida de ~120 linhas.

SEO e Redirects Legados​

• Separador de título "|" → "–" (#484) — padronização em FAQ, page descriptions, games-seo, sports-seo e game-details. Aplicado no base e em todos os overrides (7k, betpontobet, cassino, vera).
• Canonical/og:url no sports respeita rota localizada (#449) — sports/$.tsx e sports/_index.tsx agora usam routeHref() em vez de path hardcoded; tipo sports-seo.ts ajustado e configs de cada brand limpas.
• 301s pra rotas Nuxt legadas (#446) — app/config/routes/legacy-redirects.ts ganha entradas adicionais; legacy-redirect.ts cobre o catchall de sports.

Gamificação / Recompensas​

• Data real de expiração nos rewards expirados (#477) — RewardCard deixa de mostrar "expirado" sem data; usa o timestamp original.
• Bottom notification de download do app no 7k (#471) — BottomNotification ganha suporte a navegação externa pra LP; entry.client.tsx integra; override da 7k-bet-br aponta o link.

Brand Overrides​

• Alinhamento visual fi/ng/cl-bet7k com 7k-bet-br (#492) — entrega massiva: cl-bet7k-com, fi-7k-bet e ng-7k-bet ganham FAQ próprio (faq.server.ts), composition do layout, menu, theme sizes, header secondary nav, sidebar, footer-stacked heart row, e widgets (campaign-widget, featured-game, footer-socials, game-card, post-card, sidebar-buttons). Inclui assets novos (destaque-aviator.svg, exclusivo.svg, thumbnails).
• Stories alinhadas + busca removida da home (fi/ng-7k-bet) (#502) — fi e ng espelham a config de stories da cl, atualizam new-badge.png e removem a row de busca de home-rows.{custom,legacy,new}.ts.
• Banner home responsivo no vera-bet-br (#500) — HomeBannerCarousel ganha tipo home-banner ampliado com sizes responsivos por breakpoint; portado direto do legado.
• Painel de providers no vera-bet-br (#504) — novo ProviderCardBare + variant "panel" no ProvidersCarousel, com config providers-section.ts no base e override no vera reproduzindo o visual legado.

Core / SDK​

• @cactus-agents/i18n — nova chave casino:search.search_providers adicionada nos 4 locales (pt-br, pt, es, en). Suporta o input de busca de providers introduzido no refac de busca unificada do base. Changeset add-search-providers-key.

i18n / Internacionalização​

• @cactus-agents/i18n recebeu 4 PRs de chaves novas no mesmo dia (#157, #158, #159, #160), todas em pt-br (autoritativo) + pt + es + en. Cada PR cobre um surface novo do base: mobile_nav.* para variantes de bottom nav, tournaments.* para a tela de detalhe, quick-access menu + side sheets, e footer-stacked.
• mobile_nav expandido (PR #157, core): de home/casino/sports/deposit/menu para 13 intents — tournaments, missions, promotions, rewards, referral, wallet, profile, store, slots, withdraw, casino_live, sports_live. Suporta os 4 variants novos do MobileBottomNav (flat, trail-cta, fab-center, illustrated) sem brand precisar declarar namespace próprio.
• tournaments.* na gamification (PR #158, core): 5 chaves para a revamp da tournament detail — information (título do stats carousel), show_more/show_less (collapse/expand das descrições e tabs), no_players/no_prizes (empty states de ranking e prêmios).
• Quick-access menu + side sheets (PR #159, core): chaves nos namespaces layout, casino e gamification para o novo widget + no header e os painéis laterais de Favoritos, Recentes e Notificações usados em 7k-bet-br e cl-bet7k-com.
• Footer-stacked (PR #160, core): 14 chaves por locale para o novo variant — col_doubts, col_vip_games, vip_*, payment_label, download_app_label, back_to_top_cta, central_atendimento. Antes os textos viviam na pasta overrides/7k-bet-br/app/locales e bloqueavam o uso compartilhado entre brands.
• ftd_offer e ftd_cashback no namespace payments (PRs #152 e #155, core): chaves para o modal de oferta FTD e o fluxo de cashback FTD (D0) — first_modal.* e prize_modal.*. PT-BR neutra e brand-agnostic; PT, ES, EN traduzidos.
• favorites.empty_* e recently_played.empty_* (PR #153, core): chaves para o EmptyRowPlaceholder quando o usuário tem favoritos/recentes vazios — labels de scroll, aria-labels do botão e variantes com sugestões ao lado.
• casino:show_filters/hide_filters (PR #438, base via bump i18n ^0.78.0): chaves para o toggle de filtros recolhíveis nas páginas de games.
• Normalização "Casino" → "Cassino" para BRA (PR #432, base): hook useCasinoNomenclature aplica regex whole-word só quando countryCode === "BRA" — corrige o fato do BFF retornar nomenclature_for_casino_games = "Casino" (com um 's') que vencia o i18n correto via fallback ||. Workaround temporário enquanto o @cactus-agents/brand.transformFeatures() está congelado; outros países (pt-PT, es-ES, en-GB) passam direto porque "Casino" é gramaticalmente correto neles.

Gamificação​

• Tournament detail revamp completo (PR #441): a rota vip/tournaments.$id.tsx passou de 304 linhas monolíticas para uma composição de 11 componentes novos em app/components/gamification/tournament-detail/ — TournamentHero, RegistrationCTA, TournamentDescription (com show_more/show_less), TournamentDetailTabs, TournamentStatsCarousel + TournamentStatCard, TournamentPrizesList + PrizeRow, TournamentRankingList, e helpers utilitários.
• Sizing dos cards de missão e torneio é configurável por brand via app/types/mission-card.ts e app/types/tournament-card.ts novos. Brands 7k-bet-br, cl-bet7k-com declararam o widgets/mission-card.ts + widgets/tournament-card.ts próprios.
• MissionCardClassic/Stacked e TournamentCardClassic/Stacked agora usam o novo primitive CtaButton em vez de implementar botão próprio — convergência visual entre cards e signature header.

UI e Componentes​

• Novo primitive CtaButton (PR #431, app/components/ui/cta-button/): substitui implementações ad-hoc de botão CTA em LoginModal, RegisterModal, GameCardClassic, GameIframe, DepositForm, HeaderUserArea e nos cards de missão/torneio. Vem em 2 variants — flat (botão sólido tradicional) e signature (estilo do botão "Depositar" do header 7k com brilho/gradient). Configurável por brand via app/config/widgets/cta-button.ts. Cobertura completa de tests (CtaButton.test.tsx, CtaButton.config.test.tsx).
• MobileBottomNav reescrito do zero como sistema de variants tipado (PR #430): o componente legado (app/components/layout/MobileBottomNav.tsx, 204 linhas) foi removido. Substituído por dispatcher + 4 variants em app/layouts/variants/mobile-bottom-nav/ — MobileBottomNavFlat (5 tiles iguais), MobileBottomNavTrailCta (4 tiles + CTA destacado à direita), MobileBottomNavFabCenter (FAB no centro estilo Material), MobileBottomNavIllustrated (tiles com ilustração). Catálogo de intents typed (intents.ts), resolver com fallback (resolve.ts), specials (specials.ts), handlers compartilhados, plus shared shells (BottomNavShell, CtaPill, FabButton, NavTile, RotatingLabel). Cobertura: resolve.test.ts (102 linhas) + variants.test.tsx (213 linhas).
• CTA de depósito alinhado entre header / mobile-nav / game fullscreen (PR #439): o CtaPill do mobile-bottom-nav e o overlay do GameIframe agora reaproveitam o variant signature do CtaButton, evitando 3 implementações divergentes do mesmo botão "Depositar".
• Filtros do cassino recolhíveis (PR #438): aplicado em /games, /games/live, /games/category/:slug e /games/providers/:slug. Novo ícone de filtro à esquerda da busca expande/recolhe o bloco de categorias e providers in-place. Mobile e desktop começam com filtros escondidos.
• Breadcrumb do detalhe de jogo (PR #434): adicionada etapa "Início" como primeiro link e listagem do provider antes do nome do jogo (Início > Provider > Jogo). app/components/layout/InternalNavBar.tsx e app/routes/games/$provider.$game.tsx.
• StoriesCircles ganha overlay de badge "NEW" (PR #453): novo campo badge em StoriesConfig controla enabled, asset e índices 1-based dos circles que recebem o ribbon. Asset padrão /assets/stories/new-badge.png é trocado pelo override overrides/<brand>/public/assets/stories/new-badge.png. Os 14 brand overrides ganharam o bloco badge preparado (enabled: false); ativado para 7k-bet-br (pt-br) e cl-bet7k-com (es) com items [1, 2].
• FavoriteButton e LastGameFloatingWidget (PR #442): correção de SVG fill handling no botão de favoritar e ajustes de layout no widget flutuante de "última jogada".
• Quick-access menu + side sheets (PR #445): novo widget + no header de 7k-bet-br e cl-bet7k-com abre painéis laterais para Favoritos, Recentes e Notificações. Adicionado widgets/quick-access-menu.ts no override do cl-bet7k-com; rotas e flags propagadas em todos os 14 brand overrides.

Cassino​

• Sidebar não roteia mais "Mines" e "Aviator" pro provider errado (PR #437): ambos estavam apontando para o provider Spribe, mas a curadoria desses jogos no catálogo Cactus é via Banana Games. Correção em app/config/layout/sidebar.ts e nos 11 brand overrides afetados.
• Item permanente "Mini Games Diários" na sidebar do 7k-bet-br (PR #440): adicionado ao sidebar-buttons config do 7k. Doc operacional nova em docs/features/strategy/overview.md cobrindo a feature.
• Rows pessoais (Favoritos / Jogados Recentemente) escondidas quando vazias (PR #436): novo flag hidePersonalRowsWhenEmpty em features.ts. Quando ativo, FavoritesRow e RecentlyPlayedRow somem da home se o usuário não tem dado em vez de mostrar empty state. Default false em todos os 14 overrides; ativado só no 7k-bet-br. Hook novo useRecentlyPlayedSlugs em app/hooks/.

Pagamentos​

• Allow-list de métodos de pagamento por brand + agrupamento de Pix providers (PR #435): app/config/payments/methods.ts e app/types/payments-config.ts novos. Brand declara quais métodos aceita; múltiplos providers de Pix são agrupados visualmente no DepositForm. Hook usePayments ganhou +83 linhas para resolver a lista permitida e o agrupamento.
• Withdraw "Valor máximo" mostra cap da casa, não saldo do usuário (PR #450): a célula "Máximo" no WithdrawForm estava puxando availableBalance do user. Trocado para o teto que a casa permite por transação — fim das confusões em saques limitados pela política do operador.

Auth​

• Kill-switch front-end disableSocialAuth (PR #457): nova flag em app/config/features/auth.ts (type em app/types/auth-features.ts). Quando ligada, o RegisterModal esconde os botões "Continuar com Google/Facebook" e o SocialAccountsSection da área de Segurança fica oculto. Propagada para os 14 brand overrides com default false.

Sports​

• Header secundário pode ser renderizado dentro do header sticky em páginas de esportes (PR #469): novo flag em LayoutConfig + suporte nos shells HeaderTopShell e SplitShell. Adicionado secondaryHeader.stickyInsideHeader ao type. Ativado no overrides/7k-bet-br/app/config/layout/composition.ts.
• useSportsAvailableHeight com ResizeObserver (PR #470): substitui o cálculo via useEffect + window.resize por observação contínua do header — o iframe do sportsbook se reajusta dinamicamente quando o header secundário muda de altura (ex: quando colapsa em scroll).
• SEO copy do sports-seo do 7k removido (PR #466): conteúdo grande de copy SEO comentado em overrides/7k-bet-br/app/config/seo/sports-seo.ts para revisão futura. Rota de sports continua respondendo, só sem o bloco.

Layout / Footer​

• Novo variant footer-stacked para 7k-bet-br (PR #454): footer reorganizado em 6 partes empilhadas — FooterStackedMain (com 4 colunas: VIP games, dúvidas, downloads, central de atendimento), FooterStackedHeartRow, FooterStackedSeals, FooterStackedSponsors, FooterStackedPaymentBar, FooterStackedBottomBar, FooterStackedLegal. Inclui novo asset public/assets/seals/google-play.png. Config nova app/config/widgets/footer-socials.ts permite brand declarar quais redes sociais aparecem no footer.
• topbarNotification agora é configurável via LayoutConfig (PR #455): adicionado em overrides/7k-bet-br/app/config/layout/composition.ts para deixar a barra de notificações controlada pelo composition em vez de hardcoded no shell.
• Logo da sidebar do 7k-bet-br (PR #452): redimensionada para 52x24 e alinhada à esquerda.

Brand Overrides​

• 7k-bet-br absorveu o grosso do dia: MobileBottomNav variant configurada, sidebar-buttons com novo intent store (item "Loja" como 5º), footer-stacked ligado, topbarNotification no composition, sports header sticky com secondary nav inside, novo widgets/strategy/strategy.ts para o item permanente "Mini Games Diários", logo da sidebar shrunk, stories badge ativado em items [1, 2], hidePersonalRowsWhenEmpty: true, widgets/footer-socials.ts declarado.
• cl-bet7k-com (chile, es): quick-access menu + side sheets ligados, widgets/quick-access-menu.ts adicionado, stories badge ativado em items [1, 2], widgets/cta-button.ts, widgets/mission-card.ts e widgets/tournament-card.ts declarados.
• Propagação file-replacement em todos os 14 overrides (regra dura do brandOverridesPlugin): hidePersonalRowsWhenEmpty: false, notificationsSheet: { enabled: true }, disableSocialAuth: false, widgets/stories.ts com badge.enabled: false, novos paths em routes/paths.ts, widgets/cta-button.ts opcionais. PR #436 documenta o resolve de conflict entre hidePersonalRowsWhenEmpty (PR atual) e notificationsSheet (stage) em todos os overrides.
• Sidebar do cassino corrigida em 11 overrides (7k-bet-br, betpontobet-bet-br, cassino-bet-br, ng-7k-bet, pb-bet, ph-state77-com, pt-state77-com, rj-bet, state77-com, vera-bet-br, x2b-bet): "Mines" e "Aviator" agora apontam para Banana Games em vez de Spribe.
• sidebar-buttons do 7k-bet-br ganhou intent store apontando para a rota canônica gamification.store com ícone ShoppingBag. SidebarButtonIntent virou união backwards-compatível — outros brands não precisam fazer nada.

Segurança​

• Bloqueio de leak cross-user de saldo via cache classification (PR #428): bump de @cactus-agents/platform-cache para 0.12.0 + 85 linhas novas de classificação no workers/middleware.ts. Endpoints sensíveis a usuário (saldo, KYC status, transações) agora são marcados explicitamente para nunca atravessar o cache compartilhado da Cloudflare Cache API; só o cache scopado por user-key passa. Resolve incident report do dia anterior onde um usuário viu saldo de outro depois de um cache hit equivocado.
• Suporte ao chat Zendesk abre instantâneo (PR #465): removido o setTimeout(..., 5000) legado do useLiveSupport que segurava o widget por 5s "esperando o script carregar". O script já tem promise própria de ready — o delay extra era redundante e quebrava o UX em sessões de suporte urgentes.

Strategy / Campaigns​

• strategy-campaign-api.client refatorado (PR #448): cliente de Campaign API trocou de fluxo imperativo (init → fetch → dispatch) para uma promise única que devolve user state + campaign manifest. app/store/strategy.ts fica mais enxuto (-26 linhas), tipos simplificados em app/types/strategy.ts. CampaignWidget.tsx consome o novo shape direto. Tests atualizados (strategy-campaign-api.client.test.ts: 192 linhas; strategy.test.ts: 71 linhas).

Core / SDK​

8 PRs no front-cactus-core no mesmo dia — uma das maiores levas dos últimos 30 dias.

• @cactus-agents/i18n ganhou 4 PRs consecutivos (#157 → 0.75.0, #158 → 0.78.x, #159 → 0.8x.0, #160 → 0.81.0). Todas as 4 keys-libraries seguem o pattern: pt-br autoritativo, pt + es + en como traduções equivalentes, brand-agnostic. As surfaces cobertas (mobile_nav expandido, tournaments detail, quick-access menu, footer-stacked) liberaram o base para parar de injetar traduções via app/locales/overrides/ (cumprindo a regra dura do AGENTS.md: traduções novas vão no core, não no base).
• @cactus-agents/payments locales (PRs #152 e #155): namespaces ftd_offer.* (4 locales × 15 keys = 60 keys) e ftd_cashback.{first_modal,prize_modal}.* adicionados ao packages/i18n/locales/{pt-br,pt,es,en}/payments.json. Alimentam o modal de oferta FTD e o fluxo de cashback FTD (D0) que o base vai shipar nos próximos dias.
• @cactus-agents/i18n com chaves de empty state pra Favoritos / Recentes (PR #153): casino.favorites.empty_scroll_label, empty_scroll_label2, empty_scroll_aria, empty_casino_aria + casino.recently_played.empty_scroll_aria. Suporta o EmptyRowPlaceholder do base nos modos com sugestões ao lado e variant botão.
• @cactus-agents/brand com guards de OTP frequente e KYC integration (PR #156): transform/features.ts ganhou +50 linhas e bateria de tests (94 linhas em brand.test.ts). A função transformFeatures agora valida e gateia módulos de OTP frequente e integração KYC vindos do BFF antes de expô-los ao base — evita que feature flag mal-configurada do admin estoure UI no front.

Infra / CI / Deploy​

• Deploy prod-7k-bet-br agora sai da branch main-7k (PR #458, base): correção em .github/workflows/ci-deploy.yml — antes apontava para main, o que casava com o staging unificado mas não com o pipeline de produção do 7k que vive numa branch separada. Sem isso, hotfixes do 7k vinham com bundle errado.

Performance — empurrão grande​

• Drop important: true do Tailwind (tailwind.config.js). Removido globalmente — precedência CSS volta ao normal (inline style vence class). Resultado: CSS −23,5KB raw (−14,4%). Componentes que usavam o pattern condicional bgStyle ? "" : "bg-..." (omitir classe quando havia inline style) foram simplificados — agora basta sempre emitir a classe que o style inline sobrescreve quando presente. Atualizados: GameCardStacked, GameStats, GameWinners, MainLeaguesSquare, SidebarButtonsGradient, SidebarButtonsGrid.
• Migração react-modal-sheet → vaul (app/components/base/Modal.tsx). Modal chunk caiu de ~158KB pra ~65KB raw — −93KB (−59%). Mesma API externa, drop-in pelos consumers. (PR #405 fez ajustes finos depois pra resolver bugs de input-focus em mobile e espaço fantasma no footer.)
• Remoção do @tailwindcss/typography. Plugin não justificava o custo — uso restrito a 4 lugares (FaqSingleContent, WpPostContent, page.$slug, vip/levels) substituído por classes utilitárias inline. package.json enxuga uma dep + 22 linhas de pnpm-lock.yaml.
• Ícones direct-imports + lazy MainLeagues (app/widgets/home-leagues/). Drop do registry intermediário — agora cada componente faz import Icon from "~icons/<set>/<name>" direto. MainLeaguesSquare virou lazy chunk separado. 25 arquivos tocados, −564 linhas vs +454. Atualiza configs de home-leagues em 7 brands (7k-bet-br, cassino-bet-br, fi-7k-bet, ng-7k-bet, pb-bet, vera-bet-br, state77-com, x2b-bet).
• CI Lighthouse manual (.github/workflows/lighthouse.yml). Workflow caller dispatchável via workflow_dispatch pra rodar Lighthouse on-demand contra preview/prod sem precisar de schedule fixo. Útil pra validar PRs pesados de UI antes de mergear.

Cache, SSR e Worker — modelo per-device/country/buildId​

PR #390 (umbrella performance → stage, 25 arquivos, +840/−172) reescreveu o middleware do Worker pra fazer cache mais inteligente:

• workers/middleware.ts ganhou +306 linhas implementando cache de SSR particionado por (device, country, bot, brand, buildId). Antes a chave de cache era global por path — agora bot crawler vê uma versão, mobile-pt-BR-7k vê outra, desktop-es-state77 vê outra. Bot detection isolado em app/utils/bot.server.ts (+24 linhas) e device detection em app/utils/device-detect.ts.
• Service Worker (public/sw.js) atualizado (+92 linhas) pra propagar a nova chave de cache no client e respeitar invalidações por buildId.
• Nova rota /api/clear-cache (app/routes/api/clear-cache.ts) pra purge manual da edge cache de uma rota específica.
• app/root.tsx ajustado com viewport correto pra acessibilidade + headers SSR alinhados ao novo modelo.

Layout — header secundário refatorado​

• Refresh do HeaderSecondaryNavButtons (PR #425) com ícones e items ricos por seção. Adicionado app/config/layout/header-secondary-nav.ts (config base) + app/utils/sports-icons.ts (registry de ícones por modalidade esportiva). useSidebarSections ajustado pra reutilizar a mesma estrutura. Tests do resolve reescritos pra cobrir os novos shapes. Brands com override próprio: state77-com, vera-bet-br.
• Route gating do headerSecondary (PR #426). O slot agora só renderiza nas rotas home, casino e sports — antes aparecia em todas as páginas, poluindo views de gamification, user, payments, etc. Resolução em app/layouts/variants/header-secondary/resolve.ts (+6 linhas) com 31 linhas de testes novos.

UI e Componentes​

• Mouse drag em tempo real + setas no hover no BannerSlide multi-scroll (PR #407). app/components/ui/Carousel.tsx ganhou +184 linhas: drag responde durante o gesto (não só no release), setas aparecem em hover do desktop, e snap continua respeitado. Brand cl-bet7k-com já liga a feature.
• Fix carousel group-hover collision (PR #410). O group do carousel disparava hover em cards filhos que também usavam group-hover — escopado pra named group (group/carousel), evitando que mover o mouse pelo carrossel ative o overlay de cards.
• Card de favoritos / recentemente jogados com call-to-action quando vazio (PR #420). EmptyRowPlaceholder ganhou variant clicável; FavoritesRow e RecentlyPlayedRow agora mostram um placeholder que leva o usuário pra adicionar jogos. Config em app/config/widgets/favorites-row.ts.
• Variants configuráveis pra TournamentCard e MissionCard (PR #406, +1059/−381). Cada card ganhou 2 variants (classic e stacked) seguindo o pattern de domain primitives (mesmo de GameCard/ProviderCard). Internals compartilhados em tournament-internals.tsx. Brand controla via app/config/widgets/tournament-card.ts + app/config/widgets/mission-card.ts. Brands 7k-bet-br e cassino-bet-br ganharam overrides próprios.
• Setas de overflow no MethodSelector de depósito/saque (PR #414). Quando há mais métodos do que cabe na faixa visível, aparecem setas pra navegar lateralmente — substitui o scroll horizontal puro.
• Título do torneio movido pra baixo do banner (PR #423) em vip/tournaments/$id — antes overlapava o banner em mobile.

Cassino / Jogos​

• Esconder search trigger do header em listings (PR #412). Em /games/category/:slug e /games/providers/:slug o ícone de search do header some, e em vez disso aparece um pill de search dentro da página (SearchPill.tsx). Mesmo comportamento em /sports/*. Centralizou a regra em app/utils/routes.ts (+24 linhas).
• Roleta do Craque Neto (PR #411, brand 7k-bet-br). Sidebar buttons ganharam suporte mais robusto a custom items — variants Colored, Gradient e Grid agora aceitam shapes ricos com mais campos opcionais. Brand 7k-bet-br adicionou item custom apontando pra /lp/craque-neto-roulette e nova strategy.ts de 21 linhas.

Pagamentos​

• Pré-seleção de shortcut default no depósito (PR #415). Ao abrir o DepositModal, o shortcut marcado como default na config da brand já vem selecionado (e o input já vem preenchido com o valor). app/types/deposit.ts ganha o flag default?: boolean. Brand 7k-bet-br configurou em overrides/7k-bet-br/app/config/payments/deposit.ts.
• Mensagem de cupom inválido limpa (PR #418). app/routes/api/payments/coupon.ts parou de propagar a mensagem raw do BFF (que vinha em inglês ou com detalhes técnicos) pro UI — agora cai num fallback i18n controlado pelo front.

SEO​

• Redirect 301 de URL com letra maiúscula → minúscula (PR #419). workers/middleware.ts (+8 linhas) detecta paths com upper-case (ex: /Casino/Slots) e responde 301 pra versão lowercase. Evita conteúdo duplicado pro Google e bate com canonical.
• og:image agora usa o ícone PWA da brand como fallback (PR #422), em vez do logo do BFF (que era visualmente fraco em previews de WhatsApp/Twitter). Mudança de 1 linha em app/routes/_layout.tsx.
• Footer: URLs do YouTube normalizadas pra www. (PR #417). Evita o 301 que o YouTube faz em links sem www, melhorando crawl e performance percebida no clique.

Auth e Recovery​

• Recovery options com botão de live support (PR #427, fix cant-recover-password). Quando o usuário não consegue receber o e-mail/SMS de recovery, o RecoverOptionsStep agora mostra um botão direto pro chat ao vivo — antes ficava num beco sem saída.

Mobile — fixes​

• Espaço fantasma no footer + revert temporário do vaul (PR #405). Modal.tsx ajustado pra não criar padding-bottom parasita no body em iOS quando aberto. app/entry.server.tsx e app/root.tsx (+76 linhas) com fixes de viewport. PR também isola bot detection em app/utils/bot.server.ts.

Brand Overrides​

• 7k-bet-br: nova landing /lp/download-app (PR #384). Página dedicada de download do APK Android com 3 backgrounds responsivos (bg-banner-desktop.png, bg-banner-mobile.png, bg-experience.png) e redirect configurado em routes/lp-redirects.ts + routes/lps.ts. 337 linhas no template da LP em routes/lps/download-app.tsx.
• release-gobbo (PR #404, +6425/−58, brand mega-bundle): integra estratégia de autenticação configurável + enhances do campaign-widget em várias brands ao mesmo tempo.
  • 7k-bet-br: novo config/strategy/strategy.ts (402 linhas), novo config/ftd-checkin/ftd-checkin.ts (14 linhas), atualiza gamification.ts e campaign-widget.ts.
  • cassino-bet-br: novo config/strategy/strategy.ts (402 linhas), gamification.ts atualizado, campaign-widget.ts (+11 linhas), novo asset mini-games-gift-icon.png.
  • vera-bet-br: novo config/strategy/strategy.ts (218 linhas), novo ftd-checkin/ftd-checkin.ts (12 linhas), campaign-widget.ts (+8 linhas), troca asset (payday.png removido, mini-games-gift-icon.png adicionado).
  • fi-7k-bet, ng-7k-bet: ajustes pequenos em campaign-widget.ts.
  • Docs internos da feature: docs/features/ftd-checkin/overview.md (366 linhas) + docs/features/strategy/overview.md (797 linhas).
• 7k-bet-br: deposit shortcut default marcado em overrides/7k-bet-br/app/config/payments/deposit.ts (PR #415, +22 linhas).
• 7k-bet-br: sidebar-buttons custom item Craque Neto + nova strategy.ts (PR #411, +40 linhas combinadas).
• state77-com, vera-bet-br: header-secondary-nav config própria (PR #425) — ambas brands declaram overrides/<brand>/app/config/layout/header-secondary-nav.ts.
• 7k-bet-br, cassino-bet-br: tournament-card e mission-card variants declaradas (PR #406).
• cl-bet7k-com: home-banner ativa o multi-scroll variant (PR #407).

Infra / CI (front-ops)​

• feat(deploy): send files to r2 — workflow de deploy ganhou step pra subir assets pro R2 da Cloudflare (+13 linhas em deploy.yml).
• feat(repos): cl-bet7k-com environment — nova entrada em repos.yml pro deploy da brand cl.bet7k.com. Cache config legada em environments/stage-cl-bet7k-com/cache.yml removida (a config nova vai inline em repos.yml).
• fix(deploy): resolve CF zone via explicit cf_zone field — o step de SSR cache purge usava origin_domain pra query GET /zones?name=, que é strict-match. Pra subdomain deploys (cl.bet7k.com, fi.7k.bet, pt.state77.com) o apex zone nunca resolvia e o purge era silenciosamente skipado. Agora cada environment declara cf_zone explícito (com fallback compound-TLD-aware: bet.br, com.br, co.uk, etc) e o workflow usa esse campo direto.
• refactor(deploy): wrangler.toml patching com BUILD_ID + runtime vars — o patch agora injeta BUILD_ID derivado do deploy ref (garante cache key invalidada a cada deploy, alinhado com o novo modelo de cache por buildId do middleware) e consolida runtime vars num único bloco [vars]. Cache policy e KV binding são apendados condicionalmente conforme disponibilidade.

• lucide-react removido por completo e substituído por unplugin-icons apoiado em três datasets Iconify (@iconify-json/lucide, @iconify-json/simple-icons, @iconify-json/mdi) mais uma coleção custom lida via FileSystemIconLoader de app/icons/custom/. Cada ícone agora resolve para um componente SVG inline em build-time — zero fetch em runtime, SSR-safe no Cloudflare Workers, e o chunk manual vendor-lucide foi descontinuado.
• API de uso por dataset: import Trophy from "~icons/lucide/trophy" para ícones genéricos de UI, ~icons/simple-icons/<name> para logos de marca (WhatsApp, Facebook, X, Instagram, TikTok), ~icons/mdi/<name> para esportes e equivalentes a emojis, e ~icons/custom/<name> para SVGs próprios em app/icons/custom/ (auto-discovered). Naming kebab-case obrigatório (AlarmClock → alarm-clock, XCircle → x-circle).
• Tipo IconComponent substitui LucideIcon em todo o codebase via app/types/icon.ts (superset de SVGProps<SVGSVGElement> com alias legacy de size). unplugin-icons não suporta a prop size do Lucide — codemod scripts/migrate-icon-size-prop.mjs converteu 471 ocorrências de size={X} para width={X} height={X}.
• Registry string-driven em app/icons/registry.ts para configs que referenciam ícones por string (ex: icon: "mdi:soccer") consumidos via <Icon name="..." /> ou <SmartIcon icon={...} /> (smart dispatch que renderiza o ícone registrado ou cai no texto literal — preserva configs legados com emoji).
• Exceções aceitáveis para SVG inline: spinners/loaders animados customizados, checkmarks de success animados, indicadores visuais brand-specific que não existem em nenhum dataset Iconify, e seals de regulação (ANJL, Anatel, Compulsafe) servidos via <img> apontando para public/assets/seals/.
• Migração automatizada via codemods em scripts/: migrate-lucide-to-unplugin-icons.mjs (converte imports nomeados em default imports kebab-case, ordenado via biome check --write), migrate-icon-size-prop.mjs (size → width/height em JSX) e migrate-emoji-icons.mjs (emoji literais → IconName registrado). Fix posterior em toKebabCase para acrônimos consecutivos (XCircle → x-circle, antes virava xcircle quebrado).

Arquitetura de Layout — Shell Architecture​

• DefaultLayout deixa de ser monolítico e vira um dispatcher que delega o macro-arrangement do viewport a um componente Shell resolvido via layoutConfig.shell. Dois shells nascem prontos: header-top (default — header full-width sticky no topo, comportamento atual de todas as brands) e split-shell (sidebar full-height à esquerda do viewport, topbar + header + main + footer empilhados na coluna direita — replica o 7k.bet.br produção).
• Quatro camadas independentes e ortogonais na composição do layout: shell (macro-arrangement), structure (colunas internas + flags on/off), slots (variant de cada peça: header, sidebar, footer, rightPanel, banner) e componentVariants (variants globais de primitivas compartilhadas). Trocar uma camada não invalida as outras — cl-bet7k-com adota split-shell mantendo slots.sidebar = "sidebar-narrow" e structure.columns = "left-main".
• Sidebars shell-agnósticas via CSS custom properties (--sidebar-top, --sidebar-h, --sidebar-w-collapsed, --sidebar-w-expanded) publicadas pelo shell ativo — qualquer variant funciona dentro de qualquer shell sem fork.
• Mobile permanece universal: independente do shell, sidebar vira drawer overlay e header sticky no topo. Shell só altera comportamento em lg+.

Sidebar Accordion (terceira variant)​

• sidebar-accordion inspirada no layout legado 7k entra como terceira opção (junto com sidebar-narrow default e sidebar-wide). Header h-[72px] com logo + toggle expand/collapse, widget SidebarButtons no topo, seções full-width como acordeões (chevron rotativo, body com grid-template-rows: 0fr → 1fr para altura auto animada) e bloco de bottom items abaixo, separados por border-t full-width.
• Comportamento route-aware: um useEffect([pathname]) abre casino e fecha sports ao navegar para rota de cassino, e o inverso para esportes. Home e rotas neutras preservam a escolha manual.
• <SidebarPillItem> compartilhado com três modos (link / external / action) e visual gradient pill alinhado ao widget SidebarButtons — renderiza accordion items, grupos aninhados (popular, top-sports) e bottom items (promotions, help center, suporte ao vivo, referral, install app, blog, FAQ).

Widgets Configuráveis (top-games, home-banner, game-card, provider-card)​

• Top-games migrado para app/widgets/top-games/ seguindo a convenção do sidebar-buttons. Tipos centralizados em app/types/top-games.ts (TopGamesRankStyle, TopGamesDecoration discriminado none | asset, TopGamesConfig, TopGamesVariantProps) e config única em app/config/widgets/top-games.ts overrideable por brand via file-replacement. Nova variant corner-diagonal replica o widget legado 7k mantendo brand-awareness via theme tokens.
• Home-banner extraído para app/widgets/home-banner/ com config HomeBannerConfig brand-overrideable. Variant single-fade (default, reusa ~/components/ui/Slideshow com 1 slide, fade, autoplay 6s, preserva o visual pré-refactor) e multi-scroll (reusa ~/components/ui/Carousel com N cards de largura fixa e scroll-snap). Dimensões propagadas via CSS custom properties consumidas por classes Tailwind arbitrary literais (w-[var(--hb-w-d)]) — JIT escaneia, runtime substitui.
• GameCard virou config-driven dispatcher (em vez de monolito de 305 linhas) com duas variants: classic (default) e stacked. Componente permanece em app/components/games/ (é primitive de domínio usado em ~9 surfaces — mover causaria churn de imports sem ganho). Tipos em app/types/game-card.ts, config em app/config/widgets/game-card.ts, variant key declarada via componentVariants.gameCard no layoutConfig.
• ProviderCard extraído do inline em ProvidersCarousel para dispatcher com variants classic (default) e logo-only. Mesma estrutura: tipos em app/types/provider-card.ts, config em app/config/widgets/provider-card.ts, variant key em componentVariants.providerCard.
• Cards de detalhe de jogo (GameStats, GameWinners) ganham per-brand decoration + gradient config via opt-in fields — sem variant system nem reorg estrutural; defaults preservam o look atual de todas as brands.

Reorganização de Configs​

• features.ts dividido por domínio: novo app/config/features/account.ts agrupa as 5 flags account-scoped (accountSetLimits, accountTimeoutLimits, pixEvpEnabled, redeemableRewards, userPreferences); novo app/config/features/auth.ts agrupa as 5 flags do fluxo de auth (registro + password recovery). Padrão para evitar inflar features.ts quando um domínio cresce.
• Notificações consolidadas em app/config/widgets/: lista ordenada de tipos ativos sai de featuresConfig.topbarNotifications / .bottomNotifications e passa a viver junto com a metadata e parâmetros em widgets/topbar-notifications.ts / widgets/bottom-notifications.ts — fim do double source-of-truth.
• Home-leagues vira widget config-driven com variants default (round avatars, agora prefere iconName brand quando declarado, country flag como fallback gracioso) e square (cards 104×144 verticais replicando o layout legado 7k — região superior diagonal com gradient, label title/subtitle em duas linhas, brand-aware via theme tokens).

Performance — Home Cold-Start​

• Loader da home filtra de getAllGames() em vez de fan-out de N chamadas paralelas getDetail para resolver favoritos. allGames já é cacheado como entry quente; 1 cache hit + Map.get por slug substitui até 30 round-trips ao BFF. Mesma migração aplicada em /favorites. FAVORITE_GAMES_RESOLVE_LIMIT na home reduzido de 30 → 15 para casar com o card count visível em FavoritesRow.
• Sugestões para FavoritesRow e RecentlyPlayed agora anon-gated. As duas rows são login-gated no render, mas o loader as computava para todos quando rowSuggestionsInEmptyStates estava true — anon SSR pagava ~200-500ms cold e ~10-20KB de payload descartado. Gate explícito.
• /api/games/by-slugs filtra de allGames em vez de fan-out de getDetail por slug — mesmo padrão da migração do loader.
• Icon registry split em duas etapas (keys-only + Icon lazy) corta SectionTitle de 142KB para 5.6KB. O registry estaticamente importava 60+ componentes SVG; qualquer um que importasse <SmartIcon> (primitive usada em 14+ componentes da home/cassino) arrastava o registry inteiro para o chunk graph.
• tailwind.config.js corrigido para incluir overrides/**/app/** no content scan — classes Tailwind usadas só em arquivos de override deixam de ser purgadas em prod.
• Bundle analyzer (ANALYZE=1) + chunk warnings mais apertados + lighthouserc adicionados para gating de regressão de performance.
• @cactus-agents/platform-cache bumpado para 0.11.0 com KV snapshots para warm tier cross-datacenter, single-flight coalescing e cache_decision logging estruturado.

Brand Overrides​

• cl-bet7k-com: ativação completa do tema legado 7k — split-shell com sidebar widths legacy, sidebar-accordion variant, header stacked com subheader route-aware, top-games corner-diagonal, home-leagues square com glyphs próprios (20 logos de liga + 3 sport glyphs importados do legado, mais SVG da Primera División chilena), provider-card logo-only, game-card stacked, decoration brandizada em GameStats e GameWinners, home-banner multi-scroll, content max-width alinhado ao 7k produção (1440px), search row da home desabilitada, topbar notifications desativadas, e migração de configs com emoji literais para ícones MDI vetoriais.
• 7k-bet-br: replica do layout/tema cl-bet7k-com aplicada à brand BR — mesmo conjunto de variants e configs. Adicionado FeaturedGameWidget exclusivo (Aviator 7K com preview animado em GIF, thumbnail desktop opcional, badge "EXCLUSIVO" SVG, ícone custom:destaque-aviator, slug banana/aviator-7k) inserido após a row de top-games em home-rows.legacy.ts. Search row da home desabilitada. CDN-CGI image proxy temporariamente desativado até stage worker ser configurado.
• betpontobet-bet-br: mantém ícones emoji intencionalmente em row e catalog configs (não migrou para MDI vetorial — decisão de brand).

Core / SDK​

• @cactus-agents/gamification ganha campo opcional smartico.exclusiveTournaments?: string[] em GamificationConfig. IDs listados são tratados como invite-only — filtrados da lista pública e exibidos apenas quando a URL carrega ?exclusive, ?premium, ?telegram ou ?whatsapp. Originalmente uma feature 7k-only do legado Vue (env SMARTICO_EXCLUSIVE_TOURNAMENTS), promovida ao SDK para qualquer brand Smartico-backed poder optar. Backward compatible (campo opcional).
• @cactus-agents/platform-cache 0.11.0 + @cactus-agents/gamification bumpados nas dependências do base.

Docs / Infra​

• Nova doc architecture/icon-system.md cobrindo a migração lucide-react → unplugin-icons, datasets disponíveis, naming kebab-case, registry string-driven, exceções aceitáveis para SVG inline e troubleshooting de codemods.
• Nova doc architecture/performance-psi.md com requisito duro de PSI (LCP, FCP, CLS, TBT) para mudanças visuais above-the-fold, checklist de CLS = 0, padrões de LCP image, valores dinâmicos via CSS custom properties + Tailwind arbitrary literal, e regra "zero carousel libs" (estender Slideshow.tsx ou Carousel.tsx em app/components/ui/).
• architecture/layout-composition.md expandido com a seção sobre as quatro camadas independentes (shell, structure, slots, componentVariants), descrições detalhadas dos shells header-top e split-shell, e papel de cada camada na composição.
• Sidebar interna ganha entradas para icon-system e performance-psi.

• Novo widget sidebar-buttons substitui o VipHighlightButton hardcoded por um sistema config-driven com catálogo typed (closed enum) de 8 intents: casino, sports, tournaments, missions, referral, rewards, mini-games, promotions. Cada intent tem rota canônica + i18n key + ícone default (Lucide) em app/widgets/sidebar-buttons/intents.ts — brand customiza só o visual (label, icon, image, color, gradient, sublabel, badge), nunca a rota. Para CTAs one-off fora do catálogo, brand usa customItems (label + href diretos); para UI dedicada, há o special sponsor-cta.
• 3 variants visuais disponíveis: colored (pilha vertical full-width com gradient diagonal — mostra bônus dinâmico do referral), gradient (pills compactas com gradient horizontal accent → muted, single-line, look 7k legado) e grid (3-col tile grid com decoration watermark, look Vera). variant: null desliga o widget na brand.
• Hierarquia de override de cor em 3 tiers: gradient: [from, to] (tupla, override completo) > color: "#hex" (só accent) > theme tokens brand-aware (bg-sidebar-button-bg). Sem override per-item, cada brand vê o widget pintado automaticamente nas suas próprias cores via tokens do tema.
• Wiring no SidebarNarrow.tsx lê sidebarButtonsConfig e delega pro <SidebarButtons />. O VipHighlightButton foi removido — não há callers remanescentes.
• Reorg do app/config/ em 14 subpastas semânticas (theme/, layout/, widgets/, sections/, catalog/, routes/, analytics/, features/, scripts/, legal/, seo/, payments/, gamification/, sports/). Imports passam a usar caminho completo sem o sufixo .config: ~/config/theme/colors, ~/config/layout/composition, ~/config/widgets/sidebar-buttons, ~/config/routes/paths. Mesmo reorg replicado nos 13 brand overrides — mantém o lookup do brandOverridesPlugin em sincronia file-replacement.
• Brand resolver compartilhado (vite-plugins/brand-resolver.mjs) consolida três blocos existsSync(overrides/...) duplicados (Vite plugin, app/router/routes.ts em vite-node, tailwind.config.js em PostCSS) em uma única source of truth: toBrandOverrideKey, findBrandOverride, resolveBrandFile.
• Asset dedup: fortune-fruits.mp4 e fortune-snake.mp4 movidos para public/assets/thumbs/ no base; cópias idênticas removidas de 6 brand overrides (validado por md5).
• Bump @cactus-agents/i18n para 0.71.0 com as keys do namespace layout:sidebar-buttons.* nos 4 locales (pt-br, pt, es, en).

Home — sugestões em rows vazias/escassas​

• Rows de Favoritos e Jogos recentes ganham fallback automático: quando o user logado tem menos de 7 itens, a row renderiza no mesmo carrossel um placeholder dashed + divisor "Sugestões" + até 10 jogos sugeridos a 50% de opacidade (sobe pra 100% no hover/focus). A row de "Jogos recentes" passa a aparecer mesmo vazia (antes sumia).
• Fonte das sugestões: getSuggestions() novo no GamesCacheService — lê catálogo completo via getAllGames(), ordena por stats cache-only (zero BFF round-trip) e filtra métrica > 0. Favoritos usa players_month (top 10), recentes usa players_today (top 10). Em cold start sem stats, completa com random seeded por dia UTC pra ordem estável dentro do mesmo dia.
• Gated pela flag opt-in rowSuggestionsInEmptyStates, ligada em vera-bet-br, 7k-bet-br, cassino-bet-br, betpontobet-bet-br, cl-bet7k-com. Default false nas demais 9 brands para não regredir visual.
• Componentes novos: EmptyRowPlaceholder (card dashed com dimensões idênticas ao GameCard — zero layout shift) e SuggestionsDivider (separador vertical "— → Sugestões → —").
• FLIP safety mantida no FavoritesRow: o cardElementsRef só registra cards de favoritos reais; sugestões não participam do reflow.
• 8 testes unit novos cobrindo getSuggestions (top-N, exclude, cold-start seed, short-circuits, métricas diferentes).

Documentação​

• Documentação do widget pattern em architecture/layout-composition.md com nova seção "Widgets — UI opcional embebida em slots". Documenta o pattern { variant: VariantKey | null, items: Item[] }, lista os 5 widgets ativos hoje (sidebar-buttons, topbar-notifications, bottom-notifications, campaign-widget, home-leagues) e detalha o catálogo de 8 intents do sidebar-buttons, as 3 variants e a hierarquia de override (gradient > color > theme tokens).
• forking/override-files.md reescrito para refletir a estrutura de 14 subpastas. Nova árvore, tabelas escopo-a-escopo e regra de file-replacement (não deep-merge) chamada explicitamente — brands não devem esperar merge parcial em overrides.
• template/layout.md ganhou tabela de Widgets + exemplo de config do sidebar-buttons mostrando uso brand-side com intent + gradient.
• Sweep de paths em 18 docs (externa + interna) apontando pra nova estrutura de subpastas: app/config/theme.config.ts → app/config/theme/colors.ts, routes.paths.ts → routes/paths.ts, layout.config.ts → layout/composition.ts, features.config.ts → features/features.ts e equivalentes nos demais escopos. Pure path sweep, sem mudança semântica.

• Substituição do InstallAppFloatingWidget por BottomNotification config-driven (app/components/layout/BottomNotification.tsx). O widget flutuante deixa de ser específico só pra "instalar app" e vira uma fila de tipos configuráveis, espelhando a arquitetura do topbar (types, store, handlers, definitions queue). O componente legado (InstallAppFloatingWidget.tsx, ~200 linhas) foi removido.
• Seis tipos de notificação suportados: download_app, push_notify, rewards_available, referral, telegram e tournament. Cada brand define quais ficam habilitados e em qual ordem de prioridade — o primeiro que passa no shouldShow renderiza, igual à lógica do topbar.
• Separação dados × runtime: app/config/bottom-notifications.config.ts carrega só dados puros (lista de enabled, rotationDelaySeconds, params por tipo) e é overrideable por brand. A lógica runtime (ícones Lucide, ctaHref/onCta, predicados shouldShow, estratégia de storage) fica em app/layouts/bottom-notification/handlers.ts — não overrideable, espelha 1:1 o buildTopbarDefinitions.
• rotationDelaySeconds configurável: com 0 (default) o swap pro próximo widget elegível é instantâneo após dismiss, igual ao topbar. Valores maiores dão um "respiro" antes do próximo slide-up.
• Revalidação reativa em auth/rewards: quando o usuário loga, desloga ou ganha um reward, a fila reavalia automaticamente (paridade com o topbar) — sem precisar navegar pra atualizar o estado do widget.

Theme Tokens & Storage​

• Novo bloco de tokens bottom-notification-* em theme.config.ts (bg, text, icon-bg, icon-text, cta-bg, cta-text, border). Registrado no tailwind.config.js e propagado pra todas as 13 brands com valores específicos, permitindo cor distinta entre topbar e bottom-notification em cada brand.
• Cookie/event/data-attr keys prefixados bottom_* (vs topbar_* da counterpart). O estado de dismiss do widget flutuante é independente do topbar — usuário fechar a notificação no rodapé não some com o topbar equivalente, e vice-versa.
• Floating stack registra só depois do slide-in (app/store/floatingStack.ts). Antes, o espaço era reservado prematuramente, o que podia empurrar layout em rotas que ainda não tinham decidido renderizar o widget.
• Pin de largura desktop em 400px (app/components/layout/BottomNotification.tsx): substitui lg:min-w-[300px] por lg:w-[400px] pro widget manter tamanho estável em desktop ao invés de crescer com o conteúdo do CTA.

i18n no Core (@cactus-agents/i18n 0.70.2)​

• Bloco layout.bottom_notification adicionado nos 4 locales (pt-br, pt, es, en) em packages/i18n/locales/<locale>/layout.json. Estrutura: close + 6 sub-blocos (download_app, push_notify, rewards_available, referral, telegram, tournament), cada um com title, subtitle e cta. Espelha o shape existente de topbar — fica trivial reaproveitar copy entre as duas superfícies.
• Variável {{appName}} preservada no título de download_app (paridade com a chave legada install_app.floating_title que já usava o pattern). Brand não precisa hard-codar o nome do app na cópia.
• Bump do consumidor: o base atualizou @cactus-agents/i18n pra 0.70.2 no commit que landa o widget — sem essa versão, o componente renderiza chaves cruas.

Brand Overrides​

• Topbar das 7k alinhada (br/fi/ng): bg mudou de #373b5b pra #282b48 (mais escuro), icon-bg virou #a1cd3d (verde brand) e icon-text foi pra #16182a em todas as três variantes 7k (7k-bet-br, fi-7k-bet, ng-7k-bet). Os 3 brands compartilham o mesmo block de tema do topbar agora.
• Config de bottom-notification propagada nas 13 brands: 7k-bet-br, betpontobet-bet-br, casateste-com, cassino-bet-br, fi-7k-bet, ng-7k-bet, pb-bet, ph-state77-com, pt-state77-com, rj-bet, state77-com, vera-bet-br e x2b-bet. Cada brand recebeu seu próprio bottom-notifications.config.ts (lista enabled espelhando a lista do topbar daquela brand), features.config.ts (8 linhas adicionais por brand) e theme.config.ts (11 linhas: tokens bottom-notification-* específicos da brand).

• Port do SEO legado (PR #352): infraestrutura completa de SEO com verificação, JSON-LD e helpers no base, descrições ricas por jogo (games-seo.server.ts) com templating de {brand_name}, conteúdo SEO + JSON-LD por liga em sports-seo.config.ts, e correções de gênero feminino nos artigos (A/Da/Na/Pela/À) para brands com nomes femininos como "vera". Bump de @cactus-agents/i18n para 0.69.0 para consumir as chaves do core ao invés de tabelas de locale inline.
• Sistema estruturado de FAQ (mesmo PR #352): rotas, componentes e helpers para FAQs, com bloco GameFaqPreview na página de detalhe do jogo e redirect do FAQ legado. FAQs populadas para 7k-bet-br, cassino-bet-br, vera-bet-br e betpontobet-bet-br (≈725-790 entradas cada em faq.server.ts).

Header e Notificações​

• Sino de notificações dinâmico no header (PR #354): novo componente HeaderNotificationBell com badge de notificações pendentes, helper notification-badge.ts (com testes) e topbar rewards_available. Feature flags propagadas para todos os 13 brand overrides; tailwind.config.js recebeu tokens de cor para o badge.
• Contraste do sino corrigido (PR #356): em brands onde primary === header-bg, o ícone do sino sumia. Ajuste em HeaderNotificationBell.tsx força token de cor compatível com o fundo do header.

Preferências de Usuário​

• Página de preferências em /user/config (PR #357): nova seção PreferencesSection gated por feature flag userPreferences, com componente reutilizável RadioField, endpoint interno POST /api/user/update-preferences e redirect pós-login para a landing preferida do usuário (landing-preference.ts). Bump de @cactus-agents/accounts para 0.18.0 e @cactus-agents/i18n para 0.70.1.
• Stack das opções no mobile (PR #358): PreferencesSection ajustada para empilhar opções verticalmente em telas pequenas ao invés de quebrar layout em flex-row.

Cassino / Jogos​

• Recently-played semeado pela API no login (PR #355): novo endpoint /api/user/last-casino-games autenticado via accounts service, util recently-played.client.ts (118 linhas) com live updates, gate de visibilidade e play-trigger. Feature flag recentlyPlayedSeed propagada para todos os 13 brand overrides. Bump de @cactus-agents/games para 0.21.0.

Pagamentos e Moeda​

• Suporte a moedas sem decimais (Nigeria) (PR #365): CurrencyInput agora aceita prop obrigatória displayDecimalDigits (vinda de useCountry()) e ajusta display + matemática via centsScale = 10 ** (2 - displayDecimalDigits). Para NGN, digitar "1000" armazena 100000 kobo e exibe ₦ 1,000; contrato do BFF (kobo/centavos) preservado. Free-form rejeita separadores decimais quando displayDecimalDigits=0.
• Colapso do formatMoney duplicado: app/utils/money.ts virou adapter fino que delega ao coreFormatMoney de @cactus-agents/accounts. Os 6 consumers React (GameCard, GameIframe, GameStats, GameWinners, WinsCarousel, WinsCombinedWidget, RightPanelWinners) migraram para o hook useFormatMoney() que auto-resolve locale + currency + displayDecimalDigits da AccountsConfig, eliminando prop drilling. AccountsBootstrap propaga displayDecimalDigits da CountryConfig. AmountShortcuts mantém override explícito para 0 decimais (UX de shortcuts limpos cross-brand).
• GamesCacheService com displayDecimalDigits: payouts pré-formatados do cache server-side (top-games widget) agora resolvem o número de decimais via getCountryConfig(BRAND_COUNTRY). Sem isso, a home da Nigeria mostraria ₦1,000.00 no top-games e ₦1,000 em todo o resto.

Layout e Mobile​

• viewport-fit=cover no <meta viewport> (PR #363): correção de gap entre o bottom-nav e a borda inferior no Chrome iOS, principalmente em iPhones com home indicator.

Brand Overrides​

• vera-bet-br: nova landing SEO em /lp/apostas-esportivas (PR #361) — config em lps.config.ts + componente dedicado apostas-esportivas.tsx (≈540 linhas). Tipo LpDefinition recebeu campos novos para suportar conteúdo rich.
• vera-bet-br: afiliado Clever Advertising ativado (PR #360) via flag affiliateClever. Nova rota /clever (resource route loader-only) que escreve cookie lastclick a partir do utm_source da URL para os scripts 3rd-party da Clever atribuírem conversões. Resposta inclui X-Robots-Tag: noindex, nofollow e Cache-Control: no-store. Brands sem contrato Clever retornam 404. Doc em docs/features/clever/overview.md.
• vera-bet-br: novo asset PWA pwa-512x512.png adicionado.
• Múltiplas brands: página de empty-state ganhou imagem assets/images/empty.jpg no base e em 7k-bet-br, cassino-bet-br, betpontobet-bet-br e vera-bet-br.

Core / SDK​

• @cactus-agents/games — getUserLastCasinoGames (PR #148): novo método em GamesService, LegacyGamesService e CustomGamesService para buscar últimos jogos do usuário no cassino via BFF. Tipos correspondentes adicionados em types.ts. Consumido pelo endpoint /api/user/last-casino-games do base para semear o recently-played.

Documentação​

• Nova doc externa customization/user-preferences e nova doc interna template/user-preferences explicando como configurar o landing-preference e a PreferencesSection.
• country-config documentação atualizada com o campo displayDecimalDigits e regras de exibição monetária (zero-decimal para NGN/CLP, 2 decimais default).
• Bump de Docusaurus para 3.10.0 e Biome para 2.4.13.

• Redesign completo da TopbarNotification (PR #333): novo layout com botão de fechar (X) à esquerda, ícone em chip arredondado com tokens dedicados (topbar.icon-bg / topbar.icon-text), pilha de título + subtítulo no centro e CTA pill à direita, com altura de 72 px alinhada às barras modernas de instalação de app. Os ícones emoji foram substituídos por componentes do lucide-react (Smartphone, Bell, Gift, Send, Trophy, ShieldAlert) e o tipo TopbarDefinition.icon virou LucideIcon. Os modos default e restricted foram unificados num TopbarShell compartilhado, e a topbar deixou de ser sticky — agora rola junto com a página enquanto o header permanece fixo no topo do viewport. Tooltip de instalação iOS foi reancorado para o rodapé do viewport com safe-area-inset-bottom para que a seta inferior alinhe com a barra de endereços do Safari.
• Centralização do conteúdo no desktop (PR #334): o TopbarNotification recebeu um container interno max-w-[460px] mx-auto envolvendo close/ícone/texto/CTA. O fundo continua preenchendo edge-to-edge, mas em viewports largos o X e o CTA não escorregam mais para os cantos deixando um espaço vazio gigante no meio. Em mobile (< 460px) o comportamento é idêntico ao anterior — o container preenche naturalmente toda a largura.
• Refresh de tokens de tema da topbar em todos os overrides (PR #347): sincronizou o override 7k-bet-br (que estava sem icon-bg e icon-text), padronizou a paleta com fundo mais suave (lifted bg-primary), chip do ícone tingido com primary e CTA combinando com o botão primário da brand. Ajustes manuais aplicados nas variantes 7k, state77, vera-bet-br, betpontobet-bet-br e cassino-bet-br. Altura interna da linha do TopbarNotification reduzida de 68 px para 62 px para compactar o footprint vertical.

Analytics, dataLayer e Marketing​

• Stack de dataLayer de primeira classe (PR #321): nova fundação de analytics centralizada em app/utils/metrics/schema.ts com mapeamento entre MetricEvent e chaves do AnalyticsEventNameMap, garantindo dispatch correto para o GTM. O pushGTMEvent passou a usar nomes vindos do schema e payload construído sob demanda, com filtro brand-level antes do push para impedir vazamento de PII no dataLayer. O evento deposit_initiated resolve o nome final em função do método de pagamento. Foi adicionada também a página /debug/analytics (apenas em dev) com ativação por URL e stringification segura de payloads, mais a doc interna docs/features/data-layer/overview.md cobrindo todo o contrato.
• Mixpanel consolidado no hook useMixpanel (PR #335) com paridade total ao legado 7k/cassino/vera: mixpanel.init configurado com persistence: "localStorage" e track_pageview: false (evita pageview duplicado, já emitido pelo GTM); identify aceita tanto um id escalar quanto um AuthUser completo, disparando people.set ($email, $first_name, $last_name, $phone, user_id) e register de super-properties. Foi adicionada uma fila de identify para casos onde o mixpanel.identify é chamado antes do dynamic import do mixpanel-browser resolver, evitando perdas em hidratação com sessão pré-existente. useAnalytics ganhou um useEffect que re-identifica o usuário quando a store popula tardiamente. Removidos os arquivos legados app/utils/metrics/mixpanel.ts e os campos analyticsConfig.mixpanel* correspondentes.
• Portabilidade das integrações legadas Nuxt (PR #341): backfill de quatro features cobertas pelo legado, todas config-driven e desligadas por default:
  • ConfigCat (feature flags remotas): novos app/types/configcat.ts, app/config/configcat.config.ts, hook useConfigcat (lazy import do configcat-js-ssr, no-op quando desativado) e wrapper ergonômico useConfigcatFlag(key, defaultValue). Distribuído desativado nos 13 overrides; SDK key entra quando a brand decidir ativar.
  • AppsFlyer S2S (mobile app-only): tipos + config dedicados, hook useAppsFlyer que captura af_id/aaid/app_version da URL para sessionStorage, monta o payload S2S completo e dispara via proxy server-side (/api/tracking/appsflyer) — a URL S2S da brand nunca chega ao client. O proxy foi reescrito para ler de appsFlyerConfig (antes lia de brand.settings) e o payload foi expandido com first/last name, city, region e device data. Ativado em paridade com o legado para 7k-bet-br, cassino-bet-br e vera-bet-br; desativado nas demais 10 brands.
  • Reclame Aqui Reputation seal: hook useRaReputation que injeta o bundle raichu-beta uma vez no mount quando a brand tem customSeal do tipo ra-reputation, lendo o id direto do licensesConfig. O FooterBadges renderiza o widget vivo (<div id="ra-reputation" data-id=… data-model="2" />) ou cai no badge estático legado quando não há seal de widget. Habilitado em 7k-bet-br, cassino-bet-br e vera-bet-br com os ids do dynamicLicenses.json legado.
  • LP /esportes da 7k-bet-br portada para o novo override.

Cookies e Consentimento​

• Renomeação do cookie de consentimento de cactusCookiesConsent para cookies_consent (PR #337) com migração one-shot: na primeira leitura, se o cookie novo não existir e o antigo sim, o valor é copiado e o cookie legado é deletado, evitando re-prompt para usuários retornantes. A entrada cactus_jwt da COOKIE_TABLE também foi renomeada para jwt_token, batendo com o nome real setado em cookie.server.ts. A mudança elimina vazamento de termos internos da plataforma (cactus) em superfícies inspecionáveis pelo cliente final.
• Coordenação de widgets flutuantes em mobile (PR #337): o banner de consentimento agora publica cookieConsentMobileTopPx na floatingStack store via ResizeObserver + listener de resize, capturando ao mesmo tempo a âncora inferior e a altura renderizada. Os widgets LastGameFloatingWidget, InstallApp e Campaign se auto-escondem em mobile (< 640px) enquanto o banner está visível, e o BackToTop permanece visível mas ancora seu bottom em topPx + 8px com z-[65] para ficar acima do banner (z-[60]).

Cassino / Jogos​

• Borda em radial-gradient no TopGameCardShowcase (PR #330): o paleta gold/silver/bronze do pódio foi removida — todos os ranks agora usam primary da brand para identidade visual uniforme e brand-aware. A borda flat de 2 px virou um padrão wrapper+inner pintando um anel em radial-gradient (50% no centro → 100% nas bordas) via currentColor + color-mix, então qualquer cor primária de brand é capturada automaticamente. O badge do rank foi remoldado em "corner tab" rente (rounded-tl-lg / rounded-br-2xl) com bg-primary e text-button-text em todas as posições.
• Padronização do topGamesRankStyle: "showcase" em todos os brands (PR #349): default e os 10 overrides agora alinhados na mesma variante de rank para a row de top games, substituindo o legado outline-sideways.
• Flag onlineCountSource para fonte do contador "online" (PR #331): badge "online" do GameCard e card "Online agora" do GameStats passam a ler featuresConfig.onlineCountSource e escolher entre last1Hour.players (default) e last24Hours.players. O fallback oportunista entre janelas foi removido — o badge agora some quando a janela escolhida está em zero. Brand pb-bet configurado para a janela de 24 h; demais permanecem na de 1 h.

Pagamentos​

• Fluxo de salvar conta bancária do Chile reformulado (PR #327): a operação de criar/editar conta bancária agora passa pelo useValidationFlow({ context: "updateData" }) (mesma mecânica de update de endereço), garantindo o token de sessão exigido pelo BFF — antes ChlBanksSection, NgaBanksSection e ClabeSection postavam direto para /api/payments/bank-account e falhavam silenciosamente. Os selects do ChlBanksSection / WithdrawForm agora anexam o código bruto do backend entre parênteses (ex: Cuenta Corriente (CHECKING), CuentaRUT (RUT)) para ops e usuários desambiguarem duplicatas, com ordenação por adoção (CuentaRUT primeiro, ~82% da população). O proxy de bank-account agora encaminha tanto o payload bruto do BFF quanto a message já extraída, e o componente cai num genérico traduzido ("Error al guardar cuenta bancaria. Inténtalo de nuevo.") quando o extrator só consegue surfar um código de máquina. PixSection reordenou as key types por probabilidade de digitação manual no withdraw (CPF → PHONE → EVP → EMAIL) e usa filtro inclusivo, garantindo que EVP cai na posição correta quando a feature flag está ligada. Bumps acompanhantes: @cactus-agents/api-client ^0.10.1 → ^0.11.0, @cactus-agents/i18n ^0.65.0 → ^0.66.0 e @cactus-agents/payments ^0.12.2 → ^0.14.0.

Esportes​

• Iframe do sportsbook agora dimensiona pela área visível do viewport (PR #350): novo hook useSportsAvailableHeight mede o top do <main> em coordenadas de viewport (capturando topbar + sticky header naturalmente) e o offsetHeight do bottom nav (resolvendo safe-area-bottom, que getPropertyValue("--mobile-nav-h") não consegue), publicando o resultado como --sports-h. Listeners cobrem scroll (rAF-throttled) para o iframe crescer conforme a topbar desliza, visualViewport resize/scroll para a animação da URL bar do iOS, mais ResizeObserver no header e no nav. As variantes First, Altenar e Betby agora consomem o mesmo token, eliminando o calc(100vh - 200px) mágico do Betby/Altenar e o min-h-[100dvh] que colapsava o iframe a zero na branch vera/cassino.

Conta e Comunicações​

• Toggle de marketing envia datetime e não boolean (PR #344): o BFF /bff/users/self-mkt espera { mkt_accepted_at: "YYYY-MM-DD HH:MM:SS" } quando o usuário aceita comunicações e null quando revoga — não um boolean. O componente continua emitindo { mkt_accepted: boolean } (paridade com o tipo do core), e a rota /api/user/update-marketing faz a tradução antes de encaminhar ao BFF. Acompanha o bump do core (@cactus-agents/accounts) que ajustou o tipo UpdateMarketingPayload.

Brand Overrides​

• 7k-bet-br: bootstrap completo do override (PR #338) — 79 arquivos novos cobrindo analytics, casino-rows (custom/legacy/new), home-rows (custom/legacy/new), casino-live-rows, categories.custom, categories.personalize, features, game-thumbs, gamification, hotjar, image, licenses, lp-redirects, lps, menu, mixpanel, page-descriptions.server, referral-custom-v1, routes.paths, scripts, sidebar, sports, theme-layout, theme, locale override pt-br/auth.json, ícones PWA (apple-touch-icon em todos os tamanhos, favicon, pwa 96×96), 9 selos de regulação (autorizado, bis-awards-apostas-esportivas, bis-awards-cassino, compulsafe2, ebac, gambling-brasil, ibia, sigma-awards) e thumbs MP4 dos jogos fortune-fruits / fortune-snake / fortune-tiger.
• fi-7k-bet: correção do id do certificado CGA no licensesConfig e adição do SVG cga.svg em public/assets/seals/ (PR #346).
• state77-com: substituição do selo GCB pelo CGA com o link de certificado correto (PR #348).

Core / SDK​

• Pacote @cactus-agents/accounts recebeu UpdateMarketingPayload ajustado para mkt_accepted_at: string | null (datetime YYYY-MM-DD HH:MM:SS ao aceitar, null ao revogar) — antes era mkt_accepted: boolean, divergindo do contrato real do BFF /bff/users/self-mkt (Core PR #147).
• Pacote @cactus-agents/payments chegou na v0.14.0 com kycId + passwordCheck adicionados a GenericBankAccountPayload e MexBankAccountPayload, permitindo encaminhamento tipado dos artefatos de validação no fluxo de bank-account do Chile, Nigéria e México.
• Pacote @cactus-agents/api-client chegou na v0.11.0 e @cactus-agents/i18n na v0.66.0, ambos consumidos pelo bump acompanhante do PR #327.

• Banner de consentimento de cookies com Google Consent Mode v2 chega ao base. O CookieConsentBanner (fixado no canto inferior esquerdo, animado, z-60) e o painel CookieConsentDetails (abas Configurações/Sobre, toggles por categoria, tabela de cookies) injetam os defaults do GCM antes do GTM inicializar e gravam a preferência no cookie cactusCookiesConsent. Mapeamento de categorias: performance → analytics_storage, functionality → functionality_storage, demais → ad_storage + ad_user_data + ad_personalization. Bypass para bots via useIsBot(). Feature flag brand.features.cookieConsentPopup controla a exibição por marca, sem build-time config.
• Paridade total com o legado Vue (base + 7k + cassino + vera): adicionado o sétimo sinal do GCM v2 (security_storage: granted) para auditorias Lighthouse/CMP enxergarem o contrato completo; COOKIE_TABLE expandida de 6 para 19 entradas cobrindo Cloudflare, GA4, Clarity, Meta Pixel, Kwai, Amplitude, Smartico e cookies de funcionalidade (current_lang, topbar_closed, install_app_popup_closed); migração transparente do formato legado (array JSON de strings) para o novo objeto, sem reprompt de usuários existentes.
• UX e visual: o banner se posiciona acima do MobileBottomNav em mobile (h-14), some quando o drawer está aberto, fica print:hidden, e tem split 50/50 entre [Personalizar | Recusar] e [Aceitar todos]. Cores 100% via tokens de tema (bg-secondary, text-texts, bg-primary), eliminando bg-white/* e border-white/* hardcoded. O botão "Salvar" dentro do painel de detalhes se torna "Aceitar todos" quando só a categoria necessária está marcada — replica o saveButton() do legado.

Auth e Recuperação de Senha​

• Fluxo de recuperação de senha com KYC adota o contrato do BFF como fonte única da verdade. O endpoint /auth/passwords/reset/options agora retorna active_options (flags por método) + kyc (elegibilidade), e o RecoverOptionsStep renderiza estritamente a partir disso — sem flag, sem opção. Quando a interseção com os dados de contato disponíveis fica vazia, a tela mostra mensagem "nenhuma opção disponível" com CTA para suporte ao vivo, evitando que o usuário fique encalhado. A flag local recoveryPasswordMethods foi removida do tipo, do features.config.ts do base e dos 11 overrides de marca.
• RecoverKycStep reescrito como máquina de estados (useKycStore.{open, step, error}): substitui o spinner genérico anterior que deixava o usuário preso em "aguardando verificação" durante cancelamentos, erros do BFF e polling pós-iframe. Estados validated avançam para nova senha; erros fatais (failed/expired/internal_start_error/internal_status_error) fecham o modal, mostram toast e chamam resetToDocument() para reiniciar a partir do CPF; modal fechado em initial/started renderiza tela "Verificação interrompida" com CTAs de retentar/trocar método; estados finished/checking/manual_refresh mostram a UI de polling com botão "Cancelar" que conta 20s antes de habilitar.
• Token de recuperação separado do access token: /kyc/status/recovery agora retorna access_token OU recovery_token. A rota /api/kyc/status só seta o cookie de sessão para access_token; recovery_token flui pelo body do JSON e o store atualiza o flow token via a nova action setFlowToken. Origem do KYC varia entre recovery_password e password_recovery_attempt_limit conforme o ponto de entrada.

Analytics / Tracking​

• Mixpanel, Hotjar e Pendo integrados como infra genérica e config-driven. Cada SDK ganha um arquivo de tipo (app/types/{mixpanel,hotjar,pendo}.ts), config default desabilitada (enabled: false) e hook próprio: useMixpanel (wrapper sobre mixpanel-browser com import dinâmico — zero custo de bundle quando desabilitado, expõe trackEvent que auto-injeta { house: houseName }, identify, reset); useHotjar (injeta o snippet uma vez e opcionalmente chama hj('identify', null, { encryptedId, brand, hasFirstDeposit }) pós-auth quando identifyUsers: true); usePendo (injeta o agent loader e roda pendo.initialize({ visitor, account }) quando o estado de auth estabiliza). O componente AnalyticsLoaders monta os três hooks e está pendurado no app/root.tsx ao lado do TrackingCapture.
• Eventos de auth no Mixpanel: trackLogin agora também chama mixpanel.identify(user.id) + evento Login Succeeded; trackRegistration adiciona identify + Sign Up Succeeded. Novos eventos trackLoginSubmitted / trackLoginFailed são exclusivos do Mixpanel (sem equivalente GTM), disparados pelo LoginModal.handleSubmit e pelo bloco catch.

Sistema de Indique e Ganhe​

• Variantes da página de Indique e Ganhe consolidadas em três opções: default (cactus, API padrão), custom-v1 (ex custom-stats, hero com prêmio + cards de indicações qualificadas/total ganho — usado por 7k/cassino/vera) e v2 (ex betpontobet, com tiers de recompensa configuráveis). Os nomes ficaram brand-agnósticos para qualquer marca poder reusar. O config padrão da v2 agora ship vazio — antes carregava valores específicos do betpontobet (api.donaldbet.app, slug betbet, tiers R$ 50/100/200/300, shareMessage persuasivo) que vazavam em todo build; a marca betpontobet-bet-br ganhou override próprio com esses valores.
• Novo proxy server-side /api/user/referral-indicator para a variante custom-v1: encaminha Bearer encrypted_user_id ?? user.id para a API legada externa (amigos.verabet.app / connect-7k.gdm7khub.com / connect-v2.gdmhub.io), garantindo que o token nunca chega ao cliente. Acompanha novo tipo ReferralCustomStatsConfig (com apiUrl, maxReward, minBetAmount, providerName, eligibleGamesPath) e augmentation do AuthUser para incluir encrypted_user_id opcional.
• CTA dinâmico da sidebar respeita a variante: useReferral resolve bonusAmount do config da variante ativa (v2 → maxReward, custom-v1 → maxReward se setado, senão API; default → API). Corrige o badge "Indique e Ganhe R$ 0,01" da betpontobet quando o stage retornava valor de teste. SidebarNarrow consome bonusFormatted direto do hook.

Pagamentos​

• Saque para Finlândia (FIN) renderiza formulário próprio. O WithdrawForm passa a tratar as três variantes de transferência bancária explicitamente (NGA/FIN/CHL) em vez do fallback "NGA vs tudo cai em CHL", que estava renderizando campos chilenos (tipo de conta, dropdown de banco, aviso de RUT) para usuários finlandeses. Novo FinBankTransferFields mostra um único input de número de conta + aviso de propriedade do documento via a chave i18n fin_document_ownership_warning. Payload final para FIN agora envia apenas bank_number (sem bankCode, account_type ou generic_bank_*).

E2E Tests / Playwright​

• data-testid nos elementos críticos para Playwright: botões de login/registro no HeaderDefault, submit do LoginModal, wrapper do GameCard e MobileBottomNav. Necessário para os seletores do repositório front-tests-e2e. Junto, todos os hooks Husky passam a fazer source do nvm com --no-use, evitando exit code 3 sob bash 3.2 (o /bin/sh do macOS) onde o auto-switch do nvm explodia em sh -e.

Brand Overrides​

• cassino-bet-br: bootstrap completo da marca portada do legado Nuxt. 71 arquivos novos (theme azul-marinho + ciano, features, licenses com textLicense + selos da autorização SPA + IBIA + Sport Radar + EBAC + Compulsafe + BeGambleAware + Gambling Therapy + Be Complience + patrocínio Bis Awards, gamification com Smartico brandKey 0a13ef04 + CassinoVip/VipCoins, page descriptions, menu/sidebar/home-rows/casino-rows espelhados do legado, Cactus Sportsbook, variante de referral custom-v1 apontando para connect-v2.gdmhub.io). Assets PWA, favicons, logos, touch-icons e selos próprios da marca incluídos. Configurações de Mixpanel/Hotjar/Pendo virão em PR de follow-up depois que a infra base estabilizar no stage.
• fi-7k-bet: menu lateral do cassino realinhado ao games-menu.json legado — reordenadas as categorias (All Games, Slots, Live Casino, Providers), slug do Aviator trocado de spribe/aviator para banana/aviator-crash, Blackjack ao vivo trocado de evolution/infinite-blackjack para pragmaticplay/live-one-blackjack, adicionados Fortune Dragon (PG Soft) e Fortune Fruits (Banana), removidos Brazilian Roulette e Infinite Blackjack. No mesmo dia: licenças com texto oficial de compliance (NovaWave Technology N.V. + Stonefield Technologies como Billing Agent, GoC OGL/2024/547/0446) substituindo o placeholder em espanhol; flag pixEvpEnabled zerada (Pix está desabilitado para FIN no country-config).
• vera-bet-br: Mixpanel ativado (house: 'Vera') + Hotjar (hjid 6503935, sem identify para casar com o snippet do legado). O proxy de referral-indicator aponta para https://amigos.verabet.app.
• betpontobet-bet-br: ganha override completo do referral-v2.config.ts agora que o default ficou vazio — preserva os tiers de recompensa, shareMessage e configuração da api.donaldbet.app.

Core / SDK​

• Pacote @cactus-agents/i18n ganha o namespace consent completo nos 4 locales (pt-br, pt, es, en) — primeiro com 68 chaves cobrindo o banner de cookies, depois expandido para o catálogo completo de 19 cookies que o front consome. Tipo I18nNamespace registrado.
• Pacote @cactus-agents/i18n recebe a chave fin_document_ownership_warning no namespace user (4 locales) para o aviso do formulário de saque finlandês. Acompanha changeset.
• Pacote @cactus-agents/accounts corrige TwoFactorPayload para os campos esperados pelo BFF: two_factor_type e two_factor_enabled (mesma shape do AuthUserInfo), em vez de type/enabled. Os nomes errados faziam o PATCH /bff/users/self-two-factor virar no-op silencioso, e o estado de 2FA do usuário nunca mudava de fato.

• Captura de UTMs agora roda server-side no root loader (app/root.tsx). Antes, a captura era apenas client-side em useEffect — UTMs se perdiam quando um loader fazia redirect(...) antes do hydrate. Ex: landing /?utm_source=X&ref=AFIL1 que dispara redirect para /register agora preserva os parâmetros via Set-Cookie na própria response do redirect. Resolve o report "Rastreamento perde-se após o login/redirecionamento".
• Política de atribuição alinhada com legado: last-touch. Cada nova URL com UTM sobrescreve o cookie anterior, igual ao middleware global do Nuxt antigo. A versão anterior (first-touch) divergia silenciosamente da atribuição calibrada nos dashboards de BI.
• Captura também re-executa em toda navegação SPA via useLocation() no TrackingCapture — antes corria só 1x no mount.

Payloads para o BFF​

• Deposit (POST /wallet/add-credit): removido o campo src do body em buildDepositPayload. Nenhum dos quatro projetos legado (base, 7k-bet-br, cassino-bet-br, vera-bet-br) jamais enviou src no deposit — só no signup. Manter paridade evita surpresas em dashboards de BI.
• Signup (POST /bff/register-simplified / POST /auth/register): payload continua enviando utm_source, utm_campaign, utm_content, utm_medium, src, ga_client_id, app_source, affiliation_code — já era assim antes, agora com cobertura de testes end-to-end (FormData → action → body do POST).

Headers HTTP automáticos​

• X-ORIGIN-ACCESS agora é derivado do User-Agent no api.server.ts (mobile vs desktop). Antes, todo request server enviava Desktop fixo; agora bate com a segmentação de device do BI legado.
• X-LOG-INFO já era enviado em todo request, mas a documentação do SDK descrevia o formato errado ({tenant, version, locale, isAuth, originAccess}) — corrigido para o formato real 1-{timestamp}-{buildId}.

Documentação​

• Nova doc docs-internal/architecture/marketing-tracking.md cobrindo captura em 3 camadas, política last-touch, parâmetros e aliases, sanitização, storage (cookie_tracking + cookie_referrer), payloads finais por endpoint, headers automáticos, feature flag keepTrackingParamsInUrl e checklist anti-padrões.
• sdk/api-client.md atualizado: tabela de headers automáticos completa (X-ORIGIN-REFERRER family); tipo ReferrerInfo corrigido (era declarado com campos UTM fictícios); tipo RequestDebugInfo corrigido (estava descrevendo um shape inexistente).
• sdk/auth.md: RegisterSimplifiedPayload agora documenta os campos de tracking (utm_*, src, ga_client_id).
• sdk/payments.md: shape completo do DepositPayload documentado, incluindo a regra "NÃO enviar src" como callout reforçado por teste automatizado.

Testes​

• Suite nova app/utils/__tests__/tracking.test.ts (15 casos): parser de URL com todos os aliases, sanitização, merge last-touch, casos edge.
• Suite nova app/utils/__tests__/tracking.server.test.ts (9 casos): captura server-side, Set-Cookie serialization, strip de URL pela feature flag.
• Suite nova app/modules/register/__tests__/flow.tracking.test.ts (4 casos): valida o pipeline FormData → parseRegisterFormData → buildRegisterPayload ponta-a-ponta — garante que o que o browser submete chega ao body do POST que vai pro BFF.
• packages/payments/src/__tests__/transform.test.ts: novo caso confirma que src não sai no deposit.
• packages/api-client/src/__tests__/client.test.ts: novos casos cobrem X-LOG-INFO (formato + fallback nobuild) e X-ORIGIN-ACCESS (presença/ausência conforme enum).

• Adicionada a seção de Promoções com um novo ícone animado de presente na navegação.
• Convertidos os atalhos de busca rápida e a lista de categorias em carrosséis horizontais com navegação por toque (swipe).
• Implementado modo de tela cheia para o modal de Stories e adicionada navegação por swipe horizontal entre os stories.
• Aprimorado o layout do rodapé com a adição de selos de conformidade.
• Melhorias de responsividade e UX nas páginas de erro 404 e 500, incluindo localização aprimorada.
• Corrigido o alinhamento de altura entre o seletor de DDI e o campo de telefone em dispositivos móveis.
• Ajustado alinhamento do tooltip de instalação do app para iOS.
• Adicionado o componente PageDescription e centralizada a configuração de descrições de página para SEO.

Registro e Validação​

• Melhorado o fluxo de validação de e-mail e telefone com funcionalidade de envio automático de código.
• Aprimorado o formulário de endereço com busca de CEP e preenchimento automático.
• O nome do documento no formulário de registro agora é dinâmico por país (ex: CPF no Brasil, RUT no Chile).
• Melhorado o fluxo de validação de telefone com verificação de ID KYC e override de fonte.
• Corrigido o identificador de origem do aplicativo (app source) no modal de registro.
• Ajustadas as feature flags do fluxo de registro para a marca betpontobet.

Geral e SEO​

• O nome da marca agora é anexado aos títulos de todas as páginas, melhorando a identificação e o SEO.
• Aprimoradas as capacidades de tracking com a integração de um novo provedor de analytics.
• Adicionado um ícone de Troféu para a aba de Recompensas no menu da conta do usuário.