AshTypescript.Rpc.Errors (ash_typescript v0.19.2)

Copy Markdown View Source

Central error processing module for RPC operations.

Handles error transformation, unwrapping, and formatting for TypeScript clients. Uses the AshTypescript.Rpc.Error protocol to extract minimal information from exceptions.

Summary

Functions

to_errors(errors, domain \\ nil, resource \\ nil, action \\ nil, context \\ %{})

Transforms errors into standardized RPC error responses.

unhandled_error(error)

Builds a generic client-facing error for a term no handler recognises.

unwrap_errors(errors)

Unwraps nested error structures from Ash error classes.

Functions

to_errors(errors, domain \\ nil, resource \\ nil, action \\ nil, context \\ %{})

@spec to_errors(term(), atom() | nil, atom() | nil, atom() | nil, map()) :: [map()]

Transforms errors into standardized RPC error responses.

Processes errors through the following pipeline:

  1. Convert to Ash error class using Ash.Error.to_error_class
  2. Unwrap nested error structures
  3. Transform via Error protocol
  4. Apply resource-level error handler (if configured)
  5. Apply domain-level error handler (if configured)
  6. Interpolate variables into messages

unhandled_error(error)

@spec unhandled_error(term()) :: map()

Builds a generic client-facing error for a term no handler recognises.

The term is logged server-side under a fresh error id and the client only receives that id, so internal state never reaches the response.

unwrap_errors(errors)

@spec unwrap_errors(term()) :: [term()]

Unwraps nested error structures from Ash error classes.