Struct ResponseBuilder 

pub struct ResponseBuilder;

HTTP response builder (suitable for plugin runtime).

Provides the following construction capabilities:

• Success response (JSON).
• Error response (automatic mapping of status codes and structures).
• File stream response (opens files based on host UUID).
• Status code response (pure status code, no body).

Implementations

impl ResponseBuilder

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

Constructs a JSON response (200 OK).

鈿狅笍 If serialization fails, [] is returned as fallback content; this does not indicate logic success.

pub fn error(err: VtxError) -> Response

Constructs an error response (automatically maps HTTP status codes based on error type).

• AuthDenied(code) 鈫?code (401 / 403)
• NotFound(_) 鈫?404
• PermissionDenied(_) 鈫?403
• SerializationError(_) 鈫?400
• DatabaseError(_), Internal(_) 鈫?500

Return structure:

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

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

Constructs a file stream response (opens via host interface by UUID).

• Success: 200 + file content stream.
• Failure: Returns 404 JSON error response.

pub fn status(code: u16) -> Response

Constructs a pure status code response (no body).

Used for scenarios such as 204 No Content, 403 Forbidden, etc.

pub fn not_found() -> Response

Constructs a standard 404 Not Found response (no body).