test: port the upstream Hugging Face tests

aimux-providers/layout.toml

@@ -2440,3 +2440,96 @@ status = "mapped"
 upstream = "src/version.ts"
 status = "not-applicable"
 reason = "VERSION is the package version string; aimux pins it in shared/aisdk_pins.rs, which the user-agent tests read"
+
+[huggingface]
+package = "@ai-sdk/huggingface"
+
+[[huggingface.files]]
+upstream = "src/huggingface-config.ts"
+rust = "huggingface.rs"
+status = "mapped"
+
+[huggingface.files.tests]
+
+[[huggingface.files]]
+upstream = "src/huggingface-error.ts"
+rust = "huggingface/responses.rs"
+status = "mapped"
+
+[huggingface.files.tests]
+
+[[huggingface.files]]
+upstream = "src/huggingface-provider.ts"
+rust = "huggingface.rs"
+status = "mapped"
+
+[huggingface.files.tests]
+sub-feature = [
+  { case = "HuggingFaceProvider › unsupported functionality › should throw for text embedding models", issue = 276, reason = "aimux-core NoSuchModel carries only model_id and model_type and formats as \"no such model: …\", without the provider's own message" },
+  { case = "HuggingFaceProvider › unsupported functionality › should throw for image models", issue = 276, reason = "aimux-core NoSuchModel carries only model_id and model_type and formats as \"no such model: …\", without the provider's own message" },
+]
+
+[[huggingface.files]]
+upstream = "src/index.ts"
+rust = "huggingface.rs"
+status = "mapped"
+
+[huggingface.files.tests]
+
+[[huggingface.files]]
+upstream = "src/responses/convert-huggingface-responses-usage.ts"
+rust = "huggingface/responses.rs"
+status = "mapped"
+
+[huggingface.files.tests]
+
+[[huggingface.files]]
+upstream = "src/responses/convert-to-huggingface-responses-messages.ts"
+rust = "huggingface/responses.rs"
+status = "mapped"
+
+[huggingface.files.tests]
+
+[[huggingface.files]]
+upstream = "src/responses/huggingface-responses-language-model-options.ts"
+rust = "huggingface/options.rs"
+status = "mapped"
+
+[huggingface.files.tests]
+
+[[huggingface.files]]
+upstream = "src/responses/huggingface-responses-language-model.ts"
+rust = "huggingface/responses.rs"
+status = "mapped"
+
+[huggingface.files.tests]
+registered = [
+  { case = "HuggingFaceResponsesLanguageModel › doStream › preserves $expectedType stream errors", ref = "SSE 预读", reason = "an error as the first SSE event is returned by do_stream as Err, not as an error part of the stream" },
+]
+sub-feature = [
+  { case = "HuggingFaceResponsesLanguageModel › message conversion › should throw for file parts with provider references", issue = 276, reason = "aimux-core formats UnsupportedFunctionalityError as \"unsupported functionality: …\", not upstream's \"'…' functionality not supported.\"" },
+]
+
+[[huggingface.files]]
+upstream = "src/responses/huggingface-responses-prepare-tools.ts"
+rust = "huggingface/responses.rs"
+status = "mapped"
+
+[huggingface.files.tests]
+
+[[huggingface.files]]
+upstream = "src/responses/map-huggingface-responses-finish-reason.ts"
+rust = "huggingface/responses.rs"
+status = "mapped"
+
+[huggingface.files.tests]
+
+[[huggingface.files]]
+upstream = "src/responses/huggingface-responses-settings.ts"
+status = "not-applicable"
+reason = "only the HuggingFaceResponsesModelId string union; Rust takes the model id as &str"
+
+[[huggingface.files]]
+upstream = "src/version.ts"
+status = "not-applicable"
+reason = "the crate version is used instead (RFC-0046 §4.2)"

aimux-providers/src/huggingface.rs

