🥷 Guia Técnico: Motor AutoPlay v1.2.2 (ZeroAnuncios Netflix)

Este documento detalha o funcionamento interno da extensão e como ela lida com o ambiente dinâmico da Netflix (motor React).

🚀 Arquitetura Geral

O projeto segue a Single Script Architecture, utilizando Vanilla JavaScript para evitar qualquer dependência externa ou processo de compilação complexo.

🧩 Componentes Chave

1. content.js — O Núcleo do Motor

• Observe & React: Utiliza MutationObserver no document.body com childList: true e subtree: true. Isso permite que o script detecte quando um botão de "Skip" é renderizado pelo React da Netflix sem a necessidade de polling ineficiente.
• Estratégia Híbrida de Seleção:
  • Nível 1 (Seletores Tradicionais): Prioriza seletores de atributo de dados da Netflix ([data-uia="player-skip-intro"], etc.).
  • Nível 2 (Seleções de Classe): Varre classes específicas de botões de controle de vídeo.
  • Nível 3 (Deep Text Scan Fallback): Se a Netflix atualizar os IDs técnicos, o script varre todos os span e button buscando os textos-alvo (TARGET_TEXTS) que o usuário realmente vê na tela.
• Toggle State Sync: O script escuta o evento browser.storage.onChanged para ativar ou desativar o clique automático em tempo real sem a necessidade de recarregar a página.

2. background.js — O Vigia

• Ouvinte de Eventos: Mantém o log de auditoria e garante que os estados padrão (is_active: true, netflix_skipped: 0) sejam inicializados na instalação.
• Mensageria: Recebe o sinal AD_DETECTED do content script (embora na Netflix foquemos em Skip Intro, a arquitetura AutoPlay mantém compatibilidade com o modelo de bloqueio de anúncios).

3. popup.js / popup.html — O Painel de Controle (Scarlet Edition)

• Cálculo de Tempo Salvo: Estimamos uma economia média de 25 segundos por cada item pulado (Somas de Abertura + Resumo + Próximo Episódio).
• Rastreamento Temporal: Mantém entradas diárias e semanais (netflix_hoje_date, netflix_semana_dates), limpando automaticamente dados mais antigos que 7 dias para manter o storage leve.

🛡️ Segurança e Privacidade

• browser vs chrome: Utilizamos a namespace browser (com fallback ou compatibilidade) para seguir o padrão moderno W3C para extensões.
• XSS Prevention: No popup, o log de auditoria é renderizado usando textContent e createElement, garantindo que nenhum script malicioso possa ser injetado.

🛠️ Manutenção e Atualização

Para adicionar novos alvos (como novos idiomas de botões), basta atualizar a constante TARGET_TEXTS no content.js:

const TARGET_TEXTS = [
'Pular abertura',
'Skip Intro',
// Adicione novos aqui...
];




Desenvolvido por Araken Carmo Neto.

ZeroAnuncios: Rapidez, Silêncio e Precisão. 🥷🔥