Loosen HttpExceptionOptions.cause type

[namoscato]

Is there an existing issue that is already proposing this?

• I have searched the existing issues

Is your feature request related to a problem? Please describe it

The HttpExceptionOptions.cause type is strictly Error | undefined which requires client-side handling with TypeScript's useUnknownInCatchVariables flag (enabled by default in v4.4), i.e.

try {
  // ...
} catch (error) {
  throw new UnauthorizedException(undefined, {
    cause: error instanceof Error ? error : undefined,
  });
}

Describe the solution you'd like

It would be nice to loosen the type to unknown (with internal conditional logic).

Teachability, documentation, adoption, migration strategy

The proposed solution would simplify the client-side implementation:

try {
  // ...
} catch (cause) {
  throw new UnauthorizedException(undefined, { cause });
}

What is the motivation / use case for changing the behavior?

This would enable TypeScript users to more easily leverage Error.cause.

[kamilmysliwiec]

Would you like to create a PR for this issue?

[namoscato]

Sure!

[kamilmysliwiec]

Let's track this here #11673