icydb-core 0.184.23

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

//! Module: access
//! Responsibility: access-path contracts, canonicalization, validation, and lowering.
//! Does not own: predicate semantics or index storage internals.
//! Boundary: query planning produces access plans; executor consumes lowered forms.

pub(crate) mod canonical;
pub(in crate::db) mod execution_contract;
pub(crate) mod lowering;
mod model_only;
pub(crate) mod path;
pub(crate) mod plan;
pub(in crate::db) mod shape_facts;
#[cfg(test)]
mod tests;
pub(crate) mod validate;

// Canonical planner access surface.
pub(in crate::db) use canonical::normalize_access_plan_value;
pub(in crate::db) use path::{
    AccessPath, IndexBranchSetOrderedSuffix, IndexBranchSetSpec, MAX_INDEX_BRANCH_SET_VALUES,
    SemanticIndexAccessContract, SemanticIndexExpression, SemanticIndexKeyItemRef,
    SemanticIndexKeyItemsRef, SemanticIndexRangeSpec,
};
pub(in crate::db) use plan::AccessPlan;
pub(crate) use validate::AccessPlanError;
pub(in crate::db) use validate::validate_access_runtime_invariants_with_schema;
pub(in crate::db) use validate::validate_access_structure_model;

// Boundary-local access-shape fact helpers.
pub(in crate::db) use path::AccessPathKind;
pub(in crate::db) use shape_facts::{
    AccessShapeFacts, IndexShapeDetails, SinglePathAccessShapeFacts,
};

// Executor-facing access contract and lowering surface.
pub(in crate::db) use execution_contract::{
    ExecutableAccessNode, ExecutableAccessPlan, ExecutionPathPayload,
    summarize_executable_access_plan,
};
pub(in crate::db) use lowering::{
    LoweredAccess, LoweredAccessError, LoweredIndexPrefixSpec, LoweredIndexRangeSpec,
    LoweredIndexScanContract, LoweredKey, lower_access,
};
#[cfg(feature = "sql")]
pub(in crate::db) use lowering::{
    LoweredIndexPrefixCardinalitySpec, lower_exact_index_prefix_cardinality_specs_for_prefix_access,
};