commit a7375ddd421a2c1850c66f513b54c207fb97822b · zbrox.com/jacquard

+6 -38

CHANGELOG.md

···

       2
        
       

     

       3
        
       ## [0.5.0] - 2025-10-13

     

       4
        
       

     

       5
       -
       ### Breaking Changes

     

       6
       -
       

     

       7
       -
       **AgentSession trait** (`jacquard`)

     

       8
       -
       - Removed `async fn` in favour of `impl Future` return types for better trait object compatibility

     

       9
       -
       - Methods now return `impl Future` instead of being marked `async fn`

     

       10
       -
       

     

       11
       -
       **XRPC improvements** (`jacquard-common`)

     

       12
       -
       - Simplified response transmutation for typed record retrieval

     

       13
       -
       - `Response::transmute()` added for zero-cost response type conversion

     

       14
       -
       

     

       15
       -
       **jacquard-axum**

     

       16
       -
       - Removed binary target (`main.rs`), now library-only

     

       17
       -
       

     

       18
        
       ### Added

     

       19
        
       

     

       20
        
       **Agent convenience methods** (`jacquard`)

     
···

       22
        
       - **Basic CRUD**: `create_record()`, `get_record()`, `put_record()`, `delete_record()`

     

       23
        
       - **Update patterns**: `update_record()` (fetch-modify-put), `update_vec()`, `update_vec_item()`

     

       24
        
       - **Blob operations**: `upload_blob()`

     

       25
       -
       - All methods auto-fill repo from session and collection from type's `Collection::NSID`

     

       26
       -
       - Simplified bounds on `update_record` - no HRTB issues, works with all record types

     

       27
        
       

     

       28
        
       **VecUpdate trait** (`jacquard`)

     

       29
        
       - `VecUpdate` trait for fetch-modify-put patterns on array-based endpoints

     

       30
       -
       - `PreferencesUpdate` implementation for updating user preferences

     

       31
       -
       - Enables type-safe updates to preferences, saved feeds, and other array endpoints

     

       32
        
       

     

       33
       -
       **Typed record retrieval** (`jacquard-api`, `jacquard-common`)

     

       34
        
       - Each collection generates `{Type}Record` marker struct implementing `XrpcResp`

     

       35
        
       - `Collection::Record` associated type points to the marker

     

       36
        
       - `get_record::<R>()` returns `Response<R::Record>` with zero-copy `.parse()`

     
···

       42
        
       - `post_with_image.rs`: Uploading images and creating posts with embeds

     

       43
        
       - `update_preferences.rs`: Using VecUpdate for preferences

     

       44
        
       - `create_whitewind_post.rs`, `read_whitewind_post.rs`: Third-party lexicons

     

       45
       -
       - `read_tangled_repo.rs`: Reading git repo metadata from tangled.sh

     

       46
        
       - `resolve_did.rs`: Identity resolution examples

     

       47
        
       - `public_atproto_feed.rs`: Unauthenticated feed access

     

       48
        
       - `axum_server.rs`: Server-side XRPC handler

     

       49
        
       

     

       50
       -
       ### Changed

     

       51
       -
       

     

       52
       -
       **Code organization** (`jacquard-lexicon`)

     

       53
       -
       - Refactored monolithic `codegen.rs` into focused modules:

     

       54
       -
         - `codegen/structs.rs`: Record and object generation

     

       55
       -
         - `codegen/xrpc.rs`: XRPC request/response generation

     

       56
       -
         - `codegen/types.rs`: Type alias and union generation

     

       57
       -
         - `codegen/names.rs`: Identifier sanitization and naming

     

       58
       -
         - `codegen/lifetime.rs`: Lifetime propagation logic

     

       59
       -
         - `codegen/output.rs`: Module and feature generation

     

       60
       -
         - `codegen/utils.rs`: Shared utilities

     

       61
       -
       - Improved code navigation and maintainability

     

       62
        
       

     

       63
        
       **Documentation** (`jacquard`)

     

       64
       -
       - Added comprehensive trait-level docs for `AgentSessionExt`

     

       65
       -
       - Updated examples to use new convenience methods

     

       66
       -
       

     

       67
       -
       ### Fixed

     

       68
       -
       

     

       69
       -
       - `update_record` now works with all record types without lifetime issues

     

       70
       -
       - Proper `IdentityResolver` bounds on `AgentSessionExt`

     

       71
        
       

     

       72
        
       ## [0.4.1] - 2025-10-13

     

       73

