[sdk_v2] improves error handling in js sdk

[prathikr]

JavaScript SDK Improvements

🚀 Error Handling

Error Context Enhancement

• All streaming errors now include Model ID and Operation Context
• Original errors are preserved in the cause property for full error chaining
• Consistent error messages for parse failures, callback errors, and streaming interruptions
• Fail-fast behavior: Stops processing immediately after the first error to prevent memory bloat

---

🛠️ Usability & Validation

Strict Input Validation

• Added validateMessages to ChatClient:
  • Ensures messages array is not empty/null/undefined
  • Validates role and content are non-empty strings
• Added validateAudioFilePath to AudioClient:
  • Ensures path is a non-empty string
• Catalog Improvements:
  • getModel and getModelVariant now throw descriptive errors if the item is not found
  • Helpful Hints: Error messages now list available models/variants when a lookup fails (e.g., "Model with alias 'foo' not found. Available models: ...")

---

✅ Test Coverage

Expanded Validation Tests

• Added comprehensive null/undefined checks:
  • catalog.getModel(null/undefined)
  • catalog.getModelVariant(null/undefined)
  • client.completeChat(null/undefined)
  • client.completeStreamingChat(null/undefined, callback)
• Callback Validation:
  • Tests ensuring generic callback functions are valid (not null/undefined/non-function)

---

📚 Documentation

• Auto-generated updates:
  • Updated docs/interfaces/*.md to reflect type definition changes in types.ts
  • Ensured documentation stays in sync with code headers

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
foundry-local	Ready	Preview, Comment	Feb 19, 2026 5:39am

[Copilot]

Pull request overview

Copilot reviewed 25 out of 25 changed files in this pull request and generated 3 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 25 out of 25 changed files in this pull request and generated 5 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 25 out of 25 changed files in this pull request and generated 3 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 25 out of 25 changed files in this pull request and generated 5 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 25 out of 25 changed files in this pull request and generated 2 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 25 out of 25 changed files in this pull request and generated no new comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.