@codedartdev/coinsentry-sdk 0.1.0

package/README.md

@@ -0,0 +1,271 @@
+# @codedartdev/coinsentry-sdk
+
+Core headless do SDK CoinSentry. Este pacote define contratos publicos para
+frontends de clientes consumirem Auth, Session, Entity, KYC, Brand, HTTP,
+erros e Realtime sem depender de React, Next.js ou componentes da whitelabel.
+
+## Responsabilidade
+
+- Cliente HTTP same-origin com `fetch`, cookies, CSRF retry, FormData seguro e
+  corpos `URLSearchParams` para endpoints form-urlencoded.
+- Servicos headless: `auth`, `session`, `entity`, `kyc`, `brand` e modulos
+  de produto.
+- Tipos publicos, guards e codigos de erro estaveis.
+- Resolucao pura do KYC universal via `@codedartdev/coinsentry-sdk/kyc`.
+- Interface de realtime desacoplada do client WebSocket interno.
+
+## Fora Do Escopo
+
+- Segredos de assinatura do BFF.
+- Headers upstream `X-Frontend-*`.
+- React providers, hooks, modais, toasts ou redirects.
+- Chamada browser para `/api/v1/kyc/requirements`.
+- Decisao local de `client_flow`, jurisdicao, customer type ou proxima tela.
+
+`createCoinSentryClient()` e browser-safe e nunca aceita segredo de assinatura.
+O segredo do proxy deve existir apenas em APIs server-only de
+`@codedartdev/coinsentry-next`.
+
+## Uso Basico
+
+```ts
+import { createCoinSentryClient } from '@codedartdev/coinsentry-sdk';
+
+const cs = createCoinSentryClient({
+  baseUrl: '/',
+  locale: 'pt-BR',
+  onError(error) {
+    console.warn(error.code, error.status, error.reason);
+  },
+});
+
+await cs.auth.login({ email, password, slideCaptchaToken });
+const session = await cs.session.refresh();
+const entities = await cs.entity.list();
+const selected = await cs.entity.select({ entityUuid: entities[0].uuid });
+const overview = await cs.kyc.getOverview();
+```
+
+O browser deve usar `baseUrl: '/'` para chamar somente o BFF same-origin.
+Nao passe `WHITELABEL_PROXY_SIGNATURE_SECRET`,
+`FRONTEND_PROXY_SIGNATURE_SECRET` ou qualquer segredo equivalente para este
+cliente.
+
+## Locale
+
+O adapter `fetch` envia `Accept-Language` automaticamente.
+
+```ts
+cs.locale.set('pt-BR');
+cs.locale.setKyc('es-AR');
+await cs.kyc.getOverview();
+cs.locale.clearKyc();
+```
+
+`locale.setKyc()` afeta apenas requests para `/api/v1/kyc*`. Isso preserva o
+comportamento da whitelabel atual sem colocar fallback de fluxo no browser.
+
+## Transporte HTTP
+
+`client.request<T>()` e o transporte headless oficial. Use-o para endpoints
+same-origin do BFF em vez de `fetch` manual no browser. O adapter preserva
+`FormData` sem definir `Content-Type` e aceita `URLSearchParams` para casos
+form-urlencoded como autorizacao de canais realtime.
+
+Para compatibilidade com Sanctum/Fortify, requests mutaveis same-origin leem o
+ultimo cookie `XSRF-TOKEN` disponivel e enviam `X-XSRF-TOKEN` decodificado
+automaticamente. O token nao e anexado a requests cross-origin.
+
+O retry automatico de `419` continua ativo por padrao em `client.request<T>()`.
+Para endpoints sensiveis que ja inicializam CSRF antes do POST, use
+`retryOnCsrf: false` para evitar repetir a mesma acao:
+
+```ts
+await cs.request({
+  method: 'POST',
+  path: '/auth/login',
+  retryOnCsrf: false,
+  body: payload,
+});
+```
+
+`csrf.init()` e deduplicado: chamadas concorrentes compartilham o mesmo request
+e chamadas recentes reaproveitam uma janela curta de inicializacao. Metodos de
+auth, como login, register e 2FA, continuam forçando CSRF fresco antes do POST
+para preservar a seguranca do fluxo Fortify/Sanctum.
+
+## Auth
+
+`auth.login()` e `auth.twoFactorChallenge()` preservam os envelopes reais do
+backend:
+
+- `CoinSentryLoginTwoFactor`: `{ two_factor: true }`;
+- `CoinSentryLoginIncomplete`: `{ success: true, two_factor: false, needs_refresh: true }`;
+- `CoinSentryLoginMultipleEntities`: login autenticado sem entidade ativa;
+- `CoinSentryLoginSingleEntity`: login com entidade selecionada;
+- `CoinSentryLoginSuccess`: sucesso simples.
+
+Os metodos de auth que chamam `csrf.init()` antes do POST nao repetem
+automaticamente o POST em `419`. Isso evita duplicar a mesma tentativa de login,
+registro ou desafio 2FA, especialmente quando ha CAPTCHA envolvido.
+
+Use guards publicos para reduzir branching inseguro:
+
+```ts
+import {
+  isCoinSentryLoginIncomplete,
+  isCoinSentryLoginMultipleEntities,
+  isCoinSentryLoginTwoFactor,
+} from '@codedartdev/coinsentry-sdk';
+
+const response = await cs.auth.login({ email, password, slideCaptchaToken });
+
+if (isCoinSentryLoginTwoFactor(response)) {
+  showTwoFactorChallenge();
+}
+
+if (isCoinSentryLoginIncomplete(response)) {
+  await cs.session.refresh();
+}
+
+if (isCoinSentryLoginMultipleEntities(response)) {
+  openEntitySelector(response.entities);
+}
+```
+
+## Session E Entity
+
+`session.refresh()` retorna a sessao autenticada. `entity.select()` retorna um
+contrato tipado com usuario, balances, entidades e `kyc_required` quando o BFF
+responde com esse envelope.
+
+Guards uteis:
+
+- `isCoinSentrySession(value)`;
+- `hasCoinSentryActiveEntity(session)`;
+- `isCoinSentryEntityMinimal(value)`;
+- `requiresCoinSentryEntitySelection(value)`.
+
+## Modulos De Produto
+
+Alem de Auth, Session, Entity e KYC, o client expoe dominios usados pela
+whitelabel atual. Todos usam `client.request<T>()`, retornam payload de dominio
+normalizado e aceitam `{ signal }` quando aplicavel.
+
+- `account.twoFactor`: enable, QR code, confirmacao, recovery codes,
+  regeneracao, disable e status.
+- `contacts`: contatos bancarios, bancos e contatos de wallet.
+- `deposits`: dados de deposito e intent de deposito.
+- `withdrawals`: dados de saque, saque fiat, saque crypto e taxa de rede.
+- `payments`: moedas, historico, PIX receive/status/lookup/pay.
+- `affiliate`: codigo, status, referrals, payouts e rankings.
+- `market`: market data, orderbook, criar/cancelar ordens e cancelar todas.
+- `otc`: pares, quote/execute/history, ativar/desativar quote e planos
+  recorrentes.
+
+```ts
+const depositData = await cs.deposits.get('BRL');
+const fee = await cs.withdrawals.networkFee({ currency: 'BTC', network: 'BTC' });
+const quote = await cs.otc.createQuote({
+  symbol: 'USDT_BRL',
+  from_currency: 'BRL',
+  to_currency: 'USDT',
+  from_amount: '100',
+});
+```
+
+Esses modulos continuam headless: nao exibem toast, nao redirecionam e nao
+conhecem componentes da whitelabel.
+
+## KYC Headless
+
+```ts
+import {
+  hasKycClientFlow,
+  isKycFlowSnapshotConfigured,
+  resolveKycFlowSnapshot,
+} from '@codedartdev/coinsentry-sdk/kyc';
+
+const overview = await cs.kyc.getOverview();
+const flow = resolveKycFlowSnapshot({ overview });
+
+if (!isKycFlowSnapshotConfigured(flow)) {
+  throw new Error('KYC flow is not configured.');
+}
+
+if (flow.activeStep?.screen === 'document_upload') {
+  await cs.kyc.upload({ step: flow.activeStep, formData });
+}
+```
+
+O core falha fechado quando nao existe `client_flow`. Ele nao cria fallback local
+para fluxo legado, jurisdicao, customer type ou proxima tela.
+
+Guards KYC publicos:
+
+- `hasKycClientFlow(requirements)`;
+- `hasResolvedKycRequirements(requirements)`;
+- `isKycFlowSnapshotConfigured(snapshot)`;
+- `isKycOverviewFlowConfigured(overview)`.
+
+## Erros Publicos
+
+O SDK normaliza falhas em `CoinSentryApiError`:
+
+```ts
+import { normalizeCoinSentryError } from '@codedartdev/coinsentry-sdk';
+
+try {
+  await cs.kyc.getOverview();
+} catch (error) {
+  const normalized = normalizeCoinSentryError(error);
+  if (normalized.code === 'kyc_required') {
+    openKyc();
+  }
+}
+```
+
+Codigos estaveis:
+
+- `unauthenticated`
+- `csrf_expired`
+- `kyc_required`
+- `entity_required`
+- `invalid_signature`
+- `origin_not_allowed`
+- `missing_signature_headers`
+- `validation_failed`
+- `rate_limited`
+- `forbidden`
+- `network_error`
+- `server_error`
+- `unknown_error`
+
+## Realtime
+
+`createCoinSentryRealtime(adapter)` define a interface publica. A implementacao
+concreta pode ser o Reverb/Pusher client interno da whitelabel ou outro adapter
+compativel.
+
+```ts
+const realtime = createCoinSentryRealtime(adapter);
+realtime.connect();
+realtime.subscribeToEntity(entityUuid, 'balance.updated', onBalance);
+```
+
+O payload recomendado para saldo e `CoinSentryBalanceUpdate`:
+
+```ts
+type CoinSentryBalanceUpdate = {
+  currency: string;
+  available: string | number;
+  locked: string | number;
+  total?: string | number;
+};
+```
+
+## Estado Atual
+
+Beta npm (`0.1.0`, dist-tag `next`). O pacote gera `dist`, `.d.ts`,
+`.d.ts.map` e sourcemaps. O pacote permanece `UNLICENSED` enquanto os contratos
+publicos seguem em beta.

