termo_core 0.1.0 → 0.1.2

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,29 +1,6 @@
1
1
  import type * as tipos from "./tipos.js";
2
2
  import type { CredencialDeAcesso } from "../base/credencial.js";
3
3
  import { type OpcoesDaChamada } from "../base/requisicao.js";
4
- /**
5
- * Parâmetros de consulta e de cabeçalho de `/aplicativo`.
6
- */
7
- export interface ParametrosDeBuscarPaginadorAplicativo {
8
- pagina?: number;
9
- tamanho?: number;
10
- }
11
- /**
12
- * Parâmetros de consulta e de cabeçalho de `/aplicativo/autocomplete`.
13
- */
14
- export interface ParametrosDeBuscarAutoCompleteAplicativo {
15
- busca?: string;
16
- pagina?: number;
17
- tamanho?: number;
18
- }
19
- /**
20
- * Parâmetros de consulta e de cabeçalho de `/aplicativo/filtro`.
21
- */
22
- export interface ParametrosDeBuscarPeloFiltroAplicativo {
23
- nome?: string;
24
- slug?: string;
25
- ativo?: boolean;
26
- }
27
4
  /**
28
5
  * Parâmetros de consulta e de cabeçalho de `/arquivo`.
29
6
  */
@@ -48,87 +25,6 @@ export interface ParametrosDeEnviarConteudoArquivo {
48
25
  expira: number;
49
26
  assinatura: string;
50
27
  }
51
- /**
52
- * Parâmetros de consulta e de cabeçalho de `/auth`.
53
- */
54
- export interface ParametrosDeBuscarPaginadorAuth {
55
- pagina?: number;
56
- tamanho?: number;
57
- }
58
- /**
59
- * Parâmetros de consulta e de cabeçalho de `/auth/autocomplete`.
60
- */
61
- export interface ParametrosDeBuscarAutoCompleteAuth {
62
- busca?: string;
63
- perfil?: string;
64
- pagina?: number;
65
- tamanho?: number;
66
- }
67
- /**
68
- * Parâmetros de consulta e de cabeçalho de `/auth/filtro`.
69
- */
70
- export interface ParametrosDeBuscarPeloFiltroAuth {
71
- email?: string;
72
- perfil?: string;
73
- ativo?: boolean;
74
- }
75
- /**
76
- * Parâmetros de consulta e de cabeçalho de `/colaborador`.
77
- */
78
- export interface ParametrosDeBuscarPaginadorColaborador {
79
- pagina?: number;
80
- tamanho?: number;
81
- nome?: string;
82
- cargo?: string;
83
- ativo?: boolean;
84
- }
85
- /**
86
- * Parâmetros de consulta e de cabeçalho de `/colaborador/autocomplete`.
87
- */
88
- export interface ParametrosDeBuscarAutoCompleteColaborador {
89
- busca?: string;
90
- pagina?: number;
91
- tamanho?: number;
92
- }
93
- /**
94
- * Parâmetros de consulta e de cabeçalho de `/colaborador/filtro`.
95
- */
96
- export interface ParametrosDeBuscarPeloFiltroColaborador {
97
- busca?: string;
98
- nome?: string;
99
- email?: string;
100
- cargo?: string;
101
- ativo?: boolean;
102
- perfil_acesso_id?: string;
103
- }
104
- /**
105
- * Parâmetros de consulta e de cabeçalho de `/log`.
106
- */
107
- export interface ParametrosDeBuscarPaginadorLog {
108
- pagina?: number;
109
- tamanho?: number;
110
- }
111
- /**
112
- * Parâmetros de consulta e de cabeçalho de `/perfil_acesso`.
113
- */
114
- export interface ParametrosDeBuscarPaginadorPerfilAcesso {
115
- pagina?: number;
116
- tamanho?: number;
117
- }
118
- /**
119
- * Parâmetros de consulta e de cabeçalho de `/perfil_acesso/autocomplete`.
120
- */
121
- export interface ParametrosDeBuscarAutoCompletePerfilAcesso {
122
- busca?: string;
123
- pagina?: number;
124
- tamanho?: number;
125
- }
126
- /**
127
- * Parâmetros de consulta e de cabeçalho de `/perfil_acesso/filtro`.
128
- */
129
- export interface ParametrosDeBuscarPeloFiltroPerfilAcesso {
130
- nome?: string;
131
- }
132
28
  /**
133
29
  * Parâmetros de consulta e de cabeçalho de `/private/{app}`.
134
30
  */
