Skip to main content

Module task

Module task 

Source
Expand description

Task/* method handlers (draft-tasks-06 §4).

Task/set enforces the isDraft immutability constraint: once set to false, it cannot be set back to true.

§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, /copy → §5.4, /query → §5.5, /queryChanges → §5.6), with the type-specific arguments defined by draft-tasks-06 §4. The returned Value is the corresponding method-response object per the same section refs.

The returned Vec<Invocation> carries any back-reference invocations that this handler injected into the request stream (RFC 8620 §6.3). For the standard /get, /changes, /set, /query, and /queryChanges handlers in this module the vector is always empty. handle_task_copy is the one exception: it MAY emit Task/set follow-up invocations when onSuccessDestroyOriginal is true (RFC 8620 §5.4).

Each handler returns Err(JmapError) for method-level failures (accountNotFound, invalidArguments, stateMismatch, serverFail, unsupportedFilter, unsupportedSort, cannotCalculateChanges — per RFC 8620 §3.6 and §5). Per-target failures inside a /set or /copy call surface in the notCreated / notUpdated / notDestroyed maps within Ok((Value, ...)), not as Err.

Functions§

handle_task_changes
Handle a Task/changes method call (draft-tasks-06 §4.6).
handle_task_copy
Handle a Task/copy method call (draft-tasks-06 §4.8).
handle_task_get
Handle a Task/get method call (draft-tasks-06 §4.5).
handle_task_query
Handle a Task/query method call (draft-tasks-06 §4.13).
handle_task_query_changes
Handle a Task/queryChanges method call (draft-tasks-06 §4.14).
handle_task_set
Handle a Task/set method call (draft-tasks-06 §4.7).