sz-rust-orm-facade 0.6.3

//! ORM Facade — 统一访问 sz-orm 全家桶
//!
//! ## 设计目标
//!
//! 减少 `sz-rust-addons-operate`、`sz-rust-sz300` 等业务包对 `sz-orm-*` 子包的穿透依赖。
//! 业务包应通过 `sz_rust_orm_facade::*` 访问 ORM 功能，而非直接依赖 `sz-orm-core`、
//! `sz-orm-auth`、`sz-orm-mqtt`、`sz-orm-scheduler`、`sz-orm-logger`。
//!
//! ## 使用示例
//!
//! ```ignore
//! // 业务包统一通过 facade 访问（推荐）
//! use sz_rust_orm_facade::{Pool, Value, Model, ModelExt, Authorizer, JwtAuthenticator, MqttConfig, QoS};
//! use sz_rust_orm_facade::repository::{Repository, WhereCondition, WhereOp};
//! use sz_rust_orm_facade::scheduler::{CronScheduler, JobHandler, ScheduledTask, Scheduler};
//! ```

// ============================================================================
// sz-orm-core：连接池 + 模型 trait + 值类型 + 仓储层 + 错误类型 + 迁移系统
// ============================================================================
pub use sz_orm_core::{
    value_to_json,
    BelongsTo,
    BelongsToMany,
    Cache,
    CacheError,
    Connection,
    ConnectionFactory,
    DbError,
    DbType,
    HasMany,
    HasOne,
    MemoryCache,
    Model,
    ModelExt,
    MorphMany,
    MorphTo,
    Pool,
    PoolConfig,
    PoolConfigBuilder,
    PoolError,
    Relation,
    RelationAccess,
    RelationError,
    RelationLoader,
    TimestampFields,
    Value,
    // NOTE: WithRelation intentionally NOT re-exported at facade root — it is
    // exported by both sz_orm_model and sz_orm_query via glob re-exports in
    // sz-orm-core, which is ambiguous under Rust 1.96+'s deny(ambiguous_glob_imports).
    // Use `crate::find_with_related::WithRelation` instead.
};

// MultiLevelCache is publicly re-exported at the sz_orm_core crate root via `pub use cache::*`
pub use sz_orm_core::MultiLevelCache;

/// 仓储子模块（Repository trait + WhereCondition/WhereOp 条件构造）
///
/// 业务层应通过 `sz_rust_orm_facade::repository::{Repository, WhereCondition, WhereOp}` 访问，
/// 而非直接依赖 `sz_orm_core::repository`，以保持 facade 收口。
pub mod repository {
    pub use sz_orm_core::repository::{
        BatchUpdateResult, EntityAttributes, EntityKey, GenericKeyRepository, InMemoryRepository,
        PageResult, Repository, RepositoryError, RepositoryResult, WhereCondition, WhereOp,
    };
}

/// 迁移子模块（schema migration）
///
/// 业务层应通过 `sz_rust_orm_facade::migration::*` 访问，
/// 而非直接依赖 `sz_orm_core::migration`。
pub mod migration {
    pub use sz_orm_core::migration::{
        FileMigrationResolver, Migration, MigrationContext, MigrationResolver, Migrator,
    };
}

// ============================================================================
// sz-orm-auth：认证 + 授权
// ============================================================================
pub use sz_orm_auth::{Authorizer, JwtAuthenticator, RbacAuthorizer};

/// 认证子模块（Credentials / User / Claims 等数据结构）
///
/// 业务层应通过 `sz_rust_orm_facade::auth::{Credentials, User, Claims}` 访问，
/// 而非直接依赖 `sz_orm_auth::auth`。
pub mod auth {
    pub use sz_orm_auth::auth::{Claims, Credentials, User};
}

/// JWT 子模块（JwtEncoder / JwtClaims 等编码工具）
pub mod jwt {
    pub use sz_orm_auth::jwt::{JwtClaims, JwtEncoder};
}

// ============================================================================
// sz-orm-mqtt：MQTT 消息队列
// ============================================================================
pub use sz_orm_mqtt::{MqttConfig, MqttError, MqttMessage, MqttPlugin, MqttTopic, QoS};

// ============================================================================
// sz-orm-scheduler：定时任务调度器
// ============================================================================
/// 调度器子模块（CronScheduler / JobHandler / ScheduledTask 等）
///
/// 业务层应通过 `sz_rust_orm_facade::scheduler::*` 访问，
/// 而非直接依赖 `sz_orm_scheduler`。
pub mod scheduler {
    pub use sz_orm_scheduler::{
        CounterJobHandler, CronExpr, CronScheduler, JobHandler, RecordingJobHandler, ScheduledTask,
        Scheduler, SchedulerError,
    };
}

/// 调度器根级 re-export（供 core 内部 dogfood 使用）
pub use sz_orm_scheduler::{
    CronExpr, CronScheduler, JobHandler, RecordingJobHandler, ScheduledTask, Scheduler,
    SchedulerError,
};

// ============================================================================
// sz-orm-logger：日志适配器
// ============================================================================
/// 日志子模块（Logger / LogEntry / LogLevel 等）
///
/// 业务层应通过 `sz_rust_orm_facade::logger::*` 访问，
/// 而非直接依赖 `sz_orm_logger`。
pub mod logger {
    pub use sz_orm_logger::{
        LogEntry, LogLevel, Logger, LoggerFactory, Metrics, MetricsSnapshot, StructuredLogger,
    };
}

