fix(types): correct type hints for with_for_update to ForUpdateParameter

[PrinterOMG]

Description

This change fixes the type hint for the with_for_update parameter in the repositories. Currently, the type hint is Optional[bool], but according to the method's docstring, with_for_update is described as: "indicating FOR UPDATE should be used, or may be a dictionary containing flags to indicate a more specific set of FOR UPDATE flags for the SELECT". This implies that a dictionary may be passed, but the current type hint doesn’t reflect that.

If we trace where with_for_update is passed, it ends up unchanged in session.refresh in SQLAlchemy, which has the type hint ForUpdateParameter = Union["ForUpdateArg", None, bool, Dict[str, Any]], and that’s what I updated the type hints in our code to match.

However, it’s possible that this isn’t what was originally intended, and I’m not sure if this is the correct fix. There are other ways to address the issue — which approach would be preferable?

[codecov-commenter]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 88.15%. Comparing base (00e4ac2) to head (380275a).

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #465   +/-   ##
=======================================
  Coverage   88.14%   88.15%           
=======================================
  Files          84       84           
  Lines        5508     5512    +4     
  Branches      677      677           
=======================================
+ Hits         4855     4859    +4     
  Misses        445      445           
  Partials      208      208           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[github-actions]

Documentation preview will be available shortly at https://litestar-org.github.io/advanced-alchemy-docs-preview/465