> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-pt-br/sdks/sdk-web/changelogs/sdk-web-wc.md).

# @facephi/sdk-web-wc

## @facephi/sdk-web-wc

## 3.38.1

Release: 13-08-2026

### Alterações de patch

* Adicionado tratamento de tentativas máximas aos widgets Selphi e SelphID
* Corrigido um erro não bloqueante que interrompia incorretamente os widgets de captura biométrica e de documento.

  Corrigida uma solicitação de fluxo com falha que deixava o SDK travado na tela de carregamento.

  Corrigido o estado de uma execução anterior que persistia na próxima.
* Adicionadas novas variáveis CSS para as animações do Selphi: --wrapper-color-tutorial-border-error e --wrapper-color-tutorial-glow-error.

## 3.38.0

Release: 24-07-2026

### Alterações menores

* Adicionado suporte ao file-uploader como uma etapa do workflow. Após um upload bem-sucedido, o workflow agora avança automaticamente para a próxima etapa, de forma consistente com os widgets de captura Selphi e SelphID.
* Adicionado um `livenessMode` ajuste para o widget Selphi.
* Adicionado `--wrapper-color-capture-neutral` para personalizar a cor da borda da moldura de captura do SelphID.
* Adicionada validação declarativa das configurações do SDK, com sua severidade controlada pela nova `settingsStrictness` prop.
* Versão do engine selphid atualizada.

### Alterações de patch

* Adicionados nomes alternativos para várias props que têm precedência sobre os nomes legados. Os nomes legados continuaram totalmente compatíveis e agora emitiam um aviso de depreciação quando usados.
* Adicionado suporte a um logo tematizado no workflow low-code.

## 3.37.6

Release: 10-07-2026

### Alterações de patch

* Erros de carregamento de inicialização do engine selphid classificados, falhas transitórias tentadas novamente e workers encerrados em load-error
* Corrigida a condição de corrida do timeout do selphid

## 3.37.5

Release: 02-07-2026

### Alterações de patch

* Dependência uuid atualizada
* Propriedade country depreciada no widget SelphID
* Adicionado o widget de workflow Terms and Conditions com conteúdo sanitizado, ações localizadas, Tracking, tratamento de cancelamento, typings geradas e estilos isolados do tema do provider.
* Adicionado `--text-font` e `--title-font` variáveis de tema com Poppins como tipografia padrão (Regular para o corpo do texto, Semibold para títulos).
* Adicionada a possibilidade de usar o mesmo widget várias vezes em um workflow
* Reduzido o payload incorporado do Poppins de \~417KB para \~32KB usando um subconjunto de glifos e WOFF2.

## 3.37.4

Release: 11-06-2026

### Alterações de patch

* Dependências atualizadas
  * @facephi/sdk-video-recording\@2.6.5
  * @facephi/sdk-video-assistance\@1.1.5

## 3.37.3

Release: 08-06-2026

### Alterações de patch

* A versão do in18njs foi aumentada e a resolução do lodash foi movida para sdk-wc

## 3.37.2

Release: 29-05-2026

### Alterações de patch

* VideoProvider agora encaminha `cameraId` e `cameraType` de configurações de vídeo resolvidas para o hook de gravação de vídeo.
* Dependências atualizadas
  * @facephi/sdk-video-recording\@2.6.4

## 3.37.1

Release: 20-05-2026

### Alterações de patch

* Corrigida a permissão da câmera quando QR está habilitado.
* Adicionado o ID correto da primeira animação nos workflows QR
* Corrigida a Lottie da dica inicial do Selphi/SelphID para initial-tip-width e initial-tip-height
* Limitado o tamanho e o tipo de arquivo no fileUploader
* Adicionadas melhorias ao cameraSwitch
* Removido o axios dos pacotes onde não era usado e adicionada uma resolução
* Adicionado status de carregamento inicial em sdk-provider
* Adicionado Tracking na plataforma IAD.
* Dependências atualizadas
  * @facephi/sdk-video-assistance\@1.1.4
  * @facephi/sdk-video-recording\@2.6.3

## 3.37.0

Release: 08-05-2026

### Alterações menores

* Adicionado um novo parâmetro chamado DPI ao SelphID
* Adicionados os eventos widgetLoaded e userCancel ao widget file uploader, bem como novos tipos de detalhes de evento
* Adicionado o evento 'emitTrackStatus' para rastrear o status dos componentes
* Adicionado widget QR independente
* Componente Selphi atualizado.

### Alterações de patch