@@ -143,70 +39,6 @@ export interface ParametrosDePublicoBuscarPaginadorArquivo {
143
39
  pagina?: number;
144
40
  tamanho?: number;
145
41
  }
146
- /**
147
- * Versão do backend no ar
148
- *
149
- * Pública, sem token. Devolve `sucesso: true`, e a versão do backend publicada (`versao` e `versao_backend`, iguais), no formato semver.
150
- *
151
- * `GET /`
152
- */
153
- export declare function buscar_versao_test(opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.VersaoDoBackend>;
154
- /**
155
- * Lista os aplicativos com paginação
156
- *
157
- * Exige qualquer permissão da área `aplicativos`. Ordena pelo nome e traz o consumo atual de cada aplicativo (quantidade e bytes dos arquivos públicos e privados). `pagina` começa em 1 (padrão 1; valores menores viram 1). `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. `total` conta todos os aplicativos não excluídos.
158
- *
159
- * `GET /aplicativo`
160
- */
161
- export declare function buscar_paginador_aplicativo(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorAplicativo, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaAplicativo>;
162
- /**
163
- * Lista básica de aplicativos para seleção
164
- *
165
- * Exige qualquer permissão da área `aplicativos`. Devolve só id, slug e nome, em ordem alfabética de nome. `busca` procura por trecho do nome ou do slug, 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 aplicativos que casam com a busca.
166
- *
167
- * `GET /aplicativo/autocomplete`
168
- */
169
- export declare function buscar_auto_complete_aplicativo(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteAplicativo, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaAplicativoAutoComplete>;
170
- /**
171
- * Busca aplicativos por filtro
172
- *
173
- * Exige qualquer permissão da área `aplicativos`. Devolve todos os aplicativos não excluídos que casam com o filtro, sem paginação, em ordem alfabética de nome, cada um com o consumo atual. `nome` e `slug` procuram por trecho, sem diferenciar maiúsculas; `ativo` filtra pela situação. Sem filtro, devolve todos.
174
- *
175
- * `GET /aplicativo/filtro`
176
- */
177
- export declare function buscar_pelo_filtro_aplicativo(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroAplicativo, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Aplicativo>>;
178
- /**
179
- * Busca um aplicativo pelo id
180
- *
181
- * Exige qualquer permissão da área `aplicativos`. O aplicativo é cada sistema da Termotubos que guarda arquivos no TermoBucket: `slug` é o identificador do app no TermoAuth e o prefixo dos arquivos dele, `tamanho_maximo` é o limite em bytes por arquivo e `tipos_permitidos` são os tipos MIME aceitos (`image/*` aceita qualquer imagem). Traz o consumo atual: quantidade e bytes dos arquivos públicos e privados não excluídos. Aplicativo excluído responde `404`.
182
- *
183
- * `GET /aplicativo/{id}`
184
- */
185
- export declare function buscar_pelo_id_aplicativo(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Aplicativo>;
186
- /**
187
- * Atualiza um aplicativo pelo id
188
- *
189
- * Exige a permissão `editar` da área `aplicativos`. Atualização parcial: só os campos enviados mudam e campo desconhecido é recusado. `nome` não pode ficar vazio (até 120 caracteres). `tamanho_maximo` é o limite em bytes por arquivo, maior que zero e de no máximo 99.614.720 (95 MiB, limite de envio pelo Cloudflare Workers). `tipos_permitidos` substitui a lista inteira: de 1 a 50 tipos MIME no formato `tipo/subtipo`, aceitando `tipo/*` (ex.: `image/*`); os valores são gravados em minúsculas, sem repetição. `ativo = false` faz a API de arquivos recusar o aplicativo com `403`. O `slug` não muda. Vale em até 5 minutos para a API de arquivos (cache do aplicativo).
190
- *
191
- * `PATCH /aplicativo/{id}`
192
- */
193
- 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>;
194
- /**
195
- * Exclui um aplicativo pelo id
196
- *
197
- * Exige a permissão `deletar` da área `aplicativos`. A exclusão é lógica e só é aceita quando o aplicativo não tem arquivos: com arquivos responde `409`, e é preciso apagá-los antes (`DELETE /aplicativo/{id}/arquivos`). Se o aplicativo voltar a chamar a API de arquivos, ele é cadastrado de novo com os limites padrão.
198
- *
199
- * `DELETE /aplicativo/{id}`
200
- */
201
- export declare function deletar_pelo_id_aplicativo(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
202
- /**
203
- * Apaga todos os arquivos de um aplicativo
204
- *
205
- * Só para master do TermoAuth (além da permissão `deletar` da área `aplicativos`). Apaga no R2 todos os objetos do prefixo do aplicativo nos buckets público e privado e marca os registros dos arquivos como excluídos. Se o R2 falhar, nada é marcado como excluído e a chamada pode ser repetida. Devolve quantos objetos saíram do R2 e quantos registros foram marcados.
206
- *
207
- * `DELETE /aplicativo/{id}/arquivos`
208
- */
209
- export declare function deletar_arquivos_aplicativo(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.ArquivosApagados>;
210
42
  /**
211
43
  * Lista os arquivos de todos os aplicativos com paginação
212
44
  *
@@ -247,174 +79,6 @@ export declare function baixar_conteudo_arquivo(id: string, parametros?: Paramet
247
79
  * `PUT /arquivo/{id}/conteudo`
248
80
  */
249
81
  export declare function enviar_conteudo_arquivo(id: string, parametros: ParametrosDeEnviarConteudoArquivo, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
250
- /**
251
- * Lista acessos com paginação
252
- *
253
- * Exige qualquer permissão da área `colaboradores`. Ordena por perfil e depois por e-mail. `pagina` começa em 1 (padrão 1); `tamanho` tem padrão 10, sem máximo. Acessos excluídos não aparecem nem entram no `total`.
254
- *
255
- * `GET /auth`
256
- */
257
- export declare function buscar_paginador_auth(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorAuth, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaAuth>;
258
- /**
259
- * Cria um acesso
260
- *
261
- * Exige a permissão `criar` da área `colaboradores`. Cadastra quem pode entrar no TermoBucket: o e-mail é gravado em minúsculas, sem espaços nas pontas, com até 160 caracteres. O único perfil aceito é `colaborador`. O acesso nasce ativo e sem perfil de acesso. Para a pessoa conseguir entrar, o e-mail precisa ser `@termotubos.com.br` e existir no TermoAuth. O colaborador não se cadastra aqui: vem só do TermoAuth, pela sincronização.
262
- *
263
- * `POST /auth`
264
- */
265
- export declare function criar_auth(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.AuthCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Auth>;
266
- /**
267
- * Busca o acesso de quem está logado
268
- *
269
- * Livre para qualquer usuário autenticado com cadastro ativo, mesmo sem nenhuma permissão liberada. Devolve o cadastro de quem chamou, o nome do perfil de acesso do colaborador em `perfil_acesso` (`null` quando ainda não tem) e as permissões que o perfil dá por área (`aplicativos`, `colaboradores` e `configuracoes`), cada uma com `ler`, `criar`, `editar` e `deletar`. Um master do TermoAuth recebe todas as permissões e, no primeiro acesso, ganha o cadastro automaticamente. `nome` vem do TermoAuth e, se estiver vazio, repete o e-mail. É a chamada que o painel faz antes de mostrar qualquer tela.
270
- *
271
- * `GET /auth/acesso`
272
- */
273
- export declare function buscar_acesso_auth(credencial_de_acesso: CredencialDeAcesso, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.AcessoAtual>;
274
- /**
275
- * Lista básica de acessos para seleção
276
- *
277
- * Exige qualquer permissão da área `colaboradores`. 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); `tamanho` tem padrão 10, sem máximo.
278
- *
279
- * `GET /auth/autocomplete`
280
- */
281
- export declare function buscar_auto_complete_auth(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteAuth, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaAuthAutoComplete>;
282
- /**
283
- * Busca acessos por filtro
284
- *
285
- * Exige qualquer permissão da área `colaboradores`. 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; `ativo` filtra pela situação. Sem filtro, devolve todos. Acessos excluídos não aparecem.
286
- *
287
- * `GET /auth/filtro`
288
- */
289
- export declare function buscar_pelo_filtro_auth(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroAuth, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Auth>>;
290
- /**
291
- * Busca um acesso pelo id
292
- *
293
- * Exige qualquer permissão da área `colaboradores`. Acesso excluído responde `404`. `vinculado` diz se há um colaborador ligado ao acesso, e `nome` é o nome desse colaborador.
294
- *
295
- * `GET /auth/{id}`
296
- */
297
- export declare function buscar_pelo_id_auth(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Auth>;
298
- /**
299
- * Atualiza um acesso pelo id
300
- *
301
- * Exige a permissão `editar` da área `colaboradores`. Só os campos enviados mudam: `email` (gravado em minúsculas, até 160 caracteres) e `ativo` (acesso inativo é barrado em todas as rotas). O acesso de um master do TermoAuth não pode ser alterado.
302
- *
303
- * `PATCH /auth/{id}`
304
- */
305
- 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>;
306
- /**
307
- * Exclui um acesso pelo id
308
- *
309
- * 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: o colaborador pertence ao TermoAuth e só sai de lá. O acesso de um master do TermoAuth não pode ser excluído.
310
- *
311
- * `DELETE /auth/{id}`
312
- */
313
- export declare function deletar_pelo_id_auth(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
314
- /**
315
- * Lista colaboradores com paginação
316
- *
317
- * Só leitura: o colaborador é cadastrado, alterado e excluído no TermoAuth e chega aqui pela sincronização com o TermoAuth; aqui só se escolhe o perfil de acesso dele (`PATCH /colaborador/{id}/perfil_acesso`). Exige qualquer permissão da área `colaboradores`. Ordena por nome. `nome` e `cargo` filtram por trecho, sem diferenciar maiúsculas, e `ativo` pela situação. `pagina` começa em 1 (padrão 1; valores menores viram 1). `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. Colaboradores excluídos não aparecem nem entram no `total`, que conta os registros que casam com os filtros. Quando quem chama é master do TermoAuth, a lista antes traz do TermoAuth os colaboradores `@termotubos.com.br` que ainda não existem aqui, criando acesso e colaborador com o perfil de acesso `Acesso inicial` (só `ler` em todas as áreas, recriado se tiver sido excluído); quem já existe não é alterado e ninguém é excluído. Se o TermoAuth falhar, a lista sai mesmo assim, só sem a sincronização.
318
- *
319
- * `GET /colaborador`
320
- */
321
- export declare function buscar_paginador_colaborador(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorColaborador, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaColaborador>;
322
- /**
323
- * Lista básica de colaboradores para seleção
324
- *
325
- * Exige qualquer permissão da área `colaboradores`. Devolve só id, nome e e-mail, em ordem alfabética de nome, para escolher um colaborador. `busca` procura por trecho do nome ou do e-mail, sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1); `tamanho` tem padrão 10, sem máximo.
326
- *
327
- * `GET /colaborador/autocomplete`
328
- */
329
- export declare function buscar_auto_complete_colaborador(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteColaborador, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaColaboradorAutoComplete>;
330
- /**
331
- * Busca colaboradores por filtro
332
- *
333
- * Exige qualquer permissão da área `colaboradores`. 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; `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. Colaboradores excluídos não aparecem.
334
- *
335
- * `GET /colaborador/filtro`
336
- */
337
- export declare function buscar_pelo_filtro_colaborador(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroColaborador, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Colaborador>>;
338
- /**
339
- * Busca um colaborador pelo id
340
- *
341
- * Exige qualquer permissão da área `colaboradores`. Colaborador excluído responde `404`. Traz junto o e-mail do acesso, se ele é master do TermoAuth e o perfil de acesso (`perfil_acesso_id` e o nome em `perfil_acesso`).
342
- *
343
- * `GET /colaborador/{id}`
344
- */
345
- export declare function buscar_pelo_id_colaborador(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Colaborador>;
346
- /**
347
- * Define o perfil de acesso de um colaborador
348
- *
349
- * Exige a permissão `editar` da área `colaboradores`. É a única escrita do colaborador feita pelo TermoBucket: `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).
350
- *
351
- * `PATCH /colaborador/{id}/perfil_acesso`
352
- */
353
- 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>;
354
- /**
355
- * Lista o registro das requisições recebidas
356
- *
357
- * Exige qualquer permissão da área `configuracoes`. Lista as requisições que o backend recebeu, da mais nova para a mais antiga, com método, caminho, consulta, status, duração, IP, cabeçalhos e os corpos da requisição e da resposta. O cabeçalho `Authorization` e as URLs assinadas saem mascarados. `pagina` começa em 1 (padrão 1; valores menores viram 1) e `tamanho` tem padrão 20, entre 1 e 100.
358
- *
359
- * `GET /log`
360
- */
361
- export declare function buscar_paginador_log(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorLog, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaLog>;
362
- /**
363
- * Lista os perfis de acesso com paginação
364
- *
365
- * 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). `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. `total` conta todos os registros não excluídos.
366
- *
367
- * `GET /perfil_acesso`
368
- */
369
- export declare function buscar_paginador_perfil_acesso(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorPerfilAcesso, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaPerfilAcesso>;
370
- /**
371
- * Cria um perfil de acesso
372
- *
373
- * Exige a permissão `criar` da área `colaboradores`. O perfil de acesso é o conjunto de permissões que o TermoBucket 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 (`aplicativos`, `colaboradores` e `configuracoes`), 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.
374
- *
375
- * `POST /perfil_acesso`
376
- */
377
- export declare function criar_perfil_acesso(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.PerfilAcessoCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PerfilAcesso>;
378
- /**
379
- * Lista básica de perfis de acesso para seleção
380
- *
381
- * 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.
382
- *
383
- * `GET /perfil_acesso/autocomplete`
384
- */
385
- export declare function buscar_auto_complete_perfil_acesso(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompletePerfilAcesso, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaPerfilAcessoAutoComplete>;
386
- /**
387
- * Busca perfis de acesso por filtro
388
- *
389
- * 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).
390
- *
391
- * `GET /perfil_acesso/filtro`
392
- */
393
- export declare function buscar_pelo_filtro_perfil_acesso(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroPerfilAcesso, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.PerfilAcesso>>;
394
- /**
395
- * Busca um perfil de acesso pelo id
396
- *
397
- * Exige qualquer permissão da área `colaboradores` (qualquer ação liberada na área já libera a leitura). Perfil excluído responde `404`.
398
- *
399
- * `GET /perfil_acesso/{id}`
400
- */
401
- export declare function buscar_pelo_id_perfil_acesso(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PerfilAcesso>;
402
- /**
403
- * Atualiza um perfil de acesso pelo id
404
- *
405
- * 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).
406
- *
407
- * `PATCH /perfil_acesso/{id}`
408
- */
409
- 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>;
410
- /**
411
- * Exclui um perfil de acesso pelo id
412
- *
413
- * 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.
414
- *
415
- * `DELETE /perfil_acesso/{id}`
416
- */
417
- export declare function deletar_pelo_id_perfil_acesso(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
418
82
  /**
419
83
  * Lista os arquivos privados do aplicativo com paginação
420
84
  *
@@ -479,11 +143,3 @@ export declare function publico_buscar_pelo_id_arquivo(credencial_de_acesso: Cre
479
143
  * `DELETE /public/{app}/{id}`
480
144
  */
481
145
  export declare function publico_deletar_pelo_id_arquivo(credencial_de_acesso: CredencialDeAcesso, app: string, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
482
- /**
483
- * Verifica se o backend está no ar
484
- *
485
- * Pública, sem token. Responde `200` com `sucesso: true` e a versão do backend no ar (semver) sempre que o servidor está de pé; não consulta o banco nem o TermoAuth.
486
- *
487
- * `GET /test`
488
- */
489
- export declare function verificar_saude_test(opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.SaudeDoBackend>;