Generate a thorough unit test suite for existing code

Write a thorough unit test suite for the following code.

Code to test:
[paste the function(s)/module/class]

Testing framework: [Jest / Vitest / pytest / etc.]
Mocking approach: [describe how external dependencies should be mocked, e.g. "mock the database client", "mock fetch calls"]

Before writing tests, list out loud what you're going to test: the happy path, then every edge case and failure mode you can identify from the code (invalid input, empty input, boundary values, null/undefined, concurrent calls, network/dependency failures, permission/auth failures if relevant).

Then write the tests:
1. Group them logically with describe/context blocks matching the behavior being tested, not the internal implementation
2. One assertion focus per test — avoid tests that check five unrelated things at once
3. Use descriptive test names that state the expected behavior ("returns an error when the email is invalid", not "test 3")
4. Mock external dependencies (network, database, filesystem, time/Date) so tests are deterministic and fast
5. Include at least one test that would fail if a specific known bug pattern were reintroduced (e.g. an off-by-one, a race condition, a missing null check) — comment why that test exists
6. Avoid testing implementation details (private internals, exact call counts to internals) that would break on a harmless refactor

After writing the tests, tell me:
- What coverage gaps remain that you couldn't test from the code alone (e.g. things that need a real integration environment)
- Whether anything in the source code looks untestable as currently structured, and why