package/dist/brand/config.d.ts

@@ -0,0 +1,78 @@
+import type { BrandConfig, BackendBrandLogoType, BrandLogoType } from './types.js';
+export type BrandMode = 'light' | 'dark';
+export interface BrandManifestIcon {
+    src: string;
+    sizes: string;
+    type?: string;
+    purpose?: 'any' | 'maskable' | 'monochrome';
+}
+export interface BrandWebManifest {
+    name: string;
+    short_name: string;
+    description: string;
+    icons: BrandManifestIcon[];
+    theme_color: string;
+    background_color: string;
+    display: 'standalone';
+    start_url: string;
+}
+export interface BrandIconDescriptor {
+    url: string;
+    type?: string;
+    media?: string;
+}
+export interface NormalizedLogoLayout {
+    width: string;
+    height: string;
+}
+export declare function normalizeLogoType(type: BackendBrandLogoType | string | null | undefined): BrandLogoType;
+export declare function isImageLogoType(type: BackendBrandLogoType | string | null | undefined): boolean;
+export declare function normalizeLogoDimension(value: string | number | null | undefined, fallback: string): string;
+export declare function normalizeLogoLayout(layout: BrandConfig['brand']['logo']['layout'] | null | undefined): NormalizedLogoLayout;
+export declare function normalizeFontSans(value: string | null | undefined): string;
+export declare function fontSansToCssFamily(value: string | null | undefined): string;
+export declare function normalizeBrandConfig(config: BrandConfig): BrandConfig;
+export declare function getLogoImageUrl(logo: BrandConfig['brand']['logo'], mode?: BrandMode): string | null;
+export declare function getLogoTextFontFamily(config: BrandConfig): string;
+export declare function getLogoTextColors(config: BrandConfig, mode: BrandMode): {
+    base?: string | null;
+    accent?: string | null;
+};
+export declare function getBrandCssVariables(config: BrandConfig, mode: BrandMode): {
+    '--radius': string;
+    '--primary': string;
+    '--primary-foreground': string;
+    '--background': string;
+    '--foreground': string;
+    '--card': string;
+    '--card-foreground': string;
+    '--secondary': string;
+    '--secondary-foreground': string;
+    '--muted': string;
+    '--muted-foreground': string;
+    '--accent': string;
+    '--accent-foreground': string;
+    '--border': string;
+    '--ring': string;
+    '--sidebar': string;
+    '--sidebar-foreground': string;
+    '--sidebar-primary': string;
+    '--sidebar-primary-foreground': string;
+    '--sidebar-accent': string;
+    '--sidebar-accent-foreground': string;
+    '--sidebar-border': string;
+};
+export declare function buildBrandCss(config: BrandConfig): string;
+export declare function resolveBrandThemeMode(config: BrandConfig, preferredMode?: string | null): BrandMode;
+export declare function inferImageMimeType(url: string): string | undefined;
+export declare function buildBrandManifest(config: BrandConfig): BrandWebManifest;
+export declare function getBrandFaviconUrl(favicon: BrandConfig['favicon'], mode?: BrandMode): string;
+export declare function buildBrandIconsMetadata(favicon: BrandConfig['favicon'], mode?: BrandMode): {
+    icon: {
+        url: string;
+        type: string | undefined;
+        media: string;
+    }[];
+    shortcut: string;
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/brand/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/brand/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,aAAa,EAAY,MAAM,YAAY,CAAC;AAE7F,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAEzC,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,KAAK,GAAG,UAAU,GAAG,YAAY,CAAC;CAC7C;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AASD,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,aAAa,CAEvG;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAE/F;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EACzC,QAAQ,EAAE,MAAM,GACf,MAAM,CAkBR;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,IAAI,GAAG,SAAS,GAChE,oBAAoB,CAKtB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAS1E;AAWD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAE5E;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAkCrE;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,EAClC,IAAI,GAAE,SAAmB,GACxB,MAAM,GAAG,IAAI,CAOf;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAEjE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS;;;EAErE;AAyED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS;;;;;;;;;;;;;;;;;;;;;;;EAMxE;AAQD,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAmBzD;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAOnG;AAMD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQlE;AAoBD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,gBAAgB,CAsBxE;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,WAAW,CAAC,SAAS,CAAC,EAC/B,IAAI,GAAE,SAAmB,GACxB,MAAM,CAIR;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,WAAW,CAAC,SAAS,CAAC,EAC/B,IAAI,GAAE,SAAmB;;;;;;;EAY1B"}

package/dist/brand/config.js

@@ -0,0 +1,274 @@
+const FALLBACK_FAVICON = '/favicon.ico';
+const FALLBACK_FONT = 'Inter';
+const FALLBACK_LOGO_WIDTH = '160px';
+const FALLBACK_LOGO_HEIGHT = '40px';
+const SAFE_LOGO_KEYWORDS = new Set(['auto', 'fit-content']);
+const SAFE_LOGO_DIMENSION_PATTERN = /^(\d+(?:\.\d+)?)(px|rem|em|%|vw|vh)$/i;
+export function normalizeLogoType(type) {
+    return type === 'text' ? 'text' : 'image';
+}
+export function isImageLogoType(type) {
+    return normalizeLogoType(type) === 'image';
+}
+export function normalizeLogoDimension(value, fallback) {
+    if (typeof value === 'number') {
+        return Number.isFinite(value) && value >= 0 ? `${value}px` : fallback;
+    }
+    const raw = value?.trim();
+    if (!raw)
+        return fallback;
+    const lower = raw.toLowerCase();
+    if (SAFE_LOGO_KEYWORDS.has(lower))
+        return lower;
+    const match = lower.match(SAFE_LOGO_DIMENSION_PATTERN);
+    if (!match)
+        return fallback;
+    const amount = Number(match[1]);
+    if (!Number.isFinite(amount) || amount < 0)
+        return fallback;
+    return `${match[1]}${match[2].toLowerCase()}`;
+}
+export function normalizeLogoLayout(layout) {
+    return {
+        width: normalizeLogoDimension(layout?.width, FALLBACK_LOGO_WIDTH),
+        height: normalizeLogoDimension(layout?.height, FALLBACK_LOGO_HEIGHT),
+    };
+}
+export function normalizeFontSans(value) {
+    const raw = value?.trim();
+    if (!raw)
+        return FALLBACK_FONT;
+    if (!raw.includes(',')) {
+        return raw.replace(/['"`]/g, '').trim() || FALLBACK_FONT;
+    }
+    return raw.split(',')[0]?.replace(/['"`]/g, '').trim() || FALLBACK_FONT;
+}
+function quoteFontFamily(name) {
+    const clean = name.replace(/['"`]/g, '').trim();
+    if (!clean || clean === 'System') {
+        return 'ui-sans-serif, system-ui, sans-serif';
+    }
+    return `'${clean}', ui-sans-serif, system-ui, sans-serif`;
+}
+export function fontSansToCssFamily(value) {
+    return quoteFontFamily(normalizeFontSans(value));
+}
+export function normalizeBrandConfig(config) {
+    const logo = config.brand.logo;
+    const text = logo.text ?? { base: config.brand.name, accent: '' };
+    return {
+        ...config,
+        brand: {
+            ...config.brand,
+            logo: {
+                ...logo,
+                type: normalizeLogoType(logo.type),
+                imageUrl: logo.imageUrl ?? '',
+                darkImageUrl: logo.darkImageUrl ?? null,
+                layout: normalizeLogoLayout(logo.layout),
+                text: {
+                    ...text,
+                    base: text.base ?? config.brand.name,
+                    accent: text.accent ?? '',
+                    fontFamily: text.fontFamily ? normalizeFontSans(text.fontFamily) : text.fontFamily,
+                },
+            },
+        },
+        favicon: {
+            default: config.favicon?.default ?? FALLBACK_FAVICON,
+            dark: config.favicon?.dark ?? null,
+        },
+        theme: {
+            ...config.theme,
+            font: {
+                ...config.theme.font,
+                sans: normalizeFontSans(config.theme.font?.sans),
+            },
+        },
+    };
+}
+export function getLogoImageUrl(logo, mode = 'light') {
+    if (!isImageLogoType(logo.type))
+        return null;
+    const darkUrl = logo.darkImageUrl?.trim();
+    const defaultUrl = logo.imageUrl?.trim();
+    return (mode === 'dark' && darkUrl ? darkUrl : defaultUrl) || null;
+}
+export function getLogoTextFontFamily(config) {
+    return fontSansToCssFamily(config.brand.logo.text.fontFamily || config.theme.font.sans);
+}
+export function getLogoTextColors(config, mode) {
+    return config.brand.logo.text.colors?.[mode] ?? {};
+}
+function colorMixHex(a, b, t) {
+    const pa = parseHex(a);
+    const pb = parseHex(b);
+    if (!pa || !pb)
+        return a;
+    const r = Math.round(pa[0] + (pb[0] - pa[0]) * t);
+    const g = Math.round(pa[1] + (pb[1] - pa[1]) * t);
+    const bl = Math.round(pa[2] + (pb[2] - pa[2]) * t);
+    return `#${hex2(r)}${hex2(g)}${hex2(bl)}`;
+}
+function hexToRgbaValue(hex, alpha) {
+    const parsed = parseHex(hex);
+    if (!parsed)
+        return `rgba(128,128,128,${alpha})`;
+    return `rgba(${parsed[0]},${parsed[1]},${parsed[2]},${alpha})`;
+}
+function parseHex(hex) {
+    const clean = hex.replace('#', '');
+    const full = clean.length === 3
+        ? clean.split('').map((c) => c + c).join('')
+        : clean;
+    if (!/^[0-9a-fA-F]{6}$/.test(full))
+        return null;
+    return [
+        parseInt(full.slice(0, 2), 16),
+        parseInt(full.slice(2, 4), 16),
+        parseInt(full.slice(4, 6), 16),
+    ];
+}
+function hex2(n) {
+    return n.toString(16).padStart(2, '0');
+}
+function buildModeVars(colors, mode) {
+    const isDark = mode === 'dark';
+    const secondary = colorMixHex(colors.background, isDark ? '#ffffff' : '#000000', isDark ? 0.12 : 0.05);
+    const muted = colorMixHex(colors.background, isDark ? '#ffffff' : '#888888', isDark ? 0.08 : 0.07);
+    const accent = colorMixHex(colors.background, isDark ? '#ffffff' : '#000000', isDark ? 0.16 : 0.08);
+    const border = hexToRgbaValue(colors.foreground, isDark ? 0.12 : 0.1);
+    const mutedForeground = hexToRgbaValue(colors.foreground, isDark ? 0.68 : 0.62);
+    return {
+        '--primary': colors.primary,
+        '--primary-foreground': colors.primaryForeground,
+        '--background': colors.background,
+        '--foreground': colors.foreground,
+        '--card': colors.background,
+        '--card-foreground': colors.foreground,
+        '--secondary': secondary,
+        '--secondary-foreground': colors.foreground,
+        '--muted': muted,
+        '--muted-foreground': mutedForeground,
+        '--accent': accent,
+        '--accent-foreground': colors.foreground,
+        '--border': border,
+        '--ring': colors.primary,
+        '--sidebar': colors.background,
+        '--sidebar-foreground': colors.foreground,
+        '--sidebar-primary': colors.primary,
+        '--sidebar-primary-foreground': colors.primaryForeground,
+        '--sidebar-accent': accent,
+        '--sidebar-accent-foreground': colors.foreground,
+        '--sidebar-border': border,
+    };
+}
+export function getBrandCssVariables(config, mode) {
+    const colors = mode === 'dark' ? config.theme.colors.dark : config.theme.colors.light;
+    return {
+        ...buildModeVars(colors, mode),
+        '--radius': config.theme.radius,
+    };
+}
+function formatCssVars(vars) {
+    return Object.entries(vars)
+        .map(([key, value]) => `      ${key}: ${value};`)
+        .join('\n');
+}
+export function buildBrandCss(config) {
+    const normalized = normalizeBrandConfig(config);
+    const lightVars = getBrandCssVariables(normalized, 'light');
+    const darkVars = getBrandCssVariables(normalized, 'dark');
+    const fontFamily = fontSansToCssFamily(normalized.theme.font.sans);
+    return `
+    :root {
+${formatCssVars(lightVars)}
+    }
+
+    html[data-theme="dark"] {
+${formatCssVars(darkVars)}
+    }
+
+    html, body, button, input, select, textarea {
+      font-family: ${fontFamily};
+    }
+  `.trim();
+}
+export function resolveBrandThemeMode(config, preferredMode) {
+    if (preferredMode === 'light' || preferredMode === 'dark') {
+        return preferredMode;
+    }
+    const defaultMode = config.theme.defaultMode;
+    return defaultMode === 'dark' ? 'dark' : 'light';
+}
+function stripQueryAndHash(url) {
+    return url.split(/[?#]/)[0] ?? url;
+}
+export function inferImageMimeType(url) {
+    const lower = stripQueryAndHash(url).toLowerCase();
+    if (lower.endsWith('.svg'))
+        return 'image/svg+xml';
+    if (lower.endsWith('.png'))
+        return 'image/png';
+    if (lower.endsWith('.webp'))
+        return 'image/webp';
+    if (lower.endsWith('.jpg') || lower.endsWith('.jpeg'))
+        return 'image/jpeg';
+    if (lower.endsWith('.ico'))
+        return 'image/x-icon';
+    return undefined;
+}
+function inferIconSizes(url) {
+    const path = stripQueryAndHash(url);
+    if (/\.(svg|ico)$/i.test(path))
+        return 'any';
+    const match = path.match(/(?:^|[^\d])(\d{2,4})x\1(?:[^\d]|$)|(?:^|[^\d])(\d{2,4})(?:[^\d]|$)/);
+    const size = match?.[1] ?? match?.[2];
+    return size ? `${size}x${size}` : 'any';
+}
+function buildManifestIcon(src) {
+    return {
+        src,
+        sizes: inferIconSizes(src),
+        type: inferImageMimeType(src),
+        purpose: 'any',
+    };
+}
+export function buildBrandManifest(config) {
+    const normalized = normalizeBrandConfig(config);
+    const mode = resolveBrandThemeMode(normalized);
+    const colors = mode === 'dark' ? normalized.theme.colors.dark : normalized.theme.colors.light;
+    const defaultFavicon = normalized.favicon.default || FALLBACK_FAVICON;
+    const darkFavicon = normalized.favicon.dark?.trim();
+    const icons = [buildManifestIcon(defaultFavicon)];
+    if (darkFavicon && darkFavicon !== defaultFavicon) {
+        icons.push(buildManifestIcon(darkFavicon));
+    }
+    return {
+        name: normalized.brand.name,
+        short_name: normalized.brand.name,
+        description: normalized.brand.description || normalized.brand.tagline || normalized.brand.name,
+        icons,
+        theme_color: colors.primary,
+        background_color: colors.background,
+        display: 'standalone',
+        start_url: '/',
+    };
+}
+export function getBrandFaviconUrl(favicon, mode = 'light') {
+    const defaultFavicon = favicon?.default || FALLBACK_FAVICON;
+    const darkFavicon = favicon?.dark?.trim();
+    return mode === 'dark' && darkFavicon ? darkFavicon : defaultFavicon;
+}
+export function buildBrandIconsMetadata(favicon, mode = 'light') {
+    const activeFavicon = getBrandFaviconUrl(favicon, mode);
+    return {
+        icon: [{
+                url: activeFavicon,
+                type: inferImageMimeType(activeFavicon),
+                media: 'all',
+            }],
+        shortcut: activeFavicon,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/brand/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/brand/config.ts"],"names":[],"mappings":"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","sourcesContent":["import type { BrandConfig, BackendBrandLogoType, BrandLogoType, ColorSet } from './types.js';\n\nexport type BrandMode = 'light' | 'dark';\n\nexport interface BrandManifestIcon {\n  src: string;\n  sizes: string;\n  type?: string;\n  purpose?: 'any' | 'maskable' | 'monochrome';\n}\n\nexport interface BrandWebManifest {\n  name: string;\n  short_name: string;\n  description: string;\n  icons: BrandManifestIcon[];\n  theme_color: string;\n  background_color: string;\n  display: 'standalone';\n  start_url: string;\n}\n\nexport interface BrandIconDescriptor {\n  url: string;\n  type?: string;\n  media?: string;\n}\n\nconst FALLBACK_FAVICON = '/favicon.ico';\nconst FALLBACK_FONT = 'Inter';\nconst FALLBACK_LOGO_WIDTH = '160px';\nconst FALLBACK_LOGO_HEIGHT = '40px';\nconst SAFE_LOGO_KEYWORDS = new Set(['auto', 'fit-content']);\nconst SAFE_LOGO_DIMENSION_PATTERN = /^(\\d+(?:\\.\\d+)?)(px|rem|em|%|vw|vh)$/i;\n\nexport interface NormalizedLogoLayout {\n  width: string;\n  height: string;\n}\n\nexport function normalizeLogoType(type: BackendBrandLogoType | string | null | undefined): BrandLogoType {\n  return type === 'text' ? 'text' : 'image';\n}\n\nexport function isImageLogoType(type: BackendBrandLogoType | string | null | undefined): boolean {\n  return normalizeLogoType(type) === 'image';\n}\n\nexport function normalizeLogoDimension(\n  value: string | number | null | undefined,\n  fallback: string,\n): string {\n  if (typeof value === 'number') {\n    return Number.isFinite(value) && value >= 0 ? `${value}px` : fallback;\n  }\n\n  const raw = value?.trim();\n  if (!raw) return fallback;\n\n  const lower = raw.toLowerCase();\n  if (SAFE_LOGO_KEYWORDS.has(lower)) return lower;\n\n  const match = lower.match(SAFE_LOGO_DIMENSION_PATTERN);\n  if (!match) return fallback;\n\n  const amount = Number(match[1]);\n  if (!Number.isFinite(amount) || amount < 0) return fallback;\n\n  return `${match[1]}${match[2].toLowerCase()}`;\n}\n\nexport function normalizeLogoLayout(\n  layout: BrandConfig['brand']['logo']['layout'] | null | undefined,\n): NormalizedLogoLayout {\n  return {\n    width: normalizeLogoDimension(layout?.width, FALLBACK_LOGO_WIDTH),\n    height: normalizeLogoDimension(layout?.height, FALLBACK_LOGO_HEIGHT),\n  };\n}\n\nexport function normalizeFontSans(value: string | null | undefined): string {\n  const raw = value?.trim();\n  if (!raw) return FALLBACK_FONT;\n\n  if (!raw.includes(',')) {\n    return raw.replace(/['\"`]/g, '').trim() || FALLBACK_FONT;\n  }\n\n  return raw.split(',')[0]?.replace(/['\"`]/g, '').trim() || FALLBACK_FONT;\n}\n\nfunction quoteFontFamily(name: string): string {\n  const clean = name.replace(/['\"`]/g, '').trim();\n  if (!clean || clean === 'System') {\n    return 'ui-sans-serif, system-ui, sans-serif';\n  }\n\n  return `'${clean}', ui-sans-serif, system-ui, sans-serif`;\n}\n\nexport function fontSansToCssFamily(value: string | null | undefined): string {\n  return quoteFontFamily(normalizeFontSans(value));\n}\n\nexport function normalizeBrandConfig(config: BrandConfig): BrandConfig {\n  const logo = config.brand.logo;\n  const text = logo.text ?? { base: config.brand.name, accent: '' };\n\n  return {\n    ...config,\n    brand: {\n      ...config.brand,\n      logo: {\n        ...logo,\n        type: normalizeLogoType(logo.type),\n        imageUrl: logo.imageUrl ?? '',\n        darkImageUrl: logo.darkImageUrl ?? null,\n        layout: normalizeLogoLayout(logo.layout),\n        text: {\n          ...text,\n          base: text.base ?? config.brand.name,\n          accent: text.accent ?? '',\n          fontFamily: text.fontFamily ? normalizeFontSans(text.fontFamily) : text.fontFamily,\n        },\n      },\n    },\n    favicon: {\n      default: config.favicon?.default ?? FALLBACK_FAVICON,\n      dark: config.favicon?.dark ?? null,\n    },\n    theme: {\n      ...config.theme,\n      font: {\n        ...config.theme.font,\n        sans: normalizeFontSans(config.theme.font?.sans),\n      },\n    },\n  };\n}\n\nexport function getLogoImageUrl(\n  logo: BrandConfig['brand']['logo'],\n  mode: BrandMode = 'light',\n): string | null {\n  if (!isImageLogoType(logo.type)) return null;\n\n  const darkUrl = logo.darkImageUrl?.trim();\n  const defaultUrl = logo.imageUrl?.trim();\n\n  return (mode === 'dark' && darkUrl ? darkUrl : defaultUrl) || null;\n}\n\nexport function getLogoTextFontFamily(config: BrandConfig): string {\n  return fontSansToCssFamily(config.brand.logo.text.fontFamily || config.theme.font.sans);\n}\n\nexport function getLogoTextColors(config: BrandConfig, mode: BrandMode) {\n  return config.brand.logo.text.colors?.[mode] ?? {};\n}\n\nfunction colorMixHex(a: string, b: string, t: number): string {\n  const pa = parseHex(a);\n  const pb = parseHex(b);\n  if (!pa || !pb) return a;\n\n  const r = Math.round(pa[0] + (pb[0] - pa[0]) * t);\n  const g = Math.round(pa[1] + (pb[1] - pa[1]) * t);\n  const bl = Math.round(pa[2] + (pb[2] - pa[2]) * t);\n\n  return `#${hex2(r)}${hex2(g)}${hex2(bl)}`;\n}\n\nfunction hexToRgbaValue(hex: string, alpha: number): string {\n  const parsed = parseHex(hex);\n  if (!parsed) return `rgba(128,128,128,${alpha})`;\n\n  return `rgba(${parsed[0]},${parsed[1]},${parsed[2]},${alpha})`;\n}\n\nfunction parseHex(hex: string): [number, number, number] | null {\n  const clean = hex.replace('#', '');\n  const full = clean.length === 3\n    ? clean.split('').map((c) => c + c).join('')\n    : clean;\n\n  if (!/^[0-9a-fA-F]{6}$/.test(full)) return null;\n\n  return [\n    parseInt(full.slice(0, 2), 16),\n    parseInt(full.slice(2, 4), 16),\n    parseInt(full.slice(4, 6), 16),\n  ];\n}\n\nfunction hex2(n: number): string {\n  return n.toString(16).padStart(2, '0');\n}\n\nfunction buildModeVars(colors: ColorSet, mode: BrandMode) {\n  const isDark = mode === 'dark';\n  const secondary = colorMixHex(colors.background, isDark ? '#ffffff' : '#000000', isDark ? 0.12 : 0.05);\n  const muted = colorMixHex(colors.background, isDark ? '#ffffff' : '#888888', isDark ? 0.08 : 0.07);\n  const accent = colorMixHex(colors.background, isDark ? '#ffffff' : '#000000', isDark ? 0.16 : 0.08);\n  const border = hexToRgbaValue(colors.foreground, isDark ? 0.12 : 0.1);\n  const mutedForeground = hexToRgbaValue(colors.foreground, isDark ? 0.68 : 0.62);\n\n  return {\n    '--primary': colors.primary,\n    '--primary-foreground': colors.primaryForeground,\n    '--background': colors.background,\n    '--foreground': colors.foreground,\n    '--card': colors.background,\n    '--card-foreground': colors.foreground,\n    '--secondary': secondary,\n    '--secondary-foreground': colors.foreground,\n    '--muted': muted,\n    '--muted-foreground': mutedForeground,\n    '--accent': accent,\n    '--accent-foreground': colors.foreground,\n    '--border': border,\n    '--ring': colors.primary,\n    '--sidebar': colors.background,\n    '--sidebar-foreground': colors.foreground,\n    '--sidebar-primary': colors.primary,\n    '--sidebar-primary-foreground': colors.primaryForeground,\n    '--sidebar-accent': accent,\n    '--sidebar-accent-foreground': colors.foreground,\n    '--sidebar-border': border,\n  };\n}\n\nexport function getBrandCssVariables(config: BrandConfig, mode: BrandMode) {\n  const colors = mode === 'dark' ? config.theme.colors.dark : config.theme.colors.light;\n  return {\n    ...buildModeVars(colors, mode),\n    '--radius': config.theme.radius,\n  };\n}\n\nfunction formatCssVars(vars: Record<string, string>): string {\n  return Object.entries(vars)\n    .map(([key, value]) => `      ${key}: ${value};`)\n    .join('\\n');\n}\n\nexport function buildBrandCss(config: BrandConfig): string {\n  const normalized = normalizeBrandConfig(config);\n  const lightVars = getBrandCssVariables(normalized, 'light');\n  const darkVars = getBrandCssVariables(normalized, 'dark');\n  const fontFamily = fontSansToCssFamily(normalized.theme.font.sans);\n\n  return `\n    :root {\n${formatCssVars(lightVars)}\n    }\n\n    html[data-theme=\"dark\"] {\n${formatCssVars(darkVars)}\n    }\n\n    html, body, button, input, select, textarea {\n      font-family: ${fontFamily};\n    }\n  `.trim();\n}\n\nexport function resolveBrandThemeMode(config: BrandConfig, preferredMode?: string | null): BrandMode {\n  if (preferredMode === 'light' || preferredMode === 'dark') {\n    return preferredMode;\n  }\n\n  const defaultMode = config.theme.defaultMode;\n  return defaultMode === 'dark' ? 'dark' : 'light';\n}\n\nfunction stripQueryAndHash(url: string): string {\n  return url.split(/[?#]/)[0] ?? url;\n}\n\nexport function inferImageMimeType(url: string): string | undefined {\n  const lower = stripQueryAndHash(url).toLowerCase();\n  if (lower.endsWith('.svg')) return 'image/svg+xml';\n  if (lower.endsWith('.png')) return 'image/png';\n  if (lower.endsWith('.webp')) return 'image/webp';\n  if (lower.endsWith('.jpg') || lower.endsWith('.jpeg')) return 'image/jpeg';\n  if (lower.endsWith('.ico')) return 'image/x-icon';\n  return undefined;\n}\n\nfunction inferIconSizes(url: string): string {\n  const path = stripQueryAndHash(url);\n  if (/\\.(svg|ico)$/i.test(path)) return 'any';\n\n  const match = path.match(/(?:^|[^\\d])(\\d{2,4})x\\1(?:[^\\d]|$)|(?:^|[^\\d])(\\d{2,4})(?:[^\\d]|$)/);\n  const size = match?.[1] ?? match?.[2];\n  return size ? `${size}x${size}` : 'any';\n}\n\nfunction buildManifestIcon(src: string): BrandManifestIcon {\n  return {\n    src,\n    sizes: inferIconSizes(src),\n    type: inferImageMimeType(src),\n    purpose: 'any',\n  };\n}\n\nexport function buildBrandManifest(config: BrandConfig): BrandWebManifest {\n  const normalized = normalizeBrandConfig(config);\n  const mode = resolveBrandThemeMode(normalized);\n  const colors = mode === 'dark' ? normalized.theme.colors.dark : normalized.theme.colors.light;\n  const defaultFavicon = normalized.favicon.default || FALLBACK_FAVICON;\n  const darkFavicon = normalized.favicon.dark?.trim();\n  const icons = [buildManifestIcon(defaultFavicon)];\n\n  if (darkFavicon && darkFavicon !== defaultFavicon) {\n    icons.push(buildManifestIcon(darkFavicon));\n  }\n\n  return {\n    name: normalized.brand.name,\n    short_name: normalized.brand.name,\n    description: normalized.brand.description || normalized.brand.tagline || normalized.brand.name,\n    icons,\n    theme_color: colors.primary,\n    background_color: colors.background,\n    display: 'standalone',\n    start_url: '/',\n  };\n}\n\nexport function getBrandFaviconUrl(\n  favicon: BrandConfig['favicon'],\n  mode: BrandMode = 'light',\n): string {\n  const defaultFavicon = favicon?.default || FALLBACK_FAVICON;\n  const darkFavicon = favicon?.dark?.trim();\n  return mode === 'dark' && darkFavicon ? darkFavicon : defaultFavicon;\n}\n\nexport function buildBrandIconsMetadata(\n  favicon: BrandConfig['favicon'],\n  mode: BrandMode = 'light',\n) {\n  const activeFavicon = getBrandFaviconUrl(favicon, mode);\n\n  return {\n    icon: [{\n      url: activeFavicon,\n      type: inferImageMimeType(activeFavicon),\n      media: 'all',\n    }],\n    shortcut: activeFavicon,\n  };\n}\n"]}

package/dist/brand/index.d.ts

@@ -0,0 +1,4 @@
+export type { BackendBrandLogoType, BrandConfig, BrandLogoType, ColorSet, DeepPartial, SecurityTxtConfig, } from './types.js';
+export { buildBrandCss, buildBrandIconsMetadata, buildBrandManifest, fontSansToCssFamily, getBrandCssVariables, getBrandFaviconUrl, getLogoImageUrl, getLogoTextColors, getLogoTextFontFamily, inferImageMimeType, isImageLogoType, normalizeBrandConfig, normalizeFontSans, normalizeLogoDimension, normalizeLogoLayout, normalizeLogoType, resolveBrandThemeMode, } from './config.js';
+export type { BrandIconDescriptor, BrandManifestIcon, BrandMode, BrandWebManifest, NormalizedLogoLayout, } from './config.js';
+//# sourceMappingURL=index.d.ts.map