ffbb-data-client 2.3.3__tar.gz → 2.3.4__tar.gz

{ffbb_data_client-2.3.3 → ffbb_data_client-2.3.4}/.github/workflows/keep-ffbb-api-discovery-alive.yml

@@ -20,14 +20,14 @@ jobs:
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
-          last_ts=$(gh api repos/${{ github.repository }}/actions/workflows/update-ffbb-api-discovery.yml/runs \
-            --jq -r '.workflow_runs[0].created_at' 2>/dev/null || echo "1970-01-01T00:00:00Z")
+          last_ts=$(gh api repos/${{ github.repository }}/actions/workflows/268964669/runs \
+            --jq '.workflow_runs[0].created_at' | tr -d '"' || echo "1970-01-01T00:00:00Z")
           echo "last_run=$last_ts"
           cutoff=$(date -u -d '-22 hours' +%Y-%m-%dT%H:%M:%SZ)
           echo "cutoff=$cutoff"
           if [[ "$last_ts" < "$cutoff" ]]; then
             echo "STALE: last run $last_ts is older than 22h, triggering discovery now"
-            gh workflow run update-ffbb-api-discovery.yml
+            gh workflow run 268964669 --repo ${{ github.repository }} --ref master
             echo "triggered=true" >> "$GITHUB_OUTPUT"
           else
             echo "OK: discovery ran at $last_ts, no action needed"

{ffbb_data_client-2.3.3 → ffbb_data_client-2.3.4}/.github/workflows/publish.yml

@@ -4,6 +4,7 @@ on:
   push:
     tags:
       - 'v*'
+  workflow_dispatch:
 
 permissions:
   contents: read

{ffbb_data_client-2.3.3 → ffbb_data_client-2.3.4}/.github/workflows/release-after-discovery-merge.yml

@@ -9,6 +9,7 @@ on:
 permissions:
   contents: write
   pull-requests: read
+  actions: write
 
 concurrency:
   group: release-after-discovery-${{ github.event.workflow_run.head_sha }}
@@ -89,3 +90,10 @@ jobs:
           git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
           git tag -a "$NEXT_TAG" -m "Release $NEXT_TAG after FFBB API discovery PR #$PR_NUMBER"
           git push origin "$NEXT_TAG"
+
+      - name: Dispatch publish workflow
+        if: steps.pr.outputs.release == 'true'
+        env:
+          NEXT_TAG: ${{ steps.version.outputs.tag }}
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: gh workflow run publish.yml --ref "$NEXT_TAG"

{ffbb_data_client-2.3.3 → ffbb_data_client-2.3.4}/.github/workflows/update-ffbb-api-discovery.yml

@@ -81,3 +81,4 @@ jobs:
             src/ffbb_data_client/data/endpoint_discovery.json
             src/ffbb_data_client/data/indexes.json
             src/ffbb_data_client/data/openapi.json
+            README.md

{ffbb_data_client-2.3.3 → ffbb_data_client-2.3.4}/CHANGELOG.md

@@ -7,8 +7,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.3.4] - 2026-08-19
+
+### Fixed
+- **Security**: Masquage complet des tokens d'authentification dans les messages et arguments de formatage de logs (`CWE-532` / alertes CodeQL).
+- **Directus 403**: Retrait du champ `nom` obsolète dans `SaisonFields` pour prévenir les erreurs de permissions sur l'endpoint des saisons.
+
+### Added & Changed
+- **Website & Documentation**: Refonte de la landing page avec design spatial et support mobile 100% responsive (tiroir de navigation hamburger, protection contre le CSS grid blowout, typographie fluide).
+- **PyPI & Docs**: Correction des liens relatifs dans le README pour un affichage propre sur PyPI.
+
+
+## [2.3.3] - 2026-08-10
+
 ### Added
-- **Recherche parallèle** : `search_many` / `search_many_async` exécutent plusieurs recherches Meilisearch indépendantes concurrentement (`asyncio.gather`) et renvoient les résultats dans l'ordre. Chaque `SearchSpec` est dispatché vers la méthode `search_multiple_<resource>_async` correspondante.
+- **Recherche parallèle**: `search_many` / `search_many_async` exécutent plusieurs recherches Meilisearch indépendantes concurrentement (`asyncio.gather`) et renvoient les résultats dans l'ordre. Chaque `SearchSpec` est dispatché vers la méthode `search_multiple_<resource>_async` correspondante.
+- **Keepalive CI**: nouveau workflow `keep-ffbb-api-discovery-alive` garantissant une exécution quotidienne de la discovery automatique des artefacts API (relance si aucun run depuis 22 h).
+- **Unit tests** pour le script de discovery FFBB API (`scripts/discover_endpoints.py`).
 
 ### Changed
 - **Performance**: `recursive_smart_multi_search` / `recursive_smart_multi_search_async`
