rullst-core 12.3.0

//! Rullst Core Library
#![allow(
    clippy::collapsible_if,
    clippy::unnecessary_map_or,
    clippy::redundant_async_block
)]
#![deny(clippy::unwrap_used, clippy::expect_used)]
#![warn(missing_docs)]
extern crate self as rullst;

/// Rullst application and server configuration models.
pub mod config;
pub mod db;
pub mod edge;

#[cfg(all(not(target_arch = "wasm32"), feature = "orm"))]
/// Artisan command-line migrations and seed execution helpers.
pub mod artisan;
#[cfg(not(target_arch = "wasm32"))]
pub mod cache;
/// Edge client components rendering module.
pub mod client;
/// Portable, versioned wire contract shared by web and platform clients.
pub mod client_contract;
#[cfg(not(target_arch = "wasm32"))]
/// Agentic DevOps Engine & Infrastructure Tuning (Milestone 20).
pub mod devops;
#[cfg(not(target_arch = "wasm32"))]
/// Type-indexed dependency injection container.
pub mod di;
#[cfg(not(target_arch = "wasm32"))]
mod error_buffer;
#[cfg(not(target_arch = "wasm32"))]
/// HTML visual logging and runtime console for development mode.
pub mod error_console;
#[cfg(not(target_arch = "wasm32"))]
/// Feature flagging management and drivers.
pub mod feature;
#[cfg(not(target_arch = "wasm32"))]
/// Hybrid Frontend SSR Adapters (Leptos, Dioxus, HTMX).
pub mod frontend;
#[cfg(not(target_arch = "wasm32"))]
/// Kubernetes and Cloud-Native Health Probes.
pub mod health;
#[cfg(not(target_arch = "wasm32"))]
/// Fast compile-time HTML rendering utilities.
pub mod html;
#[cfg(not(target_arch = "wasm32"))]
/// HTMX helpers for rapid reactive UI design.
pub mod htmx;
#[cfg(not(target_arch = "wasm32"))]
/// Process readiness and graceful request-drain coordination.
pub mod lifecycle;
#[cfg(not(target_arch = "wasm32"))]
/// Live state synchronization and server-push connection handlers.
pub mod live;
#[cfg(not(target_arch = "wasm32"))]
/// Multitenancy request routing and tenant state isolation layers.
pub mod multitenant;
#[cfg(all(not(target_arch = "wasm32"), feature = "offline-sync"))]
/// Encrypted, bounded offline synchronization foundations for platform clients.
pub mod offline_sync;
#[cfg(not(target_arch = "wasm32"))]
/// Canonical production middleware ordering contract.
pub mod production;
#[cfg(not(target_arch = "wasm32"))]
pub mod queue;
#[cfg(not(target_arch = "wasm32"))]
/// Rullst Radar Kernel-Level Telemetry & Tokio runtime visualizer.
pub mod radar;
#[cfg(not(target_arch = "wasm32"))]
/// Native Real-Time Engine (Channels, Broadcast, Presence).
pub mod realtime;
#[cfg(all(
    not(target_arch = "wasm32"),
    any(feature = "cache-redis", feature = "queue-redis")
))]
mod redis_connection;
#[cfg(not(target_arch = "wasm32"))]
/// Network and service resilience (rate limits, traffic shield, load shedding).
pub mod resilience;
#[cfg(not(target_arch = "wasm32"))]
/// High-performance application routers built on Axum.
pub mod routing;
/// Typed, versioned browser-to-server function transport.
pub mod rpc;
#[cfg(not(target_arch = "wasm32"))]
/// Interactive Scalar API documentation UI.
pub mod scalar;
#[cfg(not(target_arch = "wasm32"))]
pub mod scheduler;
#[cfg(not(target_arch = "wasm32"))]
/// CSRF tokens, CORS, and response headers security policies.
pub mod security;
#[cfg(not(target_arch = "wasm32"))]
/// Rullst HTTP web server core engine.
pub mod server;
#[cfg(not(target_arch = "wasm32"))]
/// File and cloud storage abstraction layer.
pub mod storage;
#[cfg(not(target_arch = "wasm32"))]
/// Rullst OpenTelemetry and Tracing.
pub mod telemetry;
#[cfg(not(target_arch = "wasm32"))]
/// Distributed Tracing Spans Collector.
pub mod telemetry_spans;
#[cfg(not(target_arch = "wasm32"))]
/// Scaffolding tools for robust integration testing.
pub mod testing;
#[cfg(not(target_arch = "wasm32"))]
pub mod uploads;
#[cfg(not(target_arch = "wasm32"))]
/// Strongly-typed request validation extractors.
pub mod validation;
#[cfg(not(target_arch = "wasm32"))]
/// WebSocket live connection and messaging system.
pub mod ws;

#[cfg(all(not(target_arch = "wasm32"), feature = "orm"))]
#[macro_export]
/// Standard migration and seeding bootstrap macro for Rullst.
macro_rules! artisan {
    ($migrations:expr) => {
        let _ = $crate::artisan::check_and_run_artisan($migrations, vec![]).await;
    };
    ($migrations:expr, $seeders:expr) => {
        let _ = $crate::artisan::check_and_run_artisan($migrations, $seeders).await;
    };
}

