event hooks

Some events need to do something else before the event can be
transmitted, and indeed the contents of the event aren't necessarily
known until that other thing has happened.

Add a hook that gets called when the event is ready to be sent
and when the event is to be free'd.

Signed-off-by: Dr. David Alan Gilbert <dave@treblig.org>

1 files changed, 15 insertions, 0 deletions

diff --git a/matrix-event.h b/matrix-event.h
index 2f079b2..6bdb35e 100644
--- a/matrix-event.h
+++ b/matrix-event.h
@@ -25,7 +25,14 @@
 #include <glib.h>
 
 struct _JsonObject;
+struct _MatrixRoomEvent;
 
+/* Callback by events;
+ * called with 'just_free' false prior to sending an event.
+ * called with 'just_free' true when freeing the event.
+ */
+typedef void (*EventSendHook)(struct _MatrixRoomEvent *event,
+        gboolean just_free);
 typedef struct _MatrixRoomEvent {
     /* for outgoing events, our made-up transaction id. NULL for incoming
      * events.
@@ -37,6 +44,14 @@ typedef struct _MatrixRoomEvent {
 
     gchar *event_type;
     struct _JsonObject *content;
+
+    /* Hook (& data) called when the event is unqueued; the hook should
+     * do the send itself.
+     * Useful where a file has to be uploaded before sending the event.
+     */
+    EventSendHook hook;
+
+    void *hook_data;
 } MatrixRoomEvent;