> 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 correção

* 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 documentos.

  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 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 envio bem-sucedido, o workflow agora avança automaticamente para a próxima etapa, em conformidade com os widgets de captura Selphi e SelphID.
* Adicionado um `livenessMode` configuração 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 pelo novo `settingsStrictness` prop.
* Atualizada a versão do mecanismo selphid.

### Alterações de correção

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

## 3.37.6

Release: 10-07-2026

### Alterações de correção

* Classificados os erros de carregamento na inicialização do mecanismo selphid, com retentativas em falhas transitórias e encerramento de workers em load-error
* Corrigida condição de corrida de timeout do selphid

## 3.37.5

Release: 02-07-2026

### Alterações de correção

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

## 3.37.4

Release: 11-06-2026

### Alterações de correção

* 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 correção

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

## 3.37.2

Release: 29-05-2026

### Alterações de correção

* VideoProvider agora encaminha `cameraId` e `cameraType` das 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 correção

* Corrigida a permissão da câmera quando o QR está habilitado.
* Adicionado o ID correto da primeira animação nos workflows de QR
* Corrigida a Lottie da dica inicial do Selphi/SelphID para initial-tip-width e initial-tip-height
* Limitado o tamanho e o tipo do 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 no 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
* Atualizado o componente Selphi.

### Alterações de correção

* Pacotes atualizados para corrigir vulnerabilidades.
* Removido 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 de IDV
* Corrigido o comportamento da gravação de vídeo quando a licença não é válida
* Prevenidos 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 correção

* Vulnerabilidade do picomatch resolvida

## 3.36.1

Release: 09-04-2026

### Alterações de correção

* 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 do SelphID
* Adicionado asset de Tracking IAD da plataforma 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 correção

* Adicionada lógica para filtrar opções em chooseDocument se documentType ou country forem fornecidos
* Corrigida a videorecording para fluxos de QR no mobile: a partir de agora, o socket de videorecording não permanece aberto quando o usuário volta para a visualização de desktop
* Corrigida a sincronização da visualização de 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 correção

* Corrigido vazamento de qrExtraParams na URL do widget QR

## 3.35.1

Release: 26-02-2026

### Alterações de correção

* Corrigidas vulnerabilidades e removidos pacotes não utilizados
* Corrigido recurso gif não encontrado
* 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

* Atualizada a versão dos widgets para 6.35.0

### Alterações de correção

* Renomeadas as variáveis CSS do SDK para kebab-case
* Adicionada variável de controle para evitar que stopVideo seja chamado duas vezes
* Adicionado customized ao facephi-qr-widget
* Visualizações CSS personalizadas no SDK
* Visualização initial-tip personalizável, tanto as cores quanto as animações.
* Adicionada personalização ao chose-document
* Adicionado o uso correto das variáveis CSS do SDK.

## 3.29.0

Release: 10-02-2026

### Alterações menores

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

## 3.28.0

Release: 22-01-2026

### Alterações menores

* Excluída a propriedade language não utilizada nos wrappers do Selphi e do SelphID

### Alterações de correção

* Corrigida a compatibilidade das variáveis de ambiente (Vite)
* Adicionado proxy como caminho possível de recursos quando é adicionado como prop ao SDK

## 3.27.2

Release: 23-12-2025

### Alterações de correção

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

## 3.27.1

Release: 17-12-2025

### Alterações de correção

* Adicionado sendFinish ao QR-widget

## 3.27.0

Release: 17-12-2025

### Alterações menores

* Adicionada saída da biblioteca Angular

### Alterações de correção

* 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 no SDK para realizar operações de Authentication em integrações de IDV

### Alterações de correção

* 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 correção

* Versão atualizada para latest

## 3.25.0

Release: 24-11-2025

### Alterações menores

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

## 3.24.1

Release: 10-11-2025

### Alterações de correção

* 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 correção

* Widget Selphi atualizado

## 3.23.0

Release: 29-10-2025

### Alterações menores

* Carregada a versão do Selphi e do Selphid usada pelo componente SDK