@@ -17,6 +32,35 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   allers-retours réseau un par un — divisant la latence de pagination par le nombre de pages.
 - Les requêtes de pagination sont désormais **clonées** (`dataclasses.replace`) au lieu de
   muter les objets `MultiSearchQuery` du caller, supprimant une fuite d'état entre appels.
+- **Refactor**: `api_ffbb_app_client.py` découpé en mixins (2408 → 113 lignes).
+- **Performance**: réutilisation des connexions HTTP, wheel allégée et déduplication des recherches Meilisearch.
+- **CI**: migration du AI PR reviewer (`.js` → `.cjs`), pagination et retry; simplification de la résolution de conflits de PR.
+
+### Fixed
+- Incohérences de la codebase : collision `HitType`, imports `_models` dépréciés remplacés par les sous-modules directs.
+- CI : exécution uniquement de l'environnement tox correspondant à la matrice dans le job de test.
+- Alertes CodeQL (imports) et ordre d'imports isort dans `http_requests_utils`.
+
+## [2.3.2] - 2026-06-13
+
+### Fixed
+- Résolution du cycle d'imports du token manager et alignement des fichiers d'outillage (`fix: resolve token manager import cycle and sync tooling files`).
+- Alertes CodeQL (imports et `empty-except`).
+- Corrections pre-commit appliquées pour passer la CI.
+
+## [2.3.1] - 2026-06-13
+
+### Added
+- **AI Pull Request Reviewer**: workflow d'analyse automatique des PR (analyse statique, commentaires automatiques, résolution de conflits `bolt.md`).
+
+### Changed
+- **Performance**: suppression de `TypeAdapter` de Pydantic au profit des parseurs natifs; optimisation de la réutilisation des connexions HTTP et du cache warming parallèle.
+- **CI**: cache pip et tox dans la pipeline GitHub Actions; opt-in Node.js 24 pour toutes les actions JavaScript; upgrade `actions/checkout` (4→6), `actions/setup-node` (4→6), `upload-artifact`/`download-artifact` (v7/v8), `github/codeql-action` (4.35.5→4.36.x); permission `workflows: write` ajoutée puis revertée sur `release-after-discovery-merge`.
+
+### Fixed
+- Alertes de code scanning (`md5`, variables globales inutilisées, faux positifs Ruff S105).
+- Cycle d'imports entre `token_manager` et `http_requests_utils`.
+- Ordre d'imports (isort) et corrections flake8 pour le pre-commit de mise à jour des artefacts.
 
 ## [2.3.0] - 2026-05-24
 
