Skip to main content

Module message

Module message 

Source
Expand description

Message/* method handlers (draft-atwood-jmap-chat-00 §Message).

§Wire-shape contract

Every handle_* function in this module conforms to the canonical JMAP method shape. The args: serde_json::Value parameter MUST be a JSON Object whose fields match the corresponding RFC 8620 §5 method shape (/get → §5.1, /changes → §5.2, /set → §5.3, /query → §5.5, /queryChanges → §5.6), with the type-specific arguments defined by draft-atwood-jmap-chat-00 §Message. The returned Value is the corresponding method-response object per the same section refs.

The returned HandlerOutput::extra_invocations carries any invocations that this handler injected into the request stream (RFC 8620 §6.3); for the handlers in this module the vector is always empty.

Each handler returns Err(JmapError) for method-level failures (RFC 8620 §3.6.2 and §5):

  • every handler: accountNotFound, invalidArguments, serverFail;
  • /get, /set: requestTooLarge past maxObjectsInGet / maxObjectsInSet;
  • /set: stateMismatch;
  • /changes, /queryChanges: cannotCalculateChanges;
  • /queryChanges: tooManyChanges;
  • /query, /queryChanges: unsupportedFilter;
  • /query: unsupportedSort, anchorNotFound.

Per-target failures inside /set (including the slow_mode_check rateLimit and reaction-patch invalidPatch paths) surface in the notCreated / notUpdated / notDestroyed maps within Ok((Value, ...)), not as Err.

Enums§

StoreOutcome
The result of store_server_message.

Constants§

ENCRYPTED_BODY_TYPES
Default bodyType values that indicate an end-to-end encrypted body: the one type draft-atwood-jmap-chat-00 §Message body names. A backend adds others, such as "application/mimi-fanout" (draft-atwood-jmap-chat-mimi-00 §MLS Messages), through ChatLimits::encrypted_body_types.
SUPPORTED_BODY_TYPES
Default bodyType values this server accepts, advertised as the supportedBodyTypes capability (draft-atwood-jmap-chat-00 §Account-Level Capability Object). A backend lists other types through ChatLimits::supported_body_types.

Functions§

find_message_by_sender_msg_id
Find the Message in chat_id whose senderMsgId is sender_msg_id.
handle_message_changes
Handle a Message/changes method call (draft-atwood-jmap-chat-00 §Message).
handle_message_get
Handle a Message/get method call (draft-atwood-jmap-chat-00 §Message).
handle_message_query
Handle a Message/query method call (draft-atwood-jmap-chat-00 §Message).
handle_message_query_changes
Handle a Message/queryChanges method call (draft-atwood-jmap-chat-00 §Message).
handle_message_set
Handle a Message/set method call (draft-atwood-jmap-chat-00 §Message).
store_server_message
Store a Message that the server, not a client, creates: for example a MIMI fanout Message (draft-atwood-jmap-chat-mimi-00 §application/mimi-fanout) or a federation Peer/deliver Message.