Convention over errors

[NickGhignatti]

Currently, our error handling is inconsistent across the codebase. We rely on a mix of:

• Throwing generic exceptions.
• Returning null or undefined.
• Returning boolean flags.

This makes it difficult for developers to know exactly what can go wrong without diving into the implementation details, often leading to unhandled edge cases and "catch-all" blocks that obscure the root cause of issues.

I propose we implement a standardized Error , something like:

type Error= 
  | { type: 'NotFound'; message: string }
  | { type: 'ValidationError'; fields: string[] }
  | { type: 'Unauthorized'; action: string };

[NickGhignatti]

Currently the best idea so far is the soft standardization through an OpenApi specification to adhere at