termo_core 0.1.3 → 0.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,19 +1,3 @@
1
- export interface AcessoAtual {
2
- colaborador_id?: string | null;
3
- email: string;
4
- id: string;
5
- master: boolean;
6
- nome: string;
7
- perfil: string;
8
- perfil_acesso?: string | null;
9
- permissoes: Permissoes;
10
- }
11
- export interface Acoes {
12
- criar?: boolean;
13
- deletar?: boolean;
14
- editar?: boolean;
15
- ler?: boolean;
16
- }
17
1
  /**
18
2
  * Arquivo (guardado no TermoBucket) ou link anexado a uma tarefa ou ticket. A lista não traz o arquivo:
19
3
  * ele vem só no `buscarPeloId`, pela URL de download assinada.
@@ -93,53 +77,6 @@ export interface AplicativoResumo {
93
77
  id: string;
94
78
  nome: string;
95
79
  }
96
- export interface Auth {
97
- ativo: boolean;
98
- atualizado_em: string;
99
- criado_em: string;
100
- email: string;
101
- id: string;
102
- master: boolean;
103
- nome?: string | null;
104
- perfil: string;
105
- termoauth_id?: string | null;
106
- ultimo_login_em?: string | null;
107
- vinculado: boolean;
108
- }
109
- export interface AuthAtualizar {
110
- ativo?: boolean | null;
111
- email?: string | null;
112
- }
113
- export interface AuthAutoComplete {
114
- email: string;
115
- id: string;
116
- perfil: string;
117
- }
118
- export interface AuthCriar {
119
- email: string;
120
- perfil: string;
121
- }
122
- export interface Colaborador {
123
- ativo: boolean;
124
- atualizado_em: string;
125
- auth_id: string;
126
- cargo?: string | null;
127
- criado_em: string;
128
- email: string;
129
- funcao?: string | null;
130
- id: string;
131
- master: boolean;
132
- nome: string;
133
- perfil_acesso?: string | null;
134
- perfil_acesso_id?: string | null;
135
- setor?: string | null;
136
- telefone?: string | null;
137
- }
138
- export interface ColaboradorAutoComplete {
139
- email: string;
140
- id: string;
141
- nome: string;
142
- }
143
80
  /**
144
81
  * Quem aparece como dono, membro, responsável, solicitante ou autor nos projetos, tarefas e tickets.
145
82
  */
@@ -147,9 +84,6 @@ export interface ColaboradorResumo {
147
84
  id: string;
148
85
  nome: string;
149
86
  }
