diff --git a/xep-0313.xml b/xep-0313.xml index fd74d9fa..f247e68b 100644 --- a/xep-0313.xml +++ b/xep-0313.xml @@ -15,6 +15,7 @@ 2017-11-15 Standards Track Standards + Council XMPP Core XEP-0030 @@ -29,6 +30,17 @@ &mwild; &ksmith; + + 1.1.0 + 2023-03-09 + mw + +
    +
  • Clarify archive metadata response in the case of an empty archive.
    • +
  • Clarify query response in the case of no matching results.
    • +
+ + 1.0.1 2022-02-16 @@ -373,6 +385,10 @@ consistent with the format defined in &xep0068;. Servers MUST NOT mark any fields in the form as being required (i.e. with the data forms <required/> element), regardless of whether they are defined in this document or elsewhere.

+ +

Except where explicitly noted below (i.e. 'Limiting results by id'), a query is still considered successful even + if the archive is empty or if no messages match the filter criteria - such queries simply return no results.

+

If a 'with' field is present in the form, it contains a JID against which to match messages. The server MUST only return messages if they match the supplied JID. A message in a user's archive matches if the JID matches either the to or from of the message. An item in a MUC archive matches if the publisher of the item matches the JID; note that this should only be available to entities that would already have been allowed to know the publisher of the events (e.g. this could not be used by a visitor to a semi-anonymous MUC).

@@ -803,8 +819,9 @@ ]]> -

The server response includes a <metadata/> element containing information about the archive. This element MUST include <start/> and <end/> +

The server response includes a <metadata/> element containing information about the archive. If the archive is not empty, this element MUST include <start/> and <end/> elements, which each have an 'id' and XEP-0082 formatted 'timestamp of the first and last messages in the archive respectively.

+

If the archive is empty, the server MUST instead send an empty <metadata/> element.