* Pacotes atualizados para corrigir vulnerabilidades.
* Removido o CSS --color-tutorial-success. Adicionado color-tutorial-tshirt para animações.
* Corrigidas múltiplas emissões de EmitOperationId
* Corrigida a aplicação de CSS nos fluxos IDV
* Corrigido o comportamento da gravação de vídeo quando a licença não é válida
* Evitados eventos continue duplicados no widget QR.
* Adicionadas melhorias de acessibilidade ao componente FileUploader.
* Dependências atualizadas
  * @facephi/sdk-video-assistance\@1.1.3
  * @facephi/sdk-video-recording\@2.6.2

## 3.36.2

Release: 14-04-2026

### Alterações de patch

* Vulnerabilidade do picomatch corrigida

## 3.36.1

Release: 09-04-2026

### Alterações de patch

* Dependências atualizadas
* Adicionar `antispoofPayloadSize` ao widget Selphi (`PayloadSize` de `@facephi/selphi-web-component`, padrão `Small`)
* Dependências atualizadas
  * @facephi/sdk-metrics\@1.0.2
  * @facephi/sdk-video-recording\@2.6.1

## 3.36.0

Release: 01-04-2026

### Alterações menores

* Removida a prop tokenizerLocation do Selphi e SelphID
* Adicionado ID da plataforma de assets de Tracking do IAD para IDV
* Criada uma nova funcionalidade de gravação local como parte da identificação por vídeo
* Mensagens de erro da gravação de vídeo atualizadas

### Alterações de patch

* Adicionada lógica para filtrar opções em chooseDocument se documentType ou country forem fornecidos
* Corrigida a videogravação para fluxos QR em dispositivos móveis: a partir de agora, o socket da videogravação não permanece aberto quando o usuário volta para a visualização desktop
* Corrigida a sincronização da visualização desktop e mobile com QR
* Dependências atualizadas
  * @facephi/sdk-video-recording\@2.6.0

## 3.35.2

Release: 05-03-2026

### Alterações de patch

* Corrigido qrExtraParams solto na URL do widget QR

## 3.35.1

Release: 26-02-2026

### Alterações de patch

* Vulnerabilidades corrigidas e pacotes não utilizados removidos
* Recurso gif não encontrado corrigido
* Corrigido erro de autenticação do proxy
* Dependências atualizadas
  * @facephi/sdk-voice-recognition\@1.0.2
  * @facephi/sdk-video-assistance\@1.1.2
  * @facephi/sdk-video-recording\@2.5.1
  * @facephi/sdk-metrics\@1.0.1

## 3.35.0

Release: 12-02-2026

### Alterações menores

* Versão dos widgets atualizada para 6.35.0

### Alterações de patch

* Nomes das variáveis CSS do SDK renomeados para kebab case
* Adicionada variável de controle para impedir que stopVideo seja chamado duas vezes
* Adicionada personalização ao facephi-qr-widget
* Visualizações CSS personalizadas no SDK
* Visualização da dica inicial personalizável, tanto cores quanto animações.
* Adicionada personalização ao chose-document
* Adicionado uso correto das variáveis CSS do SDK.

## 3.29.0

Release: 10-02-2026

### Alterações menores

* Adicionado ID para o Civil Validation Widget
* Adicionada funcionalidade de tokenização, novo erro genérico em vez de timeout e widget de validação civil

## 3.28.0

Release: 22-01-2026

### Alterações menores

* Propriedade de idioma não utilizada excluída nos wrappers Selphi e SelphID

### Alterações de patch

* Compatibilidade com variáveis de ambiente corrigida (Vite)
* Adicionado proxy como possível caminho de recursos quando é adicionado como prop ao SDK

## 3.27.2

Release: 23-12-2025

### Alterações de patch

* Corrigida a aplicação do tema em sdk-provider

## 3.27.1

Release: 17-12-2025

### Alterações de patch

* Adicionado evento sendFinish ao widget QR

## 3.27.0

Release: 17-12-2025

### Alterações menores

* Saída da biblioteca Angular adicionada

### Alterações de patch

* Corrigido erro relacionado a import.meta.env em ambientes CRA

## 3.26.0

Release: 05-12-2025

### Alterações menores

* Ampliado o escopo da propriedade proxy para habilitar a funcionalidade de gravação de vídeo por meio de um servidor proxy
* Refatorado sdk-web para incluir compatibilidade com a lógica de negócios de IDV
* sdk-metrics para IDV
* Criados novos serviços idv e idv Tracking para iniciar workflows idv e rastrear assets idv, respectivamente
* Substituída esta variável bind por state no store
* Introduzido um parâmetro opcional authenticationId ao SDK para realizar operações de ‘Authentication’ em integrações IDV

