ffbb-data-client 2.0.2__tar.gz → 2.2.0__tar.gz

{ffbb_data_client-2.0.2 → ffbb_data_client-2.2.0}/.coveragerc

@@ -3,7 +3,7 @@
 
 [run]
 branch = True
-source = ffbb_api_client_v3
+source = ffbb_data_client
 parallel = True
 # CRITICAL for Coveralls: ensures paths are relative to the git root
 # Without this, Coveralls reports 0% or fails to map files
@@ -21,9 +21,9 @@ omit =
 # Maps coverage paths from different environments (tox, Docker, etc.)
 # to the canonical source root. Order matters: first match wins.
 source =
-    src/ffbb_api_client_v3
-    */ffbb_api_client_v3
-    */src/ffbb_api_client_v3
+    src/ffbb_data_client
+    */ffbb_data_client
+    */src/ffbb_data_client
 
 [report]
 # Minimum coverage threshold — CI will fail below this
@@ -62,7 +62,7 @@ exclude_lines =
 
 [html]
 directory = htmlcov
-title = FFBBApiClientV3 Coverage
+title = FFBB Data Client Coverage
 
 [xml]
 # Required by coverallsapp/github-action@v2 Universal Coverage Reporter

ffbb_data_client-2.2.0/.github/dependabot.yml

@@ -0,0 +1,19 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5
+
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5
+
+  - package-ecosystem: "pip"
+    directory: "/docs"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5

{ffbb_data_client-2.0.2 → ffbb_data_client-2.2.0}/.github/scripts/check_wrapper_parity.py

@@ -62,23 +62,49 @@ def write_summary(text: str) -> None:
 def main() -> int:
     api_methods = get_public_methods(CLIENTS / "api_ffbb_app_client.py")
     ms_methods = get_public_methods(CLIENTS / "meilisearch_ffbb_client.py")
-    wrapper_methods = get_public_methods(CLIENTS / "ffbb_data_client.py")
+
+    # Collect wrapper methods from the main file AND any facade files.
+    # After the v2.1.0 refactor, methods live in _rest_facade.py and
+    # _search_facade.py; the thin ffbb_data_client.py delegates via setattr.
+    wrapper_files = [
+        CLIENTS / "ffbb_data_client.py",
+        CLIENTS / "_rest_facade.py",
+        CLIENTS / "_search_facade.py",
+    ]
+    wrapper_methods: set[str] = set()
+    for wf in wrapper_files:
+        if wf.exists():
+            wrapper_methods |= get_public_methods(wf)
 
     all_inner = api_methods | ms_methods
     missing = sorted(all_inner - wrapper_methods)
 
     if not missing:
-        msg = "## ✅ Wrapper parity OK\n\nAll public methods from inner clients are exposed in `FFBBDataClient`."
+        msg = "## ✅ Wrapper parity OK\n\nAll public methods from inner clients are exposed in `FFBBDataClient` (including facade files)."
         print(msg)
         write_summary(msg)
         return 0
 
     # Build markdown report
