SOAR-0015: Error Handler Protocols for Client and Server

[winnisx7]

Summary

This PR adds the proposal document for SOAR-0015, which introduces ClientErrorHandler and ServerErrorHandler protocols for centralized error observation.

Related Links

• Implementation PR: [apple/swift-openapi-runtime#162](Pull Request: Add Error Handler Support to UniversalClient swift-openapi-runtime#162)

Motivation

Currently, swift-openapi-runtime provides limited options for centralized error handling. Developers must handle errors individually at each API call site, leading to code duplication. The existing ClientMiddleware operates at the HTTP level and cannot intercept errors that occur during response decoding or other runtime operations.

This proposal introduces protocol-based error handlers that are invoked after errors have been wrapped in ClientError or ServerError, enabling centralized logging, monitoring, and analytics.

What's in this PR

• Adds Sources/_OpenAPIGeneratorCore/Documentation.docc/Proposals/SOAR-0015.md

Checklist

• Proposal document added
• Implementation PR linked

[winnisx7]

Hi @czechboy0, I've created the proposal document as suggested. Would appreciate your review when you have a chance!

[czechboy0]

Hi @winnisx7,

thank you for your interest in contributing to Swift OpenAPI Generator.

For now, we prefer human-written code and proposals, and your document appears to be written by an LLM. If you just used an LLM to format your hand-written proposal, please just provide your original proposal, without running it through an LLM. That'll help protect other contributors' time by not having to read the usual extra fluff that LLMs add.

I appreciate that every project is figuring out their own rules about LLM usage, and I do want to help you get your contribution reviewed and merged, let's just keep it between us humans :) Thanks