rustsf 0.1.1

Salesforce SDK for Rust, supports the latest API version 68.0, (Winter 2026)
Documentation
//! # Salesforce REST API Headers
//!
//! ## Available Headers
//! - [Assignment Rule Header](crate::rest_api::builder::headers::assignment_rule_header)
//! - [Call Options Header](crate::rest_api::builder::headers::call_options_header)
//! - Compression Headers
//! - [Conditional Request Headers](crate::rest_api::builder::headers::conditional_request_headers)
//! - [Duplicate Rule Header](crate::rest_api::builder::headers::duplicate_rule_header)
//! - [Limit Info Header](crate::rest_api::builder::headers::limit_info_header)
//! - [MRU Header](crate::rest_api::builder::headers::mru_header)
//! - [Package Version Header](crate::rest_api::builder::headers::package_version_header)
//! - [Query Options Header](crate::rest_api::builder::headers::query_options_header)
//! - Warning Header
//!
//! # See
//! https://developer.salesforce.com/docs/platform/api-rest/guide/headers.html

use super::RestApiBuilder;

mod assignment_rule_header;
mod call_options_header;
mod conditional_request_headers;
mod duplicate_rule_header;

mod most_recently_used_header;
mod package_version_header;
mod query_options_header;

// todo do not forget to add the response headers, e.g. https://developer.salesforce.com/docs/platform/api-rest/guide/headers-api-usage.html

impl<'a> RestApiBuilder<'a> {
	/// Sets a header key-value pair in the headers map of the current object.
	///
	/// # Arguments
	///
	/// * `key` - A string slice that holds the name of the header.
	/// * `value` - A string slice that holds the value of the header.
	///
	/// # Returns
	///
	/// Returns a mutable reference to the current object, allowing method chaining.
	///
	/// # Example
	/// ```
	/// use rustsf::{RestApi, SalesforceCredentials};
	/// use chrono::Utc;
	///
	/// #[tokio::main]
	/// async fn main() {
	///     let credentials = SalesforceCredentials::sfdx_url("force://PlatformCLI::token@example.com").unwrap();
	///     let api = RestApi::new(credentials).await.unwrap();
	///
	/// 	let mut request = api.build().header("Sforce-Duplicate-Rule-Header", "allowSave=true");
	/// }
	/// ```
	pub fn header(&mut self, key: &str, value: &str) -> &mut Self {
		self.headers.insert(key.to_string(), value.to_string());
		self
	}
}