Errors
======

Both SDKs map gRPC/Connect status codes into typed OLO SDK errors. Platform
Connect failures may also set ``reason`` from the ``olo-error-reason`` header.

.. tab-set::
   :sync-group: sdk-language

   .. tab-item:: Python
      :sync: python

      .. automodule:: olo.errors
         :members:
         :show-inheritance:

   .. tab-item:: TypeScript
      :sync: typescript

      RPC failures are mapped from Connect/gRPC status codes to typed
      ``OloError`` subclasses.

      **Base types**

      - :doc:`OloError </typescript/api/generated/olo/classes/OloError>` — base
        class for all SDK errors.
      - ``OloErrorOptions`` — metadata attached to an SDK error.
      - ``wrapRpcError`` — map thrown values to typed SDK errors.

      **Typed errors**

      - :doc:`OloAmbiguousNamespace </typescript/api/generated/olo/classes/OloAmbiguousNamespace>`
      - :doc:`OloTimeoutError </typescript/api/generated/olo/classes/OloTimeoutError>`
      - :doc:`OloInvalidArgument </typescript/api/generated/olo/classes/OloInvalidArgument>`
      - :doc:`OloNotFound </typescript/api/generated/olo/classes/OloNotFound>`
      - :doc:`OloUnavailable </typescript/api/generated/olo/classes/OloUnavailable>`
      - :doc:`OloFailedPrecondition </typescript/api/generated/olo/classes/OloFailedPrecondition>`
      - :doc:`OloInternalError </typescript/api/generated/olo/classes/OloInternalError>`
      - :doc:`OloUnauthenticated </typescript/api/generated/olo/classes/OloUnauthenticated>`
      - :doc:`OloPermissionDenied </typescript/api/generated/olo/classes/OloPermissionDenied>`
      - :doc:`OloPlatformNotConfigured </typescript/api/generated/olo/classes/OloPlatformNotConfigured>`