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
64
65
//! Rust record types mirroring the `dev.idiolect.*` Lexicon family.
//!
//! This crate's types are **generated** from the canonical lexicon
//! json in `lexicons/dev/idiolect/*.json` by `idiolect-codegen`.
//! Per the hyperdeclarative principle (P2: records-not-registries),
//! the lexicons are the single source of truth; Rust, TypeScript,
//! and SQL views are derived from them.
//!
//! Do not edit the contents of [`generated`] by hand. Re-run
//! `cargo run -p idiolect-codegen` after changing any lexicon.
//!
//! # Appview quickstart
//!
//! Every record type implements [`Record`], so indexers, xrpc
//! handlers, and tests can be generic over `R: Record`:
//!
//! ```
//! use idiolect_records::{Encounter, Record};
//! fn describe<R: Record>() -> String {
//! format!("{} ({})", R::kind(), R::NSID)
//! }
//! assert_eq!(describe::<Encounter>(), "encounter (dev.idiolect.encounter)");
//! ```
//!
//! When the nsid is only known at runtime (e.g. firehose traffic),
//! use [`decode_record`] to decode into the [`AnyRecord`] variant:
//!
//! ```
//! use idiolect_records::{AnyRecord, decode_record, Record, Encounter};
//! let json: serde_json::Value = serde_json::from_str(r#"{
//! "lens": { "uri": "at://did:plc:x/dev.idiolect.lens/1" },
//! "sourceSchema": { "uri": "at://did:plc:x/dev.idiolect.schema/a" },
//! "use": { "action": "translate_source_to_target" },
//! "kind": "invocation-log",
//! "visibility": "public-detailed",
//! "occurredAt": "2026-04-19T00:00:00.000Z"
//! }"#).unwrap();
//! let rec = decode_record(Encounter::NSID, json).unwrap();
//! match rec {
//! AnyRecord::Encounter(_) => {}
//! _ => panic!("expected encounter"),
//! }
//! ```
//!
//! Fixtures for every record kind are exported from [`examples`] for
//! use in downstream tests without reinventing minimally-valid json.
// re-export every generated module at the crate root, plus each
// lexicon's main record type, so callers can write
// `idiolect_records::Encounter` instead of
// `idiolect_records::generated::encounter::Encounter`.
pub use ;
pub use ;