@@ -216,3 +216,6 @@ impl ProviderDiscovery for HuggingFaceProvider {
         Box::pin(async move { crate::openai::model::list_models_once(&config).await })
     }
 }
+
+#[cfg(test)]
+mod tests;

aimux-providers/src/huggingface/tests/mod.rs

@@ -0,0 +1,4 @@
+//! Ports of the `@ai-sdk/huggingface@2.0.62` test files.
+
+mod provider;
+mod responses;

aimux-providers/src/huggingface/tests/provider.rs

@@ -0,0 +1,81 @@
+//! Port of `src/huggingface-provider.test.ts`.
+//!
+//! Harness differences from the TypeScript (expectations are unchanged):
+//! - `typeof provider === 'function'` and the `[Function]` snapshot are checked
+//!   by calling [`HuggingFaceProvider::call`], the Rust form of the callable
+//!   provider.
+//! - `typeof provider.responses === 'function'` is checked by a typed binding:
+//!   the method exists and returns the Responses model.
+
+use std::collections::HashMap;
+use std::sync::Arc;
+
+use crate::{HuggingFaceProviderSettings, HuggingFaceResponsesModel, create_huggingface};
+use aimux_core::language_model::LanguageModel;
+use aimux_core::provider::Provider;
+
+mod hugging_face_provider {
+    use super::*;
+
+    mod create_hugging_face {
+        use super::*;
+
+        /// upstream: @ai-sdk/huggingface src/huggingface-provider.test.ts › HuggingFaceProvider › createHuggingFace › should create provider with default configuration
+        #[test]
+        fn should_create_provider_with_default_configuration() {
+            let provider =
+                create_huggingface(HuggingFaceProviderSettings::default()).expect("valid settings");
+
+            let _model: Arc<dyn LanguageModel> = provider.call("any-model");
+            let _responses: HuggingFaceResponsesModel = provider.responses("any-model");
+            provider
+                .language_model("any-model")
+                .expect("language model");
+        }
+
+        /// upstream: @ai-sdk/huggingface src/huggingface-provider.test.ts › HuggingFaceProvider › createHuggingFace › should create provider with custom settings
+        #[test]
+        fn should_create_provider_with_custom_settings() {
+            let provider = create_huggingface(HuggingFaceProviderSettings {
+                api_key: Some("custom-key".to_string().into()),
+                base_url: Some("https://custom.url".to_string()),
+                headers: Some(HashMap::from([(
+                    "Custom-Header".to_string(),
+                    Some("test".to_string()),
+                )])),
+                ..Default::default()
+            })
+            .expect("valid settings");
+
+            let _model: Arc<dyn LanguageModel> = provider.call("any-model");
+            let _responses: HuggingFaceResponsesModel = provider.responses("any-model");
+            provider
+                .language_model("any-model")
+                .expect("language model");
+        }
+    }
+
+    mod model_creation_methods {
+        use super::*;
+
+        /// upstream: @ai-sdk/huggingface src/huggingface-provider.test.ts › HuggingFaceProvider › model creation methods › should expose responses method
+        #[test]
+        fn should_expose_responses_method() {
+            let provider =
+                create_huggingface(HuggingFaceProviderSettings::default()).expect("valid settings");
+
+            let _responses: HuggingFaceResponsesModel = provider.responses("any-model");
+        }
+
+        /// upstream: @ai-sdk/huggingface src/huggingface-provider.test.ts › HuggingFaceProvider › model creation methods › should expose languageModel method
+        #[test]
+        fn should_expose_language_model_method() {
+            let provider =
+                create_huggingface(HuggingFaceProviderSettings::default()).expect("valid settings");
+
+            let _model: Arc<dyn LanguageModel> = provider
+                .language_model("any-model")
+                .expect("language model");
+        }
+    }
+}

aimux-providers/src/huggingface/tests/responses/mod.rs

@@ -0,0 +1,3 @@
+//! Ports of `src/responses/huggingface-responses-language-model.test.ts`.
+
+mod responses_language_model;