Quando auto_detect_url está habilitado, o servidor resolve furniture, revestimento ou pisos a partir do produto autorizado e da URL da página. Não envie um identificador ou tipo de produto pelo navegador: a decisão pertence ao servidor.

Fashion usa /api/v2/snippet-fashion/[UUID], o matcher de URL é o comportamento padrão e o produto é encontrado pela página autorizada. Não há override manual de produto documentado para esse runtime, e Fashion não usa a Promise ou os eventos de prontidão do Home.

Medidas consulta /api/v2/widget-measurements/match e usa sua própria resposta JSON de capacidades e seu próprio runtime. O objeto público, quando a ação é elegível, é window.ReverbsWidgetV2Measurements; ele não é o objeto Home e não fornece a Promise de prontidão do Home.

• Capture de forma síncrona o elemento que iniciou o script com document.currentScript. Leia dele o data-provei-user-id e valide o mesmo UUID aceito por /api/v2/snippet/[userId] antes de construir seletores ou fazer qualquer requisição.
• Registre, antes de inserir o runtime, listeners filtrados pelo mesmo proprietário para reverbs:ready e reverbs:error. Ignore eventos terminais cujo userId seja de outra instalação.
• Insira exatamente o runtime clássico em https://app.provei.ai/api/v2/snippet/<encoded UUID>, usando encodeURIComponent no UUID. O elemento precisa ter async, crossOrigin="anonymous", o atributo data-provei-runtime e o mesmo data-provei-user-id.
• Consuma window.reverbsWidgetReady somente quando window.reverbsWidgetOwnerId corresponder ao UUID capturado. Uma Promise de outro proprietário é um conflito e não deve ser controlada pelo loader da loja.
• Para Home, nunca envie no navegador um ID de produto ou um tipo de produto. A origem e o caminho atuais, junto com a configuração provisionada, definem a correspondência no servidor.

Fixe o UUID esperado no código de consumo e filtre cada evento terminal antes de agir. O exemplo abaixo mostra as duas ordens seguras: registre listeners antes de recarregar/inserir o loader, ou aguarde a Promise existente somente depois de confirmar o mesmo proprietário.

(function () {
  var expectedOwnerId = "11111111-1111-4111-8111-111111111111";
  var finished = false;

  function detailOf(event) {
    return event && event.detail ? event.detail : event;
  }

  function belongsToThisOwner(detail) {
    return detail && detail.userId === expectedOwnerId;
  }

  function cleanup() {
    window.removeEventListener("reverbs:ready", onReady);
    window.removeEventListener("reverbs:error", onError);
  }

  function onReady(event) {
    var detail = detailOf(event);
    if (finished || !belongsToThisOwner(detail)) return;
    var widget = detail.widget;
    if (!widget) return;
    finished = true;
    cleanup();
    // O runtime está inicializado; abrir depende de uma ação explícita.
  }

  function onError(event) {
    var detail = detailOf(event);
    if (finished || !belongsToThisOwner(detail)) return;
    finished = true;
    cleanup();
    console.error(detail.code, detail.message);
  }

  // Opção 1: execute antes de inserir ou recarregar a tag do loader.
  window.addEventListener("reverbs:ready", onReady);
  window.addEventListener("reverbs:error", onError);

  // Opção 2: se o loader já existe, reutilize a Promise do mesmo owner.
  if (window.reverbsWidgetOwnerId === expectedOwnerId &&
      window.reverbsWidgetReady &&
      typeof window.reverbsWidgetReady.then === "function") {
    window.reverbsWidgetReady.then(
      function (widget) {
        onReady({ detail: { userId: expectedOwnerId, widget: widget } });
      },
      onError
    );
  }
})();

reverbs:ready confirma apenas o estado de runtime inicializado. Ele não prova que o plano, créditos ou correspondência do produto produziram um launcher visível. O erro terminal usa code, message e userId; inclua também invalid_owner_id e owner_conflict no tratamento.