+    missing_detail = " ".join(
+        [
+            "The following methods exist in inner clients but are **not exposed**",
+            "in `FFBBDataClient` or its facade files:",
+        ]
+    )
+    fix_detail = " ".join(
+        [
+            "Add the missing method(s) to",
+            "`src/ffbb_data_client/clients/ffbb_data_client.py` or one of its",
+            "facade files (`_rest_facade.py`, `_search_facade.py`)",
+            "so they delegate to the appropriate inner client.",
+        ]
+    )
+
     lines = [
         "## ⚠️ Wrapper parity check failed",
         "",
-        "The following methods exist in inner clients but are **not exposed** "
-        "in `FFBBDataClient`:",
+        missing_detail,
         "",
         "| Method | Source client |",
         "|---|---|",
@@ -94,9 +120,7 @@ def main() -> int:
     lines += [
         "",
         "### How to fix",
-        "Add the missing method(s) to "
-        "`src/ffbb_data_client/clients/ffbb_data_client.py` "
-        "so they delegate to the appropriate inner client.",
+        fix_detail,
     ]
 
     report = "\n".join(lines)

{ffbb_data_client-2.0.2 → ffbb_data_client-2.2.0}/.github/workflows/check_wrapper_parity.yml

@@ -23,10 +23,10 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
 
       - name: Set up Python
-        uses: actions/setup-python@v6
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
         with:
           python-version: '3.11'
 

{ffbb_data_client-2.0.2 → ffbb_data_client-2.2.0}/.github/workflows/ci.yml

@@ -37,6 +37,10 @@ jobs:
         with: {python-version: "3.14"}
       - name: Run static analysis and format checkers
         run: pipx run pre-commit run --all-files --show-diff-on-failure
+      - name: Run type checks
+        run: >-
+          pipx run --python '${{ steps.setup-python.outputs.python-path }}'
+          tox -e type
       - name: Build package distribution files
         run: >-
           pipx run --python '${{ steps.setup-python.outputs.python-path }}'
@@ -74,7 +78,7 @@ jobs:
           tox -e validate
       - name: Record the path of wheel distribution
         id: wheel-distribution
-        run: echo "path=$(ls dist/*.whl)" >> $GITHUB_OUTPUT
+        run: echo "path=$(ls dist/*.whl)" >> "$GITHUB_OUTPUT"
       - name: Store the distribution files for use in other stages
         uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a  # v7.0.1
         with:
@@ -118,6 +122,7 @@ jobs:
       # `parallel: true` signals that more reports are coming from other jobs.
       # `flag-name` labels this specific combination for per-flag drill-down on Coveralls.
       - name: Upload coverage to Coveralls (parallel)
+        if: ${{ github.ref_type != 'tag' }}
         uses: coverallsapp/github-action@648a8eb78e6d50909eff900e4ec85cab4524a45b  # v2.3.6
         with:
           file: coverage.lcov
@@ -136,6 +141,7 @@ jobs:
     if: ${{ always() }}
     steps:
       - name: Finalize coverage report on Coveralls
+        if: ${{ github.ref_type != 'tag' }}
         uses: coverallsapp/github-action@648a8eb78e6d50909eff900e4ec85cab4524a45b  # v2.3.6
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}

ffbb_data_client-2.2.0/.github/workflows/codeql.yml

@@ -0,0 +1,33 @@
+name: CodeQL
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+  schedule:
+    - cron: '31 2 * * 1'
+
+permissions:
+  contents: read
+
+jobs:
+  analyze:
+    name: Analyze Python
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
+
+      - name: Initialize CodeQL
+        uses: github/codeql-action/init@9e0d7b8d25671d64c341c19c0152d693099fb5ba  # v4
+        with:
+          languages: python
+          queries: security-extended,security-and-quality
+
+      - name: Perform CodeQL Analysis
+        uses: github/codeql-action/analyze@9e0d7b8d25671d64c341c19c0152d693099fb5ba  # v4

{ffbb_data_client-2.0.2 → ffbb_data_client-2.2.0}/.github/workflows/deploy-pages.yml

@@ -20,7 +20,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
         with:
           fetch-depth: 0
 
@@ -36,7 +36,7 @@ jobs:
         run: touch website/.nojekyll
 
       - name: Upload Pages artifact
-        uses: actions/upload-pages-artifact@v5
+        uses: actions/upload-pages-artifact@fc324d3547104276b827a68afc52ff2a11cc49c9  # v5
         with:
           path: website
 
@@ -52,4 +52,4 @@ jobs:
     steps:
       - name: Deploy to GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@v5
+        uses: actions/deploy-pages@cd2ce8fcbc39b97be8ca5fce6e763baed58fa128  # v5

{ffbb_data_client-2.0.2 → ffbb_data_client-2.2.0}/.github/workflows/publish.yml

@@ -5,19 +5,26 @@ on:
     tags:
       - 'v*'
 
