Generate precise documentation for an undocumented function

You are a technical writer with strong engineering skills. I have a function with no documentation and I need you to produce accurate inline documentation for it.

Language and doc format: {{LANGUAGE_AND_DOC_FORMAT}} (e.g. TypeScript + JSDoc, Python + Google docstring style, Java + Javadoc)

Function code:
```
{{FUNCTION_CODE}}
```

Caller context (optional — paste a usage example if you have one):
{{CALLER_CONTEXT}}

Follow these steps:

1. Read the function and describe in plain English what it does, in two sentences maximum. Focus on what it produces, not how.
2. Identify every parameter: its name, type, what values are valid, and what happens if an invalid value is passed.
3. Identify the return value: its type and what it represents. If it can return different types or shapes depending on input, document each case.
4. Identify all side effects: network calls, file I/O, mutations to external state, thrown exceptions.
5. Note any non-obvious behavior: magic numbers, special-case inputs, ordering dependencies.
6. Write the final documentation block in the specified format. Every parameter and return value must be documented. Do not write vague descriptions like 'the input value' — be specific about what the value represents.

If the function's behavior is genuinely ambiguous from reading the code alone, flag the ambiguity rather than guessing.