// ============================================================================
// sz-orm-query-builder：链式 SQL 构造器（sea-query 风格，独立于 Model）
// ============================================================================
pub use sz_orm_query_builder::{
    BuiltQuery, DeleteQuery, InsertQuery, Query, SelectQuery, UpdateQuery,
};

// ============================================================================
// sz-orm-macros：编译时 SQL 宏（sql_string! / query! 等）
// ============================================================================
pub use sz_orm_macros::{query, sql_string};

// ============================================================================
// sz-orm-core 补充子模块（core 内部 dogfood 所需）
// ============================================================================

/// Hooks 子模块（生命周期钩子）
///
/// 业务层应通过 `sz_rust_orm_facade::hooks::*` 访问，
/// 而非直接依赖 `sz_orm_core::hooks`。
pub mod hooks {
    pub use sz_orm_core::hooks::*;
}

/// L2 缓存子模块（二级缓存共享层）
///
/// 业务层应通过 `sz_rust_orm_facade::l2_cache::*` 访问，
/// 而非直接依赖 `sz_orm_core::l2_cache`。
pub mod l2_cache {
    pub use sz_orm_core::l2_cache::*;
}

/// 关联查询子模块（find_with_related  eager/join/subquery 策略）
///
/// 业务层应通过 `sz_rust_orm_facade::find_with_related::*` 访问，
/// 而非直接依赖 `sz_orm_core::find_with_related`。
pub mod find_with_related {
    pub use sz_orm_core::find_with_related::{
        find_with_related_eager_sql, find_with_related_join, find_with_related_subquery,
        inspect_relation, FindWithRelated, WithRelation, WithRelation as FindWithRelation,
    };
}

// ============================================================================
// sz-orm-limit：限流器（速率限制中间件依赖）
// ============================================================================
pub use sz_orm_limit::{
    DistributedRateLimiter, FixedWindowRateLimiter, InMemoryBackend, RateLimitError,
    RateLimitHeaders, RateLimitResponseStrategy, RateLimitResult, SlidingWindowRateLimiter,
    TokenBucketRateLimiter,
};

/// RateLimiter trait re-export（限流中间件核心 trait）
pub use sz_orm_limit::RateLimiter;

// ============================================================================
// sz-orm-tracing：分布式追踪（trace 中间件依赖）
// ============================================================================
pub use sz_orm_tracing::{
    Alert, AlertHook, AlertLevel, ErrorBudget, ErrorRateCounter, LatencyHistogram, LogAlertHook,
    OtelTracer, SaturationGauge, SlaMonitor, SlaReport, Span, SpanLog, SzTracer, Tracer,
    TracingError,
};

// ============================================================================
// sz-orm-queue：消息队列（runtime::queue 依赖）
// ============================================================================
pub use sz_orm_queue::{
    ActiveConfig, BackpressurePolicy, InMemoryQueue, KafkaConfig, Message, MessageQueue, MqError,
    MqProvider, NatsConfig, OverflowStrategy, PulsarConfig, QueueConfig,
};

// ============================================================================
// sz-orm-websocket：WebSocket 服务（runtime::websocket 依赖）
// ============================================================================
pub use sz_orm_websocket::{DefaultWebSocketHandler, WebSocketHandler, WsError, WsServer};

// ============================================================================
// sz-orm-storage：云存储驱动（upload/storage 依赖）
// ============================================================================
pub use sz_orm_storage::{
    AliyunOssStorage, HuaweiObsStorage, LocalStorage, QiniuKodoStorage, S3Storage, Storage,
    StorageBuilder, StorageConfig, StorageError, StorageProvider, StorageWrapper,
    TencentCosStorage, UpYunStorage,
};

// ============================================================================
// sz-orm-sql-validator：SQL 安全校验（SQL 注入防护）
// ============================================================================
pub use sz_orm_sql_validator::{
    detect_statement_type, validate, validate_column_name, validate_delete, validate_insert,
    validate_parameter_count, validate_select, validate_sql, validate_table_name, validate_update,
    ComplexityLevel, SqlComplexityScore, SqlStatementType, SqlToken, SqlValidationError,
    ValidationResult, WhitelistValidator,
};

// ============================================================================
// sz-orm-graphql — GraphQL 集成（可选 feature: graphql）
// ============================================================================
#[cfg(feature = "graphql")]
pub mod graphql;

// ============================================================================
// sz-orm-grpc — gRPC 支持（可选 feature: grpc）
// ============================================================================
#[cfg(feature = "grpc")]
pub mod grpc;

// ============================================================================
// 连接池配置调优（L2 方案：sqlx 配置调优，不修改 sz-orm 上游）
// ============================================================================
pub mod pool_config;
pub use pool_config::SqlxPoolConfig;

// ============================================================================
// P3 L3 连接池调优（PoolWarmer + QueryCache + PoolScaler）
// ============================================================================
pub mod pool_scaler;
pub mod pool_warmer;
pub mod query_cache;

pub use pool_scaler::{PoolMetrics, PoolScaler, PoolScalerConfig};
pub use pool_warmer::{PoolWarmer, WarmupError as PoolWarmupError};
pub use query_cache::{QueryCache, QueryCacheConfig, QueryCacheError};