Guia

Licenciamento

Todos os recursos são gratuitos. Uma licença paga apenas remove a marca-d'água “Powered by KatuCharts” — e a ativação é uma única linha de código.

Como funciona

Os gráficos são renderizados com todos os recursos liberados mesmo sem licença; a única diferença é uma pequena marca-d'água “Powered by KatuCharts”. Uma licença fornece uma chave que a remove. O endpoint de verificação já vem embutido no pacote publicado, então não há transporte para configurar — basta definir a chave.

Ative sua chave

Aplique sua chave uma vez na inicialização, antes de criar qualquer gráfico. Como o endpoint de verificação já vem no pacote, uma única chamada a setLicenseKey é tudo o que você precisa:

import KatuCharts from 'katucharts.js';

// run once at startup, before creating any chart
KatuCharts.setLicenseKey('YOUR_LICENSE_KEY');

Obtenha sua chave no seu painel da conta após a compra. localhost sempre valida durante o desenvolvimento, então você pode integrar antes de publicar.

Domínios e assentos

Uma chave se vincula aos domínios onde é executada, até o limite de assentos do seu plano:

Os primeiros domínios onde a chave roda são registrados como assentos, até o limite do seu plano.
localhost e endereços locais são sempre permitidos e nunca consomem um assento.
Libere um domínio no seu painel para liberar um assento e mover a licença.

Modo estrito e hospedagem própria

Por padrão, a chave é confirmada online em segundo plano e os gráficos continuam funcionando durante breves interrupções de rede (modo leniente). Passe opções para configureLicensing para exigir uma confirmação online, apontar para seu próprio endpoint de verificação ou ajustar a janela de tolerância offline:

KatuCharts.configureLicensing({
  mode: 'strict',          // require an online confirmation; default 'lenient'
  verifyUrl: 'https://charts.example.com/api/v1/license/verify',
  gracePeriodMs: 7 * 24 * 60 * 60 * 1000,
});
KatuCharts.setLicenseKey('YOUR_LICENSE_KEY');

A maioria dos aplicativos nunca precisa disso — os padrões cuidam da ativação sozinhos.

Verifique o estado da licença

isLicensed() informa se há uma chave válida ativa no momento, para você registrar ou sinalizar o uso sem licença:

KatuCharts.setLicenseKey('YOUR_LICENSE_KEY');
if (!KatuCharts.isLicensed()) {
  console.warn('KatuCharts running unlicensed — watermark shown.');
}