sdaas-rs 0.1.0

Official Rust SDK for SDaaS — Semantic Delta as a Service
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103

//! API key validation example
//!
//! Demonstrates API key validation and quota monitoring.
//!
//! Run with: `cargo run --example validation`

use sdaas_rs::Client;

fn main() {
    let rt = tokio::runtime::Runtime::new().unwrap();
    rt.block_on(main_async()).unwrap();
}

async fn main_async() -> Result<(), Box<dyn std::error::Error>> {
    println!("🔐 SDaaS Rust SDK - API Key Validation Example\n");

    // Initialize client with your API key
    let client = Client::new(
        "your-api-key-here",
        "https://saas-core-production.up.railway.app",
    );

    println!("📋 Validating API key...\n");

    // Validate API key and fetch account details
    match client.validate_key().await {
        Ok(response) => {
            if !response.valid {
                eprintln!("❌ API key is not valid!");
                return Ok(());
            }

            println!("✅ API key is valid!\n");

            let key = &response.key;

            // Display account tier
            println!("👤 Account Information");
            println!("────────────────────────────────────");
            println!("   Tier: {}", key.tier);

            // Display quota information
            println!("\n📊 Quota Management");
            println!("────────────────────────────────────");
            println!("   Limit:     {:>15}", key.quota_limit);
            println!("   Remaining: {:>15}", key.quota_remaining);

            // Calculate usage percentage
            let usage = key.quota_limit - key.quota_remaining;
            let usage_percent = if key.quota_limit > 0 {
                (usage as f64 / key.quota_limit as f64) * 100.0
            } else {
                0.0
            };

            println!("   Usage:     {:>14.1}%", usage_percent);

            // Display rate limiting
            println!("\n⚡ Rate Limiting");
            println!("────────────────────────────────────");
            println!("   Limit:     {:>15}/sec", key.rate_limit);
            println!("   Remaining: {:>15}", key.rate_limit_remaining);

            // Warnings
            println!("\n⚠️  Status Indicators");
            println!("────────────────────────────────────");

            let quota_threshold = key.quota_limit / 10;
            if key.quota_remaining < quota_threshold {
                println!(
                    "   ⚠️  Quota is running low! ({:.1}% remaining)",
                    (key.quota_remaining as f64 / key.quota_limit as f64) * 100.0
                );
            } else {
                println!("   ✅ Quota status: OK");
            }

            if key.rate_limit_remaining < (key.rate_limit / 10) {
                println!("   ⚠️  Rate limit nearly exhausted!");
            } else {
                println!("   ✅ Rate limit status: OK");
            }

            println!("\n📈 Summary");
            println!("────────────────────────────────────");
            println!(
                "   Plan: {} ({})",
                key.tier,
                if key.quota_limit > 1_000_000 {
                    "⭐ Premium"
                } else {
                    "💼 Standard"
                }
            );
            println!("   Ready for operations: ✅");
            Ok(())
        }
        Err(e) => {
            eprintln!("❌ Validation failed: {}", e);
            Err(Box::new(e) as Box<dyn std::error::Error>)
        }
    }
}