···

       2
        
       

     

       3
        
       ## [0.5.0] - 2025-10-13

     

       4
        
       

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       5
        
       ### Added

     

       6
        
       

     

       7
        
       **Agent convenience methods** (`jacquard`)

     
···

       9
        
       - **Basic CRUD**: `create_record()`, `get_record()`, `put_record()`, `delete_record()`

     

       10
        
       - **Update patterns**: `update_record()` (fetch-modify-put), `update_vec()`, `update_vec_item()`

     

       11
        
       - **Blob operations**: `upload_blob()`

     

       12
       +
       - All methods auto-fill repo from session or URI parameter as relevant, and collection from type's `Collection::NSID`

     

       0
        
       
     

       13
        
       

     

       14
        
       **VecUpdate trait** (`jacquard`)

     

       15
        
       - `VecUpdate` trait for fetch-modify-put patterns on array-based endpoints

     

       16
       +
       - `PreferencesUpdate` implementation for updating Bluesky user preferences

     

       17
       +
       - Enables simpler updates to preferences and other 'array of union' types

     

       18
        
       

     

       19
       +
       **Typed record retrieval** (`jacquard-api`, `jacquard-common`, `jacquard-lexicon`)

     

       20
        
       - Each collection generates `{Type}Record` marker struct implementing `XrpcResp`

     

       21
        
       - `Collection::Record` associated type points to the marker

     

       22
        
       - `get_record::<R>()` returns `Response<R::Record>` with zero-copy `.parse()`

     
···

       28
        
       - `post_with_image.rs`: Uploading images and creating posts with embeds

     

       29
        
       - `update_preferences.rs`: Using VecUpdate for preferences

     

       30
        
       - `create_whitewind_post.rs`, `read_whitewind_post.rs`: Third-party lexicons

     

       31
       +
       - `read_tangled_repo.rs`: Reading git repo metadata from tangled.org

     

       32
        
       - `resolve_did.rs`: Identity resolution examples

     

       33
        
       - `public_atproto_feed.rs`: Unauthenticated feed access

     

       34
        
       - `axum_server.rs`: Server-side XRPC handler

     

       35
        
       

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       36
        
       

     

       37
        
       **Documentation** (`jacquard`)

     

       38
       +
       - A whole host of examples added, as well as a lengthy explainer of the trait patterns.

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       39
        
       

     

       40
        
       ## [0.4.1] - 2025-10-13

     

       41

+102 -15

Cargo.lock

···

       1761
        
        "bytes",

     

       1762
        
        "clap",

     

       1763
        
        "http",

     

       1764
       -
        "jacquard-api",

     

       1765
       -
        "jacquard-common",

     

       1766
       -
        "jacquard-derive",

     

       1767
       -
        "jacquard-identity",

     

       1768
        
        "jacquard-oauth",

     

       1769
        
        "jose-jwk",

     

       1770
        
        "miette",

     