Depois de ready, remova somente os listeners da loja e mantenha o runtime vivo: o handler de prontidão não deve chamar open() nem remover o elemento de runtime. A remoção do runtime pertence às fronteiras de falha de carregamento (script_load_failed) ou de destroy(), não ao caminho de sucesso. Essa limpeza de listeners é garantida após um resultado terminal; não há timeout oculto para uma requisição de rede que permaneça indefinidamente pendente.

Os métodos Home documentados são open, close e destroy. Eventos de abertura, fechamento e destruição são observáveis em reverbs:open, reverbs:close e reverbs:destroy.

Em uma SPA, mantenha um único loader clássico global. O runtime acompanha mudanças de rota e rematcha a URL autorizada; não reinsira a tag a cada pushState, replaceState, popstate ou hashchange.

• Cargas repetidas ou concorrentes do mesmo UUID compartilham a Promise singleton e o objeto do mesmo runtime.
• Um segundo UUID não substitui o primeiro: emita owner_conflict em reverbs:error e não acrescente um runtime do segundo proprietário.
• Após destroy(), o runtime pertencente e seus listeners internos são removidos; reinserir o mesmo loader pode iniciar uma nova instalação limpa. Listeners registrados pela loja precisam seguir a própria regra de limpeza terminal.

O suporte/admin do Provei, e não um painel de autoatendimento do cliente, deve registrar a origem principal da loja e cada origem adicional que realmente carregará o widget. Envie a origem HTTPS completa, sem caminho, query ou fragmento.

• https://loja.exemplo.com.br e https://www.loja.exemplo.com.br são origens diferentes; registre cada uma quando ambas forem usadas.
• Registre previews ou checkout somente se o runtime for carregado neles. Não use um curinga para substituir a autorização explícita.
• O User ID e os marcadores HTML identificam o proprietário, mas não autorizam uma origem não registrada.

A correspondência compara a origem e o caminho do produto ativo com a página atual depois da normalização. Protocolo e host são tratados na forma canônica da URL, e a comparação não diferencia maiúsculas de minúsculas; query string e hash não participam da identidade; barras finais são removidas para evitar uma diferença artificial. O caminho continua sendo relevante para escolher o produto.

Se houver uma correspondência ambígua, indisponível ou não provisionada, o resultado é no-match: o servidor não escolhe um produto arbitrário e o loader não é rejeitado por isso. Se show_on_all_pages e button_enabled estiverem ativos, um botão ainda pode aparecer sem correspondência;open() continua exigindo uma correspondência elegível. Sem essa configuração, o script pode ter sido autorizado e inicializado, mas nenhum launcher aparecerá.

Comece com uma política mínima para o runtime. O domínio do Provei deve aparecer em script-src, connect-src e frame-src. Não inclua hosts de analytics ou de gerenciadores de tags na política base se esses recursos não estiverem habilitados.

Content-Security-Policy:
  script-src 'self' https://app.provei.ai;
  connect-src 'self' https://app.provei.ai;
  frame-src 'self' https://app.provei.ai;
  style-src 'self';
  img-src 'self';

O loader inline de referência e os estilos inline atuais precisam seguir a política de inline escolhida pelo site: use um nonce/hash aplicado corretamente ou, quando essa for a decisão de segurança da loja, 'unsafe-inline' emscript-src e style-src. Um nonce/hash do script não autoriza estilos diferentes, e vice-versa.

script-src 'self' https://app.provei.ai 'nonce-<NONCE-DO-SITE>';
style-src 'self' 'nonce-<NONCE-DO-SITE>';
img-src 'self' https://cdn.configurado-pela-loja.example data: blob:;

Substitua o CDN de exemplo pelos CDNs configurados para as superfícies de imagem habilitadas. Mantenha apenas as fontes de imagem necessárias, incluindodata: e blob: somente se a experiência realmente as usar.

script-src 'self' https://app.provei.ai https://www.googletagmanager.com;
connect-src 'self' https://app.provei.ai https://www.google-analytics.com https://region1.google-analytics.com;
frame-src 'self' https://app.provei.ai https://www.googletagmanager.com;

O bloco GTM/Analytics é separado de propósito: acrescente os hosts acima somente quando o GTM estiver configurado e quando as tags publicadas realmente fizerem essas chamadas. As tags do container podem exigir outros hosts; permita-os individualmente, conforme a configuração aprovada.

