/*
This file is part of GNUnet.
Copyright (C) 2021--2024 GNUnet e.V.
GNUnet is free software: you can redistribute it and/or modify it
under the terms of the GNU Affero General Public License as published
by the Free Software Foundation, either version 3 of the License,
or (at your option) any later version.
GNUnet is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License
along with this program. If not, see .
SPDX-License-Identifier: AGPL3.0-or-later
*/
/*
* @author Tobias Frisch
* @file gnunet_chat_context.h
*/
#ifndef GNUNET_CHAT_CONTEXT_H_
#define GNUNET_CHAT_CONTEXT_H_
#include
#include
#include
#include
#include
#include "gnunet_chat_util.h"
struct GNUNET_CHAT_Handle;
struct GNUNET_CHAT_Message;
struct GNUNET_CHAT_Context
{
struct GNUNET_CHAT_Handle *handle;
enum GNUNET_CHAT_ContextType type;
uint32_t flags;
char *nick;
char *topic;
int deleted;
struct GNUNET_SCHEDULER_Task *request_task;
struct GNUNET_CONTAINER_MultiShortmap *timestamps;
struct GNUNET_CONTAINER_MultiHashMap *dependencies;
struct GNUNET_CONTAINER_MultiHashMap *messages;
struct GNUNET_CONTAINER_MultiHashMap *requests;
struct GNUNET_CONTAINER_MultiHashMap *taggings;
struct GNUNET_CONTAINER_MultiHashMap *invites;
struct GNUNET_CONTAINER_MultiHashMap *files;
struct GNUNET_MESSENGER_Room *room;
const struct GNUNET_MESSENGER_Contact *contact;
void *user_pointer;
struct GNUNET_CONTAINER_MultiShortmap *member_pointers;
struct GNUNET_NAMESTORE_QueueEntry *query;
};
/**
* Creates a chat context from a messenger room
* with a selected chat handle.
*
* @param[in,out] handle Chat handle
* @param[in,out] room Messenger room
* @return New chat context
*/
struct GNUNET_CHAT_Context*
context_create_from_room (struct GNUNET_CHAT_Handle *handle,
struct GNUNET_MESSENGER_Room *room);
/**
* Creates a chat context from a messenger contact
* with a selected chat handle.
*
* @param[in,out] handle Chat handle
* @param[in] contact Messenger contact
* @return New chat context
*/
struct GNUNET_CHAT_Context*
context_create_from_contact (struct GNUNET_CHAT_Handle *handle,
const struct GNUNET_MESSENGER_Contact *contact);
/**
* Destroys a chat context and frees its memory.
*
* @param[in,out] context Chat context
*/
void
context_destroy (struct GNUNET_CHAT_Context* context);
/**
* Request a message from a chat context with a
* given hash.
*
* @param[in,out] context Chat context
* @param[in] hash Message hash
*/
void
context_request_message (struct GNUNET_CHAT_Context* context,
const struct GNUNET_HashCode *hash);
/**
* Updates the connected messenger room of a
* selected chat context.
*
* @param[in,out] context Chat context
* @param[in,out] room Messenger room
* @param[in] record Write changes to records
*/
void
context_update_room (struct GNUNET_CHAT_Context *context,
struct GNUNET_MESSENGER_Room *room,
enum GNUNET_GenericReturnValue record);
/**
* Updates the nick of a selected chat context.
*
* @param[in,out] context Chat context
* @param[in] nick Nick name
*/
void
context_update_nick (struct GNUNET_CHAT_Context *context,
const char *nick);
/**
* Deletes linked content from a given chat context
* of a specific chat message.
*
* @param[in,out] context Chat context
* @param[in] message Chat message
*/
void
context_delete_message (struct GNUNET_CHAT_Context *context,
const struct GNUNET_CHAT_Message *message);
/**
* Reads the data of records under a given label
* and updates the chat context with it.
*
* @param[in,out] context Chat context
* @param[in] label Label
* @param[in] count Count of data
* @param[in] data Records data
*/
void
context_read_records (struct GNUNET_CHAT_Context *context,
const char *label,
unsigned int count,
const struct GNUNET_GNSRECORD_Data *data);
/**
* Writes the data from a selected chat context into
* the namestore as private records.
*
* @param[in,out] context Chat context
*/
void
context_write_records (struct GNUNET_CHAT_Context *context);
/**
* Removes the data from a selected chat context from
* the namestore and closes its room optionally.
*
* @param[in,out] context Chat context
* @param[in] exit Closing its room
*/
void
context_delete (struct GNUNET_CHAT_Context *context,
enum GNUNET_GenericReturnValue exit);
#endif /* GNUNET_CHAT_CONTEXT_H_ */