From ab87b2503042ec9cf226574fa68af1b5b9809cc7 Mon Sep 17 00:00:00 2001
From: mathieui <mathieui@mathieui.net>
Date: Sun, 14 Feb 2021 12:00:25 +0100
Subject: XEP-0153: API changes

---
 docs/api/plugins/xep_0153.rst | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

(limited to 'docs/api/plugins/xep_0153.rst')

diff --git a/docs/api/plugins/xep_0153.rst b/docs/api/plugins/xep_0153.rst
index 00e22098..bdcbc07c 100644
--- a/docs/api/plugins/xep_0153.rst
+++ b/docs/api/plugins/xep_0153.rst
@@ -9,6 +9,42 @@ XEP-0153: vCard-Based Avatars
     :exclude-members: session_bind, plugin_init, plugin_end
 
 
+Internal API methods
+--------------------
+
+The internal API is used here to maintain an in-memory JID→avatar hash
+cache.
+
+.. glossary::
+
+    set_hash
+        - **jid**: :class:`~.JID` of whom to retrieve the last activity
+        - **node**: unused
+        - **ifrom**: unused
+        - **args**: ``str``, avatar hash
+
+        Set the avatar hash for a JID.
+
+    reset_hash
+        - **jid**: :class:`~.JID` of whom to retrieve the last activity
+        - **node**: unused
+        - **ifrom**: :class:`~.JID` of the entity requesting the reset.
+        - **args**: unused
+        - **returns**
+          information.
+
+        Reset the avatar hash for a JID. This downloads the vcard and computes
+        the hash.
+
+    get_hash
+        - **jid**: :class:`~.JID` of whom to retrieve the last activity
+        - **node**: unused
+        - **ifrom**: unused
+        - **args**: unused
+        - **returns**: ``Optional[str]``, the avatar hash
+
+        Get the avatar hash for a JID.
+
 Stanza elements
 ---------------
 
-- 
cgit v1.2.3


From 9927e69435e4e451722184d5b73107554a4df5c6 Mon Sep 17 00:00:00 2001
From: mathieui <mathieui@mathieui.net>
Date: Fri, 26 Feb 2021 00:07:47 +0100
Subject: docs: add references to API docs

---
 docs/api/plugins/xep_0153.rst | 1 +
 1 file changed, 1 insertion(+)

(limited to 'docs/api/plugins/xep_0153.rst')

diff --git a/docs/api/plugins/xep_0153.rst b/docs/api/plugins/xep_0153.rst
index bdcbc07c..d4ce342f 100644
--- a/docs/api/plugins/xep_0153.rst
+++ b/docs/api/plugins/xep_0153.rst
@@ -8,6 +8,7 @@ XEP-0153: vCard-Based Avatars
     :members:
     :exclude-members: session_bind, plugin_init, plugin_end
 
+.. _api-0153:
 
 Internal API methods
 --------------------
-- 
cgit v1.2.3