ffbb-data-client 2.4.26__tar.gz → 2.4.27__tar.gz

{ffbb_data_client-2.4.26 → ffbb_data_client-2.4.27}/.github/workflows/update-ffbb-api-discovery.yml

@@ -36,10 +36,30 @@ jobs:
 
       - name: Refresh FFBB API discovery artefacts
         env:
+          # Secrets optionnels : en leur absence, TokenManager bascule sur
+          # l'endpoint public /items/configuration (chemin nominal, aucun
+          # ticket requis). Ne pas les rendre obligatoires.
           API_FFBB_APP_BEARER_TOKEN: ${{ secrets.API_FFBB_APP_BEARER_TOKEN }}
           MEILISEARCH_BEARER_TOKEN: ${{ secrets.MEILISEARCH_BEARER_TOKEN }}
         run: python scripts/discover_endpoints.py
 
+      - name: Probe FFBB permission matrix
+        continue-on-error: true
+        env:
+          # Idem : optionnel, le endpoint public est le chemin nominal.
+          API_FFBB_APP_BEARER_TOKEN: ${{ secrets.API_FFBB_APP_BEARER_TOKEN }}
+        run: python scripts/discover_permissions.py
+
+      - name: Detect permission drift
+        id: permission
+        run: |
+          if [ -f data/permission_drift_summary.md ] && grep -q '^- FLIP' data/permission_drift_summary.md; then
+            echo "pchanged=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "pchanged=false" >> "$GITHUB_OUTPUT"
+            echo "No permission drift detected; skipping permission PR."
+          fi
+
       - name: Detect structural discovery changes
         id: changes
         run: |
@@ -60,7 +80,7 @@ jobs:
           retention-days: 14
 
       - name: Create pull request
-        if: steps.changes.outputs.changed == 'true'
+        if: steps.changes.outputs.changed == 'true' || steps.permission.outputs.pchanged == 'true'
         uses: peter-evans/create-pull-request@5f6978faf089d4d20b00c7766989d076bb2fc7f1  # v8
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
@@ -80,12 +100,15 @@ jobs:
             data/openapi_full.json
             data/api_update_summary.md
             data/field_dictionary.json
+            data/permission_matrix.json
+            data/permission_drift_summary.md
             src/ffbb_data_client/data/__init__.py
             src/ffbb_data_client/data/collections.json
             src/ffbb_data_client/data/endpoint_discovery.json
             src/ffbb_data_client/data/indexes.json
             src/ffbb_data_client/data/openapi.json
             src/ffbb_data_client/data/field_dictionary.json
+            src/ffbb_data_client/data/permission_matrix.json
             docs/data_dictionary.rst
             docs/index.rst
             README.md

{ffbb_data_client-2.4.26 → ffbb_data_client-2.4.27}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ffbb-data-client
-Version: 2.4.26
+Version: 2.4.27
 Summary: API FFBB — SDK Python moderne & asynchrone pour les donnees officielles de la Federation Francaise de BasketBall (clubs, classements, calendriers, lives, Meilisearch). Alternative moderne a ffbb-api-client.
 Home-page: https://github.com/nickdesi/ffbb-data-client
 Author: nickdesi
@@ -94,7 +94,7 @@ Dynamic: license-file
 </div>
 
 <!-- DISCOVERY_METRICS:START -->
-> 🔄 **Cartographie API FFBB Synchronisée en Direct** : `162` collections Directus OpenAPI cartographiées, `13` index Meilisearch surveillés quotidiennement.
+> 🔄 **Cartographie API synchronisée** : `162` collections Directus OpenAPI cartographiées, `13` index Meilisearch surveillés.
 <!-- DISCOVERY_METRICS:END -->
 
 ---

{ffbb_data_client-2.4.26 → ffbb_data_client-2.4.27}/README.md

@@ -38,7 +38,7 @@
 </div>
 
 <!-- DISCOVERY_METRICS:START -->
