termo_core 0.1.5 → 0.1.7

package/dist/tracing/rotas.d.ts

@@ -140,23 +140,15 @@ export interface ParametrosDeBuscarPeloFiltroUso {
 /**
  * Lista os aplicativos paginados
  *
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Lista os aplicativos não excluídos da conta em ordem alfabética do nome. `pagina` começa em 1 (padrão 1; menor que 1 vira 1). A página tem sempre 50 itens: o parâmetro `tamanho` é aceito, mas ignorado. A resposta traz `itens`, `total` (quantidade de registros que casam com os filtros), `pagina` e `tamanho` (50). Parâmetros de consulta, todos opcionais: `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: aceito, mas ignorado: a página tem sempre 50 itens.
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Lista os aplicativos em ordem alfabética do nome. Os aplicativos vêm do TermoAuth: quando quem chama é master do TermoAuth, a lista é sincronizada antes da resposta (app novo ganha uma `chave` e app que saiu do TermoAuth some daqui); nome, setor e domínios não se alteram por aqui. `pagina` começa em 1 (padrão 1; menor que 1 vira 1). A página tem sempre 50 itens: o parâmetro `tamanho` é aceito, mas ignorado. A resposta traz `itens`, `total` (quantidade de registros que casam com os filtros), `pagina` e `tamanho` (50). Parâmetros de consulta, todos opcionais: `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: aceito, mas ignorado: a página tem sempre 50 itens.
  *
  * `GET /aplicativo`
  */
 export declare function buscar_paginador_aplicativo(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorAplicativo, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaAplicativo>;
-/**
- * Cadastra um aplicativo
- *
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Cadastra um site ou sistema que vai enviar eventos ao TermoTracing. `nome` é obrigatório. `dominios` precisa ter ao menos um domínio válido (host com ponto, `localhost` ou curinga `*.dominio.com`, porta opcional); `https://`, caminho e ponto final são removidos. `franquia_mensal` (eventos por ciclo mensal) tem padrão 100000 e precisa ser maior que zero. `comportamento_ao_estourar` aceita `COBRAR_EXCEDENTE` (padrão) ou `PARAR_INGESTAO`. O backend gera a `chave` pública (prefixo `pk_live_`) que o script do site usa na ingestão; ela não é segredo, porque a ingestão só aceita os domínios cadastrados. Campos do corpo: `nome`: nome do aplicativo (obrigatório, não pode ficar vazio); `dominios`: domínios autorizados a enviar eventos; precisa de ao menos um válido (host com ponto, `localhost` ou `*.dominio.com`, porta opcional). `https://`, caminho e ponto final são removidos; `franquia_mensal`: eventos incluídos por ciclo mensal, maior que zero (padrão 100000); `comportamento_ao_estourar`: `COBRAR_EXCEDENTE` (padrão) segue recebendo e conta o excedente; `PARAR_INGESTAO` recusa os lotes depois da franquia.
- *
- * `POST /aplicativo`
- */
-export declare function criar_aplicativo(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.AplicativoCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Aplicativo>;
 /**
  * Lista básica de aplicativos para seleção
  *
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve só id, nome e chave dos aplicativos não excluídos da conta, em ordem alfabética do nome. `busca` procura o trecho no nome, sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`. Parâmetros de consulta, todos opcionais: `busca`: trecho do nome, sem diferenciar maiúsculas (opcional); `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: itens por página (padrão 10, sem máximo; menor que 1 vira 1).
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve só id, nome e chave dos aplicativos não excluídos, em ordem alfabética do nome. `busca` procura o trecho no nome, sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`. Parâmetros de consulta, todos opcionais: `busca`: trecho do nome, sem diferenciar maiúsculas (opcional); `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: itens por página (padrão 10, sem máximo; menor que 1 vira 1).
  *
  * `GET /aplicativo/autocomplete`
  */
@@ -164,7 +156,7 @@ export declare function buscar_auto_complete_aplicativo(credencial_de_acesso: Cr
 /**
  * Busca aplicativos por filtro
  *
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve todos os aplicativos não excluídos da conta que casam com o filtro, sem paginação, em ordem alfabética do nome. `nome` procura o trecho no nome e `dominio` em qualquer domínio cadastrado (sem diferenciar maiúsculas); `chave` compara a chave exata e `comportamento_ao_estourar` o valor exato (`COBRAR_EXCEDENTE` ou `PARAR_INGESTAO`). Sem filtro, devolve todos. Parâmetros de consulta, todos opcionais: `nome`: trecho do nome, sem diferenciar maiúsculas; `dominio`: trecho de um dos domínios cadastrados, sem diferenciar maiúsculas; `chave`: chave pública exata; `comportamento_ao_estourar`: `COBRAR_EXCEDENTE` ou `PARAR_INGESTAO`.
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve todos os aplicativos não excluídos que casam com o filtro, sem paginação, em ordem alfabética do nome. `nome` procura o trecho no nome e `dominio` em qualquer domínio cadastrado (sem diferenciar maiúsculas); `chave` compara a chave exata e `comportamento_ao_estourar` o valor exato (`COBRAR_EXCEDENTE` ou `PARAR_INGESTAO`). Sem filtro, devolve todos. Parâmetros de consulta, todos opcionais: `nome`: trecho do nome, sem diferenciar maiúsculas; `dominio`: trecho de um dos domínios cadastrados, sem diferenciar maiúsculas; `chave`: chave pública exata; `comportamento_ao_estourar`: `COBRAR_EXCEDENTE` ou `PARAR_INGESTAO`.
  *
  * `GET /aplicativo/filtro`
  */
@@ -172,31 +164,15 @@ export declare function buscar_pelo_filtro_aplicativo(credencial_de_acesso: Cred
 /**
  * Busca um aplicativo pelo id
  *
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve o aplicativo pelo id; registro excluído não é encontrado.
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve o aplicativo pelo id; registro excluído não é encontrado.
  *
  * `GET /aplicativo/{id}`
  */
 export declare function buscar_pelo_id_aplicativo(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Aplicativo>;
-/**
- * Atualiza um aplicativo pelo id
- *
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Atualização parcial: só os campos enviados mudam. `nome` não pode ficar vazio; `dominios` substitui a lista inteira e precisa de ao menos um domínio válido; `franquia_mensal` precisa ser maior que zero; `comportamento_ao_estourar` aceita `COBRAR_EXCEDENTE` ou `PARAR_INGESTAO`. Com `rotacionar_chave: true` o backend gera uma `chave` nova e a antiga para de valer na ingestão. Campos do corpo, todos opcionais: `nome`: novo nome (não pode ficar vazio); `dominios`: nova lista de domínios, que substitui a atual; precisa de ao menos um válido; `franquia_mensal`: nova franquia mensal de eventos, maior que zero; `comportamento_ao_estourar`: `COBRAR_EXCEDENTE` ou `PARAR_INGESTAO`; `rotacionar_chave`: com `true`, gera uma chave nova e a antiga para de valer na ingestão.
- *
- * `PATCH /aplicativo/{id}`
- */
-export declare function atualizar_pelo_id_aplicativo(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.AplicativoAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Aplicativo>;
-/**
- * Exclui um aplicativo pelo id
- *
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Exclusão lógica: o aplicativo some das leituras e a chave dele deixa de ser aceita na ingestão.
- *
- * `DELETE /aplicativo/{id}`
- */
-export declare function deletar_pelo_id_aplicativo(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
 /**
  * Lista os erros paginados
  *
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Lista os grupos de erro não excluídos da conta, do que afetou mais usuários para o que afetou menos e, no empate, do que ocorreu mais vezes. `aplicativo_id` filtra pelo aplicativo e `status` pela situação (`ABERTO`, `RESOLVIDO` ou `IGNORADO`, sem diferenciar maiúsculas). `pagina` começa em 1 (padrão 1; menor que 1 vira 1). A página tem sempre 50 itens: o parâmetro `tamanho` é aceito, mas ignorado. A resposta traz `itens`, `total` (quantidade de registros que casam com os filtros), `pagina` e `tamanho` (50). Parâmetros de consulta, todos opcionais: `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: aceito, mas ignorado: a página tem sempre 50 itens; `aplicativo_id`: id do aplicativo (opcional); `status`: `ABERTO`, `RESOLVIDO` ou `IGNORADO`, sem diferenciar maiúsculas (opcional).
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Lista os grupos de erro não excluídos, do que afetou mais usuários para o que afetou menos e, no empate, do que ocorreu mais vezes. `aplicativo_id` filtra pelo aplicativo e `status` pela situação (`ABERTO`, `RESOLVIDO` ou `IGNORADO`, sem diferenciar maiúsculas). `pagina` começa em 1 (padrão 1; menor que 1 vira 1). A página tem sempre 50 itens: o parâmetro `tamanho` é aceito, mas ignorado. A resposta traz `itens`, `total` (quantidade de registros que casam com os filtros), `pagina` e `tamanho` (50). Parâmetros de consulta, todos opcionais: `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: aceito, mas ignorado: a página tem sempre 50 itens; `aplicativo_id`: id do aplicativo (opcional); `status`: `ABERTO`, `RESOLVIDO` ou `IGNORADO`, sem diferenciar maiúsculas (opcional).
  *
  * `GET /erro`
  */
@@ -204,7 +180,7 @@ export declare function buscar_paginador_erro(credencial_de_acesso: CredencialDe
 /**
  * Cadastra um erro
  *
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Registra a ocorrência de um erro num aplicativo da conta (os erros normalmente são agrupados sozinhos a partir dos eventos da ingestão). `aplicativo_id` precisa ser de um aplicativo da conta; `mensagem` é obrigatória; `tipo` aceita um dos tipos de evento (`ERRO_JS`, `PROMISE_REJEITADA`, `CONSOLE`, `REQUISICAO`, `NAVEGACAO`, `SAIDA`, `PULSO`, `CLIQUE`, `DESEMPENHO`, `IDENTIFICACAO` ou `PERSONALIZADO`). Erros com o mesmo tipo, mensagem, arquivo e linha formam um só grupo na conta: se o grupo já existe, a ocorrência soma 1 e o grupo existente é devolvido. Campos do corpo: `aplicativo_id`: id de um aplicativo da conta (obrigatório); `tipo`: tipo do erro (obrigatório): `ERRO_JS`, `PROMISE_REJEITADA`, `CONSOLE`, `REQUISICAO`, `NAVEGACAO`, `SAIDA`, `PULSO`, `CLIQUE`, `DESEMPENHO`, `IDENTIFICACAO` ou `PERSONALIZADO`; `mensagem`: mensagem do erro (obrigatória, não pode ficar vazia); `arquivo`: arquivo onde o erro ocorreu (opcional); `linha`: linha do erro (opcional); `pilha`: pilha de chamadas (opcional).
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Registra a ocorrência de um erro num aplicativo (os erros normalmente são agrupados sozinhos a partir dos eventos da ingestão). `aplicativo_id` precisa ser de um aplicativo; `mensagem` é obrigatória; `tipo` aceita um dos tipos de evento (`ERRO_JS`, `PROMISE_REJEITADA`, `CONSOLE`, `REQUISICAO`, `NAVEGACAO`, `SAIDA`, `PULSO`, `CLIQUE`, `DESEMPENHO`, `IDENTIFICACAO` ou `PERSONALIZADO`). Erros com o mesmo tipo, mensagem, arquivo e linha formam um só grupo na conta: se o grupo já existe, a ocorrência soma 1 e o grupo existente é devolvido. Campos do corpo: `aplicativo_id`: id de um aplicativo (obrigatório); `tipo`: tipo do erro (obrigatório): `ERRO_JS`, `PROMISE_REJEITADA`, `CONSOLE`, `REQUISICAO`, `NAVEGACAO`, `SAIDA`, `PULSO`, `CLIQUE`, `DESEMPENHO`, `IDENTIFICACAO` ou `PERSONALIZADO`; `mensagem`: mensagem do erro (obrigatória, não pode ficar vazia); `arquivo`: arquivo onde o erro ocorreu (opcional); `linha`: linha do erro (opcional); `pilha`: pilha de chamadas (opcional).
  *
  * `POST /erro`
  */
@@ -212,7 +188,7 @@ export declare function criar_erro(credencial_de_acesso: CredencialDeAcesso, cor
 /**
  * Lista básica de erros para seleção
  *
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve só id e rótulo (a mensagem do erro), em ordem alfabética da mensagem. `busca` procura o trecho na mensagem, sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`. Parâmetros de consulta, todos opcionais: `busca`: trecho da mensagem, sem diferenciar maiúsculas (opcional); `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: itens por página (padrão 10, sem máximo; menor que 1 vira 1).
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve só id e rótulo (a mensagem do erro), em ordem alfabética da mensagem. `busca` procura o trecho na mensagem, sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`. Parâmetros de consulta, todos opcionais: `busca`: trecho da mensagem, sem diferenciar maiúsculas (opcional); `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: itens por página (padrão 10, sem máximo; menor que 1 vira 1).
  *
  * `GET /erro/autocomplete`
  */
@@ -220,7 +196,7 @@ export declare function buscar_auto_complete_erro(credencial_de_acesso: Credenci
 /**
  * Busca erros por filtro
  *
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve todos os grupos de erro não excluídos da conta que casam com o filtro, sem paginação, do que afetou mais usuários para o que afetou menos. `aplicativo_id` filtra pelo aplicativo; `mensagem` procura o trecho na mensagem; `tipo`, `status` (`ABERTO`, `RESOLVIDO` ou `IGNORADO`) e `navegador` comparam o valor exato, sem diferenciar maiúsculas; `inicio` traz os que ocorreram de novo a partir dessa data e hora e `fim` os que começaram até ela (ISO 8601). Sem filtro, devolve todos. Parâmetros de consulta, todos opcionais: `aplicativo_id`: id do aplicativo; `mensagem`: trecho da mensagem, sem diferenciar maiúsculas; `tipo`: tipo do erro (sem diferenciar maiúsculas): `ERRO_JS`, `PROMISE_REJEITADA`, `CONSOLE`, `REQUISICAO`, `NAVEGACAO`, `SAIDA`, `PULSO`, `CLIQUE`, `DESEMPENHO`, `IDENTIFICACAO` ou `PERSONALIZADO`; `status`: `ABERTO`, `RESOLVIDO` ou `IGNORADO` (sem diferenciar maiúsculas); `navegador`: navegador onde ocorreu (valor exato, sem diferenciar maiúsculas); `inicio`: erros com ocorrência a partir desta data e hora ISO 8601, por exemplo 2026-10-07T00:00:00Z; `fim`: erros cuja primeira ocorrência foi até esta data e hora ISO 8601.
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve todos os grupos de erro não excluídos que casam com o filtro, sem paginação, do que afetou mais usuários para o que afetou menos. `aplicativo_id` filtra pelo aplicativo; `mensagem` procura o trecho na mensagem; `tipo`, `status` (`ABERTO`, `RESOLVIDO` ou `IGNORADO`) e `navegador` comparam o valor exato, sem diferenciar maiúsculas; `inicio` traz os que ocorreram de novo a partir dessa data e hora e `fim` os que começaram até ela (ISO 8601). Sem filtro, devolve todos. Parâmetros de consulta, todos opcionais: `aplicativo_id`: id do aplicativo; `mensagem`: trecho da mensagem, sem diferenciar maiúsculas; `tipo`: tipo do erro (sem diferenciar maiúsculas): `ERRO_JS`, `PROMISE_REJEITADA`, `CONSOLE`, `REQUISICAO`, `NAVEGACAO`, `SAIDA`, `PULSO`, `CLIQUE`, `DESEMPENHO`, `IDENTIFICACAO` ou `PERSONALIZADO`; `status`: `ABERTO`, `RESOLVIDO` ou `IGNORADO` (sem diferenciar maiúsculas); `navegador`: navegador onde ocorreu (valor exato, sem diferenciar maiúsculas); `inicio`: erros com ocorrência a partir desta data e hora ISO 8601, por exemplo 2026-10-07T00:00:00Z; `fim`: erros cuja primeira ocorrência foi até esta data e hora ISO 8601.
  *
  * `GET /erro/filtro`
  */
@@ -228,7 +204,7 @@ export declare function buscar_pelo_filtro_erro(credencial_de_acesso: Credencial
 /**
  * Busca um erro pelo id
  *
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve o erro pelo id; registro excluído não é encontrado.
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve o erro pelo id; registro excluído não é encontrado.
  *
  * `GET /erro/{id}`
  */
@@ -236,7 +212,7 @@ export declare function buscar_pelo_id_erro(credencial_de_acesso: CredencialDeAc
 /**
  * Atualiza um erro pelo id
  *
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Atualização parcial: só os campos enviados mudam. Muda o `status` do grupo de erro: `ABERTO`, `RESOLVIDO` ou `IGNORADO`. Campos do corpo, todos opcionais: `status`: nova situação: `ABERTO`, `RESOLVIDO` ou `IGNORADO`.
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Atualização parcial: só os campos enviados mudam. Muda o `status` do grupo de erro: `ABERTO`, `RESOLVIDO` ou `IGNORADO`. Campos do corpo, todos opcionais: `status`: nova situação: `ABERTO`, `RESOLVIDO` ou `IGNORADO`.
  *
  * `PATCH /erro/{id}`
  */
@@ -244,7 +220,7 @@ export declare function atualizar_pelo_id_erro(credencial_de_acesso: CredencialD
 /**
  * Exclui um erro pelo id
  *
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Exclusão lógica: o registro some das leituras, mas não é apagado na hora.
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Exclusão lógica: o registro some das leituras, mas não é apagado na hora.
  *
  * `DELETE /erro/{id}`
  */
@@ -252,7 +228,7 @@ export declare function deletar_pelo_id_erro(credencial_de_acesso: CredencialDeA
 /**
  * Lista os eventos paginados
  *
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Lista os eventos não excluídos da conta. Com `sessao_id`, devolve a linha do tempo da sessão do mais antigo para o mais recente; sem ele, do mais recente para o mais antigo. `aplicativo_id` filtra pelo aplicativo. `pagina` começa em 1 (padrão 1; menor que 1 vira 1). A página tem sempre 50 itens: o parâmetro `tamanho` é aceito, mas ignorado. A resposta traz `itens`, `total` (quantidade de registros que casam com os filtros), `pagina` e `tamanho` (50). Parâmetros de consulta, todos opcionais: `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: aceito, mas ignorado: a página tem sempre 50 itens; `sessao_id`: id da sessão: com ele, a lista vem do mais antigo para o mais recente (opcional); `aplicativo_id`: id do aplicativo (opcional).
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Lista os eventos não excluídos. Com `sessao_id`, devolve a linha do tempo da sessão do mais antigo para o mais recente; sem ele, do mais recente para o mais antigo. `aplicativo_id` filtra pelo aplicativo. `pagina` começa em 1 (padrão 1; menor que 1 vira 1). A página tem sempre 50 itens: o parâmetro `tamanho` é aceito, mas ignorado. A resposta traz `itens`, `total` (quantidade de registros que casam com os filtros), `pagina` e `tamanho` (50). Parâmetros de consulta, todos opcionais: `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: aceito, mas ignorado: a página tem sempre 50 itens; `sessao_id`: id da sessão: com ele, a lista vem do mais antigo para o mais recente (opcional); `aplicativo_id`: id do aplicativo (opcional).
  *
  * `GET /evento`
  */
@@ -260,7 +236,7 @@ export declare function buscar_paginador_evento(credencial_de_acesso: Credencial
 /**
  * Lista básica de eventos para seleção
  *
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve só id e rótulo (o nome do evento ou, sem nome, a mensagem ou o tipo), em ordem alfabética do rótulo. `busca` procura o trecho no rótulo, sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`. Parâmetros de consulta, todos opcionais: `busca`: trecho do rótulo (nome, mensagem ou tipo), sem diferenciar maiúsculas (opcional); `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: itens por página (padrão 10, sem máximo; menor que 1 vira 1).
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve só id e rótulo (o nome do evento ou, sem nome, a mensagem ou o tipo), em ordem alfabética do rótulo. `busca` procura o trecho no rótulo, sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`. Parâmetros de consulta, todos opcionais: `busca`: trecho do rótulo (nome, mensagem ou tipo), sem diferenciar maiúsculas (opcional); `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: itens por página (padrão 10, sem máximo; menor que 1 vira 1).
  *
  * `GET /evento/autocomplete`
  */
@@ -268,7 +244,7 @@ export declare function buscar_auto_complete_evento(credencial_de_acesso: Creden
 /**
  * Busca eventos por filtro
  *
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve todos os eventos não excluídos da conta que casam com o filtro, sem paginação, do mais antigo para o mais recente (`ocorrido_em`). `aplicativo_id` e `sessao_id` filtram pelo id; `tipo` compara o valor exato, sem diferenciar maiúsculas (`ERRO_JS`, `PROMISE_REJEITADA`, `CONSOLE`, `REQUISICAO`, `NAVEGACAO`, `SAIDA`, `PULSO`, `CLIQUE`, `DESEMPENHO`, `IDENTIFICACAO` ou `PERSONALIZADO`); `nome` procura o trecho no nome; `inicio` e `fim` (data e hora ISO 8601) limitam o `ocorrido_em`. Sem filtro, devolve todos. Os eventos ficam guardados por 30 dias. Parâmetros de consulta, todos opcionais: `aplicativo_id`: id do aplicativo; `sessao_id`: id da sessão; `tipo`: tipo do evento (sem diferenciar maiúsculas): `ERRO_JS`, `PROMISE_REJEITADA`, `CONSOLE`, `REQUISICAO`, `NAVEGACAO`, `SAIDA`, `PULSO`, `CLIQUE`, `DESEMPENHO`, `IDENTIFICACAO` ou `PERSONALIZADO`; `nome`: trecho do nome, sem diferenciar maiúsculas; `inicio`: eventos ocorridos a partir desta data e hora ISO 8601, por exemplo 2026-10-07T00:00:00Z; `fim`: eventos ocorridos até esta data e hora ISO 8601.
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve todos os eventos não excluídos que casam com o filtro, sem paginação, do mais antigo para o mais recente (`ocorrido_em`). `aplicativo_id` e `sessao_id` filtram pelo id; `tipo` compara o valor exato, sem diferenciar maiúsculas (`ERRO_JS`, `PROMISE_REJEITADA`, `CONSOLE`, `REQUISICAO`, `NAVEGACAO`, `SAIDA`, `PULSO`, `CLIQUE`, `DESEMPENHO`, `IDENTIFICACAO` ou `PERSONALIZADO`); `nome` procura o trecho no nome; `inicio` e `fim` (data e hora ISO 8601) limitam o `ocorrido_em`. Sem filtro, devolve todos. Os eventos ficam guardados por 30 dias. Parâmetros de consulta, todos opcionais: `aplicativo_id`: id do aplicativo; `sessao_id`: id da sessão; `tipo`: tipo do evento (sem diferenciar maiúsculas): `ERRO_JS`, `PROMISE_REJEITADA`, `CONSOLE`, `REQUISICAO`, `NAVEGACAO`, `SAIDA`, `PULSO`, `CLIQUE`, `DESEMPENHO`, `IDENTIFICACAO` ou `PERSONALIZADO`; `nome`: trecho do nome, sem diferenciar maiúsculas; `inicio`: eventos ocorridos a partir desta data e hora ISO 8601, por exemplo 2026-10-07T00:00:00Z; `fim`: eventos ocorridos até esta data e hora ISO 8601.
  *
  * `GET /evento/filtro`
  */
@@ -276,7 +252,7 @@ export declare function buscar_pelo_filtro_evento(credencial_de_acesso: Credenci
 /**
  * Busca um evento pelo id
  *
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve o evento pelo id; registro excluído não é encontrado.
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve o evento pelo id; registro excluído não é encontrado.
  *
  * `GET /evento/{id}`
  */
@@ -284,7 +260,7 @@ export declare function buscar_pelo_id_evento(credencial_de_acesso: CredencialDe
 /**
  * Atualiza um evento pelo id
  *
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Atualização parcial: só os campos enviados mudam. Muda o `nome` (cortado em 120 caracteres) e o `payload` (JSON livre) do evento. Campos do corpo, todos opcionais: `nome`: novo nome do evento (cortado em 120 caracteres); `payload`: novos dados livres do evento (JSON), que substituem os atuais.
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Atualização parcial: só os campos enviados mudam. Muda o `nome` (cortado em 120 caracteres) e o `payload` (JSON livre) do evento. Campos do corpo, todos opcionais: `nome`: novo nome do evento (cortado em 120 caracteres); `payload`: novos dados livres do evento (JSON), que substituem os atuais.
  *
  * `PATCH /evento/{id}`
  */
@@ -292,7 +268,7 @@ export declare function atualizar_pelo_id_evento(credencial_de_acesso: Credencia
 /**
  * Exclui um evento pelo id
  *
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Exclusão lógica: o registro some das leituras, mas não é apagado na hora.
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Exclusão lógica: o registro some das leituras, mas não é apagado na hora.
  *
  * `DELETE /evento/{id}`
  */
@@ -300,7 +276,7 @@ export declare function deletar_pelo_id_evento(credencial_de_acesso: CredencialD
 /**
  * Lista as sessões paginadas
  *
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Lista as sessões não excluídas da conta, da mais recente para a mais antiga. `aplicativo_id` filtra pelo aplicativo. `pagina` começa em 1 (padrão 1; menor que 1 vira 1). A página tem sempre 50 itens: o parâmetro `tamanho` é aceito, mas ignorado. A resposta traz `itens`, `total` (quantidade de registros que casam com os filtros), `pagina` e `tamanho` (50). Parâmetros de consulta, todos opcionais: `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: aceito, mas ignorado: a página tem sempre 50 itens; `aplicativo_id`: id do aplicativo (opcional).
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Lista as sessões não excluídas, da mais recente para a mais antiga. `aplicativo_id` filtra pelo aplicativo. `pagina` começa em 1 (padrão 1; menor que 1 vira 1). A página tem sempre 50 itens: o parâmetro `tamanho` é aceito, mas ignorado. A resposta traz `itens`, `total` (quantidade de registros que casam com os filtros), `pagina` e `tamanho` (50). Parâmetros de consulta, todos opcionais: `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: aceito, mas ignorado: a página tem sempre 50 itens; `aplicativo_id`: id do aplicativo (opcional).
  *
  * `GET /sessao`
  */
@@ -308,7 +284,7 @@ export declare function buscar_paginador_sessao(credencial_de_acesso: Credencial
 /**
  * Cadastra uma sessão
  *
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Grava uma sessão de navegação de um aplicativo da conta (as sessões normalmente nascem sozinhas na ingestão). `aplicativo_id` precisa ser de um aplicativo da conta; `sessao_externa` e `anonimo_id` são obrigatórios e não podem ficar vazios. `navegador`, `sistema_operacional`, `dispositivo`, `resolucao` e `pais` têm padrão `DESCONHECIDO`; `pagina_inicial` tem padrão vazio. Campos do corpo: `aplicativo_id`: id de um aplicativo da conta (obrigatório); `sessao_externa`: identificador da sessão no navegador (obrigatório, não pode ficar vazio); `anonimo_id`: identificador anônimo do visitante (obrigatório, não pode ficar vazio); `usuario_id`: id do usuário logado no site (opcional); `navegador`: navegador (padrão `DESCONHECIDO`); `sistema_operacional`: sistema operacional (padrão `DESCONHECIDO`); `dispositivo`: tipo de dispositivo (padrão `DESCONHECIDO`); `resolucao`: resolução da tela (padrão `DESCONHECIDO`); `pais`: código do país com duas letras (padrão `DESCONHECIDO`); `pagina_inicial`: endereço da primeira página (padrão vazio).
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Grava uma sessão de navegação de um aplicativo (as sessões normalmente nascem sozinhas na ingestão). `aplicativo_id` precisa ser de um aplicativo; `sessao_externa` e `anonimo_id` são obrigatórios e não podem ficar vazios. `navegador`, `sistema_operacional`, `dispositivo`, `resolucao` e `pais` têm padrão `DESCONHECIDO`; `pagina_inicial` tem padrão vazio. Campos do corpo: `aplicativo_id`: id de um aplicativo (obrigatório); `sessao_externa`: identificador da sessão no navegador (obrigatório, não pode ficar vazio); `anonimo_id`: identificador anônimo do visitante (obrigatório, não pode ficar vazio); `usuario_id`: id do usuário logado no site (opcional); `navegador`: navegador (padrão `DESCONHECIDO`); `sistema_operacional`: sistema operacional (padrão `DESCONHECIDO`); `dispositivo`: tipo de dispositivo (padrão `DESCONHECIDO`); `resolucao`: resolução da tela (padrão `DESCONHECIDO`); `pais`: código do país com duas letras (padrão `DESCONHECIDO`); `pagina_inicial`: endereço da primeira página (padrão vazio).
  *
  * `POST /sessao`
  */
@@ -316,7 +292,7 @@ export declare function criar_sessao(credencial_de_acesso: CredencialDeAcesso, c
 /**
  * Lista básica de sessões para seleção
  *
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve só id e rótulo (`usuario_id` ou, sem ele, `anonimo_id`, mais a data e hora de início em UTC, no formato `DD/MM/AAAA HH:MM`), em ordem alfabética do rótulo. `busca` procura o trecho no rótulo, sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`. Parâmetros de consulta, todos opcionais: `busca`: trecho do rótulo (usuário ou identificador anônimo e data de início), sem diferenciar maiúsculas (opcional); `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: itens por página (padrão 10, sem máximo; menor que 1 vira 1).
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve só id e rótulo (`usuario_id` ou, sem ele, `anonimo_id`, mais a data e hora de início em UTC, no formato `DD/MM/AAAA HH:MM`), em ordem alfabética do rótulo. `busca` procura o trecho no rótulo, sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`. Parâmetros de consulta, todos opcionais: `busca`: trecho do rótulo (usuário ou identificador anônimo e data de início), sem diferenciar maiúsculas (opcional); `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: itens por página (padrão 10, sem máximo; menor que 1 vira 1).
  *
  * `GET /sessao/autocomplete`
  */
@@ -324,7 +300,7 @@ export declare function buscar_auto_complete_sessao(credencial_de_acesso: Creden
 /**
  * Busca sessões por filtro
  *
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve todas as sessões não excluídas da conta que casam com o filtro, sem paginação, da mais recente para a mais antiga (`iniciada_em`). `usuario_id`, `anonimo_id`, `navegador` e `pais` comparam o valor exato, sem diferenciar maiúsculas; `com_erro` filtra quem teve (ou não) ao menos um erro; `inicio` e `fim` (data e hora ISO 8601) limitam o `iniciada_em`. Sem filtro, devolve todas. Parâmetros de consulta, todos opcionais: `aplicativo_id`: id do aplicativo; `usuario_id`: id do usuário logado no site (valor exato, sem diferenciar maiúsculas); `anonimo_id`: identificador anônimo do visitante (valor exato, sem diferenciar maiúsculas); `navegador`: navegador (valor exato, sem diferenciar maiúsculas); `pais`: código do país com duas letras (sem diferenciar maiúsculas); `com_erro`: `true` só sessões com algum erro; `false` só sessões sem erro; `inicio`: sessões iniciadas a partir desta data e hora ISO 8601, por exemplo 2026-10-07T00:00:00Z; `fim`: sessões iniciadas até esta data e hora ISO 8601.
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve todas as sessões não excluídas que casam com o filtro, sem paginação, da mais recente para a mais antiga (`iniciada_em`). `usuario_id`, `anonimo_id`, `navegador` e `pais` comparam o valor exato, sem diferenciar maiúsculas; `com_erro` filtra quem teve (ou não) ao menos um erro; `inicio` e `fim` (data e hora ISO 8601) limitam o `iniciada_em`. Sem filtro, devolve todas. Parâmetros de consulta, todos opcionais: `aplicativo_id`: id do aplicativo; `usuario_id`: id do usuário logado no site (valor exato, sem diferenciar maiúsculas); `anonimo_id`: identificador anônimo do visitante (valor exato, sem diferenciar maiúsculas); `navegador`: navegador (valor exato, sem diferenciar maiúsculas); `pais`: código do país com duas letras (sem diferenciar maiúsculas); `com_erro`: `true` só sessões com algum erro; `false` só sessões sem erro; `inicio`: sessões iniciadas a partir desta data e hora ISO 8601, por exemplo 2026-10-07T00:00:00Z; `fim`: sessões iniciadas até esta data e hora ISO 8601.
  *
  * `GET /sessao/filtro`
  */
@@ -332,7 +308,7 @@ export declare function buscar_pelo_filtro_sessao(credencial_de_acesso: Credenci
 /**
  * Busca uma sessão pelo id
  *
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve a sessão pelo id; registro excluído não é encontrado.
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve a sessão pelo id; registro excluído não é encontrado.
  *
  * `GET /sessao/{id}`
  */
@@ -340,7 +316,7 @@ export declare function buscar_pelo_id_sessao(credencial_de_acesso: CredencialDe
 /**
  * Atualiza uma sessão pelo id
  *
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Atualização parcial: só os campos enviados mudam. Muda `usuario_id`, `pais` e `tempo_carregamento_ms` (em milissegundos) e marca a última atividade como agora. Campos do corpo, todos opcionais: `usuario_id`: novo id do usuário logado no site; `pais`: novo código do país com duas letras; `tempo_carregamento_ms`: tempo de carregamento da página inicial, em milissegundos.
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Atualização parcial: só os campos enviados mudam. Muda `usuario_id`, `pais` e `tempo_carregamento_ms` (em milissegundos) e marca a última atividade como agora. Campos do corpo, todos opcionais: `usuario_id`: novo id do usuário logado no site; `pais`: novo código do país com duas letras; `tempo_carregamento_ms`: tempo de carregamento da página inicial, em milissegundos.
  *
  * `PATCH /sessao/{id}`
  */
@@ -348,7 +324,7 @@ export declare function atualizar_pelo_id_sessao(credencial_de_acesso: Credencia
 /**
  * Exclui uma sessão pelo id
  *
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Exclusão lógica: o registro some das leituras, mas não é apagado na hora.
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Exclusão lógica: o registro some das leituras, mas não é apagado na hora.
  *
  * `DELETE /sessao/{id}`
  */
@@ -356,7 +332,7 @@ export declare function deletar_pelo_id_sessao(credencial_de_acesso: CredencialD
 /**
  * Lista os registros de uso paginados
  *
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Lista os registros de uso diário não excluídos da conta, do dia mais recente para o mais antigo. `ciclo` (`AAAA-MM`) filtra pelo mês e `aplicativo_id` pelo aplicativo. `pagina` começa em 1 (padrão 1; menor que 1 vira 1). A página tem sempre 50 itens: o parâmetro `tamanho` é aceito, mas ignorado. A resposta traz `itens`, `total` (quantidade de registros que casam com os filtros), `pagina` e `tamanho` (50). Parâmetros de consulta, todos opcionais: `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: aceito, mas ignorado: a página tem sempre 50 itens; `ciclo`: ciclo mensal exato, no formato AAAA-MM (opcional); `aplicativo_id`: id do aplicativo (opcional).
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Lista os registros de uso diário não excluídos, do dia mais recente para o mais antigo. `ciclo` (`AAAA-MM`) filtra pelo mês e `aplicativo_id` pelo aplicativo. `pagina` começa em 1 (padrão 1; menor que 1 vira 1). A página tem sempre 50 itens: o parâmetro `tamanho` é aceito, mas ignorado. A resposta traz `itens`, `total` (quantidade de registros que casam com os filtros), `pagina` e `tamanho` (50). Parâmetros de consulta, todos opcionais: `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: aceito, mas ignorado: a página tem sempre 50 itens; `ciclo`: ciclo mensal exato, no formato AAAA-MM (opcional); `aplicativo_id`: id do aplicativo (opcional).
  *
  * `GET /uso`
  */
@@ -364,7 +340,7 @@ export declare function buscar_paginador_uso(credencial_de_acesso: CredencialDeA
 /**
  * Cadastra um registro de uso
  *
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Soma eventos aceitos e recusados ao uso diário de um aplicativo da conta (o uso normalmente é contado sozinho pela ingestão). `aplicativo_id` precisa ser de um aplicativo da conta; `dia` é obrigatório, no formato `AAAA-MM-DD`; `eventos_aceitos` e `eventos_recusados` têm padrão 0. Se já existe o registro daquele aplicativo naquele dia, os valores enviados são somados aos atuais e o registro existente é devolvido. O `ciclo` é o mês do dia (`AAAA-MM`). Campos do corpo: `aplicativo_id`: id de um aplicativo da conta (obrigatório); `dia`: dia no formato AAAA-MM-DD (obrigatório); `eventos_aceitos`: eventos aceitos a somar (padrão 0); `eventos_recusados`: eventos recusados a somar (padrão 0).
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Soma eventos aceitos e recusados ao uso diário de um aplicativo (o uso normalmente é contado sozinho pela ingestão). `aplicativo_id` precisa ser de um aplicativo; `dia` é obrigatório, no formato `AAAA-MM-DD`; `eventos_aceitos` e `eventos_recusados` têm padrão 0. Se já existe o registro daquele aplicativo naquele dia, os valores enviados são somados aos atuais e o registro existente é devolvido. O `ciclo` é o mês do dia (`AAAA-MM`). Campos do corpo: `aplicativo_id`: id de um aplicativo (obrigatório); `dia`: dia no formato AAAA-MM-DD (obrigatório); `eventos_aceitos`: eventos aceitos a somar (padrão 0); `eventos_recusados`: eventos recusados a somar (padrão 0).
  *
  * `POST /uso`
  */
@@ -372,7 +348,7 @@ export declare function criar_uso(credencial_de_acesso: CredencialDeAcesso, corp
 /**
  * Lista básica de registros de uso para seleção
  *
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve só id e rótulo (nome do aplicativo e dia), ordenados por ciclo e dia. `busca` procura o trecho no ciclo (`AAAA-MM`), sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`. Parâmetros de consulta, todos opcionais: `busca`: trecho do ciclo (AAAA-MM), sem diferenciar maiúsculas (opcional); `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: itens por página (padrão 10, sem máximo; menor que 1 vira 1).
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve só id e rótulo (nome do aplicativo e dia), ordenados por ciclo e dia. `busca` procura o trecho no ciclo (`AAAA-MM`), sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`. Parâmetros de consulta, todos opcionais: `busca`: trecho do ciclo (AAAA-MM), sem diferenciar maiúsculas (opcional); `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: itens por página (padrão 10, sem máximo; menor que 1 vira 1).
  *
  * `GET /uso/autocomplete`
  */
@@ -380,7 +356,7 @@ export declare function buscar_auto_complete_uso(credencial_de_acesso: Credencia
 /**
  * Busca registros de uso por filtro
  *
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve todos os registros de uso diário não excluídos da conta que casam com o filtro, sem paginação, do dia mais antigo para o mais recente. `aplicativo_id` filtra pelo aplicativo; `ciclo` (`AAAA-MM`) pelo mês; `dia_inicial` e `dia_final` (`AAAA-MM-DD`) limitam o dia. Sem filtro, devolve todos. Parâmetros de consulta, todos opcionais: `aplicativo_id`: id do aplicativo; `ciclo`: ciclo mensal exato, no formato AAAA-MM; `dia_inicial`: primeiro dia, no formato AAAA-MM-DD; `dia_final`: último dia, no formato AAAA-MM-DD.
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve todos os registros de uso diário não excluídos que casam com o filtro, sem paginação, do dia mais antigo para o mais recente. `aplicativo_id` filtra pelo aplicativo; `ciclo` (`AAAA-MM`) pelo mês; `dia_inicial` e `dia_final` (`AAAA-MM-DD`) limitam o dia. Sem filtro, devolve todos. Parâmetros de consulta, todos opcionais: `aplicativo_id`: id do aplicativo; `ciclo`: ciclo mensal exato, no formato AAAA-MM; `dia_inicial`: primeiro dia, no formato AAAA-MM-DD; `dia_final`: último dia, no formato AAAA-MM-DD.
  *
  * `GET /uso/filtro`
  */
@@ -388,7 +364,7 @@ export declare function buscar_pelo_filtro_uso(credencial_de_acesso: CredencialD
 /**
  * Busca um registro de uso pelo id
  *
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve o registro de uso pelo id; registro excluído não é encontrado.
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve o registro de uso pelo id; registro excluído não é encontrado.
  *
  * `GET /uso/{id}`
  */
@@ -396,7 +372,7 @@ export declare function buscar_pelo_id_uso(credencial_de_acesso: CredencialDeAce
 /**
  * Atualiza um registro de uso pelo id
  *
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Atualização parcial: só os campos enviados mudam. Substitui `eventos_aceitos` e/ou `eventos_recusados` pelos valores enviados. Campos do corpo, todos opcionais: `eventos_aceitos`: novo total de eventos aceitos no dia; `eventos_recusados`: novo total de eventos recusados no dia.
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Atualização parcial: só os campos enviados mudam. Substitui `eventos_aceitos` e/ou `eventos_recusados` pelos valores enviados. Campos do corpo, todos opcionais: `eventos_aceitos`: novo total de eventos aceitos no dia; `eventos_recusados`: novo total de eventos recusados no dia.
  *
  * `PATCH /uso/{id}`
  */
@@ -404,7 +380,7 @@ export declare function atualizar_pelo_id_uso(credencial_de_acesso: CredencialDe
 /**
  * Exclui um registro de uso pelo id
  *
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Exclusão lógica: o registro some das leituras, mas não é apagado na hora.
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Exclusão lógica: o registro some das leituras, mas não é apagado na hora.
  *
  * `DELETE /uso/{id}`
  */