mud_server.db.facade
====================

.. py:module:: mud_server.db.facade

.. autoapi-nested-parse::

   Public DB facade module.

   This module is the app-facing import surface for database operations.

   Design goals:
   1. Keep application layers importing a stable module path (``mud_server.db.facade``).
   2. Enforce an explicit facade API contract for the 0.3.10 refactor phase.
   3. Keep runtime call forwarding compatible with tests that monkeypatch
      ``mud_server.db.database.<symbol>``.

   Implementation notes:
   - ``_PUBLIC_API`` is intentionally explicit and versioned by source control.
     New facade symbols must be added here deliberately.
   - ``_REMOVED_API`` lists legacy names removed during the refactor so callers
     get a clear upgrade message instead of a generic attribute error.
   - Public callables are exposed as lightweight forwarding wrappers that resolve
     the current backing attribute at call time. This avoids dynamic module-class
     mutation while preserving monkeypatch compatibility for call sites.