150
- export interface ColaboradorVincularPerfilAcesso {
151
- perfil_acesso_id?: string | null;
152
- }
153
87
  export interface Comentario {
154
88
  atualizado_em: string;
155
89
  autor?: ColaboradorResumo | null;
@@ -178,15 +112,6 @@ export interface ComentarioCriar {
178
112
  texto: string;
179
113
  ticket_id?: string | null;
180
114
  }
181
- export interface Configuracao {
182
- atualizado_em: string;
183
- atualizado_por?: string | null;
184
- criptografia_disponivel: boolean;
185
- segredo_do_app_gerado_no_termo_auth: ValorProtegido;
186
- }
187
- export interface ConfiguracaoAtualizar {
188
- segredo_do_app_gerado_no_termo_auth?: string | null;
189
- }
190
115
  export interface Documento {
191
116
  aplicativo_id: string;
192
117
  atualizado_em: string;
@@ -215,16 +140,6 @@ export interface DocumentoCriar {
215
140
  nome: string;
216
141
  tipo?: string;
217
142
  }
218
- export interface EntregaDoEvento {
219
- dados: Record<string, unknown>;
220
- entidade_id: string;
221
- id: string;
222
- ocorrido_em: string;
223
- publicador: string;
224
- recebido_em: string;
225
- tipo: string;
226
- versao: number;
227
- }
228
143
  export interface Etiqueta {
229
144
  atualizado_em: string;
230
145
  cor: string;
@@ -313,69 +228,6 @@ export interface PaginaAplicativoAutoComplete {
313
228
  tamanho: number;
314
229
  total: number;
315
230
  }
316
- export interface PaginaAuthItensItem {
317
- ativo: boolean;
318
- atualizado_em: string;
319
- criado_em: string;
320
- email: string;
321
- id: string;
322
- master: boolean;
323
- nome?: string | null;
324
- perfil: string;
325
- termoauth_id?: string | null;
326
- ultimo_login_em?: string | null;
327
- vinculado: boolean;
328
- }
329
- export interface PaginaAuth {
330
- itens: Array<PaginaAuthItensItem>;
331
- pagina: number;
332
- tamanho: number;
333
- total: number;
334
- }
335
- export interface PaginaAuthAutoCompleteItensItem {
336
- email: string;
337
- id: string;
338
- perfil: string;
339
- }
340
- export interface PaginaAuthAutoComplete {
341
- itens: Array<PaginaAuthAutoCompleteItensItem>;
342
- pagina: number;
343
- tamanho: number;
344
- total: number;
345
- }
346
- export interface PaginaColaboradorItensItem {
347
- ativo: boolean;
348
- atualizado_em: string;
349
- auth_id: string;
350
- cargo?: string | null;
351
- criado_em: string;
352
- email: string;
353
- funcao?: string | null;
354
- id: string;
355
- master: boolean;
356
- nome: string;
357
- perfil_acesso?: string | null;
358
- perfil_acesso_id?: string | null;
359
- setor?: string | null;
360
- telefone?: string | null;
361
- }
362
- export interface PaginaColaborador {
363
- itens: Array<PaginaColaboradorItensItem>;
364
- pagina: number;
365
- tamanho: number;
366
- total: number;
367
- }
368
- export interface PaginaColaboradorAutoCompleteItensItem {
369
- email: string;
370
- id: string;
371
- nome: string;
372
- }
373
- export interface PaginaColaboradorAutoComplete {
374
- itens: Array<PaginaColaboradorAutoCompleteItensItem>;
375
- pagina: number;
376
- tamanho: number;
377
- total: number;
378
- }
379
231
  export interface PaginaComentarioItensItem {
380
232
  atualizado_em: string;
381
233
  autor?: ColaboradorResumo | null;
@@ -472,31 +324,6 @@ export interface PaginaNotificacao {
472
324
  tamanho: number;
473
325
  total: number;
474
326
  }
475
- export interface PaginaPerfilAcessoItensItem {
476
- atualizado_em: string;
477
- colaboradores: number;
478
- criado_em: string;
479
- descricao?: string | null;
480
- id: string;
481
- nome: string;
482
- permissoes: Permissoes;
483
- }
484
- export interface PaginaPerfilAcesso {
485
- itens: Array<PaginaPerfilAcessoItensItem>;
486
- pagina: number;
487
- tamanho: number;
488
- total: number;
489
- }
490
- export interface PaginaPerfilAcessoAutoCompleteItensItem {
491
- id: string;
492
- nome: string;
493
- }
494
- export interface PaginaPerfilAcessoAutoComplete {
495
- itens: Array<PaginaPerfilAcessoAutoCompleteItensItem>;
496
- pagina: number;
497
- tamanho: number;
498
- total: number;
499
- }
500
327
  export interface PaginaProjetoItensItem {
501
328
  aplicativos: Array<AplicativoResumo>;
502
329
  arquivado: boolean;
@@ -679,35 +506,6 @@ export interface PaginaTicketAutoComplete {
679
506
  tamanho: number;
680
507
  total: number;
681
508
  }
682
- export interface PerfilAcesso {
683
- atualizado_em: string;
684
- colaboradores: number;
685
- criado_em: string;
686
- descricao?: string | null;
687
- id: string;
688
- nome: string;
689
- permissoes: Permissoes;
690
- }
691
- export interface PerfilAcessoAtualizar {
692
- descricao?: string | null;
693
- nome?: string | null;
694
- permissoes?: Permissoes | null;
695
- }
696
- export interface PerfilAcessoAutoComplete {
697
- id: string;
698
- nome: string;
699
- }
700
- export interface PerfilAcessoCriar {
701
- descricao?: string | null;
702
- nome: string;
703
- permissoes?: Permissoes;
704
- }
705
- export interface Permissoes {
706
- aplicativos?: Acoes;
707
- colaboradores?: Acoes;
708
- projetos?: Acoes;
709
- tickets?: Acoes;
710
- }
711
509
  export interface Projeto {
712
510
  aplicativos: Array<AplicativoResumo>;
713
511
  arquivado: boolean;
@@ -776,11 +574,6 @@ export interface ProjetoCriar {
776
574
  export interface RespostaDeErro {
777
575
  erro: string;
778
576
  }
779
- export interface SaudeDoBackend {
780
- mensagem: string;
781
- sucesso: boolean;
782
- versao: string;
783
- }
784
577
  /**
785
578
  * Uma coluna do quadro do projeto. A `ordem` é decimal para encaixar uma coluna entre duas sem
786
579
  * renumerar as outras.
@@ -992,12 +785,3 @@ export interface TicketTarefa {
992
785
  projeto_nome: string;
993
786
  titulo: string;
994
787
  }
995
- export interface ValorProtegido {
996
- configurado: boolean;
997
- final_visivel?: string | null;
998
- }
999
- export interface VersaoDoBackend {
1000
- sucesso: boolean;
1001
- versao: string;
1002
- versao_backend: string;
1003
- }
@@ -25,61 +25,6 @@ export interface ParametrosDeBuscarPeloFiltroAplicativo {
25
25
  chave?: string;
26
26
  comportamento_ao_estourar?: string;
27
27
  }
28
- /**
29
- * Parâmetros de consulta e de cabeçalho de `/auth`.
30
- */
31
- export interface ParametrosDeBuscarPaginadorAuth {
32
- pagina?: number;
33
- tamanho?: number;
34
- }
35
- /**
36
- * Parâmetros de consulta e de cabeçalho de `/auth/autocomplete`.
37
- */
38
- export interface ParametrosDeBuscarAutoCompleteAuth {
39
- busca?: string;
40
- perfil?: string;
41
- pagina?: number;
42
- tamanho?: number;
43
- }
44
- /**
45
- * Parâmetros de consulta e de cabeçalho de `/auth/filtro`.
46
- */
47
- export interface ParametrosDeBuscarPeloFiltroAuth {
48
- email?: string;
49
- perfil?: string;
50
- ativo?: boolean;
51
- }
52
- /**
53
- * Parâmetros de consulta e de cabeçalho de `/colaborador`.
54
- */
55
- export interface ParametrosDeBuscarPaginadorColaborador {
56
- pagina?: number;
57
- tamanho?: number;
58
- nome?: string;
59
- setor?: string;
60
- cargo?: string;
61
- ativo?: boolean;
62
- }
63
- /**
64
- * Parâmetros de consulta e de cabeçalho de `/colaborador/autocomplete`.
65
- */
66
- export interface ParametrosDeBuscarAutoCompleteColaborador {
67
- busca?: string;
68
- pagina?: number;
69
- tamanho?: number;
70
- }
71
- /**
72
- * Parâmetros de consulta e de cabeçalho de `/colaborador/filtro`.
73
- */
74
- export interface ParametrosDeBuscarPeloFiltroColaborador {
75
- busca?: string;
76
- nome?: string;
77
- email?: string;
78
- setor?: string;
79
- cargo?: string;
80
- ativo?: boolean;
81
- perfil_acesso_id?: string;
82
- }
83
28
  /**
84
29
  * Parâmetros de consulta e de cabeçalho de `/erro`.
85
30
  */
@@ -137,27 +82,6 @@ export interface ParametrosDeBuscarPeloFiltroEvento {
137
82
  inicio?: string;
138
83
  fim?: string;
139
84
  }
140
- /**
141
- * Parâmetros de consulta e de cabeçalho de `/perfil_acesso`.
142
- */
143
- export interface ParametrosDeBuscarPaginadorPerfilAcesso {
144
- pagina?: number;
145
- tamanho?: number;
146
- }
147
- /**
148
- * Parâmetros de consulta e de cabeçalho de `/perfil_acesso/autocomplete`.
149
- */
150
- export interface ParametrosDeBuscarAutoCompletePerfilAcesso {
151
- busca?: string;
152
- pagina?: number;
153
- tamanho?: number;
154
- }
155
- /**
156
- * Parâmetros de consulta e de cabeçalho de `/perfil_acesso/filtro`.
157
- */
158
- export interface ParametrosDeBuscarPeloFiltroPerfilAcesso {
159
- nome?: string;
160
- }
161
85
  /**
162
86
  * Parâmetros de consulta e de cabeçalho de `/sessao`.
163
87
  */
@@ -213,35 +137,6 @@ export interface ParametrosDeBuscarPeloFiltroUso {
213
137
  dia_inicial?: string;
214
138
  dia_final?: string;
215
139
  }
216
- /**
217
- * Parâmetros de consulta e de cabeçalho de `/webhooks/termowebhook`.
218
- */
219
- export interface ParametrosDeReceberEventoTermoWebhookWebhooks {
220
- /**
221
- * Horário Unix em segundos usado na assinatura
222
- *
223
- * Enviado no cabeçalho `X-TermoWebhook-Data`.
224
- */
225
- "X-TermoWebhook-Data": number;
226
- /**
227
- * Id (kid) da chave do hub que assinou a entrega
228
- *
229
- * Enviado no cabeçalho `X-TermoWebhook-Chave`.
230
- */
231
- "X-TermoWebhook-Chave": string;
232
- /**
233
- * Id do aplicativo destino no hub, que precisa ser o do TermoTracing
234
- *
235
- * Enviado no cabeçalho `X-TermoWebhook-Destino`.
236
- */
237
- "X-TermoWebhook-Destino": string;
238
- /**
239
- * `ed25519=<base64url>` da assinatura de `<data>.<destino>.<corpo>`
240
- *
241
- * Enviado no cabeçalho `X-TermoWebhook-Assinatura`.
242
- */
243
- "X-TermoWebhook-Assinatura": string;
244
- }
245
140
  /**
246
141
  * Lista os aplicativos paginados
247
142
  *
@@ -298,126 +193,6 @@ export declare function atualizar_pelo_id_aplicativo(credencial_de_acesso: Crede
298
193
  * `DELETE /aplicativo/{id}`
299
194
  */
300
195
  export declare function deletar_pelo_id_aplicativo(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
301
- /**
302
- * Lista os acessos com paginação
303
- *
304
- * Exige qualquer permissão da área `colaboradores` (qualquer ação liberada na área já libera a leitura). Ordena por perfil e depois por e-mail. Acessos excluídos não aparecem. `pagina` começa em 1 (padrão 1; valores menores viram 1). A página tem sempre 50 itens: `tamanho` é aceito, mas ignorado. `total` conta todos os registros não excluídos.
305
- *
306
- * `GET /auth`
307
- */
308
- export declare function buscar_paginador_auth(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorAuth, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaAuth>;
309
- /**
310
- * Cria um acesso
311
- *
312
- * Exige a permissão `criar` da área `colaboradores`. Cadastra quem pode entrar no TermoTracing. `email` é obrigatório, com até 160 caracteres, e é gravado em minúsculas, sem espaços nas pontas; `perfil` é `colaborador` ou `cliente`. O acesso nasce ativo e sem nenhuma permissão. Para a pessoa conseguir entrar, o e-mail precisa ser `@termotubos.com.br` e existir no TermoAuth com o mesmo endereço.
313
- *
314
- * `POST /auth`
315
- */
316
- export declare function criar_auth(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.AuthCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Auth>;
317
- /**
318
- * Busca o acesso de quem está logado
319
- *
320
- * Livre para qualquer usuário autenticado com acesso ativo, mesmo sem nenhuma permissão liberada. Devolve o acesso de quem chamou (id, e-mail, nome, perfil e se é master do TermoAuth) e as permissões por área (`rastreamento`, `aplicativos` e `colaboradores`), cada uma com `ler`, `criar`, `editar` e `deletar`. Um master do TermoAuth recebe todas as permissões e, no primeiro pedido, ganha o acesso e o colaborador automaticamente. `nome` vem do TermoAuth e, se estiver vazio, repete o e-mail. É a chamada que o painel faz antes de mostrar qualquer tela.
321
- *
322
- * `GET /auth/acesso`
323
- */
324
- export declare function buscar_acesso_auth(credencial_de_acesso: CredencialDeAcesso, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.AcessoAtual>;
325
- /**
326
- * Lista básica de acessos para seleção
327
- *
328
- * Exige qualquer permissão da área `colaboradores` (qualquer ação liberada na área já libera a leitura). Devolve só id, e-mail e perfil, em ordem alfabética de e-mail, para escolher um acesso. `busca` procura por trecho do e-mail, sem diferenciar maiúsculas; `perfil` compara o valor exato. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. `total` conta os registros que casam com a busca.
329
- *
330
- * `GET /auth/autocomplete`
331
- */
332
- export declare function buscar_auto_complete_auth(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteAuth, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaAuthAutoComplete>;
333
- /**
334
- * Busca acessos por filtro
335
- *
336
- * Exige qualquer permissão da área `colaboradores` (qualquer ação liberada na área já libera a leitura). Devolve todos os acessos que casam com o filtro, sem paginação, em ordem alfabética de e-mail. `email` procura por trecho, sem diferenciar maiúsculas; `perfil` compara o valor exato (`colaborador` ou `cliente`); `ativo` filtra pela situação. Sem filtro, devolve todos. Acessos excluídos não aparecem.
337
- *
338
- * `GET /auth/filtro`
339
- */
340
- export declare function buscar_pelo_filtro_auth(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroAuth, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Auth>>;
341
- /**
342
- * Busca um acesso pelo id
343
- *
344
- * Exige qualquer permissão da área `colaboradores` (qualquer ação liberada na área já libera a leitura). Acesso excluído responde `404`. `vinculado` diz se há um colaborador ligado ao acesso, e `nome` é o nome desse colaborador. `master` diz se a pessoa é master do TermoAuth.
345
- *
346
- * `GET /auth/{id}`
347
- */
348
- export declare function buscar_pelo_id_auth(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Auth>;
349
- /**
350
- * Atualiza um acesso pelo id
351
- *
352
- * Exige a permissão `editar` da área `colaboradores`. Atualização parcial: só os campos enviados mudam. `email` (até 160 caracteres, gravado em minúsculas) e `ativo` (acesso inativo é barrado em todas as rotas). O perfil não muda. O acesso de um master do TermoAuth não pode ser alterado.
353
- *
354
- * `PATCH /auth/{id}`
355
- */
356
- export declare function atualizar_pelo_id_auth(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.AuthAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Auth>;
357
- /**
358
- * Exclui um acesso pelo id
359
- *
360
- * Exige a permissão `deletar` da área `colaboradores`. A exclusão é lógica: o acesso some das consultas e a pessoa deixa de entrar, mas o registro fica guardado e não há como restaurar. Acesso com colaborador vinculado não pode ser excluído por aqui. O acesso de um master do TermoAuth não pode ser excluído.
361
- *
362
- * `DELETE /auth/{id}`
363
- */
364
- export declare function deletar_pelo_id_auth(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
365
- /**
366
- * Lista os colaboradores com paginação
367
- *
368
- * Exige qualquer permissão da área `colaboradores` (qualquer ação liberada na área já libera a leitura). Ordena por nome. Quando quem chama é master do TermoAuth, antes de listar o TermoTracing busca no TermoAuth os colaboradores `@termotubos.com.br` que ainda não existem aqui e os cadastra sem nenhuma permissão. `pagina` começa em 1 (padrão 1; valores menores viram 1). A página tem sempre 50 itens: `tamanho` é aceito, mas ignorado. `total` conta todos os registros não excluídos.
369
- *
370
- * `GET /colaborador`
371
- */
372
- export declare function buscar_paginador_colaborador(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorColaborador, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaColaborador>;
373
- /**
374
- * Lista básica de colaboradores para seleção
375
- *
376
- * Exige qualquer permissão da área `colaboradores` (qualquer ação liberada na área já libera a leitura). Devolve só id, nome e e-mail, em ordem alfabética de nome. `busca` procura por trecho do nome ou do e-mail, 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. `total` conta os registros que casam com a busca.
377
- *
378
- * `GET /colaborador/autocomplete`
379
- */
380
- export declare function buscar_auto_complete_colaborador(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteColaborador, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaColaboradorAutoComplete>;
381
- /**
382
- * Busca colaboradores por filtro
383
- *
384
- * Exige qualquer permissão da área `colaboradores` (qualquer ação liberada na área já libera a leitura). Devolve todos os colaboradores que casam com o filtro, sem paginação, em ordem alfabética de nome. `busca` procura por trecho do nome ou do e-mail (a busca rápida da tela); `nome`, `email` e `cargo` procuram por trecho, sem diferenciar maiúsculas; `ativo` filtra pela situação; `perfil_acesso_id` filtra pelo perfil de acesso. Sem filtro, devolve todos. O colaborador é do TermoAuth: aqui ele só é lido (chega pela sincronização e pelos eventos do TermoWebhook) e `setor`, `cargo` e `funcao` vêm de lá.
385
- *
386
- * `GET /colaborador/filtro`
387
- */
388
- export declare function buscar_pelo_filtro_colaborador(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroColaborador, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Colaborador>>;
389
- /**
390
- * Busca um colaborador pelo id
391
- *
392
- * Exige qualquer permissão da área `colaboradores` (qualquer ação liberada na área já libera a leitura). Devolve o colaborador com o e-mail e o `master` do acesso dele. Colaborador excluído responde `404`. O colaborador é do TermoAuth: aqui ele só é lido (chega pela sincronização e pelos eventos do TermoWebhook) e `setor`, `cargo` e `funcao` vêm de lá.
393
- *
394
- * `GET /colaborador/{id}`
395
- */
396
- export declare function buscar_pelo_id_colaborador(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Colaborador>;
397
- /**
398
- * Define o perfil de acesso de um colaborador
399
- *
400
- * Exige a permissão `editar` da área `colaboradores`. É a única escrita do colaborador feita pelo TermoTracing: `perfil_acesso_id` aponta para um perfil de `GET /perfil_acesso/filtro` e passa a definir o que a pessoa enxerga; `null` tira o perfil e deixa a pessoa sem nenhuma área. O colaborador de um master do TermoAuth não aceita perfil (ele já tem tudo). Vale em até 5 minutos (cache do acesso).
401
- *
402
- * `PATCH /colaborador/{id}/perfil_acesso`
403
- */
404
- export declare function vincular_perfil_acesso_colaborador(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.ColaboradorVincularPerfilAcesso, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Colaborador>;
405
- /**
406
- * Busca a configuração do TermoTracing
407
- *
408
- * Só um master do TermoAuth (os demais recebem `403`). A configuração é uma linha única e guarda o segredo do app `termo-tracing` gerado no TermoAuth, cifrado no banco com AES-256-GCM e a chave derivada de `GLOBAL_SECRET_CRIPTOGRAFIA`. O valor nunca volta: `segredo_do_app_gerado_no_termo_auth` traz só `configurado` e `final_visivel` (os 4 últimos caracteres, mascarados). Sem a `GLOBAL_SECRET_CRIPTOGRAFIA` no servidor, `criptografia_disponivel` vem `false` e o segredo aparece como não configurado.
409
- *
410
- * `GET /configuracao`
411
- */
412
- export declare function buscar_pelo_id_configuracao(credencial_de_acesso: CredencialDeAcesso, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Configuracao>;
413
- /**
414
- * Atualiza o segredo do app gerado no TermoAuth
415
- *
416
- * Só um master do TermoAuth (os demais recebem `403`). `segredo_do_app_gerado_no_termo_auth` é obrigatório: uma string troca o segredo (até 2.000 caracteres, sem quebra de linha; espaços nas pontas são removidos) e `null` ou string vazia limpa. O valor é gravado cifrado e entregue na hora ao `termo_core`, que o usa para pedir o token de aplicativo no TermoAuth, sem deploy. Campo desconhecido no corpo responde `422`.
417
- *
418
- * `PATCH /configuracao`
419
- */
420
- export declare function atualizar_pelo_id_configuracao(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.ConfiguracaoAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Configuracao>;
421
196
  /**
422
197
  * Lista os erros paginados
423
198
  *
@@ -498,14 +273,6 @@ export declare function buscar_auto_complete_evento(credencial_de_acesso: Creden
498
273
  * `GET /evento/filtro`
499
274
  */
500
275
  export declare function buscar_pelo_filtro_evento(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroEvento, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Evento>>;
501
- /**
502
- * Recebe um lote de eventos de um site (ingestão)
503
- *
504
- * Rota pública, sem token: é a que o script instalado no site do cliente chama. O corpo é JSON, opcionalmente comprimido em gzip (`Content-Encoding: gzip`), com a `chave` pública do aplicativo, os dados da `sessao` e a lista de `eventos`. O cabeçalho `Origin` (ou, na falta dele, `Referer`) precisa ser de um dos domínios cadastrados no aplicativo. Cada lote aceita até 500 eventos (o excedente é recusado) e eventos de tipo desconhecido são recusados; cada chave aceita até 6000 eventos por minuto. Tipos aceitos: `ERRO_JS`, `PROMISE_REJEITADA`, `CONSOLE`, `REQUISICAO`, `NAVEGACAO`, `SAIDA`, `PULSO`, `CLIQUE`, `DESEMPENHO`, `IDENTIFICACAO` e `PERSONALIZADO`. Com o comportamento `PARAR_INGESTAO` e a franquia do mês esgotada, o lote é recusado. Os eventos aceitos são gravados em segundo plano; a resposta diz quantos foram aceitos e recusados. Campos do corpo: `chave`: chave pública do aplicativo (prefixo `pk_live_`), obrigatória; `sessao`: dados da sessão de navegação que enviou o lote; `eventos`: eventos do lote; até 500 por lote, o excedente é recusado. Campos de `sessao`: `sessao.sessao_externa`: identificador da sessão gerado pelo script (obrigatório); `sessao.anonimo_id`: identificador anônimo do visitante (obrigatório); `sessao.usuario_id`: id do usuário logado no site (opcional); `sessao.navegador`: navegador (padrão vazio); `sessao.sistema_operacional`: sistema operacional (padrão vazio); `sessao.dispositivo`: tipo de dispositivo (padrão vazio); `sessao.resolucao`: resolução da tela (padrão vazio); `sessao.pagina_inicial`: endereço da primeira página (padrão vazio). Campos de cada item de `eventos`: `evento_id`: identificador do evento no navegador, usado para não gravar o mesmo evento duas vezes (até 120 caracteres); `tipo`: tipo do evento (obrigatório): `ERRO_JS`, `PROMISE_REJEITADA`, `CONSOLE`, `REQUISICAO`, `NAVEGACAO`, `SAIDA`, `PULSO`, `CLIQUE`, `DESEMPENHO`, `IDENTIFICACAO` ou `PERSONALIZADO`; outro valor é recusado; `nome`: nome do evento (padrão vazio; cortado em 120 caracteres); `mensagem`: mensagem (cortada em 2000 caracteres); `pilha`: pilha de chamadas (cortada em 8000 caracteres); `arquivo`: arquivo do erro (cortado em 2000 caracteres); `linha`: linha do erro; `coluna`: coluna do erro; `url`: endereço da página ou da requisição (cortado em 2000 caracteres); `metodo`: método HTTP da requisição; `status`: status HTTP da requisição; `duracao_ms`: duração em milissegundos; `nivel`: nível do console; `seletor`: seletor CSS do elemento clicado (cortado em 500 caracteres); `texto`: texto do elemento clicado (cortado em 200 caracteres); `metrica`: nome da métrica de desempenho; `valor`: valor da métrica de desempenho; `usuario_id`: id do usuário logado no site; `payload`: dados livres (JSON); `ocorrido_em`: data e hora ISO 8601 em que o evento ocorreu (padrão: a hora do recebimento).
505
- *
506
- * `POST /evento/ingestao`
507
- */
508
- export declare function criar_evento(corpo_da_requisicao: tipos.EventoCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.ResultadoIngestao>;
509
276
  /**
510
277
  * Busca um evento pelo id
511
278
  *
@@ -530,62 +297,6 @@ export declare function atualizar_pelo_id_evento(credencial_de_acesso: Credencia
530
297
  * `DELETE /evento/{id}`
531
298
  */
532
299
  export declare function deletar_pelo_id_evento(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
533
- /**
534
- * Lista os perfis de acesso com paginação
535
- *
536
- * Exige qualquer permissão da área `colaboradores` (qualquer ação liberada na área já libera a leitura). Ordena pelo nome. `pagina` começa em 1 (padrão 1; valores menores viram 1). A página tem sempre 50 itens: `tamanho` é aceito, mas ignorado. `total` conta todos os registros não excluídos.
537
- *
538
- * `GET /perfil_acesso`
539
- */
540
- export declare function buscar_paginador_perfil_acesso(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorPerfilAcesso, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaPerfilAcesso>;
541
- /**
542
- * Cria um perfil de acesso
543
- *
544
- * Exige a permissão `criar` da área `colaboradores`. O perfil de acesso é o conjunto de permissões que o TermoTracing dá a um colaborador: cada colaborador aponta para um perfil (`PATCH /colaborador/{id}/perfil_acesso`) e enxerga o que o perfil libera. `nome` é obrigatório (até 80 caracteres, único sem diferenciar maiúsculas); `descricao` é opcional (até 200); `permissoes` traz, para cada área (`rastreamento`, `aplicativos`, `colaboradores`), as ações `ler`, `criar`, `editar` e `deletar` (o que não vier fica `false`). A resposta inclui `colaboradores`, quantas pessoas usam o perfil. O master do TermoAuth tem tudo liberado sem precisar de perfil.
545
- *
546
- * `POST /perfil_acesso`
547
- */
548
- export declare function criar_perfil_acesso(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.PerfilAcessoCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PerfilAcesso>;
549
- /**
550
- * Lista básica de perfis de acesso para seleção
551
- *
552
- * Exige qualquer permissão da área `colaboradores` (qualquer ação liberada na área já libera a leitura). Devolve só o id e o nome, em ordem alfabética. `busca` procura por trecho do 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. `total` conta os registros que casam com a busca.
553
- *
554
- * `GET /perfil_acesso/autocomplete`
555
- */
556
- export declare function buscar_auto_complete_perfil_acesso(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompletePerfilAcesso, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaPerfilAcessoAutoComplete>;
557
- /**
558
- * Busca perfis de acesso por filtro
559
- *
560
- * Exige qualquer permissão da área `colaboradores` (qualquer ação liberada na área já libera a leitura). Devolve todos os perfis que casam com o filtro, sem paginação, em ordem alfabética de nome. `nome` procura por trecho, sem diferenciar maiúsculas. Sem filtro, devolve todos (é o que a tela usa para listar e para escolher o perfil de um colaborador).
561
- *
562
- * `GET /perfil_acesso/filtro`
563
- */
564
- export declare function buscar_pelo_filtro_perfil_acesso(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroPerfilAcesso, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.PerfilAcesso>>;
565
- /**
566
- * Busca um perfil de acesso pelo id
567
- *
568
- * Exige qualquer permissão da área `colaboradores` (qualquer ação liberada na área já libera a leitura). Perfil excluído responde `404`.
569
- *
570
- * `GET /perfil_acesso/{id}`
571
- */
572
- export declare function buscar_pelo_id_perfil_acesso(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PerfilAcesso>;
573
- /**
574
- * Atualiza um perfil de acesso pelo id
575
- *
576
- * Exige a permissão `editar` da área `colaboradores`. Atualização parcial: só os campos enviados mudam. `nome` segue o limite do cadastro; `descricao` vazia apaga o valor; `permissoes`, quando enviado, substitui o conjunto inteiro (o que não vier fica `false`). Todo colaborador do perfil passa a valer com as novas permissões em até 5 minutos (cache do acesso).
577
- *
578
- * `PATCH /perfil_acesso/{id}`
579
- */
580
- export declare function atualizar_pelo_id_perfil_acesso(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.PerfilAcessoAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PerfilAcesso>;
581
- /**
582
- * Exclui um perfil de acesso pelo id
583
- *
584
- * Exige a permissão `deletar` da área `colaboradores`. A exclusão é lógica e só é aceita quando nenhum colaborador usa o perfil: com gente vinculada responde `409`, e é preciso trocar o perfil dessas pessoas antes.
585
- *
586
- * `DELETE /perfil_acesso/{id}`
587
- */
588
- export declare function deletar_pelo_id_perfil_acesso(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
589
300
  /**
590
301
  * Lista as sessões paginadas
591
302
  *
@@ -642,14 +353,6 @@ export declare function atualizar_pelo_id_sessao(credencial_de_acesso: Credencia
642
353
  * `DELETE /sessao/{id}`
643
354
  */
644
355
  export declare function deletar_pelo_id_sessao(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
645
- /**
646
- * Verifica se o backend está no ar
647
- *
648
- * Pública, sem token e sem chave de aplicativo. Responde `200` com `sucesso: true`, `mensagem` e `versao` (a versão do backend no ar, em semver) sempre que o servidor está de pé; não consulta o banco nem o TermoAuth. É a rota que o deploy consulta depois de reiniciar o serviço.
649
- *
650
- * `GET /test`
651
- */
652
- export declare function verificar_saude_test(opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.SaudeDoBackend>;
653
356
  /**
654
357
  * Lista os registros de uso paginados
655
358
  *
@@ -706,11 +409,3 @@ export declare function atualizar_pelo_id_uso(credencial_de_acesso: CredencialDe
706
409
  * `DELETE /uso/{id}`
707
410
  */
708
411
  export declare function deletar_pelo_id_uso(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
709
- /**
710
- * Recebe as entregas do TermoWebhook
711
- *
712
- * Pública, sem token do usuário: é chamada pelo TermoWebhook, o hub de eventos da Termotubos, para entregar os eventos que o TermoTracing assina. A entrega é conferida pela assinatura Ed25519 do hub (chave pública em `/.well-known/jwks.json` do TermoWebhook), pela data e pelo destino, que precisa ser o próprio TermoTracing. Eventos tratados: `colaborador.criado` e `colaborador.atualizado`, versões 1 e 2, publicados pelo TermoAuth: criam ou atualizam o colaborador e o acesso dele (a v2 também traz setor, cargo e função), descartando o evento mais antigo que o último aplicado. Qualquer outro tipo responde `200` sem fazer nada. Como o hub entrega pelo menos uma vez, repetir o mesmo evento é seguro.
713
- *
714
- * `POST /webhooks/termowebhook`
715
- */
716
- export declare function receber_evento_termo_webhook_webhooks(parametros: ParametrosDeReceberEventoTermoWebhookWebhooks, corpo_da_requisicao: tipos.EntregaDoTermoWebhook, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;