## 3.22.0

Release: 07-10-2025

### Alterações menores

* Foi habilitado um novo parâmetro que permite adicionar uma URL para redirecionar serviços para um proxy.

## 3.21.2

Release: 29-09-2025

### Alterações de correção

* Atualizados os widgets Selphi e SelphID para a versão mais recente

## 3.21.1

Release: 22-09-2025

### Alterações de correção

* 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

* Habilitada a funcionalidade de timer de diagnóstico para o widget Selphi

### Alterações de correção

* Adicionado customerId ao fluxo de QR
* Dependências atualizadas

## 3.20.3

Release: 15-09-2025

### Alterações de correção

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

## 3.20.2

Release: 08-09-2025

### Alterações de correção

* Atualizada a versão do selphid para 6.18.3

## 3.20.1

Release: 03-09-2025

### Alterações de correção

* Atualizadas as versões dos widgets 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 consumo
* Adicionados métodos generateBrowserCache para baixar recursos do Selphi ou do SelphID antes da inicialização

### Alterações de correção

* 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

* Atualizado o widget Selphi para a versão 6.17.0

## 3.17.0

Release: 31-07-2025

### Alterações menores

* Corrigida a compatibilidade da propriedade previewImage
* Adicionada opção para exportar pacote autônomo para ambientes CDN
* Implementadas variáveis CSS do widget 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

* Atualizada a versão dos widgets para a mais recente

## 3.15.0

Release: 25-06-2025

### Alterações menores

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

## 3.14.2

Release: 13-06-2025

### Alterações de correção

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

## 3.14.1

Release: 12-06-2025

### Alterações de correção

* 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
* Ignorada a visualização de erro de timeout no widget para casos de uso de 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 tokenizer/licensing worker em base64 durante a build.

### Alterações de correção

* 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 correção

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

## 3.11.1

Release: 22-05-2025

### Alterações de correção

* Corrigido o valor padrão da prop tutorial

## 3.11.0

Release: 22-05-2025

### Alterações menores

* Enviados resultados de antispoofing para o 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 correção

* Widgets atualizados para 6.13.0
* Adicionados novos nomes de props de widget nos wrappers do SDK

## 3.10.0

Release: 07-05-2025

### Alterações menores

* Tratados o worker atribuído e a memória wasm para garantir bom desempenho em dispositivos de baixa capacidade
* Neste pr, modificamos o CSS do widget de resultados para que, no caso de ser usado em um dispositivo móvel, a informação resultante da captura ainda seja exibida.

## 3.9.0

Release: 22-04-2025

### Alterações menores

* Lógica aprimorada para os serviços de gravação de vídeo
* Adaptada a lógica do mecanismo de autoselect

### Alterações de correção

* Atualizadas as variáveis CSS para os widgets selphi e selphid, e limpos os estilos globais
* 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 correção

* Adicionado CDN\_URL à build

## 3.8.0

Release: 31-03-2025

### Alterações menores

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

### Alterações de correção

* 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

* Atualizadas as versões dos widgets e adicionada a prop enableVideoTimer

## 3.6.0

Release: 14-03-2025

### Alterações menores

* Adicionada a prop resourcePath ao sdk-provider
* Corrigido o Workflow de QR em dispositivos móveis
* Implementadas novas props de widget nos wrappers de widget do SDK para compatibilidade total

### Alterações de correção

* Worker tokenizer atualizado
* Atualizados Selphi e Selphid 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 correção

* Dependências internas atualizadas

## 3.5.7

Release: 26-02-2025

### Alterações de correção

* Máscara renderizada condicionalmente com base no estado de teste

## 3.5.6

Release: 25-02-2025

### Alterações de correção

* Corrigido problema com workflowprovider durante o carregamento

## 3.5.5

Release: 25-02-2025

### Alterações de correção

* Tratamento de erros melhorado via SDK com workflow

## 3.5.4

Release: 21-02-2025

### Alterações de correção

* Corrigidos erros de digitação nos wrappers de widget para o SDK

