did-hosting-common 0.9.0

DID Hosting Common, Common methods and structs related to WebVH Content
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

//! First-class domain objects.
//!
//! Per `docs/multi-domain-spec.md` §3. Domains are runtime-managed
//! entities (not config-file static): an admin adds / disables /
//! re-points a domain via the management API or DIDComm and the
//! daemon picks the change up live. This module is the type surface;
//! CRUD + normalisation lives in T15.
//!
//! ## Storage layout
//!
//! `domains:{name}` — one `DomainEntry` per row in the `domains`
//! keyspace (`KS_DOMAINS`). `meta:default_domain` carries the
//! current default (single-key pointer). See
//! `super::store::keyspaces` for the const names.
//!
//! ## What's here vs. what's in `super::acl`
//!
//! `DomainScope` is the per-ACL-entry visibility rule (which domains
//! a caller's ACL entry is allowed to operate on). It conceptually
//! belongs to the ACL but is defined here because both the domain
//! module (when adding a new domain, we may want to validate ACL
//! references) and the ACL module need to see it; keeping the type
//! definition with the domain module avoids a cycle.

pub mod detect;
pub mod normalize;
pub mod safety;
pub mod scope;
pub mod seed;
pub mod store;
pub mod types;
pub mod wire;

pub use detect::{HostHeaders, parse_forwarded_host, parse_trusted_cidrs, resolve_request_host};
pub use normalize::normalize_domain_name;
pub use safety::{
    assert_acl_allows_host, assert_did_host_allowed,
    assert_did_host_allowed_when_domains_configured, assert_domain_active_for_resolution,
    assert_host_is_active_domain, assert_request_host_matches_did, assert_resolution_allowed,
    extract_did_host,
};
pub use scope::{DomainResolveError, DomainScope, resolve_request_domain};
pub use seed::{SeedOutcome, SeedTier, seed_domains_first_boot};
pub use store::{
    DISABLE_PURGE_REASON, create_domain, delete_domain_record, disable_domain, enable_domain,
    get_default_domain, get_domain, list_domains, set_default_domain, update_domain,
};
pub use types::{DomainBranding, DomainEntry, DomainQuota, DomainStatus, DomainUrlScheme};