jmap-metadata-client 0.3.0

JMAP Object Metadata extension client helpers (draft-ietf-jmap-metadata-02) — property constants, filter-condition builders, and /changes helpers for metadata-augmented requests
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63

# jmap-metadata-client — Implementation Plan

Pure client-side helpers for the JMAP Object Metadata extension
([draft-ietf-jmap-metadata-02]).

## Crate Family Position

```
jmap-metadata-types
    └── jmap-metadata-client  ← this crate
```

## What This Crate Is

Constants and JSON builders that callers combine with the typed
extension clients' own `Foo/get`, `Foo/changes`, and `Foo/query`
calls. draft-02 removed the -01 standalone `Metadata` object and its
`Metadata/*` methods, so the -01 `JmapMetadataExt` trait,
`SessionClient`, and five method bindings were deleted in the -02
rewrite (bd JMAP-ua37.3).

| Item | Draft § |
|---|---|
| `METADATA_PROPERTY`, `PRIVATE_METADATA_PROPERTY` | §2, §3.1 |
| `IGNORE_METADATA_ONLY_CHANGES` | §3.3 |
| `is_metadata_property`, `is_metadata_only_change` | §3.3 |
| `metadata_exists_condition`, `private_metadata_exists_condition` | §3.5 |
| `metadata_text_contains_condition`, `private_metadata_text_contains_condition` | §3.5 |
| `metadata_text_equals_condition`, `private_metadata_text_equals_condition` | §3.5 |
| re-exports from `jmap-metadata-types` | §1.2.1, §2.1, §3.5 |

## What This Crate Is Not

- Not a server-side crate (see `jmap-metadata-server`).
- Not an HTTP client — no transport, no session handling.
- Not a typed extension of each type's `FilterCondition`: by decision
  (bd JMAP-ua37.4) the builders return `serde_json::Value`. Extension
  clients whose `*_query` takes a `Value` filter accept them directly;
  the chat client and two calendars-client query methods take typed
  filters and cannot (bd JMAP-ua37.7).

## Module Layout

```
src/
  lib.rs   constants, classifiers, condition builders, re-exports
```

## Test Strategy

Inline `#[cfg(test)]` unit tests plus rustdoc examples. Oracles are
wire names and hand-written JSON literals taken from the §3.3 and §3.5
field definitions — never derived from the code under test.

## References

- **[draft-ietf-jmap-metadata-02]** — JMAP Object Metadata (normative
  for property names, the `/changes` argument, and filter conditions).
- **[RFC 8620]** — JMAP Core (`/get`, `/changes`, `/query`, filter
  operators).

[draft-ietf-jmap-metadata-02]: https://datatracker.ietf.org/doc/html/draft-ietf-jmap-metadata-02
[RFC 8620]: https://www.rfc-editor.org/rfc/rfc8620