## 3.5.3

Release: 20-02-2025

### Alterações de correção

* Atualizado o SDK com a última versão dos widgets Selphi e SelphID

## 3.5.2

Release: 19-02-2025

### Alterações de correção

* Corrigidos os tipos de asset para imagens completas de documento

## 3.5.1

Release: 18-02-2025

### Alterações de correção

* Adicionadas traduções ausentes para o 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 correção

* Corrigida a atribuição de recursos Graph para um objeto vazio

## 3.4.1

Release: 10-02-2025

### Alterações de correção

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

## 3.4.0

Release: 07-02-2025

### Alterações menores

* Adicionado teste, melhorada a lógica de Tracking e implementado o elemento máscara

## 3.3.4

Release: 30-01-2025

### Alterações de correção

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

## 3.3.3

Release: 23-01-2025

### Alterações de correção

* Versão dos widgets atualizada

## 3.3.2

Release: 23-01-2025

### Alterações de correção

* Corrigido o carregador do SDK

## 3.3.1

Release: 22-01-2025

### Alterações de correção

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

## 3.3.0

Release: 15-01-2025

### Alterações menores

* Adicionado widget de assistência de vídeo

### Alterações de correção

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

## 3.2.2

Release: 15-01-2025

### Alterações de correção

* Traduções corrigidas
* Corrigida a espera de traduções para Request

## 3.2.1

Release: 14-01-2025

### Alterações de correção

* 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 solicitações requisitadas

## 3.1.1

Release: 08-01-2025

### Alterações de correção

* Corrigido o problema de a tela de Results não fazer chamada de API ao usar QR
* Corrigido: resolução ideal solicitada ao trocar de câmeras
* 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 correção

* Corrigido Emit Api Error em WorkflowEvents

## 3.0.4

Release: 13-12-2024

### Alterações de correção

* Corrigidos os estilos do 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 correção

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

## 3.0.2

### Alterações de correção

* Incluída a resolução de tablet 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 correção

* Corrigido problema ao propagar os eventos originais do widget

## 3.0.0

Release: 05-12-2024

### Alterações maiores

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

### Alterações menores

* Adicionado o Results Component na visualização de desktop no modo QR
* Suporte para texto personalizável do botão no Widget de Results
* Adicionado CDN para os recursos do SDK Web
* Adicionadas imagens completas de Tracking
* Adicionados eventos avançados de Tracking
* Lógica de validação da prop country melhorada

### Alterações de correção

* Vídeo corrigido
* Corrigido o skip do Widget de Validação de Documento
* Corrigido VideoRecording no flow
* Corrigida a recuperação de Events ausentes
* Corrigido o Widget de Próxima Etapa
* Corrigido widget desconhecido
* Corrigido o término do Video Recruitment
* Adicionado object-fit na imagem
* Corrigidos vários problemas para landing
* Corrigido bug na troca de câmera em Samsung
* Exibido carregamento quando existe gravação de vídeo
* Corrigido vídeo, aguardado o channel antes de carregar o widget SelphID e Selphi
* Atualizado SelphID e Selphi para 6.6.1
* Corrigido texto do botão Widget de Resultados
* Removidos decoradores de listener no Widget de voz
* Corrigida a Próxima Etapa
* Corrigido problema ao fazer Tracking de documento de um lado
* Corrigido QR com gravação de vídeo
* Adicionado Event de Finalização
* Widgets atualizados para 6.4.0
* Corrigido Landing API Key
* Corrigido generate operationId no Landing
* Corrigido Send Selphi no Landing
* Adicionado Event para provider Load SDK
* Corrigidos assets ContentType
* Configurações analisadas para widgets de componente web
* Corrigido problema com evento QR no final
* Aguardada a gravação quando ela é necessária
* Corrigido erro com contentType
* Corrigido emit Data
* Atualizado SelphID e Selphi para 6.7.0
* Dependências atualizadas
* Dependências atualizadas
  * @facephi/sdk-video-recording\@1.1.1