### Alterações de patch

* Corrigido o teste do serviço cipher e transformado o objeto de resultado do OCR
* Dependências atualizadas
  * @facephi/sdk-video-recording\@2.5.0
  * @facephi/sdk-metrics\@1.0.0

## 3.25.1

Release: 28-11-2025

### Alterações de patch

* Versão atualizada como a mais recente

## 3.25.0

Release: 24-11-2025

### Alterações menores

* Adicionado novo `file-uploader-widget` com capacidades de arrastar e soltar

## 3.24.1

Release: 10-11-2025

### Alterações de patch

* Erros de Tracking desnecessários foram alterados para avisos

## 3.24.0

Release: 03-11-2025

### Alterações menores

* Widget Selphi atualizado

## 3.23.1

Release: 03-11-2025

### Alterações de patch

* Widget Selphi atualizado

## 3.23.0

Release: 29-10-2025

### Alterações menores

* Versão do Selphi e do Selphid utilizada pelo componente sdk carregada

## 3.22.0

Release: 07-10-2025

### Alterações menores

* Um novo parâmetro foi habilitado, permitindo adicionar uma URL para redirecionar serviços para um proxy.

## 3.21.2

Release: 29-09-2025

### Alterações de patch

* Widgets selphi e selphid atualizados para a versão mais recente

## 3.21.1

Release: 22-09-2025

### Alterações de patch

* Dependências atualizadas
  * @facephi/sdk-video-recruitment\@1.3.1
  * @facephi/sdk-video-assistance\@1.1.1
  * @facephi/sdk-video-recording\@2.4.1

## 3.21.0

Release: 19-09-2025

### Alterações menores

* Funcionalidade de temporizador de diagnóstico habilitada para o widget Selphi

### Alterações de patch

* Adicionado customerId ao fluxo QR
* Dependências atualizadas

## 3.20.3

Release: 15-09-2025

### Alterações de patch

* Melhorada a compatibilidade com a integração do shadow root

## 3.20.2

Release: 08-09-2025

### Alterações de patch

* Versão do selphid atualizada para 6.18.3

## 3.20.1

Release: 03-09-2025

### Alterações de patch

* Versões dos widgets atualizadas para 6.18.1

## 3.20.0

Release: 03-09-2025

### Alterações menores

* Adicionado um novo log para controlar erros de tracking
* Habilitado o uso da nova propriedade enableDocumentFlip para o widget Selphid
* Adicionado RENAP Widget
* Adicionados códigos de erro para IDV

## 3.19.0

Release: 19-08-2025

### Alterações menores

* Implementado um gerenciador global de erros para sdk-web-wc
* Adicionado o serviço de gerenciamento de criptografia de dados em sdk-web-wc devido aos requisitos dos novos serviços de IDV
* Corrigido erro para garantir que o serviço de segurança esteja disponível para uso
* Adicionados métodos generateBrowserCache para baixar recursos do Selphi ou do SelphID antes da inicialização

### Alterações de patch

* Dependências atualizadas
  * @facephi/sdk-video-recruitment\@1.3.0
  * @facephi/sdk-video-assistance\@1.1.0

## 3.18.0

Release: 11-08-2025

### Alterações menores

* Widget Selphi atualizado para a versão 6.17.0

## 3.17.0

Release: 31-07-2025

### Alterações menores

* Compatibilidade da propriedade previewImage corrigida
* Adicionada opção para exportar bundle autônomo para ambientes CDN
* Implementadas variáveis CSS dos widgets para a largura máxima do ícone de erro e a propriedade do modal de tutorial

## 3.16.0

Release: 25-07-2025

### Alterações menores

* Versão dos widgets atualizada para a mais recente

## 3.15.0

Release: 25-06-2025

### Alterações menores

* Arquivos de animação e tradução consumidos diretamente do sdk sem o uso de qualquer CDN
* Adicionado livenessMoveResult ao sendSelphi para landings

## 3.14.2

Release: 13-06-2025

### Alterações de patch

* Dependências atualizadas
  * @facephi/sdk-video-recording\@2.4.0

## 3.14.1

Release: 12-06-2025

### Alterações de patch

* Dependências atualizadas
  * @facephi/sdk-video-recording\@2.3.0

## 3.14.0

Release: 09-06-2025

### Alterações menores

* Adicionado estilo bidirecional com variáveis --wraper e tema
* Vista de erro de Timeout ignorada no widget para casos de uso em landing

## 3.13.0

