termo_core 0.1.14 → 0.1.15

package/dist/agenda/rotas.d.ts

@@ -170,7 +170,7 @@ export declare function buscar_pelo_filtro_evento(credencial_de_acesso: Credenci
 /**
  * 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.
+ * 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]`). **Videochamada:** `com_videochamada: true` cria a reunião no TermoMeet (com o token de quem marca) com o título e o horário do evento e grava o link dela em `link_reuniao`; se o TermoMeet falhar, responde `502` e nada é gravado. **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`
  */
@@ -202,7 +202,7 @@ export declare function buscar_pelo_id_evento(credencial_de_acesso: CredencialDe
 /**
  * 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`).
+ * 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`). `com_videochamada: true` cria a videochamada no TermoMeet para o evento que ainda não tem link (`502` se o TermoMeet falhar); com `escopo` `todos`, mudar o título ou o horário de um evento com videochamada do TermoMeet atualiza a reunião, e excluir a série inteira a exclui.
  *
  * `PATCH /evento/{id}`
  */

package/dist/agenda/rotas.js

@@ -153,7 +153,7 @@ export function buscar_pelo_filtro_evento(credencial_de_acesso, parametros, opco
 /**
  * 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.
+ * 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]`). **Videochamada:** `com_videochamada: true` cria a reunião no TermoMeet (com o token de quem marca) com o título e o horário do evento e grava o link dela em `link_reuniao`; se o TermoMeet falhar, responde `502` e nada é gravado. **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`
  */
@@ -220,7 +220,7 @@ export function buscar_pelo_id_evento(credencial_de_acesso, id, opcoes_da_chamad
 /**
  * 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`).
+ * 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`). `com_videochamada: true` cria a videochamada no TermoMeet para o evento que ainda não tem link (`502` se o TermoMeet falhar); com `escopo` `todos`, mudar o título ou o horário de um evento com videochamada do TermoMeet atualiza a reunião, e excluir a série inteira a exclui.
  *
  * `PATCH /evento/{id}`
  */

package/dist/agenda/tipos.d.ts

@@ -85,6 +85,10 @@ export interface Evento {
 }
 export interface EventoAtualizar {
     agenda_id?: string | null;
+    /**
+     * `true` cria a videochamada no TermoMeet para um evento que ainda não tem link.
+     */
+    com_videochamada?: boolean | null;
     convidado_ids?: Array<string> | null;
     cor?: string | null;
     descricao?: string | null;
@@ -117,6 +121,11 @@ export interface EventoCriar {
      * Sem ela, o evento vai para a "Minha agenda".
      */
     agenda_id?: string | null;
+    /**
+     * `true` cria a videochamada no TermoMeet com o título e o horário do evento e põe o link
+     * dela em `link_reuniao`.
+     */
+    com_videochamada?: boolean | null;
     convidado_ids?: Array<string> | null;
     cor?: string | null;
     descricao?: string | null;

package/dist/talk/rotas.d.ts

@@ -89,6 +89,14 @@ export declare function explorar_conversa(credencial_de_acesso: CredencialDeAces
  * `GET /conversa/pessoas`
  */
 export declare function buscar_pessoas_conversa(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPessoasConversa, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.ColaboradorPessoa>>;
+/**
+ * Mostra um colaborador
+ *
+ * O cartão da pessoa: nome, e-mail, telefone, setor e cargo. Vale também para quem já saiu da empresa, que continua nas mensagens antigas.
+ *
+ * `GET /conversa/pessoas/{id}`
+ */
+export declare function buscar_pessoa_conversa(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.ColaboradorPessoa>;
 /**
  * Busca uma conversa pelo id
  *
@@ -185,6 +193,14 @@ export declare function remover_participante_conversa(credencial_de_acesso: Cred
  * `PATCH /conversa/{id}/preferencias`
  */
 export declare function atualizar_preferencias_conversa(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.PreferenciasAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.MeuEstado>;
+/**
+ * Inicia uma reunião ou uma chamada no TermoMeet
+ *
+ * Cria no TermoMeet (com o token de quem pediu) uma reunião instantânea com o nome da conversa (ou "Reunião de"/"Chamada de" quem pediu) e manda o link na conversa como mensagem de quem pediu. `tipo` `REUNIAO` (padrão) manda "📹 Reunião no TermoMeet: <link>"; `CHAMADA` manda "📞 <nome> iniciou uma chamada no TermoMeet: <link>" e avisa por push quem não está no app. O corpo pode ir vazio. Quem está conectado recebe `mensagem.criada` na hora. A resposta traz o `codigo` e o `link` da sala para abrir na hora.
+ *
+ * `POST /conversa/{id}/reuniao`
+ */
+export declare function iniciar_reuniao_mensagem(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.ReuniaoIniciar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.ReuniaoIniciada>;
 /**
  * Sai do grupo ou do espaço
  *

package/dist/talk/rotas.js

@@ -85,6 +85,22 @@ export function buscar_pessoas_conversa(credencial_de_acesso, parametros = {}, o
         formato_da_resposta: "json",
     }, opcoes_da_chamada);
 }
+/**
+ * Mostra um colaborador
+ *
+ * O cartão da pessoa: nome, e-mail, telefone, setor e cargo. Vale também para quem já saiu da empresa, que continua nas mensagens antigas.
+ *
+ * `GET /conversa/pessoas/{id}`
+ */
+export function buscar_pessoa_conversa(credencial_de_acesso, id, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: `/conversa/pessoas/${codificar_parametro_de_caminho(id)}`,
+        credencial_de_acesso,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
 /**
  * Busca uma conversa pelo id
  *
@@ -285,6 +301,23 @@ export function atualizar_preferencias_conversa(credencial_de_acesso, id, corpo_
         formato_da_resposta: "json",
     }, opcoes_da_chamada);
 }
+/**
+ * Inicia uma reunião ou uma chamada no TermoMeet
+ *
+ * Cria no TermoMeet (com o token de quem pediu) uma reunião instantânea com o nome da conversa (ou "Reunião de"/"Chamada de" quem pediu) e manda o link na conversa como mensagem de quem pediu. `tipo` `REUNIAO` (padrão) manda "📹 Reunião no TermoMeet: <link>"; `CHAMADA` manda "📞 <nome> iniciou uma chamada no TermoMeet: <link>" e avisa por push quem não está no app. O corpo pode ir vazio. Quem está conectado recebe `mensagem.criada` na hora. A resposta traz o `codigo` e o `link` da sala para abrir na hora.
+ *
+ * `POST /conversa/{id}/reuniao`
+ */
+export function iniciar_reuniao_mensagem(credencial_de_acesso, id, corpo_da_requisicao, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "POST",
+        caminho_da_rota: `/conversa/${codificar_parametro_de_caminho(id)}/reuniao`,
+        credencial_de_acesso,
+        corpo_json: corpo_da_requisicao,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
 /**
  * Sai do grupo ou do espaço
  *

package/dist/talk/tipos.d.ts

@@ -38,7 +38,7 @@ export interface AnexoEnviar {
     tipo: string;
 }
 /**
- * Colaborador para escolher numa conversa: nome, e-mail, setor e cargo.
+ * Colaborador para escolher numa conversa (e para o cartão da pessoa): nome, e-mail, telefone, setor e cargo.
  */
 export interface ColaboradorPessoa {
     cargo?: string | null;
@@ -46,6 +46,7 @@ export interface ColaboradorPessoa {
     id: string;
     nome: string;
     setor?: string | null;
+    telefone?: string | null;
 }
 /**
  * Resumo do colaborador (id e nome) para mostrar autoria.
@@ -231,6 +232,26 @@ export interface ReacaoAlternar {
 export interface RespostaDeErro {
     erro: string;
 }
+export interface ReuniaoIniciada {
+    /**
+     * Código da sala no TermoMeet (`abc-defg-hij`).
+     */
+    codigo: string;
+    /**
+     * Link da sala no TermoMeet, o mesmo que foi na mensagem.
+     */
+    link: string;
+    /**
+     * A mensagem com o link que foi para a conversa.
+     */
+    mensagem: Mensagem;
+}
+export interface ReuniaoIniciar {
+    /**
+     * `REUNIAO` (padrão, reunião instantânea) ou `CHAMADA` (liga para quem está na conversa).
+     */
+    tipo?: string | null;
+}
 export interface UltimaMensagem {
     autor: ColaboradorResumo;
     criado_em: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "termo_core",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "description": "Todos os clientes da Termotubos num pacote só: um módulo por serviço e cada rota da API como uma função com fetch, com o endereço resolvido pelo ambiente atual.",
   "license": "MIT",
   "author": "TI Termotubos <ti@termotubos.com.br>",