termo_core 0.1.12 → 0.1.14

package/dist/agenda/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Cliente tipado da API do TermoAgenda, gerado a partir do `openapi.json` do serviço.
+ */
+export * from "./tipos.js";
+export * from "./rotas.js";
+export { CredencialDeAcesso, ErroAoChamarServico } from "../base/index.js";

package/dist/agenda/index.js

@@ -0,0 +1,7 @@
+// Gerado pelo gerador do TermoCore (`cargo run -p gerador`). Não edite à mão: a próxima geração sobrescreve.
+/**
+ * Cliente tipado da API do TermoAgenda, gerado a partir do `openapi.json` do serviço.
+ */
+export * from "./tipos.js";
+export * from "./rotas.js";
+export { CredencialDeAcesso, ErroAoChamarServico } from "../base/index.js";

package/dist/agenda/rotas.d.ts

@@ -0,0 +1,281 @@
+import type * as tipos from "./tipos.js";
+import type { CredencialDeAcesso } from "../base/credencial.js";
+import { type OpcoesDaChamada } from "../base/requisicao.js";
+/**
+ * Parâmetros de consulta e de cabeçalho de `/agenda`.
+ */
+export interface ParametrosDeBuscarPaginadorAgenda {
+    pagina?: number;
+}
+/**
+ * Parâmetros de consulta e de cabeçalho de `/agenda/autocomplete`.
+ */
+export interface ParametrosDeBuscarAutoCompleteAgenda {
+    busca?: string;
+    pagina?: number;
+    tamanho?: number;
+}
+/**
+ * Parâmetros de consulta e de cabeçalho de `/agenda/filtro`.
+ */
+export interface ParametrosDeBuscarPeloFiltroAgenda {
+    nome?: string;
+}
+/**
+ * Parâmetros de consulta e de cabeçalho de `/disponibilidade`.
+ */
+export interface ParametrosDeBuscarDisponibilidadeEvento {
+    /**
+     * Ids separados por vírgula.
+     */
+    colaborador_ids?: string;
+    /**
+     * Ids separados por vírgula.
+     */
+    sala_ids?: string;
+    inicio: string;
+    fim: string;
+    /**
+     * O evento que está sendo editado não conta como ocupado.
+     */
+    ignorar_evento_id?: string;
+}
+/**
+ * Parâmetros de consulta e de cabeçalho de `/evento`.
+ */
+export interface ParametrosDeBuscarPeloFiltroEvento {
+    inicio: string;
+    fim: string;
+}
+/**
+ * Parâmetros de consulta e de cabeçalho de `/evento/autocomplete`.
+ */
+export interface ParametrosDeBuscarAutoCompleteEvento {
+    busca?: string;
+    pagina?: number;
+    tamanho?: number;
+}
+/**
+ * Parâmetros de consulta e de cabeçalho de `/evento/busca`.
+ */
+export interface ParametrosDeBuscarPaginadorEvento {
+    pagina?: number;
+    /**
+     * Trecho do título, do local ou da descrição.
+     */
+    texto?: string;
+}
+/**
+ * Parâmetros de consulta e de cabeçalho de `/evento/{id}`.
+ */
+export interface ParametrosDeDeletarPeloIdEvento {
+    /**
+     * Na repetição: `este`, `seguintes` ou `todos` (padrão).
+     */
+    escopo?: string;
+    ocorrencia?: string;
+}
+/**
+ * Parâmetros de consulta e de cabeçalho de `/sala`.
+ */
+export interface ParametrosDeBuscarPaginadorSala {
+    pagina?: number;
+    nome?: string;
+}
+/**
+ * Parâmetros de consulta e de cabeçalho de `/sala/autocomplete`.
+ */
+export interface ParametrosDeBuscarAutoCompleteSala {
+    busca?: string;
+    pagina?: number;
+    tamanho?: number;
+}
+/**
+ * Parâmetros de consulta e de cabeçalho de `/sala/filtro`.
+ */
+export interface ParametrosDeBuscarPeloFiltroSala {
+    nome?: string;
+    ativa?: boolean;
+}
+/**
+ * Lista as agendas paginadas
+ *
+ * As agendas de quem pediu, sempre 50 por página; `pagina` começa em 1.
+ *
+ * `GET /agenda`
+ */
+export declare function buscar_paginador_agenda(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorAgenda, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaAgenda>;
+/**
+ * Cria uma agenda extra
+ *
+ * Livre para todo colaborador logado. A agenda é privada: só o dono vê. Cada pessoa já tem a "Minha agenda", criada sozinha no primeiro acesso; esta rota cria outras (ex.: "Visitas"). `nome` é obrigatório (até 80 caracteres) e `cor` segue o formato `#1a73e8` (padrão).
+ *
+ * `POST /agenda`
+ */
+export declare function criar_agenda(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.AgendaCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Agenda>;
+/**
+ * Lista básica das agendas
+ *
+ * Id, nome e cor das agendas de quem pediu. `busca` procura o trecho no nome; `pagina` começa em 1 e `tamanho` tem padrão 10.
+ *
+ * `GET /agenda/autocomplete`
+ */
+export declare function buscar_auto_complete_agenda(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteAgenda, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaAgendaAutoComplete>;
+/**
+ * Lista as agendas de quem pediu
+ *
+ * Garante a "Minha agenda" e devolve as agendas da pessoa (a padrão primeiro, depois em ordem alfabética). `nome` procura o trecho no nome.
+ *
+ * `GET /agenda/filtro`
+ */
+export declare function buscar_pelo_filtro_agenda(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroAgenda, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Agenda>>;
+/**
+ * Busca uma agenda pelo id
+ *
+ * Só a agenda de quem pediu; a de outra pessoa responde `404`.
+ *
+ * `GET /agenda/{id}`
+ */
+export declare function buscar_pelo_id_agenda(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Agenda>;
+/**
+ * Renomeia ou troca a cor de uma agenda
+ *
+ * `PATCH /agenda/{id}`
+ */
+export declare function atualizar_pelo_id_agenda(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.AgendaAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Agenda>;
+/**
+ * Exclui uma agenda e os eventos dela
+ *
+ * Os eventos da agenda saem antes dela. A "Minha agenda" não pode ser excluída (`409`).
+ *
+ * `DELETE /agenda/{id}`
+ */
+export declare function deletar_pelo_id_agenda(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
+/**
+ * Horários ocupados de pessoas e salas
+ *
+ * Para escolher o horário de uma reunião: os blocos ocupados (só `inicio` e `fim`, sem título nem detalhe) de cada colaborador em `colaborador_ids` e de cada sala em `sala_ids` (ids separados por vírgula, até 100 no total) entre `inicio` e `fim` (até 62 dias). Conta como ocupado o evento em que a pessoa organiza ou foi convidada sem recusar; dia inteiro não conta. `ignorar_evento_id` tira o evento que está sendo editado.
+ *
+ * `GET /disponibilidade`
+ */
+export declare function buscar_disponibilidade_evento(credencial_de_acesso: CredencialDeAcesso, parametros: ParametrosDeBuscarDisponibilidadeEvento, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Disponibilidade>;
+/**
+ * Eventos de um intervalo (a grade)
+ *
+ * As ocorrências entre `inicio` e `fim` (até 62 dias) de quem pediu: os eventos que organizou e aqueles para que foi convidado. A repetição já vem expandida: cada ocorrência traz `ocorrencia` (o início original, que o `PATCH` e o `DELETE` recebem) e `serie_inicio`.
+ *
+ * `GET /evento`
+ */
+export declare function buscar_pelo_filtro_evento(credencial_de_acesso: CredencialDeAcesso, parametros: ParametrosDeBuscarPeloFiltroEvento, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Evento>>;
+/**
+ * Marca um evento
+ *
+ * Livre para todo colaborador logado; quem marca é o organizador. Sem `agenda_id`, vai para a "Minha agenda". `inicio` e `fim` em ISO 8601 (o fim depois do início, até 31 dias); `titulo` vazio vira "(Sem título)"; `dia_inteiro` usa meia-noite de Brasília no início e no fim (exclusivo). `convidado_ids` (até 100 colaboradores) e `sala_ids` (até 5 salas ativas). `recorrencia`: `frequencia` `DIARIA`, `SEMANAL`, `MENSAL` ou `ANUAL`, `intervalo` 1 a 99, `dias_semana` (0 = domingo, na semanal), e `ate` (AAAA-MM-DD) ou `vezes` (1 a 730). `lembretes` em minutos antes (padrão `[10]`). **Conflito:** se um convidado (que não recusou) ou uma sala já tem reunião no horário, responde `409` com `conflitos` (quem, ou qual sala, e quando), conferindo cada ocorrência da repetição nos próximos 12 meses; evento de dia inteiro não ocupa e a agenda do próprio organizador não bloqueia.
+ *
+ * `POST /evento`
+ */
+export declare function criar_evento(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.EventoCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Evento>;
+/**
+ * Lista básica de eventos
+ *
+ * Id, título e início dos eventos de quem pediu, do mais novo para o mais antigo. `busca` procura o trecho no título; `tamanho` tem padrão 10 (até 50).
+ *
+ * `GET /evento/autocomplete`
+ */
+export declare function buscar_auto_complete_evento(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteEvento, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaEventoAutoComplete>;
+/**
+ * Busca eventos pelo texto
+ *
+ * Eventos de quem pediu com o trecho de `texto` no título, no local ou na descrição, do mais novo para o mais antigo, sempre 50 por página.
+ *
+ * `GET /evento/busca`
+ */
+export declare function buscar_paginador_evento(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorEvento, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaEvento>;
+/**
+ * Busca um evento pelo id
+ *
+ * Só o organizador e os convidados veem o evento; para os demais, `404`.
+ *
+ * `GET /evento/{id}`
+ */
+export declare function buscar_pelo_id_evento(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Evento>;
+/**
+ * Altera um evento
+ *
+ * Só o organizador (`403` para o convidado). Só os campos enviados mudam; `local`, `descricao`, `cor`, `link_reuniao` e `recorrencia` com `null` apagam o valor. Na repetição, `escopo` diz o alcance: `todos` (padrão; mudar o horário desloca a série inteira pela diferença em relação à `ocorrencia`), `este` (só a `ocorrencia`, que vira um evento à parte) ou `seguintes` (da `ocorrencia` em diante, que vira uma série nova). Quem continua convidado guarda a resposta. Confere o conflito como no `POST` (`409`).
+ *
+ * `PATCH /evento/{id}`
+ */
+export declare function atualizar_pelo_id_evento(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.EventoAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Evento>;
+/**
+ * Exclui um evento
+ *
+ * Só o organizador. Na repetição, `escopo` `este` (só a `ocorrencia`), `seguintes` (dela em diante) ou `todos` (padrão).
+ *
+ * `DELETE /evento/{id}`
+ */
+export declare function deletar_pelo_id_evento(credencial_de_acesso: CredencialDeAcesso, id: string, parametros?: ParametrosDeDeletarPeloIdEvento, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
+/**
+ * Responde ao convite
+ *
+ * Só o convidado: `SIM`, `NAO` ou `TALVEZ`. Quem recusa deixa de ficar ocupado no horário.
+ *
+ * `POST /evento/{id}/resposta`
+ */
+export declare function responder_evento(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.EventoResponder, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Evento>;
+/**
+ * Lista as salas paginadas
+ *
+ * Precisa de `ler` na área `salas`. Sempre 50 por página, em ordem alfabética; `pagina` começa em 1 e `nome` procura o trecho no nome.
+ *
+ * `GET /sala`
+ */
+export declare function buscar_paginador_sala(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorSala, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaSala>;
+/**
+ * Cadastra uma sala de reunião
+ *
+ * Precisa de `criar` na área `salas` do perfil de acesso. `nome` é obrigatório e único sem diferenciar maiúsculas (até 80 caracteres); `local` vai até 120; `capacidade` de 1 a 1000 pessoas; `recursos` (TV, videoconferência…) até 20 itens de 40 caracteres; `cor` no formato `#0d9488` (padrão); `ativa` tem padrão `true`. Sala inativa não entra em evento novo.
+ *
+ * `POST /sala`
+ */
+export declare function criar_sala(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.SalaCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Sala>;
+/**
+ * Lista básica das salas ativas
+ *
+ * Livre para todo colaborador logado (é a escolha de sala do evento). Id, nome, local, capacidade e cor das salas ativas, em ordem alfabética. `busca` procura o trecho no nome; `pagina` começa em 1 e `tamanho` tem padrão 10 (até 200).
+ *
+ * `GET /sala/autocomplete`
+ */
+export declare function buscar_auto_complete_sala(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteSala, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaSalaAutoComplete>;
+/**
+ * Busca salas por filtro
+ *
+ * Precisa de `ler` na área `salas`. Todas as salas em ordem alfabética; `nome` procura o trecho no nome e `ativa` filtra ativas ou inativas.
+ *
+ * `GET /sala/filtro`
+ */
+export declare function buscar_pelo_filtro_sala(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroSala, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Sala>>;
+/**
+ * Busca uma sala pelo id
+ *
+ * Precisa de `ler` na área `salas`.
+ *
+ * `GET /sala/{id}`
+ */
+export declare function buscar_pelo_id_sala(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Sala>;
+/**
+ * Altera uma sala
+ *
+ * Precisa de `editar` na área `salas`. Só os campos enviados mudam; `local` e `capacidade` com `null` apagam o valor. Desativar a sala não mexe nos eventos já marcados.
+ *
+ * `PATCH /sala/{id}`
+ */
+export declare function atualizar_pelo_id_sala(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.SalaAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Sala>;
+/**
+ * Exclui uma sala
+ *
+ * Precisa de `deletar` na área `salas`. Exclusão lógica: a sala some da escolha, mas os eventos antigos continuam mostrando o nome dela.
+ *
+ * `DELETE /sala/{id}`
+ */
+export declare function deletar_pelo_id_sala(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;

package/dist/agenda/rotas.js

@@ -0,0 +1,387 @@
+// Gerado pelo gerador do TermoCore (`cargo run -p gerador`). Não edite à mão: a próxima geração sobrescreve.
+import { chamar_servico, codificar_parametro_de_caminho } from "../base/requisicao.js";
+import { TERMO_AGENDA as SERVICO_DESTA_API } from "../base/servicos.js";
+/**
+ * Lista as agendas paginadas
+ *
+ * As agendas de quem pediu, sempre 50 por página; `pagina` começa em 1.
+ *
+ * `GET /agenda`
+ */
+export function buscar_paginador_agenda(credencial_de_acesso, parametros = {}, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: "/agenda",
+        credencial_de_acesso,
+        parametros_de_consulta: parametros,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Cria uma agenda extra
+ *
+ * Livre para todo colaborador logado. A agenda é privada: só o dono vê. Cada pessoa já tem a "Minha agenda", criada sozinha no primeiro acesso; esta rota cria outras (ex.: "Visitas"). `nome` é obrigatório (até 80 caracteres) e `cor` segue o formato `#1a73e8` (padrão).
+ *
+ * `POST /agenda`
+ */
+export function criar_agenda(credencial_de_acesso, corpo_da_requisicao, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "POST",
+        caminho_da_rota: "/agenda",
+        credencial_de_acesso,
+        corpo_json: corpo_da_requisicao,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Lista básica das agendas
+ *
+ * Id, nome e cor das agendas de quem pediu. `busca` procura o trecho no nome; `pagina` começa em 1 e `tamanho` tem padrão 10.
+ *
+ * `GET /agenda/autocomplete`
+ */
+export function buscar_auto_complete_agenda(credencial_de_acesso, parametros = {}, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: "/agenda/autocomplete",
+        credencial_de_acesso,
+        parametros_de_consulta: parametros,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Lista as agendas de quem pediu
+ *
+ * Garante a "Minha agenda" e devolve as agendas da pessoa (a padrão primeiro, depois em ordem alfabética). `nome` procura o trecho no nome.
+ *
+ * `GET /agenda/filtro`
+ */
+export function buscar_pelo_filtro_agenda(credencial_de_acesso, parametros = {}, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: "/agenda/filtro",
+        credencial_de_acesso,
+        parametros_de_consulta: parametros,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Busca uma agenda pelo id
+ *
+ * Só a agenda de quem pediu; a de outra pessoa responde `404`.
+ *
+ * `GET /agenda/{id}`
+ */
+export function buscar_pelo_id_agenda(credencial_de_acesso, id, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: `/agenda/${codificar_parametro_de_caminho(id)}`,
+        credencial_de_acesso,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Renomeia ou troca a cor de uma agenda
+ *
+ * `PATCH /agenda/{id}`
+ */
+export function atualizar_pelo_id_agenda(credencial_de_acesso, id, corpo_da_requisicao, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "PATCH",
+        caminho_da_rota: `/agenda/${codificar_parametro_de_caminho(id)}`,
+        credencial_de_acesso,
+        corpo_json: corpo_da_requisicao,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Exclui uma agenda e os eventos dela
+ *
+ * Os eventos da agenda saem antes dela. A "Minha agenda" não pode ser excluída (`409`).
+ *
+ * `DELETE /agenda/{id}`
+ */
+export function deletar_pelo_id_agenda(credencial_de_acesso, id, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "DELETE",
+        caminho_da_rota: `/agenda/${codificar_parametro_de_caminho(id)}`,
+        credencial_de_acesso,
+        formato_da_resposta: "sem_conteudo",
+    }, opcoes_da_chamada);
+}
+/**
+ * Horários ocupados de pessoas e salas
+ *
+ * Para escolher o horário de uma reunião: os blocos ocupados (só `inicio` e `fim`, sem título nem detalhe) de cada colaborador em `colaborador_ids` e de cada sala em `sala_ids` (ids separados por vírgula, até 100 no total) entre `inicio` e `fim` (até 62 dias). Conta como ocupado o evento em que a pessoa organiza ou foi convidada sem recusar; dia inteiro não conta. `ignorar_evento_id` tira o evento que está sendo editado.
+ *
+ * `GET /disponibilidade`
+ */
+export function buscar_disponibilidade_evento(credencial_de_acesso, parametros, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: "/disponibilidade",
+        credencial_de_acesso,
+        parametros_de_consulta: parametros,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Eventos de um intervalo (a grade)
+ *
+ * As ocorrências entre `inicio` e `fim` (até 62 dias) de quem pediu: os eventos que organizou e aqueles para que foi convidado. A repetição já vem expandida: cada ocorrência traz `ocorrencia` (o início original, que o `PATCH` e o `DELETE` recebem) e `serie_inicio`.
+ *
+ * `GET /evento`
+ */
+export function buscar_pelo_filtro_evento(credencial_de_acesso, parametros, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: "/evento",
+        credencial_de_acesso,
+        parametros_de_consulta: parametros,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Marca um evento
+ *
+ * Livre para todo colaborador logado; quem marca é o organizador. Sem `agenda_id`, vai para a "Minha agenda". `inicio` e `fim` em ISO 8601 (o fim depois do início, até 31 dias); `titulo` vazio vira "(Sem título)"; `dia_inteiro` usa meia-noite de Brasília no início e no fim (exclusivo). `convidado_ids` (até 100 colaboradores) e `sala_ids` (até 5 salas ativas). `recorrencia`: `frequencia` `DIARIA`, `SEMANAL`, `MENSAL` ou `ANUAL`, `intervalo` 1 a 99, `dias_semana` (0 = domingo, na semanal), e `ate` (AAAA-MM-DD) ou `vezes` (1 a 730). `lembretes` em minutos antes (padrão `[10]`). **Conflito:** se um convidado (que não recusou) ou uma sala já tem reunião no horário, responde `409` com `conflitos` (quem, ou qual sala, e quando), conferindo cada ocorrência da repetição nos próximos 12 meses; evento de dia inteiro não ocupa e a agenda do próprio organizador não bloqueia.
+ *
+ * `POST /evento`
+ */
+export function criar_evento(credencial_de_acesso, corpo_da_requisicao, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "POST",
+        caminho_da_rota: "/evento",
+        credencial_de_acesso,
+        corpo_json: corpo_da_requisicao,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Lista básica de eventos
+ *
+ * Id, título e início dos eventos de quem pediu, do mais novo para o mais antigo. `busca` procura o trecho no título; `tamanho` tem padrão 10 (até 50).
+ *
+ * `GET /evento/autocomplete`
+ */
+export function buscar_auto_complete_evento(credencial_de_acesso, parametros = {}, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: "/evento/autocomplete",
+        credencial_de_acesso,
+        parametros_de_consulta: parametros,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Busca eventos pelo texto
+ *
+ * Eventos de quem pediu com o trecho de `texto` no título, no local ou na descrição, do mais novo para o mais antigo, sempre 50 por página.
+ *
+ * `GET /evento/busca`
+ */
+export function buscar_paginador_evento(credencial_de_acesso, parametros = {}, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: "/evento/busca",
+        credencial_de_acesso,
+        parametros_de_consulta: parametros,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Busca um evento pelo id
+ *
+ * Só o organizador e os convidados veem o evento; para os demais, `404`.
+ *
+ * `GET /evento/{id}`
+ */
+export function buscar_pelo_id_evento(credencial_de_acesso, id, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: `/evento/${codificar_parametro_de_caminho(id)}`,
+        credencial_de_acesso,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Altera um evento
+ *
+ * Só o organizador (`403` para o convidado). Só os campos enviados mudam; `local`, `descricao`, `cor`, `link_reuniao` e `recorrencia` com `null` apagam o valor. Na repetição, `escopo` diz o alcance: `todos` (padrão; mudar o horário desloca a série inteira pela diferença em relação à `ocorrencia`), `este` (só a `ocorrencia`, que vira um evento à parte) ou `seguintes` (da `ocorrencia` em diante, que vira uma série nova). Quem continua convidado guarda a resposta. Confere o conflito como no `POST` (`409`).
+ *
+ * `PATCH /evento/{id}`
+ */
+export function atualizar_pelo_id_evento(credencial_de_acesso, id, corpo_da_requisicao, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "PATCH",
+        caminho_da_rota: `/evento/${codificar_parametro_de_caminho(id)}`,
+        credencial_de_acesso,
+        corpo_json: corpo_da_requisicao,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Exclui um evento
+ *
+ * Só o organizador. Na repetição, `escopo` `este` (só a `ocorrencia`), `seguintes` (dela em diante) ou `todos` (padrão).
+ *
+ * `DELETE /evento/{id}`
+ */
+export function deletar_pelo_id_evento(credencial_de_acesso, id, parametros = {}, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "DELETE",
+        caminho_da_rota: `/evento/${codificar_parametro_de_caminho(id)}`,
+        credencial_de_acesso,
+        parametros_de_consulta: parametros,
+        formato_da_resposta: "sem_conteudo",
+    }, opcoes_da_chamada);
+}
+/**
+ * Responde ao convite
+ *
+ * Só o convidado: `SIM`, `NAO` ou `TALVEZ`. Quem recusa deixa de ficar ocupado no horário.
+ *
+ * `POST /evento/{id}/resposta`
+ */
+export function responder_evento(credencial_de_acesso, id, corpo_da_requisicao, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "POST",
+        caminho_da_rota: `/evento/${codificar_parametro_de_caminho(id)}/resposta`,
+        credencial_de_acesso,
+        corpo_json: corpo_da_requisicao,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Lista as salas paginadas
+ *
+ * Precisa de `ler` na área `salas`. Sempre 50 por página, em ordem alfabética; `pagina` começa em 1 e `nome` procura o trecho no nome.
+ *
+ * `GET /sala`
+ */
+export function buscar_paginador_sala(credencial_de_acesso, parametros = {}, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: "/sala",
+        credencial_de_acesso,
+        parametros_de_consulta: parametros,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Cadastra uma sala de reunião
+ *
+ * Precisa de `criar` na área `salas` do perfil de acesso. `nome` é obrigatório e único sem diferenciar maiúsculas (até 80 caracteres); `local` vai até 120; `capacidade` de 1 a 1000 pessoas; `recursos` (TV, videoconferência…) até 20 itens de 40 caracteres; `cor` no formato `#0d9488` (padrão); `ativa` tem padrão `true`. Sala inativa não entra em evento novo.
+ *
+ * `POST /sala`
+ */
+export function criar_sala(credencial_de_acesso, corpo_da_requisicao, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "POST",
+        caminho_da_rota: "/sala",
+        credencial_de_acesso,
+        corpo_json: corpo_da_requisicao,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Lista básica das salas ativas
+ *
+ * Livre para todo colaborador logado (é a escolha de sala do evento). Id, nome, local, capacidade e cor das salas ativas, em ordem alfabética. `busca` procura o trecho no nome; `pagina` começa em 1 e `tamanho` tem padrão 10 (até 200).
+ *
+ * `GET /sala/autocomplete`
+ */
+export function buscar_auto_complete_sala(credencial_de_acesso, parametros = {}, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: "/sala/autocomplete",
+        credencial_de_acesso,
+        parametros_de_consulta: parametros,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Busca salas por filtro
+ *
+ * Precisa de `ler` na área `salas`. Todas as salas em ordem alfabética; `nome` procura o trecho no nome e `ativa` filtra ativas ou inativas.
+ *
+ * `GET /sala/filtro`
+ */
+export function buscar_pelo_filtro_sala(credencial_de_acesso, parametros = {}, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: "/sala/filtro",
+        credencial_de_acesso,
+        parametros_de_consulta: parametros,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Busca uma sala pelo id
+ *
+ * Precisa de `ler` na área `salas`.
+ *
+ * `GET /sala/{id}`
+ */
+export function buscar_pelo_id_sala(credencial_de_acesso, id, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: `/sala/${codificar_parametro_de_caminho(id)}`,
+        credencial_de_acesso,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Altera uma sala
+ *
+ * Precisa de `editar` na área `salas`. Só os campos enviados mudam; `local` e `capacidade` com `null` apagam o valor. Desativar a sala não mexe nos eventos já marcados.
+ *
+ * `PATCH /sala/{id}`
+ */
+export function atualizar_pelo_id_sala(credencial_de_acesso, id, corpo_da_requisicao, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "PATCH",
+        caminho_da_rota: `/sala/${codificar_parametro_de_caminho(id)}`,
+        credencial_de_acesso,
+        corpo_json: corpo_da_requisicao,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Exclui uma sala
+ *
+ * Precisa de `deletar` na área `salas`. Exclusão lógica: a sala some da escolha, mas os eventos antigos continuam mostrando o nome dela.
+ *
+ * `DELETE /sala/{id}`
+ */
+export function deletar_pelo_id_sala(credencial_de_acesso, id, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "DELETE",
+        caminho_da_rota: `/sala/${codificar_parametro_de_caminho(id)}`,
+        credencial_de_acesso,
+        formato_da_resposta: "sem_conteudo",
+    }, opcoes_da_chamada);
+}