icydb-core 0.144.13

IcyDB — A schema-first typed query engine and persistence runtime for Internet Computer canisters
Documentation 
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
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

//! Module: db::query::fluent::load::validation
//! Shares fluent load validation helpers for terminal field resolution and
//! paged-vs-non-paged mode checks.

use crate::{
    db::query::{
        fluent::load::FluentLoadQuery,
        intent::{IntentError, QueryError},
        plan::{
            FieldSlot, resolve_aggregate_target_field_slot, validate_fluent_non_paged_mode,
            validate_fluent_paged_mode,
        },
    },
    traits::EntityKind,
};

impl<E> FluentLoadQuery<'_, E>
where
    E: EntityKind,
{
    // Enforce non-paged intent readiness before resolving one terminal slot.
    // Terminal methods consume the resolved slot directly so execution and
    // explain helpers stay flat instead of nesting closures per field lane.
    pub(super) fn resolve_non_paged_slot(
        &self,
        field: impl AsRef<str>,
    ) -> Result<FieldSlot, QueryError> {
        self.ensure_non_paged_mode_ready()?;

        resolve_aggregate_target_field_slot(E::MODEL, field.as_ref())
    }

    pub(super) fn ensure_cursor_mode_ready(&self) -> Result<(), QueryError> {
        // Cursor-mode fluent queries only need the paged policy gate when a
        // continuation token is actually present on the request boundary.
        if self.cursor_token.is_some() {
            validate_fluent_paged_mode(
                self.query.has_grouping(),
                self.query.has_explicit_order(),
                self.query.load_spec(),
            )
            .map_err(IntentError::from)
            .map_err(QueryError::intent)?;
        }

        Ok(())
    }

    pub(super) fn ensure_paged_mode_ready(&self) -> Result<(), QueryError> {
        validate_fluent_paged_mode(
            self.query.has_grouping(),
            self.query.has_explicit_order(),
            self.query.load_spec(),
        )
        .map_err(IntentError::from)
        .map_err(QueryError::intent)
    }

    pub(super) fn ensure_non_paged_mode_ready(&self) -> Result<(), QueryError> {
        validate_fluent_non_paged_mode(self.cursor_token.is_some(), self.query.has_grouping())
            .map_err(IntentError::from)
            .map_err(QueryError::intent)
    }
}