Summary:

Add an optional fileName to RecordingOptions so the recording is written to <directory>/Audio/<fileName>.<ext> instead of recording-<uuid>.<ext>

Use case:

We record audio in the app and persist it locally for later upload.

To survive cache eviction, we already use directory: 'document' (added in 56.0.12 — ref #46189).

Today we still have to rename the file post-record from recording-<uuid>.m4a into a structured name (<audioType>__<Id>__<startedAtMs>.m4a) so we can recover orphaned files after a crash, app upgrade, or container UUID change without consulting the DB.

The rename is itself a failure window: if the app crashes between recording-stop and rename, we have a uuid-named file we can't tie back to its row. Naming the file at record-start eliminates this window.

Proposed API:

optional fileName?: string in RecordingOptions (just the basename — the SDK still appends extension and chooses the directory). Reject path separators / ...

Platforms: iOS + Android. Web inherits MediaRecorder semantics so it can ignore the field or fall back.