1 files changed, 515 insertions, 0 deletions

diff --git a/include/gnunet_chat_lib.h b/include/gnunet_chat_lib.h
new file mode 100644
index 0000000..0d4bff5
--- /dev/null
+++ b/include/gnunet_chat_lib.h
@@ -0,0 +1,515 @@
+/*
+   The development of this code was supported by the NLnet foundation as part
+   of the NGI Assure initative to have a more free and secure internet.
+ */
+/*
+ * @author Tobias Frisch
+ * @file gnunet_chat_lib.h
+ */
+
+#ifndef GNUNET_CHAT_LIB_H_
+#define GNUNET_CHAT_LIB_H_
+
+#include <gnunet/platform.h>
+#include <gnunet/gnunet_util_lib.h>
+
+/**
+ * TODO
+ */
+enum GNUNET_CHAT_MessageKind
+{
+  /**
+   * TODO
+   */
+  GNUNET_CHAT_KIND_TEXT = 1,  /**< GNUNET_CHAT_KIND_TEXT */
+
+  /**
+   * TODO
+   */
+  GNUNET_CHAT_KIND_FILE = 2,  /**< GNUNET_CHAT_KIND_FILE */
+
+  /**
+   * TODO
+   */
+  GNUNET_CHAT_KIND_UNKNOWN = 0/**< GNUNET_CHAT_KIND_UNKNOWN */
+};
+
+/**
+ * TODO
+ */
+struct GNUNET_CHAT_Handle;
+
+/**
+ * TODO
+ */
+struct GNUNET_CHAT_Contact;
+
+/**
+ * TODO
+ */
+struct GNUNET_CHAT_Group;
+
+/**
+ * TODO
+ */
+struct GNUNET_CHAT_Context;
+
+/**
+ * TODO
+ */
+struct GNUNET_CHAT_Message;
+
+/**
+ * TODO
+ */
+struct GNUNET_CHAT_File;
+
+/**
+ * TODO
+ *
+ * @param cls
+ * @param handle
+ * @param contact
+ * @return
+ */
+typedef int
+(*GNUNET_CHAT_ContactCallback) (void *cls, struct GNUNET_CHAT_Handle *handle,
+                                const struct GNUNET_CHAT_Contact *contact);
+
+/**
+ * TODO
+ *
+ * @param cls
+ * @param handle
+ * @param group
+ * @return
+ */
+typedef int
+(*GNUNET_CHAT_GroupCallback) (void *cls, struct GNUNET_CHAT_Handle *handle,
+                              const struct GNUNET_CHAT_Group *group);
+
+/**
+ * TODO
+ *
+ * @param cls
+ * @param group
+ * @param contact
+ * @return
+ */
+typedef int
+(*GNUNET_CHAT_GroupContactCallback) (void *cls, struct GNUNET_CHAT_Group *group,
+                                    const struct GNUNET_CHAT_Contact *contact);
+
+/**
+ * TODO
+ *
+ * @param cls
+ * @param context
+ * @param message
+ * @return
+ */
+typedef int
+(*GNUNET_CHAT_ContextMessageCallback) (void *cls, struct GNUNET_CHAT_Context *context,
+                                       const struct GNUNET_CHAT_Message *message);
+
+/**
+ * TODO
+ *
+ * @param cls
+ * @param message
+ * @param contact
+ * @param read_receipt
+ * @return
+ */
+typedef int
+(*GNUNET_CHAT_MessageReadReceiptCallback) (void *cls, const struct GNUNET_CHAT_Message *message,
+                                           const struct GNUNET_CHAT_Contact *contact,
+                                           int read_receipt);
+
+typedef void
+(*GNUNET_CHAT_MessageFileDownloadCallback) (void *cls, const struct GNUNET_CHAT_File *file);
+
+
+/**
+ * TODO
+ *
+ * @param cfg
+ * @param name
+ * @return
+ */
+struct GNUNET_CHAT_Handle*
+GNUNET_CHAT_start (const struct GNUNET_CONFIGURATION_Handle *cfg,
+                   const char *name);
+
+/**
+ * TODO
+ *
+ * @param handle
+ */
+void
+GNUNET_CHAT_stop (struct GNUNET_CHAT_Handle *handle);
+
+/**
+ * TODO
+ *
+ * @param handle
+ * @return
+ */
+int
+GNUNET_CHAT_update (struct GNUNET_CHAT_Handle *handle);
+
+/**
+ * TODO
+ *
+ * @param handle
+ * @param name
+ * @return
+ */
+int
+GNUNET_CHAT_set_name (struct GNUNET_CHAT_Handle *handle,
+                      const char *name);
+
+/**
+ * TODO
+ *
+ * @param handle
+ * @return
+ */
+const char*
+GNUNET_CHAT_get_name (const struct GNUNET_CHAT_Handle *handle);
+
+/**
+ * TODO
+ *
+ * @param handle
+ * @return
+ */
+const struct GNUNET_IDENTITY_PublicKey*
+GNUNET_CHAT_get_key (const struct GNUNET_CHAT_Handle *handle);
+
+/**
+ * TODO
+ *
+ * @param handle
+ * @param callback
+ * @param cls
+ * @return
+ */
+int
+GNUNET_CHAT_iterate_contacts (struct GNUNET_CHAT_Handle *handle,
+                              GNUNET_CHAT_ContactCallback callback,
+                              void *cls);
+
+/**
+ * TODO
+ *
+ * @param handle
+ * @return
+ */
+struct GNUNET_CHAT_Group *
+GNUNET_CHAT_group_create (struct GNUNET_CHAT_Handle *handle);
+
+/**
+ * TODO
+ *
+ * @param handle
+ * @param callback
+ * @param cls
+ * @return
+ */
+int
+GNUNET_CHAT_iterate_groups (struct GNUNET_CHAT_Handle *handle,
+                            GNUNET_CHAT_GroupCallback callback,
+                            void *cls);
+
+/**
+ * TODO
+ *
+ * @param contact
+ * @return
+ */
+int
+GNUNET_CHAT_contact_delete (struct GNUNET_CHAT_Contact *contact);
+
+/**
+ * TODO
+ *
+ * @param contact
+ */
+void
+GNUNET_CHAT_contact_set_blocking (struct GNUNET_CHAT_Contact *contact,
+                                  int blocking);
+
+/**
+ * TODO
+ *
+ * @param contact
+ * @return
+ */
+int
+GNUNET_CHAT_contact_is_blocking (const struct GNUNET_CHAT_Contact *contact);
+
+/**
+ * TODO
+ *
+ * @param contact Contact
+ * @param name Custom nick name
+ */
+void
+GNUNET_CHAT_contact_set_name (struct GNUNET_CHAT_Contact *contact,
+                              const char *name);
+
+/**
+ * TODO
+ *
+ * @param contact Contact
+ * @return Name or custom nick name
+ */
+const char*
+GNUNET_CHAT_contact_get_name (const struct GNUNET_CHAT_Contact *contact);
+
+/**
+ * TODO
+ *
+ * @param contact
+ * @return
+ */
+const struct GNUNET_IDENTITY_PublicKey*
+GNUNET_CHAT_contact_get_key (const struct GNUNET_CHAT_Contact *contact);
+
+/**
+ * TODO
+ *
+ * @param contact Contact
+ * @return Chat context
+ */
+struct GNUNET_CHAT_Context*
+GNUNET_CHAT_contact_get_context (struct GNUNET_CHAT_Contact *contact);
+
+/**
+ * TODO
+ *
+ * @param group
+ */
+void
+GNUNET_CHAT_group_leave (struct GNUNET_CHAT_Group *group);
+
+/**
+ * TODO
+ *
+ * @param group
+ * @param name
+ */
+void
+GNUNET_CHAT_group_set_name (struct GNUNET_CHAT_Group *group,
+                              const char *name);
+
+/**
+ * TODO
+ *
+ * @param group
+ * @return
+ */
+const char*
+GNUNET_CHAT_group_get_name (const struct GNUNET_CHAT_Group *group);
+
+/**
+ * TODO
+ *
+ * @param group
+ * @param contact
+ */
+void
+GNUNET_CHAT_group_invite_contact (struct GNUNET_CHAT_Group *group,
+                                  struct GNUNET_CHAT_Contact *contact);
+
+/**
+ * TODO
+ *
+ * @param group
+ * @param callback
+ * @param cls
+ * @return
+ */
+int
+GNUNET_CHAT_group_iterate_contacts (struct GNUNET_CHAT_Group *group,
+                                    GNUNET_CHAT_GroupContactCallback callback,
+                                    void *cls);
+
+/**
+ * TODO
+ *
+ * @param group
+ * @return
+ */
+struct GNUNET_CHAT_Context*
+GNUNET_CHAT_group_get_context (struct GNUNET_CHAT_Group *group);
+
+/**
+ * TODO
+ *
+ * @param context
+ * @param text
+ */
+void
+GNUNET_CHAT_context_send_text (struct GNUNET_CHAT_Context *context,
+                               const char *text);
+
+/**
+ * TODO
+ *
+ * @param context
+ * @param path
+ */
+void
+GNUNET_CHAT_context_send_file (struct GNUNET_CHAT_Context *context,
+                               const char *path);
+
+/**
+ * TODO
+ *
+ * @param context
+ * @param uri
+ */
+void
+GNUNET_CHAT_context_send_uri (struct GNUNET_CHAT_Context *context,
+                              const char *uri);
+
+/**
+ * TODO
+ *
+ * @param context
+ * @param file
+ */
+void
+GNUNET_CHAT_context_share_file (struct GNUNET_CHAT_Context *context,
+                                const struct GNUNET_CHAT_File *file);
+
+/**
+ * TODO
+ *
+ * @param context
+ * @param hash
+ * @param delay
+ */
+void
+GNUNET_CHAT_context_delete_message (struct GNUNET_CHAT_Context *context,
+                                    const struct GNUNET_HashCode *hash,
+                                    struct GNUNET_TIME_Relative delay);
+
+/**
+ * TODO
+ *
+ * @param context
+ * @param hash
+ * @return
+ */
+const struct GNUNET_CHAT_Message*
+GNUNET_CHAT_context_get_message (struct GNUNET_CHAT_Context *context,
+                                 const struct GNUNET_HashCode *hash);
+
+/**
+ * TODO
+ *
+ * @param context
+ * @param callback
+ * @param cls
+ * @return
+ */
+int
+GNUNET_CHAT_context_iterate_messages (struct GNUNET_CHAT_Context *context,
+                                      GNUNET_CHAT_ContextMessageCallback callback,
+                                      void *cls);
+
+/**
+ * TODO
+ *
+ * @param message
+ * @return
+ */
+enum GNUNET_CHAT_MessageKind
+GNUNET_CHAT_message_get_kind (const struct GNUNET_CHAT_Message *message);
+
+/**
+ * TODO
+ *
+ * @param message
+ * @return
+ */
+struct GNUNET_TIME_Absolute
+GNUNET_CHAT_message_get_timestamp (const struct GNUNET_CHAT_Message *message);
+
+/**
+ * TODO
+ *
+ * @param message
+ * @return
+ */
+const struct GNUNET_CHAT_Contact*
+GNUNET_CHAT_message_get_sender (const struct GNUNET_CHAT_Message *message);
+
+/**
+ * TODO
+ *
+ * @param message
+ * @param callback
+ * @param cls
+ * @return
+ */
+int
+GNUNET_CHAT_message_get_read_receipt (const struct GNUNET_CHAT_Message *message,
+                                      GNUNET_CHAT_MessageReadReceiptCallback callback,
+                                      void *cls);
+
+/**
+ * TODO
+ *
+ * @param message
+ * @return
+ */
+const char*
+GNUNET_CHAT_message_get_text (const struct GNUNET_CHAT_Message *message);
+
+
+/**
+ * TODO
+ *
+ * @param message
+ * @return
+ */
+struct GNUNET_CHAT_File*
+GNUNET_CHAT_message_get_file (const struct GNUNET_CHAT_Message *message);
+
+/**
+ * TODO
+ *
+ * @param file
+ */
+void
+GNUNET_CHAT_file_start_download (struct GNUNET_CHAT_File *file);
+
+/**
+ * TODO
+ *
+ * @param file
+ */
+void
+GNUNET_CHAT_file_pause_download (struct GNUNET_CHAT_File *file);
+
+/**
+ * TODO
+ *
+ * @param file
+ */
+void
+GNUNET_CHAT_file_resume_download (struct GNUNET_CHAT_File *file);
+
+/**
+ * TODO
+ *
+ * @param file
+ */
+void
+GNUNET_CHAT_file_stop_download (struct GNUNET_CHAT_File *file);
+
+#endif /* GNUNET_CHAT_LIB_H_ */