Release: 05-06-2025

### Alterações menores

* Corrigido o emitWorkflowEvent do SDK Provider para que o evento seja emitido apenas quando a propriedade workflow estiver ativa
* Novo script para codificar automaticamente em base64 o worker de tokenizer/licensing durante a build.

### Alterações de patch

* Dependências atualizadas
  * @facephi/sdk-video-recording\@2.2.0

## 3.12.0

Release: 29-05-2025

### Alterações menores

* Uma nova melhoria foi adicionada ao ciclo de vida do SDK Provider para melhorar sua compatibilidade com frameworks.

### Alterações de patch

* Corrigidos problemas de compatibilidade de estilo entre o uso de variáveis wrapper e as variáveis originais do widget

## 3.11.1

Release: 22-05-2025

### Alterações de patch

* Valor padrão da prop tutorial corrigido

## 3.11.0

Release: 22-05-2025

### Alterações menores

* Resultados de antispoofing enviados ao backend quando o serviço está habilitado
* Adicionado suporte a traduções personalizadas por meio de um objeto JSON fornecido no parâmetro de configurações de idioma ou na url

### Alterações de patch

* Widgets atualizados para 6.13.0
* Novos nomes de props dos widgets adicionados nos wrappers do SDK

## 3.10.0

Release: 07-05-2025

### Alterações menores

* Worker atribuído e memória wasm tratados para garantir bom desempenho em dispositivos com baixa capacidade
* Neste PR, modificamos o CSS do widget de resultados para que, no caso de ser usado em um dispositivo móvel, as informações resultantes da captura ainda sejam exibidas.

## 3.9.0

Release: 22-04-2025

### Alterações menores

* Lógica aprimorada para os serviços de gravação de vídeo
* Lógica do engine de seleção automática adaptada

### Alterações de patch

* Variáveis CSS atualizadas para os widgets selphi e selphid, e estilos globais limpos
* Dependências atualizadas
  * @facephi/sdk-video-recruitment\@1.2.0
  * @facephi/sdk-video-recording\@2.1.0

## 3.8.1

Release: 31-03-2025

### Alterações de patch

* Adicionado CDN\_URL ao build

## 3.8.0

Release: 31-03-2025

### Alterações menores

* Novo fluxo de gravação de vídeo
* Alterações para o gerenciamento e exportação do bun em video-recording

### Alterações de patch

* Processo de gravação de vídeo alterado
* Dependências atualizadas
  * @facephi/sdk-video-recording\@2.0.0

## 3.7.0

Release: 24-03-2025

### Alterações menores

* Versões do widget atualizadas e propriedade enableVideoTimer adicionada

## 3.6.0

Release: 14-03-2025

### Alterações menores

* Propriedade resourcePath adicionada ao sdk-provider
* Fluxo QR corrigido em dispositivos móveis
* Novas props dos widgets implementadas nos wrappers de widgets do sdk para compatibilidade total

### Alterações de patch

* Worker do tokenizer atualizado
* Selphi e Selphid atualizados para v6.10.0
* Adicionada a prop tokenize ao SelphidWidget para tokenização do resultado

## 3.5.8

Release: 06-03-2025

### Alterações de patch

* Dependências internas atualizadas

## 3.5.7

Release: 26-02-2025

### Alterações de patch

* Mask renderizada condicionalmente com base no estado do teste

## 3.5.6

Release: 25-02-2025

### Alterações de patch

* Corrigido problema com workflowprovider ao carregar

## 3.5.5

Release: 25-02-2025

### Alterações de patch

* Melhor tratamento de erros via sdk com workflow

## 3.5.4

Release: 21-02-2025

### Alterações de patch

* Corrigidos erros de digitação nos wrappers dos widgets do sdk

## 3.5.3

Release: 20-02-2025

### Alterações de patch

* Sdk atualizado com a última versão dos widgets Selphi e SelphID

## 3.5.2

Release: 19-02-2025

### Alterações de patch

* Corrigidos os tipos de asset para imagens de documento completas

## 3.5.1

Release: 18-02-2025

### Alterações de patch

* Traduções ausentes adicionadas ao sdk

## 3.5.0

Release: 18-02-2025

### Alterações menores

* Strings e lógica atualizadas para mostrar o idioma correto nos componentes de resultado

## 3.4.2

Release: 11-02-2025

### Alterações de patch

* Atribuição de recursos Graph corrigida para objeto vazio

## 3.4.1

Release: 10-02-2025

### Alterações de patch

* Variáveis verificadas antes de acessar suas propriedades e valores

