VTEX Companion

É uma ferramenta de diagnóstico para quem desenvolve em VTEX. Não há servidor: a extensão lê a aba sob demanda e descarta quando o painel fecha. Nenhum dado seu sai do navegador. DETECÇÃO DA STACK • É VTEX? Com que confiança e por quais sinais • Tecnologia: VTEX IO (Store Framework), FastStore, CMS Legacy Portal ou headless • Account, workspace e binding • Admin x loja final, e se a URL está num workspace de desenvolvimento • Tipo de página: home, PDP, listagem, busca, checkout, order placed, login CATÁLOGO DA PÁGINA • PDP: produto, referência, marca, categoria e a lista de SKUs com EAN, refId, seller, disponibilidade e preço, mais atalho para o admin • Listagem e busca: categoria, caminho, termo, map, ordenação e página SEO DA PÁGINA • Indexação (robots, googlebot), title, description, canonical, lang • Open Graph, Twitter, hreflang, JSON-LD, headings e imagens sem alt • Regras por tipo de página: PDP sem Product, listagem sem ItemList SCRIPTS DE TERCEIROS • Quais tags de analytics, publicidade, remarketing e monitoramento a página carrega, com o id da conta quando ele está exposto no próprio script • Origens de terceiros que a extensão não reconhece, agrupadas por volume de requisições NAVEGAÇÃO • Abrir a mesma rota em outro workspace, com os recentes e a volta ao master • Flags de URL em um clique: Site Editor, sem SSR, binding address e sales channel FETCH RUNNER • Chame as APIs da loja de dentro da própria aba, com a sessão que ela já tem • Presets prontos para as APIs de sessão, checkout, catálogo, busca, pedidos e master data da loja • Confirmação explícita antes de qualquer método que altera dados • Resposta formatada com realce ou o corpo cru, histórico da sessão e cópia como JSON ou CSV • Disponível no popup e num painel VTEX Companion dentro do DevTools SESSÃO • Os cookies de sessão presentes na origem, com o escopo de cada um • Clonar a sessão de {account}.myvtex.com para o domínio da loja, sem o token passar pela área de transferência • Entrar numa origem colando um token, e limpar todos os cookies de sessão de uma vez • O token nunca é gravado pela extensão nem sai da máquina, e os controles só aparecem em domínio reconhecido como VTEX • Segmento da loja (vtex_segment) decodificado e editável: sales channel, culture info, moeda, region id e o JSON inteiro PREVIEW DO FASTSTORE NO LOCALHOST O botão Pré-visualização do CMS do FastStore (o Headless CMS (legacy) e o Storefront > Content) abre a loja publicada. A extensão injeta um botão Localhost ao lado dele que abre a mesma URL no seu dev server, com a query inteira preservada, nas duas versões do CMS e sem depender do cmsDevMode. Também há redirecionamento automático da aba de preview, a última URL capturada com copiar/abrir, e o liga/desliga do cmsDevMode com status por frame. Lojas em VTEX IO e no portal legacy pré-visualizam por workspace e não usam esse fluxo; a aba Preview diz isso quando a loja é de uma dessas plataformas, em vez de mostrar controles que não fazem nada. NO ANDROID A extensão também é oferecida no Firefox para Android, onde tudo passa pelo popup: detecção, catálogo, SEO, scripts, sessão e o runner. O painel do DevTools não existe lá, porque o navegador não tem DevTools no aparelho, e o preview no localhost pressupõe um servidor de desenvolvimento na mesma máquina. PRIVACIDADE Não há servidor e nenhum dado é coletado, armazenado remotamente ou transmitido. Não existe content script global: a leitura da página é injetada sob demanda quando você abre o painel, e por isso a instalação não pede "ler dados em todos os sites". O acesso fixo é só a *.myvtex.com e localhost; o domínio da loja é opcional e concedido por você, site a site. Política de privacidade: https://leocadio.dev/vtex-companion/privacy/ Projeto independente e de código aberto, sem associação com a VTEX. Não é um produto oficial dela. Página do projeto: https://leocadio.dev/vtex-companion/ Código-fonte: https://github.com/Leocadio94/vtex-companion-extension