Struct UUIDExtractor 

pub struct UUIDExtractor;

Extracts entity UUIDs from mutation response objects.

Handles various response formats:

• Simple: { "id": "uuid", "name": "..." }
• Nested: { "user": { "id": "uuid", "name": "..." } }
• Array: [{ "id": "uuid1" }, { "id": "uuid2" }]

Implementations

impl UUIDExtractor

pub fn extract_entity_uuid( response: &Value, _entity_type: &str, ) -> Result<Option<String>>

Extract a single entity UUID from mutation response.

Arguments

• response - JSON response from mutation
• entity_type - The entity type (e.g., “User”, “Post”)

Returns

• Ok(Some(uuid)) - UUID found and valid
• Ok(None) - No UUID found (e.g., null response)

Errors

Returns FraiseQLError::Validation if an "id" field is found but its value is not a valid UUID v4 string.

Examples

use fraiseql_core::cache::UUIDExtractor;
use serde_json::json;

let response = json!({"id": "550e8400-e29b-41d4-a716-446655440000"});
let uuid = UUIDExtractor::extract_entity_uuid(&response, "User").unwrap();
assert_eq!(uuid, Some("550e8400-e29b-41d4-a716-446655440000".to_string()));

pub fn extract_batch_uuids( response: &Value, _entity_type: &str, ) -> Result<Vec<String>>

Extract multiple entity UUIDs from mutation response (batch operations).

Arguments

• response - JSON response (array or object)
• entity_type - The entity type (e.g., “User”, “Post”)

Returns

List of extracted UUIDs (empty if none found)

Errors

Returns FraiseQLError::Validation if any "id" field found in the response is not a valid UUID v4 string.

Examples

use fraiseql_core::cache::UUIDExtractor;
use serde_json::json;

let response = json!([
    {"id": "550e8400-e29b-41d4-a716-446655440001"},
    {"id": "550e8400-e29b-41d4-a716-446655440002"},
    {"id": "550e8400-e29b-41d4-a716-446655440003"}
]);
let uuids = UUIDExtractor::extract_batch_uuids(&response, "User").unwrap();
assert_eq!(uuids.len(), 3);

pub fn is_valid_uuid(id: &str) -> bool

Validate if a string is a valid UUID format.

Arguments

• id - String to validate

Returns

true if valid UUID format, false otherwise

Examples

use fraiseql_core::cache::UUIDExtractor;

assert!(UUIDExtractor::is_valid_uuid("550e8400-e29b-41d4-a716-446655440000"));
assert!(!UUIDExtractor::is_valid_uuid("not-a-uuid"));

Trait Implementations

impl Clone for UUIDExtractor

fn clone(&self) -> UUIDExtractor

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for UUIDExtractor

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.