Skip to main content

handle_position_changes

Function handle_position_changes 

Source
pub async fn handle_position_changes<B: ChatBackend>(
    backend: &B,
    caller: &B::CallerCtx,
    args: Value,
) -> Result<HandlerOutput, JmapError>
Expand description

Handle a ReadPosition/changes method call (draft-atwood-jmap-chat-00 §ReadPosition).

args is the RFC 8620 §5.2 /changes request shape (accountId, sinceState, optional maxChanges); the returned Value is the §5.2 /changes response shape (accountId, oldState, newState, hasMoreChanges, created, updated, destroyed).

Returns (response_args, extra_invocations). The extra list is always empty.

§Errors

Returns a method-level JmapError:

  • invalidArguments when accountId is missing or not a valid Id, sinceState is missing, or maxChanges is not a positive integer;
  • accountNotFound when the backend does not know accountId;
  • cannotCalculateChanges when the backend cannot compute the changes since sinceState;
  • serverFail when the backend fails.