sz-orm-storage 1.2.2

//! # S3 Storage（**MOCK-ONLY，非生产可用**）
//!
//! ⚠️ **重要警告：本模块为内存 Mock 实现，未集成真实 AWS S3 SDK。**
//!
//! - 所有数据存储在进程内 `HashMap`，重启即丢失
//! - 不执行任何 HTTP 请求，不与真实 S3 服务交互
//! - 不支持认证、签名、TLS、分片上传等任何 S3 生产特性
//! - **请勿用于生产环境**——仅适用于单元测试与本地开发
//!
//! 如需真实 S3 集成，请使用 [`crate::s3_sdk::S3SdkStorage`]（基于 `aws-sdk-s3`），
//! 或基于 [`crate::storage::Storage`] trait 自行实现官方 SDK 接入。

use crate::error::StorageError;
use crate::storage::Storage;
use async_trait::async_trait;
use std::collections::HashMap;
use std::sync::Arc;
use tokio::sync::RwLock;

/// AWS S3 存储后端（**Mock 实现**）
///
/// ⚠️ 仅用于测试。所有数据存储在内存 `HashMap`，不与真实 S3 服务交互。
/// 如需生产使用，请使用 [`crate::s3_sdk::S3SdkStorage`]。
pub struct S3Storage {
    pub bucket: String,
    pub region: String,
    store: Arc<RwLock<HashMap<String, Vec<u8>>>>,
}

impl S3Storage {
    pub fn new(bucket: impl Into<String>, region: impl Into<String>) -> Self {
        Self {
            bucket: bucket.into(),
            region: region.into(),
            store: Arc::new(RwLock::new(HashMap::new())),
        }
    }

    pub fn url_for(&self, key: &str) -> String {
        format!("s3://{}.{}/{}", self.bucket, self.region, key)
    }
}

#[async_trait]
impl Storage for S3Storage {
    async fn put(
        &self,
        key: &str,
        data: &[u8],
        _content_type: &str,
    ) -> Result<String, StorageError> {
        let mut store = self.store.write().await;
        store.insert(key.to_string(), data.to_vec());
        Ok(self.url_for(key))
    }

    async fn get(&self, key: &str) -> Result<Vec<u8>, StorageError> {
        let store = self.store.read().await;
        store
            .get(key)
            .cloned()
            .ok_or_else(|| StorageError::NotFound(format!("s3://{}/{}", self.bucket, key)))
    }

    async fn delete(&self, key: &str) -> Result<(), StorageError> {
        let mut store = self.store.write().await;
        store.remove(key);
        Ok(())
    }

    async fn exists(&self, key: &str) -> Result<bool, StorageError> {
        let store = self.store.read().await;
        Ok(store.contains_key(key))
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[tokio::test]
    async fn test_s3_put_and_get() {
        let storage = S3Storage::new("my-bucket", "us-east-1");
        let url = storage
            .put("file.txt", b"hello s3", "text/plain")
            .await
            .unwrap();
        assert!(url.starts_with("s3://my-bucket.us-east-1/"));
        assert!(url.contains("file.txt"));

        let data = storage.get("file.txt").await.unwrap();
        assert_eq!(data, b"hello s3");
    }

    #[tokio::test]
    async fn test_s3_get_not_found() {
        let storage = S3Storage::new("bucket", "us-west-2");
        let result = storage.get("missing.txt").await;
        assert!(result.is_err());
        assert!(matches!(result.unwrap_err(), StorageError::NotFound(_)));
    }

    #[tokio::test]
    async fn test_s3_delete() {
        let storage = S3Storage::new("bucket", "us-east-1");
        storage.put("del.txt", b"data", "text/plain").await.unwrap();
        assert!(storage.exists("del.txt").await.unwrap());

        storage.delete("del.txt").await.unwrap();
        assert!(!storage.exists("del.txt").await.unwrap());
    }

    #[tokio::test]
    async fn test_s3_exists_false_for_missing() {
        let storage = S3Storage::new("bucket", "us-east-1");
        assert!(!storage.exists("nope").await.unwrap());
    }

    #[tokio::test]
    async fn test_s3_overwrite() {
        let storage = S3Storage::new("bucket", "us-east-1");
        storage.put("key", b"v1", "text/plain").await.unwrap();
        storage.put("key", b"v2", "text/plain").await.unwrap();
        let data = storage.get("key").await.unwrap();
        assert_eq!(data, b"v2");
    }

    #[tokio::test]
    async fn test_s3_multiple_keys() {
        let storage = S3Storage::new("bucket", "us-east-1");
        storage.put("a", b"a-data", "text/plain").await.unwrap();
        storage.put("b", b"b-data", "text/plain").await.unwrap();
        storage.put("c", b"c-data", "text/plain").await.unwrap();

        assert_eq!(storage.get("a").await.unwrap(), b"a-data");
        assert_eq!(storage.get("b").await.unwrap(), b"b-data");
        assert_eq!(storage.get("c").await.unwrap(), b"c-data");

        storage.delete("b").await.unwrap();
        assert!(storage.exists("a").await.unwrap());
        assert!(!storage.exists("b").await.unwrap());
        assert!(storage.exists("c").await.unwrap());
    }
}