@@ -291,3 +335,10 @@ organisme = client.get_organisme(999999)
 if organisme is None:
     print("Organization not found or error occurred")
 ```
+
+[Unreleased]: https://github.com/nickdesi/ffbb-data-client/compare/v2.3.3...master
+[2.3.3]: https://github.com/nickdesi/ffbb-data-client/compare/v2.3.2...v2.3.3
+[2.3.2]: https://github.com/nickdesi/ffbb-data-client/compare/v2.3.1...v2.3.2
+[2.3.1]: https://github.com/nickdesi/ffbb-data-client/compare/v2.3.0...v2.3.1
+[2.3.0]: https://github.com/nickdesi/ffbb-data-client/compare/v2.2.0...v2.3.0
+[2.2.0]: https://github.com/nickdesi/ffbb-data-client/compare/v2.1.0...v2.2.0

ffbb_data_client-2.3.4/DESIGN.md

@@ -0,0 +1,171 @@
+---
+version: "alpha"
+name: "FFBB Data Client Design System"
+description: "Google Labs DESIGN.md specification for ffbb-data-client web presence and documentation UI"
+colors:
+  primary: "#090A0F"
+  on-primary: "#FFFFFF"
+  surface: "#121520"
+  on-surface: "#F1F5F9"
+  surface-variant: "#1A1F2E"
+  surface-elevated: "#22293D"
+  accent-orange: "#C03E08"
+  accent-amber: "#F59E0B"
+  accent-mint: "#34D399"
+  accent-cyan: "#06B6D4"
+  accent-indigo: "#818CF8"
+  text-secondary: "#94A3B8"
+  text-muted: "#64748B"
+  border-glass: "#22293D"
+  border-active: "#C03E08"
+typography:
+  display-hero:
+    fontFamily: "Outfit, Space Grotesk, sans-serif"
+    fontSize: "4.5rem"
+    fontWeight: "800"
+    lineHeight: "1.08"
+    letterSpacing: "-0.035em"
+  h1:
+    fontFamily: "Space Grotesk, sans-serif"
+    fontSize: "3.25rem"
+    fontWeight: "800"
+    lineHeight: "1.15"
+    letterSpacing: "-0.025em"
+  h2:
+    fontFamily: "Space Grotesk, sans-serif"
+    fontSize: "2.25rem"
+    fontWeight: "700"
+    lineHeight: "1.2"
+  h3:
+    fontFamily: "Outfit, Space Grotesk, sans-serif"
+    fontSize: "1.4rem"
+    fontWeight: "700"
+  body-lg:
+    fontFamily: "Inter, sans-serif"
+    fontSize: "1.25rem"
+    lineHeight: "1.7"
+  body-md:
+    fontFamily: "Inter, sans-serif"
+    fontSize: "1rem"
+    lineHeight: "1.65"
+  code:
+    fontFamily: "JetBrains Mono, monospace"
+    fontSize: "0.94rem"
+    lineHeight: "1.7"
+  label-caps:
+    fontFamily: "Inter, sans-serif"
+    fontSize: "0.85rem"
+    fontWeight: "600"
+    letterSpacing: "0.06em"
+rounded:
+  sm: "12px"
+  md: "16px"
+  card: "24px"
+  hero: "32px"
+  chip: "9999px"
+spacing:
+  xs: "4px"
+  sm: "8px"
+  md: "16px"
+  lg: "24px"
+  xl: "32px"
+  xxl: "64px"
+components:
+  button-primary:
+    backgroundColor: "{colors.accent-orange}"
+    textColor: "{colors.on-primary}"
+    rounded: "{rounded.chip}"
+    padding: "16px 36px"
+  button-surface:
+    backgroundColor: "{colors.surface-variant}"
+    textColor: "{colors.on-surface}"
+    rounded: "{rounded.chip}"
+    padding: "16px 36px"
+  chip-category:
+    backgroundColor: "{colors.surface-elevated}"
+    textColor: "{colors.text-secondary}"
+    rounded: "{rounded.chip}"
+    padding: "6px 16px"
+  chip-mint:
+    backgroundColor: "{colors.surface-variant}"
+    textColor: "{colors.accent-mint}"
+    rounded: "{rounded.chip}"
+  chip-cyan:
+    backgroundColor: "{colors.surface-variant}"
+    textColor: "{colors.accent-cyan}"
+    rounded: "{rounded.chip}"
+  chip-indigo:
+    backgroundColor: "{colors.surface-variant}"
+    textColor: "{colors.accent-indigo}"
+    rounded: "{rounded.chip}"
+  chip-amber:
+    backgroundColor: "{colors.surface-variant}"
+    textColor: "{colors.accent-amber}"
+    rounded: "{rounded.chip}"
+  feature-card:
+    backgroundColor: "{colors.surface}"
+    textColor: "{colors.on-surface}"
+    rounded: "{rounded.card}"
+    padding: "36px"
+  text-caption:
+    textColor: "{colors.text-muted}"
+  container-border:
+    backgroundColor: "{colors.border-glass}"
+  container-active-border:
+    backgroundColor: "{colors.border-active}"
+---
+
+## Overview
+
+Architectural Rigor meets Google Editorial Design. The visual identity of `ffbb-data-client` balances high-performance sports analytics with the refined typography and spatial clarity of Google Labs.
+
+## Colors
+
+The color system is built on deep slate foundations punctuated by the energetic warmth of Basketball Orange and Material You accent tones.
+
+- **Primary (#090A0F):** Deep midnight slate for full-bleed backgrounds and ambient mesh.
+- **Surface (#121520):** Elevated dark slate for cards and code containers.
+- **Accent Orange (#C03E08):** Vibrant French basketball orange — the primary interaction and brand signature.
+- **Accent Mint (#34D399) & Cyan (#06B6D4):** High-clarity feedback indicators for live synchronization and speed.
+- **Accent Indigo (#818CF8):** Editorial accent for architecture and developer tooling highlights.
+
+## Typography
+
+Typography establishes an expressive editorial hierarchy inspired by *Google Design* and *Space Grotesk*.
+
+- **Display & Headlines:** `Outfit` & `Space Grotesk` with tight tracking (`-0.035em`) for commanding editorial titles.
+- **Body & Captions:** `Inter` for optimal legibility across desktop and mobile screens.
+- **Code & Syntax:** `JetBrains Mono` for precise terminal snippets and typed Python examples.
+
+## Layout
+
+- Fluid 12-column grid maxing out at `1260px` with generous vertical breathing room (`96px` section padding).
+- Bento grid arrangements with asymmetric spotlight cards for lead architectural stories.
+
+## Elevation & Depth
+
+- Layered spatial depth using CSS `backdrop-filter: blur(20px)` and soft diffused shadows (`0 25px 60px -15px rgba(0,0,0,0.7)`).
+- Kinetic micro-elevations on hover with smooth spring easing curves (`cubic-bezier(0.16, 1, 0.3, 1)`).
+
+## Shapes
+
+- Pill-shaped interactive chips (`border-radius: 9999px`) for tags, action buttons, and live status badges.
+- Expressive rounded cards (`border-radius: 24px` to `32px`) echoing Material 3 geometric standards.
+
+## Components
+
+- **Playground Card:** Glassmorphism code block with macOS-style control dots, language tabs, and copy feedback.
+- **Spotlight Banner:** Lead story card combining continuous API discovery metrics with live JSON status.
+- **Interactive Chips Bar:** Filterable pills enabling frictionless switching between Python code snippets.
+
+## Do's and Don'ts
+
+### Do
+- Always use semantic color tokens for status badges (`accent-mint` for live sync, `accent-orange` for primary CTA).
+- Maintain generous whitespace and high-contrast editorial hierarchy.
+- Ensure all interactive cards have subtle hover states (`translateY(-4px)` with spring easing).
+
+### Don't
+- Never use generic pure grey backgrounds (`#111111`); always use tinted slate (`#090A0F`).
+- Avoid sharp corners (`0px` border radius) on interactive components.
+- Do not overload cards with heavy borders; prefer translucent glass borders (`rgba(255, 255, 255, 0.08)`).

