aeo-graph-explorer 0.1.1

//! Serde-friendly view of an AEO doc.
//!
//! We don't pull in `aeo-sdk-rust` because that would force callers into a
//! specific spec version. Instead we accept "anything that has `entity.id`
//! and `claims`" and treat unknown fields as opaque — the JSONL is whatever
//! the upstream crawler emitted.

use std::collections::HashMap;

use serde::{Deserialize, Serialize};
use serde_json::Value;

/// One ingested AEO node — the JSONL line stored verbatim, plus a denormalised
/// `entity` so the query API doesn't have to peek inside `body` every time.
#[derive(Clone, Debug, Deserialize, Serialize, PartialEq, Eq)]
pub struct AeoNode {
    /// Stable entity identifier — typically the canonical entity URL.
    pub id: String,
    /// Lightweight summary used by `/nodes` so list responses don't carry the
    /// whole body.
    pub entity: AeoEntity,
    /// Full AEO doc (whatever the crawler captured). Returned by
    /// `/nodes/{id}`.
    #[serde(default)]
    pub body: HashMap<String, Value>,
}

/// Denormalised view of the most-asked-about fields.
#[derive(Clone, Debug, Deserialize, Serialize, PartialEq, Eq)]
pub struct AeoEntity {
    /// The same identifier as `AeoNode.id`. Kept here for consumers who only
    /// receive the summary.
    pub id: String,
    /// `Organization`, `Person`, `Product`, ...
    #[serde(default)]
    pub kind: Option<String>,
    /// Human-readable name.
    #[serde(default)]
    pub name: Option<String>,
    /// Where the entity says its truth-source lives.
    #[serde(default)]
    pub canonical_url: Option<String>,
}

/// One assertion the entity makes about itself.
#[derive(Clone, Debug, Deserialize, Serialize, PartialEq, Eq)]
pub struct AeoClaim {
    /// Stable identifier for the claim (used for round-tripping).
    pub id: String,
    /// The predicate / type — e.g. `description`, `industry`, `headquartered_in`.
    pub predicate: String,
    /// The claim's value — a string in the common case, but kept as JSON for
    /// flexibility.
    pub value: Value,
    /// Self-reported confidence (`"high"`, `"medium"`, `"low"`).
    #[serde(default)]
    pub confidence: Option<String>,
}