Struct OutboxPageRequest 

pub struct OutboxPageRequest { /* private fields */ }

Input to one bounded study-scoped outbox-history read.

Implementations

impl OutboxPageRequest

pub const fn new(study: StudyId, max_records: usize, max_bytes: usize) -> Self

Creates a request with explicit positive record and byte limits.

Invalid bounds are retained in the value so callers can construct a request without a fallible builder; TrialLifecycleStorage rejects them with Error::ResourceLimit. Self::try_new is the validating constructor.

pub const fn defaults(study: StudyId) -> Self

Creates a request using the finite default page bounds.

pub fn try_new( study: StudyId, max_records: usize, max_bytes: usize, ) -> Result<Self>

Creates and validates a bounded request.

Errors

Returns Error::ResourceLimit when either bound is zero or uses the reserved usize::MAX sentinel.

pub const fn with_after(self, after: OutboxCursor) -> Self

Sets the continuation cursor for a later page.

pub const fn with_limits(self, max_records: usize, max_bytes: usize) -> Self

Replaces both page limits.

pub const fn with_max_records(self, max_records: usize) -> Self

Replaces the maximum number of records.

pub const fn with_max_bytes(self, max_bytes: usize) -> Self

Replaces the encoded-byte budget.

pub const fn study(&self) -> StudyId

The requested study.

pub const fn after(&self) -> Option<OutboxCursor>

The optional stateless continuation cursor.

pub const fn max_records(&self) -> usize

The maximum number of records to return.

pub const fn max_bytes(&self) -> usize

The encoded-byte budget for returned records.

pub fn validate(&self) -> Result<()>

Validates the positive local bounds.

Errors

Returns Error::ResourceLimit when either bound is zero or uses the reserved usize::MAX sentinel. Bounds must remain finite so backend checked arithmetic can account for them.

Trait Implementations

impl Clone for OutboxPageRequest

fn clone(&self) -> OutboxPageRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OutboxPageRequest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for OutboxPageRequest

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for OutboxPageRequest

impl PartialEq for OutboxPageRequest

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for OutboxPageRequest

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for OutboxPageRequest