Generate a Complete Class/Module

I need a [class/module] for [purpose] in [language/framework].

Technical requirements:
- [Requirement 1]
- [Requirement 2]
- [Requirement 3]

It should integrate with: [existing code/libraries]

Methods/functions needed:
1. [Method name]: [what it does]
2. [Method name]: [what it does]
3. [Method name]: [what it does]

Include:
- [ ] Type definitions
- [ ] Error handling
- [ ] Input validation
- [ ] JSDoc/docstring comments

Our coding conventions:
[Paste a sample from your codebase or describe the style]