// Re-export procedural macros
pub use rullst_macros::{
    html, island, live_component, live_event, memoize, route, server_function,
};

// Re-export core structs for public consumption
#[cfg(not(target_arch = "wasm32"))]
pub use routing::Router;

#[cfg(not(target_arch = "wasm32"))]
pub use server::{Server, ServerError};

// Re-export rullst-orm for applications using the ORM feature.
#[cfg(all(not(target_arch = "wasm32"), feature = "orm"))]
pub use rullst_orm::{Orm, RullstModel};

// Re-export Configuration types
pub use config::{AppConfig, DatabaseConfig, RullstConfig, SecurityConfig};

// Re-export HTTP primitives for convenience
#[cfg(not(target_arch = "wasm32"))]
pub use axum::http;

// Re-export axum response types for convenience
#[cfg(not(target_arch = "wasm32"))]
/// Standard HTTP response types and helpers.
pub mod response {
    pub use axum::response::{Html, IntoResponse, Redirect, Response};
}

// Re-export HTMX primitives for convenience
#[cfg(not(target_arch = "wasm32"))]
pub use htmx::{HtmxRequest, HtmxResponse, render_page};
#[cfg(not(target_arch = "wasm32"))]
pub use lifecycle::{
    ApplicationLifecycle, ApplicationLifecycleError, ApplicationPhase, ReadinessSnapshot,
    apply_lifecycle,
};

// Re-export Milestone 5: Production Utilities
#[cfg(not(target_arch = "wasm32"))]
pub use cache::{Cache, TenantCache};
#[cfg(not(target_arch = "wasm32"))]
pub use di::{Container, DiError, Inject, Injectable};
#[cfg(not(target_arch = "wasm32"))]
pub use queue::{Queue, QueuedJobDetail, Worker, WorkerHandle};
#[cfg(not(target_arch = "wasm32"))]
pub use realtime::{
    BroadcastManager, Channel, RealtimeError, RealtimeMessage, TenantPresence, TenantRealtime,
};
#[cfg(not(target_arch = "wasm32"))]
pub use scheduler::{Scheduler, SchedulerError, SchedulerFailurePolicy, SchedulerHandle};

// Re-export Milestone 6: Enterprise Features
#[cfg(not(target_arch = "wasm32"))]
pub use storage::{LocalDriver, Storage, StorageDriver, StorageError, TenantStorage};
#[cfg(not(target_arch = "wasm32"))]
pub use uploads::{
    OfflineMockScanner, QuarantinedUpload, ReleasedUpload, ScanVerdict, UploadError, UploadKind,
    UploadPolicy, UploadScanner,
};
#[cfg(not(target_arch = "wasm32"))]
pub use validation::{Validate, ValidatedForm, ValidatedJson, ValidationError};
#[cfg(not(target_arch = "wasm32"))]
pub use ws::{WebSocket, WsError};

// Re-export Milestone 6 Resilience Features
#[cfg(not(target_arch = "wasm32"))]
pub use production::{
    AcademyBoundaryAssessment, AcademyCheckStatus, AcademyPresetError, AcademyProductionPreset,
    AcademyProductionRequirement, ProductionMiddlewareStage, ProductionPreset,
};
#[cfg(not(target_arch = "wasm32"))]
pub use resilience::{
    RateLimitConfig, RateLimiter, TrafficShield, TrafficShieldConfig, TrafficShieldError,
    backpressure_middleware, rate_limit_middleware,
};
#[cfg(not(target_arch = "wasm32"))]
pub use security::{SecurityBaselineError, apply_security_baseline};

#[cfg(not(target_arch = "wasm32"))]
pub use async_trait::async_trait;
#[cfg(all(not(target_arch = "wasm32"), feature = "orm"))]
pub use feature::DbFeatureDriver;
#[cfg(not(target_arch = "wasm32"))]
pub use feature::{
    EnvFeatureDriver, FeatureDriver, FeatureManager, MemoryFeatureDriver, TomlFeatureDriver,
};
#[cfg(not(target_arch = "wasm32"))]
pub use multitenant::{TenantConfig, TenantLayer, TenantService, TenantStrategy, tenant_layer};

#[cfg(not(target_arch = "wasm32"))]
pub use testing::{TestApp, TestRequestBuilder, TestResponse};

// ─────────── Dependency Shielding cascades (Roadmap Milestone 8) ────────────────────

#[cfg(not(target_arch = "wasm32"))]
/// Internal asynchronous runtime wrappers.
pub mod runtime {
    pub use async_trait::async_trait;
    pub use tokio::{main, spawn, task, time};
}

/// Web server engine re-exports (Axum, Tower, Tower-HTTP).
pub mod web {
    #[cfg(not(target_arch = "wasm32"))]
    pub use axum;
    #[cfg(not(target_arch = "wasm32"))]
    pub use tower;
    #[cfg(not(target_arch = "wasm32"))]
    pub use tower_http;
}

/// Re-exported underlying asynchronous engine (Tokio).
pub mod async_runtime {
    #[cfg(not(target_arch = "wasm32"))]
    pub use tokio;
}