-> 🔄 **Cartographie API FFBB Synchronisée en Direct** : `162` collections Directus OpenAPI cartographiées, `13` index Meilisearch surveillés quotidiennement.
+> 🔄 **Cartographie API synchronisée** : `162` collections Directus OpenAPI cartographiées, `13` index Meilisearch surveillés.
 <!-- DISCOVERY_METRICS:END -->
 
 ---

{ffbb_data_client-2.4.26 → ffbb_data_client-2.4.27}/data/api_update_summary.md

@@ -1,10 +1,10 @@
 # FFBB API update summary
 
-- Timestamp: `2026-09-11T10:11:11.270973+00:00`
+- Timestamp: `2026-09-22T17:00:08.433649+00:00`
 - API base URL: `https://api.ffbb.app/`
 - Meilisearch base URL: `https://meilisearch-prod.ffbb.app/`
-- OpenAPI version: `326edbfd6bf4f57c9f1e22a17f0a177e9c85619b`
-- OpenAPI SHA256: `1c6ecdab182113ad582b154df4d66bc1416a387d6fc4d57dd5b6788f39288a51`
+- OpenAPI version: `ad3cb9daf88b1ca300873db9525ebe94e0a60b53`
+- OpenAPI SHA256: `f8b0f0dfeab65521950357efb47d43350ca403e0a0baefbcbc811ed723778b74`
 
 ## Directus collections
 - Total: `162`
@@ -22,3 +22,7 @@
 - Removed: None
 
 Generated by `python scripts/discover_endpoints.py`.
+
+## Permission matrix drift
+
+La politique d'autorisation Directus a changé (ou un canari a péri). Détail : `data/permission_drift_summary.md`.

{ffbb_data_client-2.4.26 → ffbb_data_client-2.4.27}/data/endpoint_discovery.json

