feat: add Teams (Circles) async API (#403)

## Summary
Closes #343

- Adds async-only `_AsyncTeamsAPI` module (`nc_py_api/teams.py`) for
managing Nextcloud Teams (Circles)
- Full CRUD: create, get_list, get_details, destroy, edit_name,
edit_description, edit_config
- Member management: add_member, add_members, remove_member,
set_member_level, confirm_member, join, leave
- Data classes: `Circle`, `Member` with typed properties
- Enums: `MemberType`, `MemberLevel`, `CircleConfig` (IntFlag)
- Registered on `_AsyncNextcloudBasic` — available on both
`AsyncNextcloud` and `AsyncNextcloudApp`

Following the async-only policy for new features — no sync variant.

## Test plan
- [x] 17 async tests in `tests/actual_tests/teams_test.py`
- [x] `test_teams_available` and `test_teams_create_destroy` run in both
client and AppAPI modes (`anc` fixture)
- [x] Circle CRUD: create, get_list, get_details, destroy, edit_name,
edit_description, edit_config
- [x] Member lifecycle: add_member, add_members (multi), remove_member,
set_member_level
- [x] Join/leave open circle flow
- [x] Personal and local circle creation
- [x] Error handling: destroy nonexistent circle raises
`NextcloudException`
- [x] Full suite: 613 passed, 6 skipped, 0 failures

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **New Features**
* Added Teams (Circles) API: create, list, edit, delete teams; manage
membership and roles; join/leave flows.
  * Exposed Teams-related types on the package public API.

* **Tests**
* Added comprehensive async integration tests covering lifecycle,
membership, role changes, join/request/confirm flows, and config flags.

* **Chores**
* CI workflow updated to enable and configure the Circles app during
test matrix runs.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Review <review@local>

Author: 3 people

.github/workflows/analysis-coverage.yml

@@ -213,6 +213,13 @@ jobs:
           ref: ${{ matrix.nextcloud }}
           path: apps/files_lock
 
+      - name: Checkout Circles
+        uses: actions/checkout@v6
+        with:
+          repository: nextcloud/circles
+          ref: ${{ matrix.nextcloud }}
+          path: apps/circles
+
       - name: Set up & run Nextcloud
         env:
           DB_PORT: 4444
@@ -224,6 +231,7 @@ jobs:
           ./occ config:system:set loglevel --value=0 --type=integer
           ./occ config:system:set debug --value=true --type=boolean
           ./occ config:system:set ratelimit.protection.enabled --value=false --type=boolean
+          ./occ config:system:set overwrite.cli.url --value="http://localhost:8080"
           ./occ app:enable notifications
           PHP_CLI_SERVER_WORKERS=2 php -S localhost:8080 &
 
@@ -233,6 +241,9 @@ jobs:
       - name: Enable Notes
         run: ./occ app:enable notes
 
+      - name: Enable Circles
+        run: php occ app:enable circles
+
       - name: Checkout NcPyApi
         uses: actions/checkout@v6
         with:
@@ -379,6 +390,13 @@ jobs:
           ref: ${{ matrix.nextcloud }}
           path: apps/activity
 
+      - name: Checkout Circles
+        uses: actions/checkout@v6
+        with:
+          repository: nextcloud/circles
+          ref: ${{ matrix.nextcloud }}
+          path: apps/circles
+
       - name: Set up & run Nextcloud
         env:
           DB_PORT: 4444
@@ -390,10 +408,14 @@ jobs:
           ./occ config:system:set loglevel --value=0 --type=integer
           ./occ config:system:set debug --value=true --type=boolean
           ./occ config:system:set ratelimit.protection.enabled --value=false --type=boolean
+          ./occ config:system:set overwrite.cli.url --value="http://localhost:8080"
           ./occ app:enable notifications
           ./occ app:enable activity
           PHP_CLI_SERVER_WORKERS=2 php -S localhost:8080 &
 
+      - name: Enable Circles
+        run: php occ app:enable circles
+
       - name: Checkout NcPyApi
         uses: actions/checkout@v6
         with:

nc_py_api/__init__.py

@@ -11,3 +11,4 @@
 from .files import FilePermissions, FsNode, LockType, SystemTag
 from .files.sharing import ShareType
 from .nextcloud import AsyncNextcloud, AsyncNextcloudApp, Nextcloud, NextcloudApp
+from .teams import Circle, CircleConfig, Member, MemberLevel, MemberType

nc_py_api/nextcloud.py

@@ -39,6 +39,7 @@
 from .loginflow_v2 import _AsyncLoginFlowV2API, _LoginFlowV2API
 from .notes import _AsyncNotesAPI
 from .notifications import _AsyncNotificationsAPI, _NotificationsAPI
+from .teams import _AsyncTeamsAPI
 from .user_status import _AsyncUserStatusAPI
 from .users import _AsyncUsersAPI, _UsersAPI
 from .users_groups import _AsyncUsersGroupsAPI, _UsersGroupsAPI
@@ -155,6 +156,8 @@ class _AsyncNextcloudBasic(ABC):  # pylint: disable=too-many-instance-attributes
     """Nextcloud API for managing user notifications"""
     talk: _AsyncTalkAPI
     """Nextcloud Talk API"""
+    teams: _AsyncTeamsAPI
+    """Nextcloud API for managing Teams (Circles)"""
     users: _AsyncUsersAPI
     """Nextcloud API for managing users."""
     users_groups: _AsyncUsersGroupsAPI
@@ -176,6 +179,7 @@ def __init__(self, session: AsyncNcSessionBasic):
         self.notes = _AsyncNotesAPI(session)
         self.notifications = _AsyncNotificationsAPI(session)
         self.talk = _AsyncTalkAPI(session)
+        self.teams = _AsyncTeamsAPI(session)
         self.users = _AsyncUsersAPI(session)
         self.users_groups = _AsyncUsersGroupsAPI(session)
         self.user_status = _AsyncUserStatusAPI(session)