Struct ResponseBuilder 

pub struct ResponseBuilder;

HTTP 响应构造器（适用于插件运行时）

提供以下构造能力：

• 成功响应（JSON）
• 错误响应（自动映射状态码与结构体）
• 文件流响应（基于宿主 UUID 打开文件）
• 状态码响应（纯状态码，无 body）

Implementations

impl ResponseBuilder

pub fn json<T: Serialize>(data: &T) -> Response

构造 JSON 响应（200 OK）

⚠️ 若序列化失败，返回 [] 作为兜底内容，不表示逻辑成功。

pub fn error(err: VtxError) -> Response

构造错误响应（根据错误类型自动映射 HTTP 状态码）

• AuthDenied(code) → code（401 / 403）
• NotFound(_) → 404
• PermissionDenied(_) → 403
• SerializationError(_) → 400
• DatabaseError(_), Internal(_) → 500

返回结构：

{
  "success": false,
  "error": true,
  "code": 403,
  "type": "PermissionDenied",
  "message": "You are not allowed to access this resource"
}

pub fn file(uuid: &str) -> Response

构造文件流响应（通过宿主接口按 UUID 打开）

• 成功：200 + 文件内容流
• 失败：返回 404 JSON 错误响应

pub fn status(code: u16) -> Response

构造纯状态码响应（无 body）

用于如：204 No Content、403 Forbidden 等响应场景

pub fn not_found() -> Response

构造标准 404 Not Found 响应（无正文）