{ffbb_data_client-2.3.3 → ffbb_data_client-2.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ffbb-data-client
-Version: 2.3.3
+Version: 2.3.4
 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
@@ -60,9 +60,9 @@ Dynamic: license-file
 [![Python](https://img.shields.io/pypi/pyversions/ffbb-data-client?logo=python&logoColor=white)](https://pypi.org/project/ffbb-data-client/)
 [![CI](https://github.com/nickdesi/ffbb-data-client/actions/workflows/ci.yml/badge.svg)](https://github.com/nickdesi/ffbb-data-client/actions/workflows/ci.yml)
 [![Coverage](https://coveralls.io/repos/github/nickdesi/ffbb-data-client/badge.svg?branch=master)](https://coveralls.io/github/nickdesi/ffbb-data-client?branch=master)
-[![License](https://img.shields.io/pypi/l/ffbb-data-client?color=green)](LICENSE.txt)
+[![License](https://img.shields.io/pypi/l/ffbb-data-client?color=green)](https://github.com/nickdesi/ffbb-data-client/blob/master/LICENSE.txt)
 [![MCP-Ready](https://img.shields.io/badge/MCP-Ready-orange.svg?logo=modelcontextprotocol&logoColor=white)](https://github.com/nickdesi/FFBB-MCP-Server)
-[![Security Policy](https://img.shields.io/badge/Security-Policy-blue.svg)](SECURITY.md)
+[![Security Policy](https://img.shields.io/badge/Security-Policy-blue.svg)](https://github.com/nickdesi/ffbb-data-client/blob/master/SECURITY.md)
 [![Stars](https://img.shields.io/github/stars/nickdesi/ffbb-data-client?style=social)](https://github.com/nickdesi/ffbb-data-client/stargazers)
 [![Last Commit](https://img.shields.io/github/last-commit/nickdesi/ffbb-data-client)](https://github.com/nickdesi/ffbb-data-client/commits/master)
 [![Issues](https://img.shields.io/github/issues/nickdesi/ffbb-data-client)](https://github.com/nickdesi/ffbb-data-client/issues)
@@ -92,17 +92,9 @@ Dynamic: license-file
 
 ---
 
-## 🚀 Version v2.3.1 — Juin 2026
+## 🚀 Nouveautés
 
-Principales évolutions récentes :
-
-- **détection de drift API** : surveillance des changements de schéma Directus (propriétés/types/nullabilité) ;
-- **détection de drift Meilisearch** : agrégation robuste des attributs (`sampleKeys`) sur plusieurs hits ;
-- **automatisation CI/CD** : ouverture automatique de PR lorsqu'un drift est détecté ;
-- **fiabilité outillage** : alignement pyupgrade/isort/pre-commit pour des runs CI reproductibles ;
-- **qualité/sécurité** : corrections CodeQL et nettoyage des alertes d'analyse statique.
-
-Voir aussi : [CHANGELOG.md](https://github.com/nickdesi/ffbb-data-client/blob/master/CHANGELOG.md) et [RELEASE_NOTES.md](https://github.com/nickdesi/ffbb-data-client/blob/master/RELEASE_NOTES.md).
+Les évolutions de chaque version sont documentées dans les [GitHub Releases](https://github.com/nickdesi/ffbb-data-client/releases), ainsi que dans [CHANGELOG.md](https://github.com/nickdesi/ffbb-data-client/blob/master/CHANGELOG.md) et [RELEASE_NOTES.md](https://github.com/nickdesi/ffbb-data-client/blob/master/RELEASE_NOTES.md).
 
 ---
 
@@ -362,19 +354,7 @@ Les contributions sont bienvenues :
 
 ## 📄 Licence
 
-Distribué sous licence Apache-2.0. Voir [`LICENSE.txt`](LICENSE.txt).
-
----
-
-## 📌 Recommandations GitHub
-
-**Description suggérée :**
-
-> 🏀 Modern async & typed Python SDK for FFBB public data (clubs, competitions, standings, lives) and Meilisearch search — the data layer behind the FFBB MCP Server.
-
-**Topics suggérés (≤ 20) :**
-
-`python` · `api-client` · `ffbb` · `open-data` · `basketball` · `mcp` · `model-context-protocol` · `async` · `pydantic` · `meilisearch` · `sdk` · `ai` · `llm` · `sports` · `rest-api` · `httpx` · `france` · `data` · `cache` · `typed`
+Distribué sous licence Apache-2.0. Voir [`LICENSE.txt`](https://github.com/nickdesi/ffbb-data-client/blob/master/LICENSE.txt).
 
 ---
 

{ffbb_data_client-2.3.3 → ffbb_data_client-2.3.4}/README.md

@@ -8,9 +8,9 @@
 [![Python](https://img.shields.io/pypi/pyversions/ffbb-data-client?logo=python&logoColor=white)](https://pypi.org/project/ffbb-data-client/)
 [![CI](https://github.com/nickdesi/ffbb-data-client/actions/workflows/ci.yml/badge.svg)](https://github.com/nickdesi/ffbb-data-client/actions/workflows/ci.yml)
 [![Coverage](https://coveralls.io/repos/github/nickdesi/ffbb-data-client/badge.svg?branch=master)](https://coveralls.io/github/nickdesi/ffbb-data-client?branch=master)
-[![License](https://img.shields.io/pypi/l/ffbb-data-client?color=green)](LICENSE.txt)
+[![License](https://img.shields.io/pypi/l/ffbb-data-client?color=green)](https://github.com/nickdesi/ffbb-data-client/blob/master/LICENSE.txt)
 [![MCP-Ready](https://img.shields.io/badge/MCP-Ready-orange.svg?logo=modelcontextprotocol&logoColor=white)](https://github.com/nickdesi/FFBB-MCP-Server)
-[![Security Policy](https://img.shields.io/badge/Security-Policy-blue.svg)](SECURITY.md)
+[![Security Policy](https://img.shields.io/badge/Security-Policy-blue.svg)](https://github.com/nickdesi/ffbb-data-client/blob/master/SECURITY.md)
 [![Stars](https://img.shields.io/github/stars/nickdesi/ffbb-data-client?style=social)](https://github.com/nickdesi/ffbb-data-client/stargazers)
 [![Last Commit](https://img.shields.io/github/last-commit/nickdesi/ffbb-data-client)](https://github.com/nickdesi/ffbb-data-client/commits/master)
 [![Issues](https://img.shields.io/github/issues/nickdesi/ffbb-data-client)](https://github.com/nickdesi/ffbb-data-client/issues)
@@ -40,17 +40,9 @@
 
 ---
 
-## 🚀 Version v2.3.1 — Juin 2026
+## 🚀 Nouveautés
 
-Principales évolutions récentes :
-
-- **détection de drift API** : surveillance des changements de schéma Directus (propriétés/types/nullabilité) ;
-- **détection de drift Meilisearch** : agrégation robuste des attributs (`sampleKeys`) sur plusieurs hits ;
-- **automatisation CI/CD** : ouverture automatique de PR lorsqu'un drift est détecté ;
-- **fiabilité outillage** : alignement pyupgrade/isort/pre-commit pour des runs CI reproductibles ;
-- **qualité/sécurité** : corrections CodeQL et nettoyage des alertes d'analyse statique.
-
-Voir aussi : [CHANGELOG.md](https://github.com/nickdesi/ffbb-data-client/blob/master/CHANGELOG.md) et [RELEASE_NOTES.md](https://github.com/nickdesi/ffbb-data-client/blob/master/RELEASE_NOTES.md).
+Les évolutions de chaque version sont documentées dans les [GitHub Releases](https://github.com/nickdesi/ffbb-data-client/releases), ainsi que dans [CHANGELOG.md](https://github.com/nickdesi/ffbb-data-client/blob/master/CHANGELOG.md) et [RELEASE_NOTES.md](https://github.com/nickdesi/ffbb-data-client/blob/master/RELEASE_NOTES.md).
 
 ---
 
@@ -310,19 +302,7 @@ Les contributions sont bienvenues :
 
 ## 📄 Licence
 
-Distribué sous licence Apache-2.0. Voir [`LICENSE.txt`](LICENSE.txt).
-
----
-
-## 📌 Recommandations GitHub
-
-**Description suggérée :**
-
-> 🏀 Modern async & typed Python SDK for FFBB public data (clubs, competitions, standings, lives) and Meilisearch search — the data layer behind the FFBB MCP Server.
-
-**Topics suggérés (≤ 20) :**
-
-`python` · `api-client` · `ffbb` · `open-data` · `basketball` · `mcp` · `model-context-protocol` · `async` · `pydantic` · `meilisearch` · `sdk` · `ai` · `llm` · `sports` · `rest-api` · `httpx` · `france` · `data` · `cache` · `typed`
+Distribué sous licence Apache-2.0. Voir [`LICENSE.txt`](https://github.com/nickdesi/ffbb-data-client/blob/master/LICENSE.txt).
 
 ---
 

{ffbb_data_client-2.3.3 → ffbb_data_client-2.3.4}/RELEASE_NOTES.md

@@ -1,6 +1,78 @@
-# Release Notes - FFBB API Client V2
+# Release Notes - FFBB Data Client
 
-## Version 2.2.0 (Latest Release)
+## Version 2.3.4 (Latest Release)
+
+### 🔒 Security & Bug Fixes
+- **Sensitive logging mitigation**: Masked authentication tokens in logging messages and format arguments (`CWE-532` / CodeQL compliance)
+- **Directus compatibility**: Removed non-existent `nom` field from default `SaisonFields` to prevent Directus 403 errors
+
+### 📱 Responsive Website & Documentation
+- **Mobile optimization**: Full smartphone responsiveness on landing page (mobile hamburger drawer, fluid font scaling, CSS grid blowout prevention)
+- **PyPI documentation**: Standardized README badges and absolute GitHub URLs for flawless rendering on PyPI
+
+---
+
+## Version 2.3.3
+
+### 🚀 New Features
+- **`search_many` / `search_many_async`**: run multiple independent Meilisearch searches concurrently (`asyncio.gather`) and return results in order — each `SearchSpec` is dispatched to the matching `search_multiple_<resource>_async` method
+- **Keepalive workflow**: new `keep-ffbb-api-discovery-alive` workflow guarantees a daily FFBB API discovery run (auto-triggers when no run happened in the last 22 h)
+- **Unit tests** for the FFBB API discovery script (`scripts/discover_endpoints.py`)
+
+### ⚡ Performance
+- **Concurrent Meilisearch pagination**: `recursive_smart_multi_search` / `recursive_smart_multi_search_async` now fetch pages in parallel (batches of 10, `asyncio.gather` async / `ThreadPoolExecutor` sync) instead of sequential round-trips — dividing pagination latency by the number of pages
+- **Non-mutating queries**: pagination requests are now cloned (`dataclasses.replace`) instead of mutating the caller's `MultiSearchQuery` objects, removing cross-call state leaks
+- **Slimmer wheel + HTTP connection reuse** + Meilisearch query deduplication
+
+### 🏗 Refactor
+- `api_ffbb_app_client.py` split into mixins (2408 → 113 lines)
+
+### 🐛 Bug Fixes
+- Codebase inconsistencies: `HitType` collision, deprecated `_models` imports replaced with direct submodules
+- isort formatting in `niveau_models.py`
+- CI: only run the matrix-matching tox env in the test job
+- CodeQL alerts (imports) and isort ordering in `http_requests_utils`
+
+### 📦 Misc
+- Docs: improved README, rewrote SECURITY.md, added FUNDING.yml
+- CI: AI PR reviewer migrated to `.cjs` (pagination + retry), simplified PR conflict resolution, refreshed FFBB API discovery artefacts (#57)
+- Dependency bumps (checkout v7, CodeQL 4.37, setuptools ≥83, attest 4.1.1, cache v6, softprops/action-gh-release 3.0.1)
+
+---
+
+## Version 2.3.2
+
+### 🐛 Bug Fixes
+- Resolved token manager import cycle and synced tooling files
+- CodeQL import and empty-except alerts
+- Pre-commit fixes applied to pass CI
+
+### 📦 Misc
+- Updated PyPI README version block to 2.3.1
+- Reverted invalid `workflows: write` permission on release-after-discovery-merge workflow
+
+---
+
+## Version 2.3.1
+
+### ⚡ Performance
+- Replaced Pydantic `TypeAdapter` with native parsers for faster deserialization
+- Optimized HTTP connection reuse and parallel cache warming
+
+### 🔒 Security & Quality
+- Fixed code-scanning alerts (`md5` usage, unused global variables, Ruff S105 false positives)
+- Resolved cyclic import between `token_manager` and `http_requests_utils`
+
+### 🚀 CI/CD
+- **AI Pull Request Reviewer** workflow added (static analysis, automatic comments, `bolt.md` conflict auto-resolver)
+- Node.js 24 opt-in for all JavaScript actions
+- GitHub Actions pipeline optimized with pip cache and tox
+- Action upgrades: `actions/checkout` 4→6, `actions/setup-node` 4→6, `upload-artifact` v7 / `download-artifact` v8, `github/codeql-action` 4.35.5→4.36.x
+- `hishel` dependency bumped to ≥1.3.0
+
+---
+
+## Version 2.2.0 (Previous Release)
 
 ### 🏗 Architecture Refactor
 

{ffbb_data_client-2.3.3 → ffbb_data_client-2.3.4}/scripts/discover_endpoints.py

@@ -17,6 +17,7 @@ from __future__ import annotations
 
 import hashlib
 import json
+import re
 import sys
 from datetime import datetime, timezone
 from pathlib import Path
@@ -509,6 +510,41 @@ def _build_change_summary(
     return "\n".join(lines) + "\n"
 
 
+def _update_readme_discovery_metrics(
+    collections_count: int, indexes_count: int
+) -> bool:
+    readme_path = PROJECT_ROOT / "README.md"
+    if not readme_path.exists():
+        return False
+    text = readme_path.read_text(encoding="utf-8")
+    block_start = "<!-- DISCOVERY_METRICS:START -->"
+    block_end = "<!-- DISCOVERY_METRICS:END -->"
+    nl = chr(10)
+    new_block = (
+        block_start
+        + nl
+        + f"> 🔄 **Cartographie API synchronisée** : `{collections_count}` collections Directus OpenAPI cartographiées, "
+        f"`{indexes_count}` index Meilisearch surveillés." + nl + block_end
+    )
+
+    if block_start in text and block_end in text:
+        pattern = re.compile(
+            rf"{re.escape(block_start)}.*?{re.escape(block_end)}", re.DOTALL
+        )
+        updated = pattern.sub(new_block, text)
+    else:
+        needle = "---" + nl + nl + "## 📌 À propos"
+        if needle in text:
+            updated = text.replace(needle, new_block + nl + nl + needle)
+        else:
+            updated = text + nl + nl + new_block + nl
+
+    if updated != text:
+        readme_path.write_text(updated, encoding="utf-8")
+        return True
+    return False
+
+
 def main() -> None:
     DATA_DIR.mkdir(parents=True, exist_ok=True)
 
@@ -610,6 +646,7 @@ def main() -> None:
 
     packaged_changed = _sync_packaged_artefacts(PACKAGED_ARTEFACT_PATHS)
 
+    _update_readme_discovery_metrics(len(collections), len(available_indexes))
     print(f"Directus collections: {len(collections)}")
     print(f"Directus item paths: {len(item_paths)}")
     print(f"Available Meilisearch indexes: {len(available_indexes)}")

{ffbb_data_client-2.3.3 → ffbb_data_client-2.3.4}/src/ffbb_data_client/clients/api_ffbb_app_client.py

@@ -11,7 +11,7 @@ from ..utils.retry_utils import (
     get_default_retry_config,
     get_default_timeout_config,
 )
-from ..utils.secure_logging import get_secure_logger, mask_token
+from ..utils.secure_logging import get_secure_logger
 from ._mixins.competition import CompetitionMixin
 from ._mixins.external import ExternalMixin
 from ._mixins.getters import GettersMixin
@@ -89,9 +89,10 @@ class ApiFFBBAppClient(
 
         self.logger = get_secure_logger(f"{self.__class__.__name__}")
 
-        masked_token = mask_token(self._bearer_token)
         if self.debug:
-            self.logger.info(f"ApiFFBBAppClient initialized with token: {masked_token}")
+            self.logger.info(
+                "ApiFFBBAppClient initialized with authentication token configured"
+            )
             self.logger.info(
                 f"Retry config: {self.retry_config.max_attempts} attempts, "
                 f"timeout: {self.timeout_config.total_timeout}s"

{ffbb_data_client-2.3.3 → ffbb_data_client-2.3.4}/src/ffbb_data_client/clients/meilisearch_client.py

@@ -30,7 +30,7 @@ from ..utils.retry_utils import (
     get_default_retry_config,
     get_default_timeout_config,
 )
-from ..utils.secure_logging import get_secure_logger, mask_token
+from ..utils.secure_logging import get_secure_logger
 
 _APP_CACHE: dict[str, tuple[float, Any]] = {}
 _APP_CACHE_LOCK = threading.Lock()
@@ -134,11 +134,10 @@ class MeilisearchClient:
         # Initialize secure logger
         self.logger = get_secure_logger(f"{self.__class__.__name__}")
 
-        # Log initialization with masked token
-        masked_token = mask_token(self._bearer_token)
+        # Log initialization without leaking token
         if self.debug:
             self.logger.info(
-                f"MeilisearchClient initialized with token: {masked_token}"
+                "MeilisearchClient initialized with authentication token configured"
             )
             self.logger.info(
                 f"Retry config: {self.retry_config.max_attempts} attempts, "

{ffbb_data_client-2.3.3 → ffbb_data_client-2.3.4}/src/ffbb_data_client/models/saison_fields.py

@@ -18,7 +18,6 @@ class SaisonFields:
         """Get default fields for saison queries."""
         return [
             cls.ID,
-            cls.NOM,
             cls.ACTIF,
             cls.DEBUT,
             cls.FIN,

{ffbb_data_client-2.3.3 → ffbb_data_client-2.3.4}/src/ffbb_data_client/utils/secure_logging.py

@@ -83,35 +83,38 @@ class SecureLogger:
 
         return masked_message
 
+    def _log(self, level: int, message: str, *args, **kwargs):
+        """Log with sensitive data masked in the message and its format args."""
+        masked_message = self._mask_sensitive_data(message)
+        masked_args = tuple(
+            self._mask_sensitive_data(arg) if isinstance(arg, str) else arg
+            for arg in args
+        )
+        self.logger.log(level, masked_message, *masked_args, **kwargs)
+
     def debug(self, message: str, *args, **kwargs):
         """Log a debug message with sensitive data masked."""
-        masked_message = self._mask_sensitive_data(message)
-        self.logger.debug(masked_message, *args, **kwargs)
+        self._log(logging.DEBUG, message, *args, **kwargs)
 
     def info(self, message: str, *args, **kwargs):
         """Log an info message with sensitive data masked."""
-        masked_message = self._mask_sensitive_data(message)
-        self.logger.info(masked_message, *args, **kwargs)
+        self._log(logging.INFO, message, *args, **kwargs)
 
     def warning(self, message: str, *args, **kwargs):
         """Log a warning message with sensitive data masked."""
-        masked_message = self._mask_sensitive_data(message)
-        self.logger.warning(masked_message, *args, **kwargs)
+        self._log(logging.WARNING, message, *args, **kwargs)
 
     def error(self, message: str, *args, **kwargs):
         """Log an error message with sensitive data masked."""
-        masked_message = self._mask_sensitive_data(message)
-        self.logger.error(masked_message, *args, **kwargs)
+        self._log(logging.ERROR, message, *args, **kwargs)
 
     def critical(self, message: str, *args, **kwargs):
         """Log a critical message with sensitive data masked."""
-        masked_message = self._mask_sensitive_data(message)
-        self.logger.critical(masked_message, *args, **kwargs)
+        self._log(logging.CRITICAL, message, *args, **kwargs)
 
     def log(self, level: int, message: str, *args, **kwargs):
         """Log a message at the specified level with sensitive data masked."""
-        masked_message = self._mask_sensitive_data(message)
-        self.logger.log(level, masked_message, *args, **kwargs)
+        self._log(level, message, *args, **kwargs)
 
 
 # Global secure logger instance