Find a way to distinguish API error types in error handling code

[janbuchar]

• https://apify.slack.com/archives/CD0SF6KD4/p1750081551997999
• We probably want an ApifyApiError subclass for each error type
  • In catch blocks, we would just use instanceof
  • Or we can have typescript type guard functions instead
• It might make sense to generate this code

[janbuchar]

Python counterpart of this issue apify/apify-client-python#423