+permissions:
+  contents: read
+
 jobs:
   build:
     name: Build distribution
     runs-on: ubuntu-latest
+    permissions:
+      attestations: write
+      contents: read
+      id-token: write
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
         with:
           fetch-depth: 0  # Required for setuptools_scm to resolve version from tags
 
       - name: Set up Python
-        uses: actions/setup-python@v6
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
         with:
           python-version: '3.11'
 
@@ -56,11 +63,16 @@ jobs:
           PY
 
       - name: Upload distribution artifacts
-        uses: actions/upload-artifact@v7
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a  # v7.0.1
         with:
           name: dist
           path: dist/
 
+      - name: Generate artifact attestation
+        uses: actions/attest@59d89421af93a897026c735860bf21b6eb4f7b26  # v4
+        with:
+          subject-path: dist/*
+
   publish-pypi:
     name: Publish to PyPI
     needs: build
@@ -71,13 +83,13 @@ jobs:
 
     steps:
       - name: Download distribution artifacts
-        uses: actions/download-artifact@v8
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c  # v8.0.1
         with:
           name: dist
           path: dist/
 
       - name: Publish to PyPI
-        uses: pypa/gh-action-pypi-publish@release/v1
+        uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b  # release/v1
 
   publish-github-release:
     name: Create GitHub Release
@@ -88,13 +100,13 @@ jobs:
 
     steps:
       - name: Download distribution artifacts
-        uses: actions/download-artifact@v8
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c  # v8.0.1
         with:
           name: dist
           path: dist/
 
       - name: Create GitHub Release
-        uses: softprops/action-gh-release@v3
+        uses: softprops/action-gh-release@b4309332981a82ec1c5618f44dd2e27cc8bfbfda  # v3
         with:
           files: dist/*
           generate_release_notes: true
@@ -106,7 +118,7 @@ jobs:
 
     steps:
       - name: Dispatch bump event to FFBB-MCP-Server
-        uses: peter-evans/repository-dispatch@v4
+        uses: peter-evans/repository-dispatch@28959ce8df70de7be546dd1250a005dd32156697  # v4
         with:
           token: ${{ secrets.MCP_SERVER_PAT }}
           repository: nickdesi/FFBB-MCP-Server

{ffbb_data_client-2.0.2 → ffbb_data_client-2.2.0}/.github/workflows/release-after-discovery-merge.yml

@@ -51,7 +51,7 @@ jobs:
 
       - name: Checkout tested commit
         if: steps.pr.outputs.release == 'true'
-        uses: actions/checkout@v6
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
         with:
           ref: ${{ github.event.workflow_run.head_sha }}
           fetch-depth: 0

{ffbb_data_client-2.0.2 → ffbb_data_client-2.2.0}/.github/workflows/update-ffbb-api-discovery.yml

@@ -19,10 +19,10 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
 
       - name: Set up Python
-        uses: actions/setup-python@v6
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
         with:
           python-version: '3.11'
 
@@ -44,7 +44,7 @@ jobs:
 
       - name: Upload discovery summary
         if: always()
-        uses: actions/upload-artifact@v7
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a  # v7.0.1
         with:
           name: ffbb-api-update-summary
           path: data/api_update_summary.md
@@ -53,7 +53,7 @@ jobs:
 
       - name: Create pull request
         if: steps.changes.outputs.changed == 'true'
-        uses: peter-evans/create-pull-request@v8
+        uses: peter-evans/create-pull-request@5f6978faf089d4d20b00c7766989d076bb2fc7f1  # v8
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
           branch: chore/update-ffbb-api-discovery

{ffbb_data_client-2.0.2 → ffbb_data_client-2.2.0}/.pre-commit-config.yaml

@@ -61,6 +61,16 @@ repos:
   hooks:
   - id: flake8
 
+# Type-checking on push (mypy + pyright via tox)
+- repo: local
+  hooks:
+  - id: type-check
+    name: type-check (mypy + pyright)
+    entry: bash -c 'PATH="$PWD/.venv/bin:$PATH" tox -e type'
+    language: system
+    pass_filenames: false
+    stages: [pre-push]
+
 # Check for misspells in documentation files:
 # - repo: https://github.com/codespell-project/codespell
 #   rev: v2.2.5

{ffbb_data_client-2.0.2 → ffbb_data_client-2.2.0}/CHANGELOG.md

@@ -5,6 +5,56 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.2.0] - 2026-05-17
+
+### Changed
+- **REFACTOR**: `FFBBDataClient` (2865 → 272 lines) split into modular facades — `_RestFacade` (1592 lines) and `_SearchFacade` (1020 lines)
+- Public API remains 100% backward-compatible — all 167 methods accessible directly on `FFBBDataClient`
+- `check_wrapper_parity.py` updated to scan facade files in addition to the main client
+
+### Added
+- `pytest_asyncio_mode = "auto"` in `pyproject.toml` for pytest-asyncio compatibility
+- `isolated_build = True` in `tox.ini` for proper PEP 517 builds
+
+### Fixed
+- `CacheManager` docstring corrected — Redis backend marked as "planned" (not implemented)
+- `readme_renderer[md]` moved from `install_requires` to `testing` extras (build-time only dependency)
+
+### Removed
+- Orphaned `src/ffbb_api_client_v3/` directory (residual from v2.1.0 cleanup)
+- Orphaned `.coverage` file at project root
+- `benchmark_search_organisme.py` moved from root to `scripts/`
+
+## [2.1.0] - 2026-05-17
+
+### Changed
+- **BREAKING (internal)**: Sync methods now delegate to async counterparts via `_run_async()` helper, eliminating ~604 lines of duplication
+- Sync and async share a single source of truth — async methods are canonical
+- `ThreadPoolExecutor` fallback handles nested event loops gracefully
+
+### Added
+- **NEW**: Pre-push hook for type-check (mypy + pyright) — catches type errors before push
+- **NEW**: CodeQL security scanning in CI
+- **NEW**: Dependabot for automated dependency updates (GitHub Actions + pip)
+- **NEW**: `SECURITY.md` security policy
+
+### Fixed
+- SQLite cache concurrency: sync uses `http_cache.db`, async uses `http_cache_async.db` (prevents `database is locked`)
+- CI type check failures with proper generic typing for `_run_async(coro: Awaitable[T]) -> T`
+- `FFBBDataClient` wrapper parity — added 8 missing async method delegations
+
+### Removed
+- Dead `invalidate_pattern()` from `CacheManager` and related tests
+- `ffbb_api_client_v3` shim, dead scripts, and backward-compat alias
+
+### Security
+- CI supply chain hardened with pinned action versions and trusted publishers
+
+## [2.0.2] - 2026-05-17
+
+### Changed
+- README version updated to v2.0.2
+
 ## [1.6.1] - 2026-04-29
 
 ### Changed

{ffbb_data_client-2.0.2/src/ffbb_data_client.egg-info → ffbb_data_client-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ffbb-data-client
-Version: 2.0.2
+Version: 2.2.0
 Summary: FFBB Data Client — SDK Python asynchrone pour les Statistiques de Basket France. Type-safe Pydantic models, async/sync, Meilisearch.
 Home-page: https://github.com/nickdesi/ffbb-data-client
 Author: nickdesi
@@ -33,11 +33,10 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown; charset=UTF-8
 License-File: LICENSE.txt
 Requires-Dist: python-dotenv>=1.2.2
-Requires-Dist: readme_renderer[md]>=44.0
 Requires-Dist: python-dateutil>=2.9.0.post0
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: hishel[async]>=1.2.1
-Requires-Dist: pydantic>=2.13.3
+Requires-Dist: pydantic>=2.13.4
 Provides-Extra: testing
 Requires-Dist: setuptools>=82.0.1; extra == "testing"
 Requires-Dist: coverage>=7.13.5; extra == "testing"
@@ -46,6 +45,7 @@ Requires-Dist: pytest-xdist>=3.8.0; extra == "testing"
 Requires-Dist: pytest-cov>=7.1.0; extra == "testing"
 Requires-Dist: respx>=0.23.1; extra == "testing"
 Requires-Dist: pytest-asyncio>=1.3.0; extra == "testing"
+Requires-Dist: readme_renderer[md]>=44.0; extra == "testing"
 Provides-Extra: typing
 Requires-Dist: types-python-dateutil>=2.9.0.20260408; extra == "typing"
 Dynamic: license-file
@@ -85,20 +85,18 @@ Dynamic: license-file
 - du cache HTTP configurable via `hishel` ;
 - des helpers prêts pour l'intégration MCP / agents IA.
 
-> La V3 remplace l’approche V2 basée sur des dictionnaires bruts et une configuration manuelle. Elle privilégie le typage, la robustesse réseau et les appels batchés.
-
 ---
 
-## 🚀 Version v1.7.0 — 30 avril 2026
+## 🚀 Version v2.2.0 — Mai 2026
 
 Principales évolutions récentes :
 
-- ajout d'entités REST et Meilisearch : rencontres, officiels, entraîneurs, communes et assets ;
-- réutilisation des clients `httpx` synchrones et asynchrones ;
-- cache Meilisearch optimisé pour limiter les copies coûteuses ;
-- retries de transport configurables via `CacheConfig.transport_retries` ;
-- mise à jour des schémas OpenAPI, collections et index ;
-- stabilisation CI, typage, tests et formatage.
+- **refactor architecture** : `FFBBDataClient` (2865 → 272 lignes) découpé en `_RestFacade` + `_SearchFacade` — API publique 100% compatible ;
+- **unification sync/async** : les méthodes synchrones délèguent à leurs homologues asynchrones via `_run_async()`, éliminant ~604 lignes de duplication ;
+- **nouvelles entités** : EDF (matches, joueurs, rosters, équipes), Genius Sport (matches, live logs), Rematch Videos ;
+- **cache SQLite concurrency-safe** : fichiers séparés pour sync (`http_cache.db`) et async (`http_cache_async.db`) ;
+- **CI renforcée** : mypy + pyright + CodeQL + Dependabot + hook pre-push + wrapper parity check ;
+- **nettoyage** : suppression du shim `ffbb_api_client_v3`, scripts morts et code mort (`invalidate_pattern`).
 
 Voir aussi : [`CHANGELOG.md`](CHANGELOG.md) et [`RELEASE_NOTES.md`](RELEASE_NOTES.md).
 
@@ -148,11 +146,12 @@ lives = client.get_lives()
 | Domaine | Capacités |
 |---|---|
 | API FFBB | clubs, compétitions, organismes, saisons, poules, classements, rencontres, lives |
+| Entités additionnelles | EDF (matches, joueurs, rosters, équipes), Genius Sport, Rematch Videos |
 | Recherche | organismes, compétitions, rencontres, salles, terrains, pratiques, tournois, engagements et formations |
 | REST typé | récupération de ressources individuelles avec modèles Pydantic v2 |
-| Async | méthodes `*_async()` pour les appels réseau non bloquants |
-| Cache | cache HTTP `hishel`, sessions `httpx` réutilisées, retries configurables |
-| Sécurité | masquage des tokens dans les logs |
+| Async | méthodes `*_async()` — source de vérité ; sync délègue via `_run_async()` |
+| Cache | cache HTTP `hishel`, sessions `httpx` réutilisées, retries configurables, SQLite séparés sync/async |
+| Sécurité | masquage des tokens dans les logs, CodeQL scanning, Dependabot |
 | IA / MCP | structure compatible avec des wrappers MCP et agents IA |
 
 ---
@@ -272,15 +271,21 @@ Il est donc possible de laisser le client résoudre les tokens automatiquement o
 ```text
 src/ffbb_data_client/
 ├── clients/
-│   ├── ffbb_data_client.py       # Façade publique
-│   ├── api_ffbb_app_client.py      # Client REST FFBB
-│   └── meilisearch_ffbb_client.py  # Client recherche Meilisearch
-├── helpers/                        # Requêtes HTTP, multi-search, conversions
-├── models/                         # Modèles Pydantic v2
-├── utils/                          # cache, tokens, logging sécurisé
-└── data/                           # schémas et métadonnées embarqués
+│   ├── ffbb_data_client.py       # Façade publique (272 lignes, delegation)
+│   ├── _rest_facade.py           # Façade REST API (Directus)
+│   ├── _search_facade.py         # Façade recherche Meilisearch
+│   ├── api_ffbb_app_client.py    # Client REST FFBB (async source of truth)
+│   └── meilisearch_ffbb_client.py # Client recherche Meilisearch
+├── helpers/                       # Requêtes HTTP, multi-search, conversions
+├── models/                        # Modèles Pydantic v2
+├── utils/                         # cache (sync/async séparés), tokens, logging sécurisé
+└── data/                          # schémas et métadonnées embarqués
 ```
 
+> **Architecture sync/async** : Depuis v2.1.0, les méthodes asynchrones sont la source de vérité. Les méthodes synchrones délèguent via `_run_async()`, un helper qui gère les event loops imbriqués avec `ThreadPoolExecutor`.
+>
+> **Architecture facades** : Depuis v2.2.0, `FFBBDataClient` est une fine coquille qui compose `_RestFacade` et `_SearchFacade`. L'API publique reste identique — `client.get_organisme(123)` fonctionne comme avant.
+
 ---
 
 ## 🧪 Développement local
@@ -296,8 +301,13 @@ Commandes utiles :
 pytest tests/unit/
 pytest tests/integration/
 pytest tests/ --cov=src
+tox -e type          # mypy + pyright
 ```
 
+Hooks automatiques :
+- **pre-push** : exécute mypy + pyright avant chaque push
+- **pre-commit** : black, isort, flake8, trailing-whitespace
+
 Documentation complémentaire :
 
 - [`LOCAL_CI_GUIDE.md`](LOCAL_CI_GUIDE.md)

{ffbb_data_client-2.0.2 → ffbb_data_client-2.2.0}/README.md

@@ -33,20 +33,18 @@
 - du cache HTTP configurable via `hishel` ;
 - des helpers prêts pour l'intégration MCP / agents IA.
 
-> La V3 remplace l’approche V2 basée sur des dictionnaires bruts et une configuration manuelle. Elle privilégie le typage, la robustesse réseau et les appels batchés.
-
 ---
 
-## 🚀 Version v1.7.0 — 30 avril 2026
+## 🚀 Version v2.2.0 — Mai 2026
 
 Principales évolutions récentes :
 
-- ajout d'entités REST et Meilisearch : rencontres, officiels, entraîneurs, communes et assets ;
-- réutilisation des clients `httpx` synchrones et asynchrones ;
-- cache Meilisearch optimisé pour limiter les copies coûteuses ;
-- retries de transport configurables via `CacheConfig.transport_retries` ;
-- mise à jour des schémas OpenAPI, collections et index ;
-- stabilisation CI, typage, tests et formatage.
+- **refactor architecture** : `FFBBDataClient` (2865 → 272 lignes) découpé en `_RestFacade` + `_SearchFacade` — API publique 100% compatible ;
+- **unification sync/async** : les méthodes synchrones délèguent à leurs homologues asynchrones via `_run_async()`, éliminant ~604 lignes de duplication ;
+- **nouvelles entités** : EDF (matches, joueurs, rosters, équipes), Genius Sport (matches, live logs), Rematch Videos ;
+- **cache SQLite concurrency-safe** : fichiers séparés pour sync (`http_cache.db`) et async (`http_cache_async.db`) ;
+- **CI renforcée** : mypy + pyright + CodeQL + Dependabot + hook pre-push + wrapper parity check ;
+- **nettoyage** : suppression du shim `ffbb_api_client_v3`, scripts morts et code mort (`invalidate_pattern`).
 
 Voir aussi : [`CHANGELOG.md`](CHANGELOG.md) et [`RELEASE_NOTES.md`](RELEASE_NOTES.md).
 
@@ -96,11 +94,12 @@ lives = client.get_lives()
 | Domaine | Capacités |
 |---|---|
 | API FFBB | clubs, compétitions, organismes, saisons, poules, classements, rencontres, lives |
+| Entités additionnelles | EDF (matches, joueurs, rosters, équipes), Genius Sport, Rematch Videos |
 | Recherche | organismes, compétitions, rencontres, salles, terrains, pratiques, tournois, engagements et formations |
 | REST typé | récupération de ressources individuelles avec modèles Pydantic v2 |
-| Async | méthodes `*_async()` pour les appels réseau non bloquants |
-| Cache | cache HTTP `hishel`, sessions `httpx` réutilisées, retries configurables |
-| Sécurité | masquage des tokens dans les logs |
+| Async | méthodes `*_async()` — source de vérité ; sync délègue via `_run_async()` |
+| Cache | cache HTTP `hishel`, sessions `httpx` réutilisées, retries configurables, SQLite séparés sync/async |
+| Sécurité | masquage des tokens dans les logs, CodeQL scanning, Dependabot |
 | IA / MCP | structure compatible avec des wrappers MCP et agents IA |
 
 ---
@@ -220,15 +219,21 @@ Il est donc possible de laisser le client résoudre les tokens automatiquement o
 ```text
 src/ffbb_data_client/
 ├── clients/
-│   ├── ffbb_data_client.py       # Façade publique
-│   ├── api_ffbb_app_client.py      # Client REST FFBB
-│   └── meilisearch_ffbb_client.py  # Client recherche Meilisearch
-├── helpers/                        # Requêtes HTTP, multi-search, conversions
-├── models/                         # Modèles Pydantic v2
-├── utils/                          # cache, tokens, logging sécurisé
-└── data/                           # schémas et métadonnées embarqués
+│   ├── ffbb_data_client.py       # Façade publique (272 lignes, delegation)
+│   ├── _rest_facade.py           # Façade REST API (Directus)
+│   ├── _search_facade.py         # Façade recherche Meilisearch
+│   ├── api_ffbb_app_client.py    # Client REST FFBB (async source of truth)
+│   └── meilisearch_ffbb_client.py # Client recherche Meilisearch
+├── helpers/                       # Requêtes HTTP, multi-search, conversions
+├── models/                        # Modèles Pydantic v2
+├── utils/                         # cache (sync/async séparés), tokens, logging sécurisé
+└── data/                          # schémas et métadonnées embarqués
 ```
 
+> **Architecture sync/async** : Depuis v2.1.0, les méthodes asynchrones sont la source de vérité. Les méthodes synchrones délèguent via `_run_async()`, un helper qui gère les event loops imbriqués avec `ThreadPoolExecutor`.
+>
+> **Architecture facades** : Depuis v2.2.0, `FFBBDataClient` est une fine coquille qui compose `_RestFacade` et `_SearchFacade`. L'API publique reste identique — `client.get_organisme(123)` fonctionne comme avant.
+
 ---
 
 ## 🧪 Développement local
@@ -244,8 +249,13 @@ Commandes utiles :
 pytest tests/unit/
 pytest tests/integration/
 pytest tests/ --cov=src
+tox -e type          # mypy + pyright
 ```
 
+Hooks automatiques :
+- **pre-push** : exécute mypy + pyright avant chaque push
+- **pre-commit** : black, isort, flake8, trailing-whitespace
+
 Documentation complémentaire :
 
 - [`LOCAL_CI_GUIDE.md`](LOCAL_CI_GUIDE.md)