Skip to main content

canic_core/api/
mod.rs

1//! Module: api
2//!
3//! Responsibility: public API facades for macro-generated canister endpoints.
4//! Does not own: orchestration, business logic, policy, or storage invariants.
5//! Boundary: maps endpoint calls into workflow/ops calls and public errors.
6
7pub mod auth;
8#[cfg(feature = "blob-storage")]
9pub mod blob_storage;
10pub mod cascade;
11pub mod config;
12pub mod error;
13pub mod ic;
14pub mod icp_refill;
15pub mod intent;
16pub mod lifecycle;
17pub mod memory;
18pub mod metadata;
19pub mod placement;
20pub mod pool;
21pub mod ready;
22pub mod rpc;
23pub mod runtime;
24pub mod state;
25pub mod timer;
26pub mod topology;
27
28///
29/// Read-only query re-exports
30///
31/// Only queries that satisfy ALL of the following may be re-exported directly:
32///
33/// - Read-only
34/// - No orchestration or side effects
35/// - No policy or invariant enforcement
36/// - No internal `InternalError` in public signatures
37/// - Return DTOs or primitives only
38///
39/// Queries that can fail with internal errors or enforce invariants
40/// MUST be wrapped in an API façade instead.
41///
42
43pub mod cycles {
44    pub use crate::workflow::runtime::cycles::query::CycleTrackerQuery;
45}
46pub mod env {
47    pub use crate::workflow::env::query::EnvQuery;
48}
49pub mod icrc {
50    pub use crate::workflow::icrc::query::{Icrc10Query, Icrc21Query};
51}
52pub mod log {
53    pub use crate::workflow::log::query::LogQuery;
54}
55pub mod metrics {
56    pub use crate::workflow::metrics::query::MetricsQuery;
57}