Struct RouteDecision 

pub struct RouteDecision {
    pub target: Target,
    pub upstream_protocol: Protocol,
    pub header_ops: Vec<HeaderOp>,
    pub body_transform: BodyTransform,
    pub epoch: Epoch,
}

The routing decision: the single destination plus the transforms to apply.

In v1 exactly one Target is resolved, no synchronous fan-out (ADR-002). The Epoch is the placement-table generation the decision was derived from; it is stamped onto the write so the sink can reject a stale-epoch write during a migration (docs/06 §2).

Read-path concerns are derived, not separate fields: the mandatory partition query filter and the response field-strip are both computed from BodyTransform (the injected PartitionId field is the isolation key, see osproxy-engine’s read module), and cursor (scroll/PIT) affinity is handled by the engine’s cursor signer on those endpoints. Deriving them from the same body_transform that drives the write-path inject is what keeps the two provably inverse (docs/02, round-trip property test in docs/09).

Examples

use osproxy_spi::{RouteDecision, BodyTransform, Protocol};
use osproxy_spi::core::{Target, ClusterId, IndexName, Epoch};

let target = Target::new(ClusterId::from("eu-1"), IndexName::from("orders"));
let decision = RouteDecision::passthrough(target, Protocol::Http1, Epoch::new(1));
assert!(decision.body_transform.is_none());
assert_eq!(decision.epoch, Epoch::new(1));

Fields

target: Target

The single physical destination.

upstream_protocol: Protocol

The protocol to use upstream (may differ from ingress).

header_ops: Vec<HeaderOp>

Header mutations to apply before forwarding.

body_transform: BodyTransform

The body transform to apply.

epoch: Epoch

The placement epoch this decision was derived from.

Implementations

impl RouteDecision

pub fn passthrough( target: Target, upstream_protocol: Protocol, epoch: Epoch, ) -> Self

Constructs a decision with no header ops and no body transform.

pub fn with_body_transform(self, transform: BodyTransform) -> Self

Sets the body transform (builder style).

Trait Implementations

impl Clone for RouteDecision

fn clone(&self) -> RouteDecision

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RouteDecision

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for RouteDecision

impl PartialEq for RouteDecision

fn eq(&self, other: &RouteDecision) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for RouteDecision