···

       1789
        
       dependencies = [

     

       1790
        
        "bon",

     

       1791
        
        "bytes",

     

       1792
       -
        "jacquard-common",

     

       1793
       -
        "jacquard-derive",

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       1794
        
        "miette",

     

       1795
        
        "serde",

     

       1796
        
        "thiserror 2.0.17",

     
···

       1805
        
        "axum-test",

     

       1806
        
        "bytes",

     

       1807
        
        "jacquard",

     

       1808
       -
        "jacquard-common",

     

       1809
        
        "miette",

     

       1810
        
        "serde",

     

       1811
        
        "serde_html_form",

     
···

       1855
        
       ]

     

       1856
        
       

     

       1857
        
       [[package]]

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       1858
        
       name = "jacquard-derive"

     

       1859
        
       version = "0.5.0"

     

       1860
        
       dependencies = [

     

       1861
        
        "heck 0.5.0",

     

       1862
        
        "itertools",

     

       1863
       -
        "jacquard-common",

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       1864
        
        "prettyplease",

     

       1865
        
        "proc-macro2",

     

       1866
        
        "quote",

     
···

       1880
        
        "bytes",

     

       1881
        
        "hickory-resolver",

     

       1882
        
        "http",

     

       1883
       -
        "jacquard-api",

     

       1884
       -
        "jacquard-common",

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       1885
        
        "miette",

     

       1886
        
        "percent-encoding",

     

       1887
        
        "reqwest",

     
···

       1903
        
        "glob",

     

       1904
        
        "heck 0.5.0",

     

       1905
        
        "itertools",

     

       1906
       -
        "jacquard-api",

     

       1907
       -
        "jacquard-common",

     

       1908
       -
        "jacquard-identity",

     

       1909
        
        "kdl",

     

       1910
        
        "miette",

     

       1911
        
        "prettyplease",

     
···

       1934
        
        "dashmap",

     

       1935
        
        "elliptic-curve",

     

       1936
        
        "http",

     

       1937
       -
        "jacquard-common",

     

       1938
       -
        "jacquard-identity",

     

       1939
        
        "jose-jwa",

     

       1940
        
        "jose-jwk",

     

       1941
        
        "miette",

···

       1761
        
        "bytes",

     

       1762
        
        "clap",

     

       1763
        
        "http",

     

       1764
       +
        "jacquard-api 0.4.1",

     

       1765
       +
        "jacquard-common 0.5.0",

     

       1766
       +
        "jacquard-derive 0.5.0",

     

       1767
       +
        "jacquard-identity 0.4.1",

     

       1768
        
        "jacquard-oauth",

     

       1769
        
        "jose-jwk",

     

       1770
        
        "miette",

     
···

       1789
        
       dependencies = [

     

       1790
        
        "bon",

     

       1791
        
        "bytes",

     

       1792
       +
        "jacquard-common 0.5.0",

     

       1793
       +
        "jacquard-derive 0.5.0",

     

       1794
       +
        "miette",

     

       1795
       +
        "serde",

     

       1796
       +
        "thiserror 2.0.17",

     

       1797
       +
       ]

     

       1798
       +
       

     

       1799
       +
       [[package]]

     

       1800
       +
       name = "jacquard-api"

     

       1801
       +
       version = "0.4.1"

     

       1802
       +
       source = "git+https://tangled.org/@nonbinary.computer/jacquard#8c229615c802488f3310f1cb35e7b79683289893"

     

       1803
       +
       dependencies = [

     

       1804
       +
        "bon",

     

       1805
       +
        "bytes",

     

       1806
       +
        "jacquard-common 0.5.0 (git+https://tangled.org/@nonbinary.computer/jacquard)",

     

       1807
       +
        "jacquard-derive 0.5.0 (git+https://tangled.org/@nonbinary.computer/jacquard)",

     

       1808
        
        "miette",

     

       1809
        
        "serde",

     

       1810
        
        "thiserror 2.0.17",

     
···

       1819
        
        "axum-test",

     

       1820
        
        "bytes",

     

       1821
        
        "jacquard",

     

       1822
       +
        "jacquard-common 0.5.0",

     

       1823
        
        "miette",

     

       1824
        
        "serde",

     

       1825
        
        "serde_html_form",

     
···

       1869
        
       ]

     

       1870
        
       

     

       1871
        
       [[package]]

     

       1872
       +
       name = "jacquard-common"

     

       1873
       +
       version = "0.5.0"

     

       1874
       +
       source = "git+https://tangled.org/@nonbinary.computer/jacquard#8c229615c802488f3310f1cb35e7b79683289893"

     

       1875
       +
       dependencies = [

     

       1876
       +
        "async-trait",

     

       1877
       +
        "base64 0.22.1",

     

       1878
       +
        "bon",

     

       1879
       +
        "bytes",

     

       1880
       +
        "chrono",

     

       1881
       +
        "cid",

     

       1882
       +
        "http",

     

       1883
       +
        "ipld-core",

     

       1884
       +
        "langtag",

     

       1885
       +
        "miette",

     

       1886
       +
        "multibase",

     

       1887
       +
        "multihash",

     

       1888
       +
        "ouroboros",

     

       1889
       +
        "rand 0.9.2",

     

       1890
       +
        "regex",

     

       1891
       +
        "reqwest",

     

       1892
       +
        "serde",

     

       1893
       +
        "serde_html_form",

     

       1894
       +
        "serde_ipld_dagcbor",

     

       1895
       +
        "serde_json",

     

       1896
       +
        "serde_with",

     

       1897
       +
        "smol_str",

     

       1898
       +
        "thiserror 2.0.17",

     

       1899
       +
        "tokio",

     

       1900
       +
        "trait-variant",

     

       1901
       +
        "url",

     

       1902
       +
       ]

     

       1903
       +
       

     

       1904
       +
       [[package]]

     

       1905
        
       name = "jacquard-derive"

     

       1906
        
       version = "0.5.0"

     

       1907
        
       dependencies = [

     

       1908
        
        "heck 0.5.0",

     

       1909
        
        "itertools",

     

       1910
       +
        "jacquard-common 0.5.0",

     

       1911
       +
        "prettyplease",

     

       1912
       +
        "proc-macro2",

     

       1913
       +
        "quote",

     

       1914
       +
        "serde",

     

       1915
       +
        "serde_json",

     

       1916
       +
        "serde_repr",

     

       1917
       +
        "serde_with",

     

       1918
       +
        "syn 2.0.106",

     

       1919
       +
       ]

     

       1920
       +
       

     

       1921
       +
       [[package]]

     

       1922
       +
       name = "jacquard-derive"

     

       1923
       +
       version = "0.5.0"

     

       1924
       +
       source = "git+https://tangled.org/@nonbinary.computer/jacquard#8c229615c802488f3310f1cb35e7b79683289893"

     

       1925
       +
       dependencies = [

     

       1926
       +
        "heck 0.5.0",

     

       1927
       +
        "itertools",

     

       1928
        
        "prettyplease",

     

       1929
        
        "proc-macro2",

     

       1930
        
        "quote",

     
···

       1944
        
        "bytes",

     

       1945
        
        "hickory-resolver",

     

       1946
        
        "http",

     

       1947
       +
        "jacquard-api 0.4.1",

     

       1948
       +
        "jacquard-common 0.5.0",

     

       1949
       +
        "miette",

     

       1950
       +
        "percent-encoding",

     

       1951
       +
        "reqwest",

     

       1952
       +
        "serde",

     

       1953
       +
        "serde_html_form",

     

       1954
       +
        "serde_json",

     

       1955
       +
        "thiserror 2.0.17",

     

       1956
       +
        "tokio",

     

       1957
       +
        "url",

     

       1958
       +
        "urlencoding",

     

       1959
       +
       ]

     

       1960
       +
       

     

       1961
       +
       [[package]]

     

       1962
       +
       name = "jacquard-identity"

     

       1963
       +
       version = "0.4.1"

     

       1964
       +
       source = "git+https://tangled.org/@nonbinary.computer/jacquard#8c229615c802488f3310f1cb35e7b79683289893"

     

       1965
       +
       dependencies = [

     

       1966
       +
        "async-trait",

     

       1967
       +
        "bon",

     

       1968
       +
        "bytes",

     

       1969
       +
        "http",

     

       1970
       +
        "jacquard-api 0.4.1 (git+https://tangled.org/@nonbinary.computer/jacquard)",

     

       1971
       +
        "jacquard-common 0.5.0 (git+https://tangled.org/@nonbinary.computer/jacquard)",

     

       1972
        
        "miette",

     

       1973
        
        "percent-encoding",

     

       1974
        
        "reqwest",

     
···

       1990
        
        "glob",

     

       1991
        
        "heck 0.5.0",

     

       1992
        
        "itertools",

     

       1993
       +
        "jacquard-api 0.4.1 (git+https://tangled.org/@nonbinary.computer/jacquard)",

     

       1994
       +
        "jacquard-common 0.5.0 (git+https://tangled.org/@nonbinary.computer/jacquard)",

     

       1995
       +
        "jacquard-identity 0.4.1 (git+https://tangled.org/@nonbinary.computer/jacquard)",

     

       1996
        
        "kdl",

     

       1997
        
        "miette",

     

       1998
        
        "prettyplease",

     
···

       2021
        
        "dashmap",

     

       2022
        
        "elliptic-curve",

     

       2023
        
        "http",

     

       2024
       +
        "jacquard-common 0.5.0",

     

       2025
       +
        "jacquard-identity 0.4.1",

     

       2026
        
        "jose-jwa",

     

       2027
        
        "jose-jwk",

     

       2028
        
        "miette",

+20 -12

README.md

···

       0
        
       
     

       0
        
       
     

       1
        
       # Jacquard

     

       2
        
       

     

       3
       -
       A suite of Rust crates for the AT Protocol. [Docs](https://docs.rs/jacquard/latest/jacquard/)

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       4
        
       

     

       5
        
       ## Goals and Features

     

       6
        
       

     
···

       8
        
       - Batteries-included, but easily replaceable batteries.

     

       9
        
          - Easy to extend with custom lexicons using code generation or handwritten api types

     

       10
        
          - Straightforward OAuth

     

       11
       -
          - stateless options (or options where you handle the state) for rolling your own

     

       12
       -
          - all the building blocks of the convenient abstractions are available

     

       13
       -
       - lexicon Value type for working with unknown atproto data (dag-cbor or json)

     

       14
       -
       - order of magnitude less boilerplate than some existing crates

     

       15
       -
       - use as much or as little from the crates as you need

     

       0
        
       
     

       0
        
       
     

       16
        
       

     

       17
        
       ## Example

     

       18
        
       

     
···

       75
        
       

     

       76
        
       ## Component crates

     

       77
        
       

     

       78
       -
       Jacquard is broken up into several crates for modularity. The correct one to use is generally `jacquard` itself, as it re-exports the others.

     

       79
        
       - `jacquard`: Main crate [![Crates.io](https://img.shields.io/crates/v/jacquard.svg)](https://crates.io/crates/jacquard) [![Documentation](https://docs.rs/jacquard/badge.svg)](https://docs.rs/jacquard)

     

       80
        
       - `jacquard-common`: Foundation crate [![Crates.io](https://img.shields.io/crates/v/jacquard-common.svg)](https://crates.io/crates/jacquard-common) [![Documentation](https://docs.rs/jacquard-common/badge.svg)](https://docs.rs/jacquard-common)

     

       81
       -
       - `jacquard-api`: Autogenerated API bindings [![Crates.io](https://img.shields.io/crates/v/jacquard-api.svg)](https://crates.io/crates/jacquard-api) [![Documentation](https://docs.rs/jacquard-api/badge.svg)](https://docs.rs/jacquard-api)

     

       82
        
       - `jacquard-axum`: Axum extractor and other helpers [![Crates.io](https://img.shields.io/crates/v/jacquard-axum.svg)](https://crates.io/crates/jacquard-axum) [![Documentation](https://docs.rs/jacquard-axum/badge.svg)](https://docs.rs/jacquard-axum)

     

       0
        
       
     

       83
        
       - `jacquard-oauth`: atproto OAuth implementation [![Crates.io](https://img.shields.io/crates/v/jacquard-oauth.svg)](https://crates.io/crates/jacquard-oauth) [![Documentation](https://docs.rs/jacquard-oauth/badge.svg)](https://docs.rs/jacquard-oauth)

     

       84
        
       - `jacquard-identity`: Identity resolution [![Crates.io](https://img.shields.io/crates/v/jacquard-identity.svg)](https://crates.io/crates/jacquard-identity) [![Documentation](https://docs.rs/jacquard-identity/badge.svg)](https://docs.rs/jacquard-identity)

     

       85
        
       - `jacquard-lexicon`: Lexicon parsing and code generation [![Crates.io](https://img.shields.io/crates/v/jacquard-lexicon.svg)](https://crates.io/crates/jacquard-lexicon) [![Documentation](https://docs.rs/jacquard-lexicon/badge.svg)](https://docs.rs/jacquard-lexicon)

     
···

       91
        
       

     

       92
        
       Highlights:

     

       93
        
       

     

       94
       -
       - A ton of new lexicons included in `jacquard-api`

     

       95
       -
       - `jacquard-axum` Axum extractor and a number of improvements to lifetimes and (de)serialization required to make that work (thanks [@thoth.ptnote.dev](https://tangled.org/@thoth.ptnote.dev) for helping provide feedback and sample code to test against)

     

       96
       -
       - `from_data`, `from_raw_data`, `to_data`, and `to_raw_data` to serialize to and deserialize from the loosely typed value data formats (think `serde_json::from_value` and company). Particularly useful for second-stage deserialization of type "unknown" fields in lexicons, such as `PostView.record`.

     

       97
       -
       - better API code generation

     

       98
        
       

     

       99
        
       ## Development

     

       100

···

       1
       +
       [![Crates.io](https://img.shields.io/crates/v/jacquard.svg)](https://crates.io/crates/jacquard) [![Documentation](https://docs.rs/jacquard/badge.svg)](https://docs.rs/jacquard)

     

       2
       +
       

     

       3
        
       # Jacquard

     

       4
        
       

     

       5
       +
       A suite of Rust crates intended to make it much easier to get started with atproto development, without sacrificing flexibility or performance.

     

       6
       +
       

     

       7
       +
       [Jacquard is simpler](https://whtwnd.com/nonbinary.computer/3m33efvsylz2s) because it is designed in a way which makes things simple that almost every other atproto library seems to make difficult.

     

       8
       +
       

     

       9
       +
       It is also designed around zero-copy/borrowed deserialization: types like [`Post<'_>`](https://tangled.org/@nonbinary.computer/jacquard/blob/main/crates/jacquard-api/src/app_bsky/feed/post.rs) can borrow data (via the [`CowStr<'_>`](https://docs.rs/jacquard/latest/jacquard/cowstr/enum.CowStr.html) type and a host of other types built on top of it) directly from the response buffer instead of allocating owned copies. Owned versions are themselves mostly inlined or reference-counted pointers and are therefore still quite efficient. The `IntoStatic` trait (which is derivable) makes it easy to get an owned version and avoid worrying about lifetimes.

     

       10
        
       

     

       11
        
       ## Goals and Features

     

       12
        
       

     
···

       14
        
       - Batteries-included, but easily replaceable batteries.

     

       15
        
          - Easy to extend with custom lexicons using code generation or handwritten api types

     

       16
        
          - Straightforward OAuth

     

       17
       +
          - Stateless options (or options where you handle the state) for rolling your own

     

       18
       +
          - All the building blocks of the convenient abstractions are available

     

       19
       +
          - Server-side convenience features

     

       20
       +
       - Lexicon Data value type for working with unknown atproto data (dag-cbor or json)

     

       21
       +
       - An order of magnitude less boilerplate than some existing crates

     

       22
       +
       - Use as much or as little from the crates as you need

     

       23
       +
       

     

       24
        
       

     

       25
        
       ## Example

     

       26
        
       

     
···

       83
        
       

     

       84
        
       ## Component crates

     

       85
        
       

     

       86
       +
       Jacquard is broken up into several crates for modularity. The correct one to use is generally `jacquard` itself, as it re-exports most of the others.

     

       87
        
       - `jacquard`: Main crate [![Crates.io](https://img.shields.io/crates/v/jacquard.svg)](https://crates.io/crates/jacquard) [![Documentation](https://docs.rs/jacquard/badge.svg)](https://docs.rs/jacquard)

     

       88
        
       - `jacquard-common`: Foundation crate [![Crates.io](https://img.shields.io/crates/v/jacquard-common.svg)](https://crates.io/crates/jacquard-common) [![Documentation](https://docs.rs/jacquard-common/badge.svg)](https://docs.rs/jacquard-common)

     

       0
        
       
     

       89
        
       - `jacquard-axum`: Axum extractor and other helpers [![Crates.io](https://img.shields.io/crates/v/jacquard-axum.svg)](https://crates.io/crates/jacquard-axum) [![Documentation](https://docs.rs/jacquard-axum/badge.svg)](https://docs.rs/jacquard-axum)

     

       90
       +
       - `jacquard-api`: Autogenerated API bindings [![Crates.io](https://img.shields.io/crates/v/jacquard-api.svg)](https://crates.io/crates/jacquard-api) [![Documentation](https://docs.rs/jacquard-api/badge.svg)](https://docs.rs/jacquard-api)

     

       91
        
       - `jacquard-oauth`: atproto OAuth implementation [![Crates.io](https://img.shields.io/crates/v/jacquard-oauth.svg)](https://crates.io/crates/jacquard-oauth) [![Documentation](https://docs.rs/jacquard-oauth/badge.svg)](https://docs.rs/jacquard-oauth)

     

       92
        
       - `jacquard-identity`: Identity resolution [![Crates.io](https://img.shields.io/crates/v/jacquard-identity.svg)](https://crates.io/crates/jacquard-identity) [![Documentation](https://docs.rs/jacquard-identity/badge.svg)](https://docs.rs/jacquard-identity)

     

       93
        
       - `jacquard-lexicon`: Lexicon parsing and code generation [![Crates.io](https://img.shields.io/crates/v/jacquard-lexicon.svg)](https://crates.io/crates/jacquard-lexicon) [![Documentation](https://docs.rs/jacquard-lexicon/badge.svg)](https://docs.rs/jacquard-lexicon)

     
···

       99
        
       

     

       100
        
       Highlights:

     

       101
        
       

     

       102
       +
       - `AgentSessionExt` trait with a host of convenience methods for working with records and preferences

     

       103
       +
       - Improvements to the `Collection` trait, code generation, and addition of the `VecUpdate` trait to enable that

     

       104
       +
       - A bunch of examples, both in the docs and in the repository

     

       105
       +
       - More lexicons in the generated API bindings.

     

       106
        
       

     

       107
        
       ## Development

     

       108