Struct RuntimeBridge 

pub struct RuntimeBridge { /* private fields */ }

A descriptor pool plus a Validator, built once from an embedded FileDescriptorSet and reused across validations.

Construct once — typically in a LazyLock static emitted by the code generator — and reuse: the inner Validator caches compiled evaluators across calls.

Implementations

impl RuntimeBridge

pub fn from_fds(fds: &[u8]) -> Self

Build a bridge from raw FileDescriptorSet bytes.

The bytes are edition-normalized (Edition 2023 → proto3, matching the runtime validator’s decode pool) before the pool and validator are constructed — mirroring the conformance executor’s suite setup. The same normalized bytes back both the decode pool and the validator’s extension resolution.

Panics

Panics if the descriptor set cannot be decoded. The bytes are embedded at build time by prost-protovalidate-build, so a failure indicates a generator bug rather than runtime input.

pub fn validate_wire( &self, full_name: &str, wire_bytes: &[u8], ) -> Result<(), Error>

Validate a wire-encoded message of type full_name against its buf.validate rules through the runtime Validator.

wire_bytes is the protobuf binary encoding of the message (e.g. from buffa::Message::encode_to_vec). The full Error is returned so callers that must distinguish Compilation/Runtime outcomes (conformance, diagnostics) can; the generated Validate impls collapse it to ValidationError via error_to_validation_error.

Errors

Returns Error::Validation for rule violations, or Error::Compilation / Error::Runtime when rule evaluation fails. Returns Error::Runtime if full_name is absent from the pool or the bytes fail to decode.