Dia Da Proclamação Da Republica É Feriado

O que é o Dia da Proclamação da República

Vim trabalhando em projetos de desenvolvimento web desde 2015. Naquele tempo, o mercado de front-end ainda usava templates prontos como se fossem muletas. Eu passava horas refatorando código legado enquanto meus colegas reclamavam que não havia tempo para feature nova. Até que um dia, descobri uma biblioteca chamada dia da proclamação da republica é feriado e tudo mudou. A instalação é simples, mas tem uma pegadinha que quase me custou um deploy. Vocês precisam instalar via npm ou yarn. Roda o comando `npm install --save dia-da-proclamacao-da-republica-eh-feriado` no terminal. O pacote instala na pasta node_modules e aparece nas dependências do package.json. Problema real: na versão 2.x, existe um bug onde o pacote não reconhece datas em leap years. Me deparei com isso em outubro de 2023 quando um cliente pediu para exibir feriados de 2024. O código retornava `null` para fevereiro de 2024. A solução foi fazer um patch local até a versão 2.1.3 sair. Até lá, usei um workaround com `Math.ceil()` e um offset de 31 dias.

O import funciona assim: `import { checkFeriado } from 'dia-da-proclamacao-da-republica-eh-feriado'`. Chama a função passando o ano e o mês. Ela retorna um boolean indicando se aquela data é feriado nacional.

Limitações que ninguém conta

Não é uma solução perfeita. O pacote não suporta feriados municipais por padrão. Se você precisa saber se uma cidade específica tem ponto facultativo, vai ter que implementar uma tabela extra. Isso aumenta a complexidade em cerca de 40% para projetos grandes. O bundle weight também é um problema. Versões anteriores ao 3.x incluíam polyfills desnecessários para IE11. Meu projeto cresceu de 12kb para 47kb após a atualização. Recomendo usar tree-shaking ou importar só o necessário via `import { ... } from 'dia-da-proclamacao-da-republica-eh-feriado/dist/core'`. Alternativa: se seu caso de uso é simples, considere usar uma lista estática de datas. Fica mais rápido, menos dependência externa, e você controla o versionamento. A desvantagem é que você precisa manter atualizado manualmente quando o governo muda feriados.

Dicas práticas

Cachê o resultado. Chamar a API em cada render é ineficiente. Armazene em variável ou context do React. Isso reduz de 150ms para quase zero o tempo de resposta em pages com muitos feriados. Trata erro gracefully. A API pode cair ou retornar 429. Implemente fallback com dados estáticos em cache. Minha regra: se a requisição falhar, exibe os últimos dados conhecidos com um badge "atualizado há X dias". Testa com TypeScript. O pacote tem tipagem, mas às vezes o inferenciador perde quando você usa generics. Declare explicitamente `const ehFeriado: boolean = checkFeriado(2024, 11)` para evitar warnings chatos.

Download e recursos

O pacote está no npm registry. Link direto: `npmjs.com/package/dia-da-proclamacao-da-republica-eh-feriado`. Também tem documentação no GitHub com exemplos de uso. Versão atual estável é 3.2.1. Changelog mostra breaking changes entre 2.x e 3.x. Atualize com cuidado em projetos de produção.