force 0.2.0

//! Bulk Query Example
//!
//! This example demonstrates querying large datasets using the Bulk API 2.0.
//!
//! # Setup
//!
//! Set the following environment variables:
//! - `SF_CLIENT_ID` - OAuth client ID
//! - `SF_CLIENT_SECRET` - OAuth client secret
//! - `SF_MY_DOMAIN_URL` - Org My Domain URL
//!
//! # Run
//!
//! ```bash
//! cargo run --example bulk_query --features bulk
//! ```

#[cfg(feature = "bulk")]
mod example {
    use anyhow::Context;
    use force::auth::ClientCredentials;
    use force::client::ForceClientBuilder;
    use futures::StreamExt;
    use serde::Deserialize;

    #[derive(Deserialize, Debug)]
    struct Account {
        #[serde(rename = "Id")]
        id: String,
        #[serde(rename = "Name")]
        name: String,
        #[serde(rename = "Industry")]
        industry: Option<String>,
        #[serde(rename = "Website")]
        website: Option<String>,
    }

    fn required_env(name: &str) -> anyhow::Result<String> {
        std::env::var(name).with_context(|| format!("{name} environment variable not set"))
    }

    pub async fn main() -> anyhow::Result<()> {
        // Initialize tracing
        tracing_subscriber::fmt::init();

        // Get credentials from environment
        let client_id = required_env("SF_CLIENT_ID")?;
        let client_secret = required_env("SF_CLIENT_SECRET")?;
        let my_domain_url = required_env("SF_MY_DOMAIN_URL")?;

        println!("═══ Authenticating ═══");
        let auth = ClientCredentials::new_my_domain(client_id, client_secret, my_domain_url);
        let client = ForceClientBuilder::new().authenticate(auth).build().await?;
        println!("✓ Authentication successful\n");

        // Execute bulk query
        println!("═══ Bulk Query ═══");
        let soql = "SELECT Id, Name, Industry, Website FROM Account WHERE Industry = 'Technology'";
        println!("Query: {soql}");

        // Creates job, polls until complete, returns streaming results
        let stream = client.bulk().query::<Account>(soql).await?;
        let stream = stream.into_stream();
        let mut stream = std::pin::pin!(stream);

        println!("\n═══ Results ═══");
        let mut count = 0;
        while let Some(account_result) = stream.next().await {
            let account = account_result?;
            count += 1;
            println!(
                "{}. {} [{}] ({})",
                count,
                account.name,
                account.id,
                account.industry.unwrap_or_else(|| "N/A".to_string())
            );

            if let Some(website) = &account.website {
                println!("   Website: {website}");
            }
        }

        println!("\n✓ Retrieved {count} records");

        Ok(())
    }
}

#[cfg(feature = "bulk")]
#[tokio::main]
async fn main() -> anyhow::Result<()> {
    example::main().await
}

#[cfg(not(feature = "bulk"))]
fn main() {
    println!("This example requires the 'bulk' feature.");
}