Os marcadores abaixo são verificáveis somente no loader de referência fornecido pelo Provei ou no loader externo personalizado da loja. A tag direta não cria data-provei-widget-loader; use a checagem separada logo abaixo para esse formato. Rode a opção 1 antes de reinserir a tag ou a opção 2 se a Promise do mesmo owner já existir.

var expectedOwnerId = "11111111-1111-4111-8111-111111111111";
var expectedRuntimeSrc =
  "https://app.provei.ai/api/v2/snippet/" + encodeURIComponent(expectedOwnerId);

function assertHomeInstallation() {
  var loaders = document.querySelectorAll(
    'script[data-provei-widget-loader][data-provei-user-id]'
  );
  var runtimes = document.querySelectorAll(
    'script[data-provei-runtime][data-provei-user-id]'
  );
  console.assert(loaders.length === 1, "um loader marcado");
  console.assert(runtimes.length === 1, "um runtime marcado");

  var loader = loaders[0];
  var runtime = runtimes[0];
  console.assert(loader.getAttribute("data-provei-user-id") === expectedOwnerId);
  console.assert(runtime.getAttribute("data-provei-user-id") === expectedOwnerId);
  console.assert(runtime.src === expectedRuntimeSrc);
  console.assert(runtime.crossOrigin === "anonymous");
  console.assert(window.reverbsWidgetOwnerId === expectedOwnerId);

  var ready = window.reverbsWidgetReady;
  console.assert(ready && typeof ready.then === "function");
  if (ready && typeof ready.then === "function") {
    ready.then(function (widget) {
      console.assert(widget === window.reverbsWidget);
      console.assert(typeof widget.open === "function");
      console.assert(typeof widget.close === "function");
      console.assert(typeof widget.destroy === "function");
    });
  }
}

// Opção 1: listeners antes da inserção/reload.
window.addEventListener("reverbs:ready", function (event) {
  if (event.detail && event.detail.userId === expectedOwnerId) {
    console.assert(event.detail.widget === window.reverbsWidget);
  }
});
// Opção 2: use a Promise somente depois de confirmar o owner.
assertHomeInstallation();

Depois da inicialização, se o botão estiver visível, clique nele e confirme o iframe /widget-v2/[UUID]. Com show_on_all_pages, o botão pode aparecer sem produto elegível, mas open() será um no-op até existir uma correspondência. Uma inicialização correta sem produto elegível é diferente de um erro de runtime.

Na instalação direta, confira o único elemento de script que aponta para o endpoint Home. Ele não é um loader marcado nem um runtime inserido por loader: a própria tag baixa o runtime gerado.

var expectedOwnerId = "11111111-1111-4111-8111-111111111111";
var expectedRuntimeSrc =
  "https://app.provei.ai/api/v2/snippet/" + encodeURIComponent(expectedOwnerId);

var directTags = Array.prototype.filter.call(document.scripts, function (script) {
  return script.src === expectedRuntimeSrc &&
    !script.hasAttribute("data-provei-widget-loader") &&
    !script.hasAttribute("data-provei-runtime");
});
console.assert(directTags.length === 1, "uma tag direta Home");
if (directTags.length === 1) {
  console.assert(directTags[0].async, "tag direta assíncrona");
  console.assert(directTags[0].crossOrigin === "anonymous", "CORS anônimo");
}
console.assert(window.reverbsWidgetOwnerId === expectedOwnerId);
console.assert(
  window.reverbsWidgetReady &&
  typeof window.reverbsWidgetReady.then === "function",
  "Promise do runtime Home"
);

Em Fashion, verifique a tag do endpoint de moda, o matcher da URL e o objeto window.reverbsWidgetFashion no momento da ação do comprador. Fashion não expõe a Promise ou o evento de prontidão do Home; o teste deve disparar a ação de experimentar e observar a interface e os eventos próprios dessa linha.

Em Medidas, confirme a requisição GET a /api/v2/widget-measurements/match, a resposta de capacidades e a renderização das ações elegíveis. Verifique o global exato window.ReverbsWidgetV2Measurements e não procure window.reverbsWidgetReady: esse é um runtime independente.