## 3.4.0

Release: 07-02-2025

### Alterações menores

* Adicionados testes, melhorada a lógica de Tracking e implementado elemento de máscara

## 3.3.4

Release: 30-01-2025

### Alterações de patch

* Corrigido para remover a verificação desnecessária da solicitação de origem no modo Debug

## 3.3.3

Release: 23-01-2025

### Alterações de patch

* Versão dos widgets atualizada

## 3.3.2

Release: 23-01-2025

### Alterações de patch

* Carregador do sdk corrigido

## 3.3.1

Release: 22-01-2025

### Alterações de patch

* Versão do SDK preparada para casos de uso fora de workflow

## 3.3.0

Release: 15-01-2025

### Alterações menores

* Widget de assistência por vídeo adicionado

### Alterações de patch

* Dependências atualizadas
  * @facephi/sdk-video-assistance\@1.0.0

## 3.2.2

Release: 15-01-2025

### Alterações de patch

* Traduções corrigidas
* Correção das traduções aguardando a Request

## 3.2.1

Release: 14-01-2025

### Alterações de patch

* Corrigido Disabled ao chamar serviços de Landing

## 3.2.0

Release: 10-01-2025

### Alterações menores

* Adicionado o parâmetro WaitRequest no SDK; com esse parâmetro definido como true, ele aguardará as requests solicitadas

## 3.1.1

Release: 08-01-2025

### Alterações de patch

* Corrigido: a tela de Resultados não faz chamada de API ao usar QR
* Corrigido: resolução ideal solicitada ao trocar de câmera
* Dependências atualizadas
  * @facephi/sdk-video-recording\@1.1.2

## 3.1.0

Release: 08-01-2025

### Alterações menores

* Adicionada verificação da origem da licença, pequeno bug corrigido

## 3.0.5

Release: 18-12-2024

### Alterações de patch

* Corrigido Emit Api Error em WorkflowEvents

## 3.0.4

Release: 13-12-2024

### Alterações de patch

* Estilos corrigidos para VideoRecruitment no iPhone no Safari
* Dependências atualizadas
  * @facephi/sdk-video-recruitment\@1.1.3

## 3.0.3

Release: 13-12-2024

### Alterações de patch

* Removida uma dependência necessária de axios e buffer

## 3.0.2

### Alterações de patch

* Resolução de tablet incluída na media query para video recruitment
* Dependências atualizadas
  * @facephi/sdk-video-recruitment\@1.1.2

## 3.0.1

Release: 10-12-2024

### Alterações de patch

* Corrigido problema ao propagar eventos originais do widget

## 3.0.0

Release: 05-12-2024

### Alterações principais

* SDK Web refatorado incluindo nova versão dos widgets em Web Components

### Alterações menores

* Componente de Resultados adicionado na visualização Desktop no modo QR
* Suporte a texto de botão personalizável no Results Widget
* CDN adicionado para os recursos do SDK Web
* Tracking completos de imagens adicionados
* Eventos avançados de Tracking adicionados
* Lógica de validação da propriedade country aprimorada

### Alterações de patch

* Vídeo corrigido
* Skip do Widget de Validação de Documento corrigido
* VideoRecording corrigido no fluxo
* Recuperação de eventos ausentes corrigida
* Widget de Próximo Passo corrigido
* Widget desconhecido corrigido
* Conclusão do Video Recruitment corrigida
* object-fit adicionado na imagem
* Vários problemas de Landing corrigidos
* Bug corrigido com a troca de câmera em Samsung
* Loading obtido quando existe VideoRecording
* Vídeo corrigido, aguardou o canal antes de carregar os widgets selphid e selphi
* selphid e Selphi atualizados para 6.6.1
* Texto do botão do Results Widget corrigido
* Decorators de listener removidos no widget de voz
* Próximo Passo corrigido
* Problema corrigido ao rastrear documento de um lado
* QR com videorecording corrigido
* Evento de Conclusão adicionado
* Widgets atualizados para 6.4.0
* Landing Api Key corrigida
* Geração de operationId em Landing corrigida
* Envio de Selphi em Landing corrigido
* Evento adicionado para carregar o provedor Sdk
* ContentType dos assets corrigido
* Configurações analisadas para widgets de web component
* Problema com evento qr ao finalizar corrigido
* Aguardei a gravação quando ela é necessária
* Erro com contentType corrigido
* emit Data corrigido
* selphid e Selphi atualizados para 6.7.0
* Dependências atualizadas
* Dependências atualizadas
  * @facephi/sdk-video-recording\@1.1.1