mud_server.db.worlds_repo
=========================

.. py:module:: mud_server.db.worlds_repo

.. autoapi-nested-parse::

   World catalog and world-access policy repository operations.



Functions
---------

.. autoapisummary::

   mud_server.db.worlds_repo.get_world_by_id
   mud_server.db.worlds_repo.list_worlds
   mud_server.db.worlds_repo.get_world_access_decision
   mud_server.db.worlds_repo.can_user_access_world
   mud_server.db.worlds_repo.get_user_character_count_for_world
   mud_server.db.worlds_repo.get_world_admin_rows
   mud_server.db.worlds_repo.list_worlds_for_user


Module Contents
---------------

.. py:function:: get_world_by_id(world_id)

   Return one world catalog row by id.


.. py:function:: list_worlds(*, include_inactive = False)

   Return world catalog rows, optionally including inactive worlds.


.. py:function:: get_world_access_decision(user_id, world_id, *, role = None)

   Resolve world access/create decision for one account and world.


.. py:function:: can_user_access_world(user_id, world_id, *, role = None)

   Return ``True`` when the account may access/select the world.


.. py:function:: get_user_character_count_for_world(user_id, world_id)

   Return the number of characters the account owns in a world.


.. py:function:: get_world_admin_rows()

   Return operational world rows for admin/superuser world monitoring.


.. py:function:: list_worlds_for_user(user_id, *, role = None, include_inactive = False, include_invite_worlds = False)

   Return world rows decorated with access policy for one account.