@@ -329,9 +329,9 @@
       "items/youtube_videos_youtube_tags"
     ],
     "metadata": {
-      "openapi_version": "326edbfd6bf4f57c9f1e22a17f0a177e9c85619b",
+      "openapi_version": "ad3cb9daf88b1ca300873db9525ebe94e0a60b53",
       "source": "https://api.ffbb.app/server/specs/oas",
-      "timestamp": "2026-09-11T10:11:11.270973+00:00"
+      "timestamp": "2026-09-22T17:00:08.433649+00:00"
     },
     "paths": {
       "items/configuration": [
@@ -1400,7 +1400,7 @@
       },
       {
         "available": true,
-        "estimatedTotalHits": 429,
+        "estimatedTotalHits": 515,
         "indexUid": "ffbbnational_pratiques",
         "sampleKeys": [
           "_geo",
@@ -1457,7 +1457,7 @@
       },
       {
         "available": true,
-        "estimatedTotalHits": 4228,
+        "estimatedTotalHits": 4296,
         "indexUid": "ffbbnational_rss",
         "sampleKeys": [
           "categories",
@@ -1487,7 +1487,7 @@
       },
       {
         "available": true,
-        "estimatedTotalHits": 1680,
+        "estimatedTotalHits": 2442,
         "indexUid": "ffbbserver_competitions",
         "sampleKeys": [
           "age",
@@ -1567,7 +1567,7 @@
       },
       {
         "available": true,
-        "estimatedTotalHits": 146,
+        "estimatedTotalHits": 144,
         "indexUid": "ffbbserver_formations",
         "sampleKeys": [
           "certification",
@@ -1602,7 +1602,7 @@
       },
       {
         "available": true,
-        "estimatedTotalHits": 4714,
+        "estimatedTotalHits": 5000,
         "indexUid": "ffbbserver_organismes",
         "sampleKeys": [
           "_geo",
@@ -1730,7 +1730,7 @@
       },
       {
         "available": true,
-        "estimatedTotalHits": 7,
+        "estimatedTotalHits": 3,
         "indexUid": "ffbbserver_tournois",
         "sampleKeys": [
           "_geo",
@@ -1769,7 +1769,7 @@
       },
       {
         "available": true,
-        "estimatedTotalHits": 6229,
+        "estimatedTotalHits": 6301,
         "indexUid": "ffbbsite_news",
         "sampleKeys": [
           "author",
@@ -1798,7 +1798,7 @@
       },
       {
         "available": true,
-        "estimatedTotalHits": 1858,
+        "estimatedTotalHits": 1863,
         "indexUid": "youtube_videos",
         "sampleKeys": [
           "channelId",
@@ -1831,7 +1831,7 @@
     ],
     "metadata": {
       "source": "https://meilisearch-prod.ffbb.app/multi-search",
-      "timestamp": "2026-09-11T10:11:11.270973+00:00"
+      "timestamp": "2026-09-22T17:00:08.433649+00:00"
     },
     "unavailable_indexes": [
       {
@@ -1867,9 +1867,9 @@
   "metadata": {
     "api_base_url": "https://api.ffbb.app/",
     "meilisearch_base_url": "https://meilisearch-prod.ffbb.app/",
-    "openapi_sha256": "1c6ecdab182113ad582b154df4d66bc1416a387d6fc4d57dd5b6788f39288a51",
-    "openapi_snapshot_sha256": "ddaf588729dc2f1f68ced57a5d4dd6fb5afc3f807be028ef1d4e8e439a3b6219",
-    "openapi_version": "326edbfd6bf4f57c9f1e22a17f0a177e9c85619b",
-    "timestamp": "2026-09-11T10:11:11.270973+00:00"
+    "openapi_sha256": "f8b0f0dfeab65521950357efb47d43350ca403e0a0baefbcbc811ed723778b74",
+    "openapi_snapshot_sha256": "db8328e08e39aac448a36efce34ee1b20ed18745c279d97a51c4c0d5eb9a848b",
+    "openapi_version": "ad3cb9daf88b1ca300873db9525ebe94e0a60b53",
+    "timestamp": "2026-09-22T17:00:08.433649+00:00"
   }
 }

{ffbb_data_client-2.4.26/src/ffbb_data_client → ffbb_data_client-2.4.27}/data/indexes.json

@@ -40,7 +40,7 @@
     },
     {
       "available": true,
-      "estimatedTotalHits": 429,
+      "estimatedTotalHits": 515,
       "indexUid": "ffbbnational_pratiques",
       "sampleKeys": [
         "_geo",
@@ -97,7 +97,7 @@
     },
     {
       "available": true,
-      "estimatedTotalHits": 4228,
+      "estimatedTotalHits": 4296,
       "indexUid": "ffbbnational_rss",
       "sampleKeys": [
         "categories",
@@ -127,7 +127,7 @@
     },
     {
       "available": true,
-      "estimatedTotalHits": 1680,
+      "estimatedTotalHits": 2442,
       "indexUid": "ffbbserver_competitions",
       "sampleKeys": [
         "age",
@@ -207,7 +207,7 @@
     },
     {
       "available": true,
-      "estimatedTotalHits": 146,
+      "estimatedTotalHits": 144,
       "indexUid": "ffbbserver_formations",
       "sampleKeys": [
         "certification",
@@ -242,7 +242,7 @@
     },
     {
       "available": true,
-      "estimatedTotalHits": 4714,
+      "estimatedTotalHits": 5000,
       "indexUid": "ffbbserver_organismes",
       "sampleKeys": [
         "_geo",
@@ -370,7 +370,7 @@
     },
     {
       "available": true,
-      "estimatedTotalHits": 7,
+      "estimatedTotalHits": 3,
       "indexUid": "ffbbserver_tournois",
       "sampleKeys": [
         "_geo",
@@ -409,7 +409,7 @@
     },
     {
       "available": true,
-      "estimatedTotalHits": 6229,
+      "estimatedTotalHits": 6301,
       "indexUid": "ffbbsite_news",
       "sampleKeys": [
         "author",
@@ -438,7 +438,7 @@
     },
     {
       "available": true,
-      "estimatedTotalHits": 1858,
+      "estimatedTotalHits": 1863,
       "indexUid": "youtube_videos",
       "sampleKeys": [
         "channelId",
@@ -471,7 +471,7 @@
   ],
   "metadata": {
     "source": "https://meilisearch-prod.ffbb.app/multi-search",
-    "timestamp": "2026-09-11T09:44:26.132076+00:00"
+    "timestamp": "2026-09-22T17:00:08.433649+00:00"
   },
   "unavailable_indexes": [
     {

ffbb_data_client-2.4.27/data/permission_drift_summary.md

@@ -0,0 +1,15 @@
+# FFBB permission matrix drift — 2026-09-22T17:00:16.721946+00:00
+
+- FLIP: competition_archived_direct: probe added
+- FLIP: competition_archived_filter: probe added
+- FLIP: competition_current_direct: probe added
+- FLIP: competition_current_filter: probe added
+- FLIP: competitions_listing: probe added
+- FLIP: config_noauth: probe added
+- FLIP: engagements_listing: probe added
+- FLIP: organismes_listing: probe added
+- FLIP: rencontres_listing: probe added
+- FLIP: saisons_id_field: probe added
+- FLIP: saisons_nom_field: probe added
+
+Vérifier la politique de rôles Directus (filtres de saison, champs restreints) ou rafraîchir les canaris après un rollover de saison.

ffbb_data_client-2.4.27/data/permission_matrix.json

@@ -0,0 +1,107 @@
+{
+  "drift": {
+    "added": [
+      "competition_archived_direct",
+      "competition_archived_filter",
+      "competition_current_direct",
+      "competition_current_filter",
+      "competitions_listing",
+      "config_noauth",
+      "engagements_listing",
+      "organismes_listing",
+      "rencontres_listing",
+      "saisons_id_field",
+      "saisons_nom_field"
+    ],
+    "flips": [],
+    "removed": []
+  },
+  "metadata": {
+    "api_base_url": "https://api.ffbb.app/",
+    "archived_competition_id": "200000002872733",
+    "canary_season": "2026-2027",
+    "current_competition_id": "200000002900744",
+    "timestamp": "2026-09-22T17:00:16.721946+00:00",
+    "token_source": "public-fallback"
+  },
+  "probes": [
+    {
+      "name": "config_noauth",
+      "notes": "Public endpoint sans auth : contrôle BunnyCDN et joignabilité.",
+      "outcome": "ok",
+      "status": 200,
+      "url": "https://api.ffbb.app/items/configuration"
+    },
+    {
+      "name": "saisons_id_field",
+      "notes": "Champ contrôle, attendu ok.",
+      "outcome": "ok",
+      "status": 200,
+      "url": "https://api.ffbb.app/items/ffbbserver_saisons?fields%5B%5D=id&limit=1"
+    },
+    {
+      "name": "saisons_nom_field",
+      "notes": "Champ restreint depuis sept 2026 : 403 Directus attendu.",
+      "outcome": "forbidden_directus",
+      "status": 403,
+      "url": "https://api.ffbb.app/items/ffbbserver_saisons?fields%5B%5D=nom&limit=1"
+    },
+    {
+      "name": "competitions_listing",
+      "notes": "Listing contrôle, attendu ok.",
+      "outcome": "ok",
+      "status": 200,
+      "url": "https://api.ffbb.app/items/ffbbserver_competitions?limit=1"
+    },
+    {
+      "name": "organismes_listing",
+      "notes": "Listing contrôle, attendu ok.",
+      "outcome": "ok",
+      "status": 200,
+      "url": "https://api.ffbb.app/items/ffbbserver_organismes?limit=1"
+    },
+    {
+      "name": "rencontres_listing",
+      "notes": "Listing contrôle, attendu ok.",
+      "outcome": "ok",
+      "status": 200,
+      "url": "https://api.ffbb.app/items/ffbbserver_rencontres?limit=1"
+    },
+    {
+      "name": "engagements_listing",
+      "notes": "Listing contrôle, attendu ok.",
+      "outcome": "ok",
+      "status": 200,
+      "url": "https://api.ffbb.app/items/ffbbserver_engagements?limit=1"
+    },
+    {
+      "name": "competition_current_direct",
+      "notes": "Canari saison 2026-2027 : à rafraîchir à chaque rollover. Un flip ici signale un canari périmé, pas forcément un changement de politique.",
+      "outcome": "ok",
+      "status": 200,
+      "url": "https://api.ffbb.app/items/ffbbserver_competitions/200000002900744"
+    },
+    {
+      "name": "competition_current_filter",
+      "notes": "Filtre sur saison courante, attendu ok non vide.",
+      "outcome": "ok",
+      "status": 200,
+      "url": "https://api.ffbb.app/items/ffbbserver_competitions?filter%5Bid%5D%5B_eq%5D=200000002900744&limit=1"
+    },
+    {
+      "name": "competition_archived_direct",
+      "notes": "Saison archivée : 403 Directus attendu sur accès direct.",
+      "outcome": "forbidden_directus",
+      "status": 403,
+      "url": "https://api.ffbb.app/items/ffbbserver_competitions/200000002872733"
+    },
+    {
+      "content_type": "application/json; charset=utf-8",
+      "name": "competition_archived_filter",
+      "notes": "Filtre sur archivé : 200 vide attendu (pas une erreur HTTP).",
+      "outcome": "empty",
+      "status": 200,
+      "url": "https://api.ffbb.app/items/ffbbserver_competitions?filter%5Bid%5D%5B_eq%5D=200000002872733&limit=1"
+    }
+  ]
+}

{ffbb_data_client-2.4.26 → ffbb_data_client-2.4.27}/docs/data_dictionary.rst

@@ -75,7 +75,7 @@ Index ``ffbbnational_galeries``
 Index ``ffbbnational_pratiques``
 --------------------------------
 
-- **Nombre d'enregistrements estimés** : ``429``
+- **Nombre d'enregistrements estimés** : ``515``
 
 .. list-table::
    :header-rows: 1
@@ -235,7 +235,7 @@ Index ``ffbbnational_pratiques``
 Index ``ffbbnational_rss``
 --------------------------
 
-- **Nombre d'enregistrements estimés** : ``4228``
+- **Nombre d'enregistrements estimés** : ``4296``
 
 .. list-table::
    :header-rows: 1
@@ -314,7 +314,7 @@ Index ``ffbbnational_rss``
 Index ``ffbbserver_competitions``
 ---------------------------------
 
-- **Nombre d'enregistrements estimés** : ``1680``
+- **Nombre d'enregistrements estimés** : ``2442``
 
 .. list-table::
    :header-rows: 1
@@ -532,7 +532,7 @@ Index ``ffbbserver_engagements``
 Index ``ffbbserver_formations``
 -------------------------------
 
-- **Nombre d'enregistrements estimés** : ``146``
+- **Nombre d'enregistrements estimés** : ``144``
 
 .. list-table::
    :header-rows: 1
@@ -626,7 +626,7 @@ Index ``ffbbserver_formations``
 Index ``ffbbserver_organismes``
 -------------------------------
 
-- **Nombre d'enregistrements estimés** : ``4714``
+- **Nombre d'enregistrements estimés** : ``5000``
 
 .. list-table::
    :header-rows: 1
@@ -966,7 +966,7 @@ Index ``ffbbserver_terrains``
 Index ``ffbbserver_tournois``
 -----------------------------
 
-- **Nombre d'enregistrements estimés** : ``7``
+- **Nombre d'enregistrements estimés** : ``3``
 
 .. list-table::
    :header-rows: 1
@@ -1072,7 +1072,7 @@ Index ``ffbbserver_tournois``
 Index ``ffbbsite_news``
 -----------------------
 
-- **Nombre d'enregistrements estimés** : ``6229``
+- **Nombre d'enregistrements estimés** : ``6301``
 
 .. list-table::
    :header-rows: 1
@@ -1148,7 +1148,7 @@ Index ``ffbbsite_news``
 Index ``youtube_videos``
 ------------------------
 
-- **Nombre d'enregistrements estimés** : ``1858``
+- **Nombre d'enregistrements estimés** : ``1863``
 
 .. list-table::
    :header-rows: 1