Module dto

Module dto 

Source
Expand description

HTTP boundary DTO types for mesh-admin introspection.

These types own the HTTP JSON wire contract. Domain types (NodePayload, NodeProperties, FailureInfo) stay clean of HTTP serialization concerns; conversion happens at the boundary via From / TryFrom impls defined here.

§Invariants

  • HB-1 (typed-internal, string-external): NodeRef, ActorId, ProcId, and SystemTime are encoded as canonical strings in the DTO types.
  • HB-2 (round-trip): NodePayload → NodePayloadDto → NodePayload is lossless for values representable in the wire format. Timestamps are formatted at millisecond precision (humantime::format_rfc3339_millis), matching the established HTTP contract; sub-millisecond precision is truncated at the boundary.
  • HB-3 (schema-honesty): Schema/OpenAPI are generated from these DTO types, so the published schema reflects the actual wire format.

Structs§

FailureInfoDto
Structured failure information for failed actors.
NodePayloadDto
Uniform response for any node in the mesh topology.

Enums§

NodePropertiesDto
Node-specific metadata. Externally-tagged enum — the JSON key is the variant name (Root, Host, Proc, Actor, Error).