Add specific error codes for logstream write failure

[deepthidevaki]

Description

LogstreamWriter#tryWrite returns specific error codes. If the sequencer is full, then the CommandApi can return a partition-leader-mismatch error code so that the gateway can retry the request. Other errors are mapped to internal error and logged at debug level.

Related issues

closes #12780

Definition of Done

Not all items need to be done depending on the issue and the pull request.

Code changes:

• The changes are backwards compatibility with previous versions
• If it fixes a bug then PRs are created to backport the fix to the last two minor versions. You can trigger a backport by assigning labels (e.g. backport stable/1.3) to the PR, in case that fails you need to create backports manually.

Testing:

• There are unit/integration tests that verify all acceptance criterias of the issue
• New tests are written to ensure backwards compatibility with further versions
• The behavior is tested manually
• The change has been verified by a QA run
• The impact of the changes is verified by a benchmark

Documentation:

• The documentation is updated (e.g. BPMN reference, configuration, examples, get-started guides, etc.)
• If the PR changes how BPMN processes are validated (e.g. support new BPMN element) then the Camunda modeling team should be informed to adjust the BPMN linting.

Other teams:
If the change impacts another team an issue has been created for this team, explaining what they need to do to support this change.

• Operate
• Tasklist
• Web Modeler
• Desktop Modeler
• Optimize

Please refer to our review guidelines.

[lenaschoenburg]

👍 Thanks @deepthidevaki, I think it's a good idea to return an Either from the Sequencer.

I've left some optional remarks, nothing else.

[deepthidevaki]

@oleschoenburg I have applied your comments.

[deepthidevaki]

bors merge

[zeebe-bors-camunda]

Build succeeded:

• Test summary

[backport-action]

Backport failed for stable/8.2, because it was unable to cherry-pick the commit(s).

Please cherry-pick the changes locally.

git fetch origin stable/8.2
git worktree add -d .worktree/backport-12910-to-stable/8.2 origin/stable/8.2
cd .worktree/backport-12910-to-stable/8.2
git checkout -b backport-12910-to-stable/8.2
ancref=$(git merge-base 7c31e9ea6596e7f6da16aada6139be536056997a 0ca6cd55d35a3ad7c958da3fc5ffea4977ad3b80)
git cherry-pick -x $ancref..0ca6cd55d35a3ad7c958da3fc5ffea4977ad3b80