@cactus-agents/brand

Transforma as respostas raw da API em BrandConfig limpo e tipado. Faz 3 requests em paralelo e aplica transformações.

Instalação

pnpm add @cactus-agents/brand

Uso básico

A forma recomendada é usar createBrandFromClient, que aceita um ApiClient diretamente:

import { createApiClient } from '@cactus-agents/api-client';
import { createBrandFromClient } from '@cactus-agents/brand';

const client = createApiClient({ baseUrl, tenant, language });
const brand = await createBrandFromClient(client, { country: 'BRA', language: 'pt-br' });

// brand.appearance.logo
// brand.features.maintenanceMode
// brand.settings.name

Uso de baixo nível (fetcher manual)

Se precisar de controle total sobre o adapter HTTP, use createBrandConfig:

import { createBrandConfig } from '@cactus-agents/brand';

const brand = await createBrandConfig({
  fetcher: {
    get: (path) => myHttpClient.get(path),
    post: (path, body) => myHttpClient.post(path, body),
  },
  country: 'BRA',
  language: 'pt-br',
});

API

createBrandConfig(options)

function createBrandConfig(options: CreateBrandConfigOptions): Promise<BrandConfig>;

interface CreateBrandConfigOptions {
  fetcher: BrandFetcher;
  country: string;
  language: string;
}

interface BrandFetcher {
  get(path: string): Promise<unknown>;
  post(path: string, body?: unknown): Promise<unknown>;
}

Faz 3 requests em paralelo:

• GET /appearance
• GET /bff/features
• POST /bookmaker-settings

selectByCountry(items, country)

Seleciona item de um array multi-país:

selectByCountry(items, 'BRA')
// 1. Exact match: item.country.code === 'BRA'
// 2. Default: item.is_default === 1
// 3. Fallback: items[0]

safeParseJson(raw, fallback)

Parse seguro de JSON strings (muitos campos da API vêm como JSON string):

safeParseJson('{"key": "value"}', {})  // { key: "value" }
safeParseJson('invalid', {})            // {}
safeParseJson(null, [])                 // []

bool(v)

Coerce 0 | 1 | null → boolean:

bool(1)    // true
bool(0)    // false
bool(null) // false

Transformações aplicadas

Raw	Transformado
Banners {"1":{...}} ou []	Banner[] sorted by order
Links duplicados (LINK_TO_X)	Último entry vence
JSON strings (auth_configs, contacts, etc.)	Objetos parseados
Flags 0 | 1	boolean
Arrays multi-país	Filtrado por selectByCountry

Raw Types

O pacote exporta raw types para referência (RawAppearance, RawFeatures, RawSettings). Estes representam as shapes verbatim da API e nunca devem ser usados na UI. Use apenas BrandConfig e seus sub-tipos.