pub const OAS_CONTEXT: &str;

pub const DID_CONTEXT: &str;

pub const ED25519_CONTEXT: &str;

pub const OAS_VERSION: &str;

use oas_document::document::DocumentMetadata;

let meta = DocumentMetadata {
    created: "2026-01-15T00:00:00Z".to_string(),
    updated: None,
    version: None,
};

#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct DocumentMetadata {
/// ISO 8601 creation timestamp (required).

pub created: String,
/// ISO 8601 last update timestamp (optional).

#[serde(skip_serializing_if = "Option::is_none")]
pub updated: Option<String>,
/// Semantic version of this entity's definition (optional).

#[serde(skip_serializing_if = "Option::is_none")]
pub version: Option<String>
}

use oas_document::OasDocument;

let json = r#"{
  "@context": ["https://www.w3.org/ns/did/v1", "https://w3id.org/security/suites/ed25519-2020/v1", "https://openagent.id/ns/oas/v1"],
  "id": "did:oas:test:hmr:alice",
  "controller": "did:oas:test:hmr:alice",
  "verificationMethod": [{"id": "did:oas:test:hmr:alice#key-1", "type": "Ed25519VerificationKey2020", "controller": "did:oas:test:hmr:alice", "publicKeyMultibase": "zTest"}],
  "authentication": ["did:oas:test:hmr:alice#key-1"],
  "oasVersion": "1.0.0",
  "kind": "hmr",
  "conformanceLevel": "L1",
  "sequence": 1,
  "metadata": {"created": "2026-01-15T00:00:00Z"}
}"#;
let doc: OasDocument = serde_json::from_str(json).unwrap();
assert_eq!(doc.id, "did:oas:test:hmr:alice");

#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct OasDocument {
/// JSON-LD contexts. MUST include the OAS context.

#[serde(rename = "@context")]
pub context: Vec<String>,
/// The `did:oas` identifier.

pub id: String,
/// DID of the controlling entity.

pub controller: String,
/// At least one Ed25519VerificationKey2020.

pub verification_method: Vec<VerificationMethod>,
/// References to keys authorized for authentication.

pub authentication: Vec<String>,
/// References to keys authorized for assertions.

#[serde(default, skip_serializing_if = "Vec::is_empty")]
pub assertion_method: Vec<String>,
/// References to keys authorized for capability invocation.

#[serde(default, skip_serializing_if = "Vec::is_empty")]
pub capability_invocation: Vec<String>,
/// References to keys authorized for capability delegation.

#[serde(default, skip_serializing_if = "Vec::is_empty")]
pub capability_delegation: Vec<String>,
/// Service endpoints.

#[serde(default, skip_serializing_if = "Vec::is_empty")]
pub service: Vec<ServiceEndpoint>,
/// OAS specification version (currently `"1.0.0"`).

pub oas_version: String,
/// Entity kind from the taxonomy.

pub kind: String,
/// Human-readable name (max 256 chars).

#[serde(skip_serializing_if = "Option::is_none")]
pub name: Option<String>,
/// Human-readable description (max 4096 chars).

#[serde(skip_serializing_if = "Option::is_none")]
pub description: Option<String>,
/// Lineage information (required for L1+ non-root entities).

#[serde(skip_serializing_if = "Option::is_none")]
pub lineage: Option<LineageSection>,
/// Governance section (ENR entities only).

/// Tracks which MHR governs this enterprise identity, epoch, and transition history.

#[serde(skip_serializing_if = "Option::is_none")]
pub governance: Option<GovernanceSection>,
/// Conformance level: L0, L1, or L2.

pub conformance_level: ConformanceLevel,
/// Lifecycle status.

#[serde(skip_serializing_if = "Option::is_none")]
pub lifecycle_status: Option<LifecycleStatus>,
/// Monotonically increasing version counter (starting at 1).

pub sequence: u64,
/// Document metadata.

pub metadata: DocumentMetadata,
/// Document proof (Ed25519Signature2020).

#[serde(skip_serializing_if = "Option::is_none")]
pub proof: Option<DocumentProof>,
/// Whether this identity has been revoked.

#[serde(skip_serializing_if = "Option::is_none")]
pub revoked: Option<bool>,
/// Timestamp of revocation.

#[serde(skip_serializing_if = "Option::is_none")]
pub revoked_at: Option<String>,
// ── Extended Identity Sections (OAS §5.8–§5.16) ──────────────────
/// Profile / presentation data (§5.8): avatar, tagline, categories.

#[serde(default, skip_serializing_if = "Option::is_none")]
pub profile: Option<ProfileSection>,
/// Contact directory (§5.9): phones, emails, socials, websites.

#[serde(default, skip_serializing_if = "Option::is_none")]
pub contact: Option<ContactSection>,
/// Calendar & scheduling (§5.10): booking links, office hours.

#[serde(default, skip_serializing_if = "Option::is_none")]
pub calendar: Option<CalendarSection>,
/// Operational specification (§5.11): SLA, rate limits, formats.

#[serde(default, skip_serializing_if = "Option::is_none")]
pub operational: Option<OperationalSection>,
/// Pricing & economics (§5.12): cost model, billing, free tier.

#[serde(default, skip_serializing_if = "Option::is_none")]
pub pricing: Option<PricingSection>,
/// Interoperability (§5.13): protocols, API schemas, auth methods.

#[serde(default, skip_serializing_if = "Option::is_none")]
pub interoperability: Option<InteroperabilitySection>,
/// Reputation summary (§5.14): interactions, endorsements, uptime.

#[serde(default, skip_serializing_if = "Option::is_none")]
pub reputation: Option<ReputationSection>,
/// Compliance & jurisdiction (§5.15): certifications, policy URLs.

#[serde(default, skip_serializing_if = "Option::is_none")]
pub compliance: Option<ComplianceSection>,
/// Relationships & affiliations (§5.16): org structure, partnerships.

#[serde(default, skip_serializing_if = "Option::is_none")]
pub relationships: Option<RelationshipsSection>
}

pub fn default_context() -> Vec<String>;

pub fn is_root(&self) -> bool;

pub fn is_revoked(&self) -> bool;

pub fn canonical_digest(&self) -> Result<String, DocumentError>;

pub fn primary_public_key_multibase(&self) -> Option<&str>;

pub fn find_verification_method(&self, id_or_fragment: &str) -> Option<&VerificationMethod>;