use std::collections::HashSet;
use std::sync::{Mutex, OnceLock};
use zeroize::{Zeroize, Zeroizing};
pub const PREFIX: &str = "IRONVAULT_";
const LEGACY_PREFIXES: [&str; 2] = ["aimodelvault_", "AIM_"];
fn warned() -> &'static Mutex<HashSet<String>> {
static WARNED: OnceLock<Mutex<HashSet<String>>> = OnceLock::new();
WARNED.get_or_init(|| Mutex::new(HashSet::new()))
}
fn raw(name: &str) -> Option<String> {
std::env::var(name)
.ok()
.map(|v| v.trim().to_string())
.filter(|v| !v.is_empty())
}
fn legacy_names(name: &str) -> Vec<String> {
name.strip_prefix(PREFIX)
.map(|suffix| {
LEGACY_PREFIXES
.iter()
.map(|p| format!("{p}{suffix}"))
.collect()
})
.unwrap_or_default()
}
pub fn var(name: &str) -> Option<String> {
if let Some(value) = raw(name) {
return Some(value);
}
for legacy in legacy_names(name) {
if raw(&legacy).is_some() {
warn_ignored(&legacy, name);
}
}
None
}
const KNOWN: [&str; 13] = [
"IRONVAULT_HOME",
"IRONVAULT_CONFIG",
"IRONVAULT_VAULT",
"IRONVAULT_VAULT_DIR",
"IRONVAULT_VAULT_PATH",
"IRONVAULT_PASSPHRASE",
"IRONVAULT_FEDERATION_PASSPHRASE",
"IRONVAULT_JWT_SECRET",
"IRONVAULT_HOST",
"IRONVAULT_PORT",
"IRONVAULT_REVOCATION_STORE",
"IRONVAULT_TELEMETRY_ENABLED",
"IRONVAULT_TELEMETRY_DISABLED",
];
pub fn report_legacy() {
for name in KNOWN {
if raw(name).is_some() {
continue;
}
for legacy in legacy_names(name) {
if raw(&legacy).is_some() {
warn_ignored(&legacy, name);
break;
}
}
}
}
pub fn var_secret(name: &str) -> Option<Zeroizing<String>> {
if let Ok(mut value) = std::env::var(name) {
let trimmed = Zeroizing::new(value.trim().to_string());
value.zeroize();
if !trimmed.is_empty() {
return Some(trimmed);
}
}
for legacy in legacy_names(name) {
if raw(&legacy).is_some() {
warn_ignored(&legacy, name);
}
}
None
}
pub fn is_set(name: &str) -> bool {
var(name).is_some()
}
fn warn_ignored(legacy: &str, current: &str) {
let mut seen = warned()
.lock()
.unwrap_or_else(std::sync::PoisonError::into_inner);
if seen.insert(legacy.to_string()) {
eprintln!(
"warning: ${legacy} is set but is NOT being read. It is the 4.x name, \
removed in 6.0 as 5.x warned it would be. Rename it to ${current} — \
until you do, this setting has no effect."
);
}
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn prefers_the_current_name() {
std::env::set_var("IRONVAULT_T_PREFER", "new");
std::env::set_var("aimodelvault_T_PREFER", "old");
assert_eq!(var("IRONVAULT_T_PREFER").as_deref(), Some("new"));
std::env::remove_var("IRONVAULT_T_PREFER");
std::env::remove_var("aimodelvault_T_PREFER");
}
#[test]
fn the_package_prefix_is_no_longer_read() {
std::env::set_var("aimodelvault_T_PKG", "value");
assert_eq!(var("IRONVAULT_T_PKG"), None);
std::env::remove_var("aimodelvault_T_PKG");
}
#[test]
fn the_binary_prefix_is_no_longer_read() {
std::env::set_var("AIM_T_BIN", "value");
assert_eq!(var("IRONVAULT_T_BIN"), None);
std::env::remove_var("AIM_T_BIN");
}
#[test]
fn empty_and_whitespace_are_unset() {
std::env::set_var("IRONVAULT_T_EMPTY", " ");
assert_eq!(var("IRONVAULT_T_EMPTY"), None);
std::env::remove_var("IRONVAULT_T_EMPTY");
}
#[test]
fn a_blank_current_name_does_not_revive_the_old_one() {
std::env::set_var("IRONVAULT_T_BLANK", "");
std::env::set_var("aimodelvault_T_BLANK", "old");
assert_eq!(var("IRONVAULT_T_BLANK"), None);
std::env::remove_var("IRONVAULT_T_BLANK");
std::env::remove_var("aimodelvault_T_BLANK");
}
#[test]
fn third_party_names_are_read_verbatim_with_no_fallback() {
assert!(legacy_names("AWS_REGION").is_empty());
assert!(legacy_names("DO_NOT_TRACK").is_empty());
assert_eq!(
legacy_names("IRONVAULT_HOME"),
vec!["aimodelvault_HOME", "AIM_HOME"]
);
}
#[test]
fn secrets_do_not_resolve_through_the_old_name_either() {
std::env::set_var("aimodelvault_T_SECRET", " hunter2 ");
assert!(var_secret("IRONVAULT_T_SECRET").is_none());
std::env::remove_var("aimodelvault_T_SECRET");
}
#[test]
fn the_current_name_still_resolves_for_secrets() {
std::env::set_var("IRONVAULT_T_SECRET_OK", " hunter2 ");
let got = var_secret("IRONVAULT_T_SECRET_OK").expect("current secret resolves");
assert_eq!(&*got, "hunter2");
std::env::remove_var("IRONVAULT_T_SECRET_OK");
}
#[test]
fn a_blank_secret_is_unset() {
std::env::set_var("IRONVAULT_T_BLANK_SECRET", " ");
assert!(var_secret("IRONVAULT_T_BLANK_SECRET").is_none());
std::env::remove_var("IRONVAULT_T_BLANK_SECRET");
}
#[test]
fn values_are_trimmed() {
std::env::set_var("IRONVAULT_T_TRIM", " spaced ");
assert_eq!(var("IRONVAULT_T_TRIM").as_deref(), Some("spaced"));
std::env::remove_var("IRONVAULT_T_TRIM");
}
}