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

ffbb_data_client-2.3.3/.gitattributes

@@ -0,0 +1,2 @@
+# Force union merge driver for Jules learning log to prevent merge conflicts
+.jules/bolt.md merge=union

ffbb_data_client-2.3.3/.github/FUNDING.yml

@@ -0,0 +1 @@
+github: [nickdesi]

ffbb_data_client-2.3.3/.github/scripts/ai-pr-reviewer.cjs

@@ -0,0 +1,278 @@
+const https = require('https');
+
+// Configuration from environment variables
+const GITHUB_TOKEN = process.env.GITHUB_TOKEN;
+const GEMINI_API_KEY = process.env.GEMINI_API_KEY;
+const GITHUB_REPOSITORY = process.env.GITHUB_REPOSITORY;
+const PR_NUMBER = process.env.GITHUB_PR_NUMBER;
+const GEMINI_MODEL = process.env.GEMINI_MODEL || 'gemini-2.5-flash';
+
+if (!GITHUB_TOKEN || !GEMINI_API_KEY || !GITHUB_REPOSITORY || !PR_NUMBER) {
+  console.error("Missing env vars: GITHUB_TOKEN, GEMINI_API_KEY, GITHUB_REPOSITORY, GITHUB_PR_NUMBER");
+  process.exit(1);
+}
+
+const SUPPORTED_EXTENSIONS = [
+  '.js', '.ts', '.jsx', '.tsx', '.py', '.sh', '.yml', '.yaml',
+  '.json', '.css', '.html', '.go', '.rs', '.c', '.cpp', '.h',
+  '.conf', '.ini', '.md', '.toml'
+];
+
+const IGNORED_FILES = [
+  'package-lock.json', 'pnpm-lock.yaml', 'yarn.lock', 'composer.lock',
+  'AGENTS.md', 'task.md', 'implementation_plan.md', 'walkthrough.md'
+];
+
+const MAX_RETRIES = 3;
+const BASE_DELAY_MS = 1000;
+
+// HTTPS request helper with retry and exponential backoff
+function makeRequest(options, postData = null, retries = MAX_RETRIES) {
+  return new Promise((resolve, reject) => {
+    const req = https.request(options, (res) => {
+      let data = '';
+      res.on('data', (chunk) => { data += chunk; });
+      res.on('end', () => {
+        if (res.statusCode >= 200 && res.statusCode < 300) {
+          resolve({ data, headers: res.headers });
+        } else if (res.statusCode === 429 && retries > 0) {
+          const delay = BASE_DELAY_MS * Math.pow(2, MAX_RETRIES - retries);
+          console.warn(`Rate limited. Retrying in ${delay}ms...`);
+          setTimeout(() => {
+            makeRequest(options, postData, retries - 1).then(resolve).catch(reject);
+          }, delay);
+        } else if (res.statusCode >= 500 && retries > 0) {
+          const delay = BASE_DELAY_MS * Math.pow(2, MAX_RETRIES - retries);
+          console.warn(`Server error ${res.statusCode}. Retrying in ${delay}ms...`);
+          setTimeout(() => {
+            makeRequest(options, postData, retries - 1).then(resolve).catch(reject);
+          }, delay);
+        } else {
+          reject(new Error(`Status ${res.statusCode}: ${data}`));
+        }
+      });
+    });
+    req.on('error', (err) => {
+      if (retries > 0) {
+        const delay = BASE_DELAY_MS * Math.pow(2, MAX_RETRIES - retries);
+        setTimeout(() => {
+          makeRequest(options, postData, retries - 1).then(resolve).catch(reject);
+        }, delay);
+      } else {
+        reject(err);
+      }
+    });
+    if (postData) {
+      req.write(typeof postData === 'string' ? postData : JSON.stringify(postData));
+    }
+    req.end();
+  });
+}
+
+// Fetch all pages of PR files (handles pagination)
+async function fetchAllPRFiles() {
+  const allFiles = [];
+  let page = 1;
+
+  while (true) {
+    const options = {
+      hostname: 'api.github.com',
+      path: `/repos/${GITHUB_REPOSITORY}/pulls/${PR_NUMBER}/files?per_page=100&page=${page}`,
+      method: 'GET',
+      headers: {
+        'Authorization': `Bearer ${GITHUB_TOKEN}`,
+        'Accept': 'application/vnd.github.v3+json',
+        'User-Agent': 'AI-PR-Reviewer-Action'
+      }
+    };
+
+    const { data } = await makeRequest(options);
+    const files = JSON.parse(data);
+
+    if (files.length === 0) break;
+    allFiles.push(...files);
+
+    if (files.length < 100) break;
+    page++;
+  }
+
+  return allFiles;
+}
+
+// Extract added line numbers from a unified diff patch
+function getAddedLines(patch) {
+  if (!patch) return [];
+  const lines = patch.split('\n');
+  const addedLines = [];
+  let currentNewLineNum = 0;
+
+  for (const line of lines) {
+    const chunkHeader = line.match(/^@@ -\d+(?:,\d+)? \+(\d+)(?:,\d+)? @@/);
+    if (chunkHeader) {
+      currentNewLineNum = parseInt(chunkHeader[1], 10);
+      continue;
+    }
+
+    if (line.startsWith('+') && !line.startsWith('+++')) {
+      addedLines.push(currentNewLineNum);
+      currentNewLineNum++;
+    } else if (line.startsWith('-')) {
+      // Deleted line — skip
+    } else {
+      currentNewLineNum++;
+    }
+  }
+  return addedLines;
+}
+
+async function run() {
+  try {
+    console.log(`AI review for PR #${PR_NUMBER} on ${GITHUB_REPOSITORY} (model: ${GEMINI_MODEL})`);
+
+    // 1. Get PR details for head SHA
+    const prDetailsOptions = {
+      hostname: 'api.github.com',
+      path: `/repos/${GITHUB_REPOSITORY}/pulls/${PR_NUMBER}`,
+      method: 'GET',
+      headers: {
+        'Authorization': `Bearer ${GITHUB_TOKEN}`,
+        'Accept': 'application/vnd.github.v3+json',
+        'User-Agent': 'AI-PR-Reviewer-Action'
+      }
+    };
+    const { data: prDetailsRaw } = await makeRequest(prDetailsOptions);
+    const prDetails = JSON.parse(prDetailsRaw);
+    const commitSha = prDetails.head.sha;
+    console.log(`Head SHA: ${commitSha}`);
+
+    // 2. Fetch all modified files (paginated)
+    const files = await fetchAllPRFiles();
+
+    const filesToAnalyze = files.filter(file => {
+      if (IGNORED_FILES.some(ignored => file.filename.endsWith(ignored))) return false;
+      return SUPPORTED_EXTENSIONS.some(ext => file.filename.endsWith(ext)) && !!file.patch;
+    });
+
+    if (filesToAnalyze.length === 0) {
+      console.log("No analyzable code files found.");
+      return;
+    }
+
+    console.log(`${filesToAnalyze.length} files retained for analysis.`);
+
+    // 3. Prepare diff data for Gemini
+    const fileDiffData = filesToAnalyze.map(file => ({
+      filename: file.filename,
+      patch: file.patch,
+      validLinesForComments: getAddedLines(file.patch)
+    }));
+
+    // 4. Call Gemini API
+    const systemInstruction = `Tu es un expert en revue de code (ingénieur logiciel principal). Analyse les modifications d'une Pull Request et génère une revue technique constructive et précise.
+
+Consignes :
+1. Génère des commentaires ciblés uniquement si nécessaire (bugs, failles de sécurité, optimisations majeures, mauvaise gestion d'erreurs, lisibilité).
+2. Chaque commentaire DOIT avoir un numéro de ligne ('line') présent dans 'validLinesForComments' du fichier correspondant. Ne commente jamais sur une ligne hors de cette liste.
+3. Rédige en français, de manière claire et technique. Propose du code de correction en bloc markdown si pertinent.
+4. Verdict global dans le champ 'verdict' :
+   - 'APPROVE' : Code excellent, prêt à fusionner (aucun commentaire requis).
+   - 'COMMENT' : Suggestions mineures, non bloquantes.
+   - 'REQUEST_CHANGES' : Bugs sérieux, failles de sécurité, ou problèmes de performance bloquants.
+5. Réponds en JSON strictement conforme à ce schéma :
+{
+  "verdict": "APPROVE" | "COMMENT" | "REQUEST_CHANGES",
+  "summary": "Résumé global de la revue.",
+  "comments": [
+    {
+      "path": "chemin/du/fichier.js",
+      "line": 42,
+      "body": "Explication du problème ou suggestion."
+    }
+  ]
+}`;
+
+    const promptUser = `Fichiers modifiés et diffs pour la PR #${PR_NUMBER} :
+${JSON.stringify(fileDiffData, null, 2)}`;
+
+    const geminiPayload = {
+      contents: [{ parts: [{ text: promptUser }] }],
+      systemInstruction: { parts: [{ text: systemInstruction }] },
+      generationConfig: { responseMimeType: "application/json" }
+    };
+
+    const geminiUrl = new URL(
+      `https://generativelanguage.googleapis.com/v1beta/models/${GEMINI_MODEL}:generateContent?key=${GEMINI_API_KEY}`
+    );
+
+    const geminiOptions = {
+      hostname: geminiUrl.hostname,
+      path: geminiUrl.pathname + geminiUrl.search,
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' }
+    };
+
+    console.log(`Sending to Gemini (${GEMINI_MODEL})...`);
+    const { data: geminiResponseRaw } = await makeRequest(geminiOptions, geminiPayload);
+    const geminiResponse = JSON.parse(geminiResponseRaw);
+
+    const responseText = geminiResponse.candidates[0].content.parts[0].text;
+    const reviewResult = JSON.parse(responseText);
+
+    console.log(`Verdict: ${reviewResult.verdict}`);
+    console.log(`Summary: ${reviewResult.summary}`);
+    console.log(`Comments: ${reviewResult.comments ? reviewResult.comments.length : 0}`);
+
+    // Filter comments to valid diff lines only
+    const validComments = [];
+    if (reviewResult.comments && Array.isArray(reviewResult.comments)) {
+      for (const comment of reviewResult.comments) {
+        const fileData = fileDiffData.find(f => f.filename === comment.path);
+        if (fileData && fileData.validLinesForComments.includes(Number(comment.line))) {
+          validComments.push({
+            path: comment.path,
+            line: Number(comment.line),
+            side: 'RIGHT',
+            body: comment.body
+          });
+        } else {
+          console.warn(`Skipped invalid comment: ${comment.path}:${comment.line} (not in diff)`);
+        }
+      }
+    }
+
+    // 5. Submit review to GitHub
+    const reviewPayload = {
+      commit_id: commitSha,
+      body: `### 🤖 Revue automatique par l'IA (${GEMINI_MODEL})
+
+**Verdict :** ${reviewResult.verdict === 'APPROVE' ? '✅ Approuvé' : reviewResult.verdict === 'REQUEST_CHANGES' ? '❌ Changements demandés' : '💬 Commentaires'}
+
+${reviewResult.summary}
+
+_Revue générée automatiquement._`,
+      event: reviewResult.verdict,
+      comments: validComments
+    };
+
+    const submitReviewOptions = {
+      hostname: 'api.github.com',
+      path: `/repos/${GITHUB_REPOSITORY}/pulls/${PR_NUMBER}/reviews`,
+      method: 'POST',
+      headers: {
+        'Authorization': `Bearer ${GITHUB_TOKEN}`,
+        'Accept': 'application/vnd.github.v3+json',
+        'User-Agent': 'AI-PR-Reviewer-Action',
+        'Content-Type': 'application/json'
+      }
+    };
+
+    await makeRequest(submitReviewOptions, reviewPayload);
+    console.log("Review published successfully.");
+
+  } catch (error) {
+    console.error("AI review failed:", error);
+    process.exit(1);
+  }
+}
+
+run();

{ffbb_data_client-2.3.2 → ffbb_data_client-2.3.3}/.github/workflows/ai-pr-reviewer.yml

@@ -3,12 +3,19 @@ name: AI Pull Request Reviewer
 on:
   pull_request:
     types: [opened, synchronize]
+    paths-ignore:
+      - '**.md'
   workflow_dispatch:
     inputs:
       pr_number:
-        description: 'Numéro de la Pull Request à analyser'
+        description: 'PR number to review'
         required: true
         type: string
+      gemini_model:
+        description: 'Gemini model to use'
+        required: false
+        default: 'gemini-2.5-flash'
+        type: string
 
 permissions:
   pull-requests: write
@@ -19,35 +26,26 @@ env:
 
 jobs:
   review:
-    # Optionnel: pour limiter la revue aux PR créées par un utilisateur spécifique (ex: Jules)
-    # Remplacer 'jules-username' par l'identifiant GitHub de Jules
-    # if: github.event.pull_request.user.login == 'jules-username'
-
     runs-on: ubuntu-latest
 
     env:
       GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
+      GEMINI_MODEL: ${{ inputs.gemini_model || 'gemini-2.5-flash' }}
 
     steps:
       - name: Checkout Repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
-          fetch-depth: 0 # Nécessaire pour avoir l'historique et faire le merge
+          fetch-depth: 0
 
       - name: Setup Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: 18
-
-      - name: Resolve bolt.md Merge Conflicts
-        env:
-          BASE_BRANCH: ${{ github.event.pull_request.base.ref }}
-          HEAD_BRANCH: ${{ github.event.pull_request.head.ref }}
-        run: node .github/scripts/resolve-bolt-conflict.js
+          node-version: 24
 
       - name: Run AI Reviewer
         if: env.GEMINI_API_KEY != ''
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           GITHUB_PR_NUMBER: ${{ inputs.pr_number || github.event.pull_request.number }}
-        run: node .github/scripts/ai-pr-reviewer.js
+        run: node .github/scripts/ai-pr-reviewer.cjs

{ffbb_data_client-2.3.2 → ffbb_data_client-2.3.3}/.github/workflows/check_wrapper_parity.yml

@@ -27,7 +27,7 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
 
       - name: Set up Python
         uses: actions/setup-python@v6

{ffbb_data_client-2.3.2 → ffbb_data_client-2.3.3}/.github/workflows/ci.yml

@@ -31,13 +31,13 @@ jobs:
   lint:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0  # v7.0.0
       - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
         with:
           python-version: "3.14"
           cache: 'pip'
       - name: Cache pre-commit
-        uses: actions/cache@v5
+        uses: actions/cache@v6
         with:
           path: ~/.cache/pre-commit
           key: ${{ runner.os }}-pre-commit-${{ hashFiles('.pre-commit-config.yaml') }}
@@ -49,7 +49,7 @@ jobs:
   type-check:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0  # v7.0.0
       - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
         id: setup-python
         with:
@@ -66,7 +66,7 @@ jobs:
     outputs:
       wheel-distribution: ${{ steps.wheel-distribution.outputs.path }}
     steps:
-      - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0  # v7.0.0
         with: {fetch-depth: 0}  # deep clone for setuptools-scm
       - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
         id: setup-python
@@ -93,7 +93,6 @@ jobs:
               'ffbb_data_client/data/endpoint_discovery.json',
               'ffbb_data_client/data/indexes.json',
               'ffbb_data_client/data/openapi.json',
-              'ffbb_data_client/data/openapi_full.json',
           }
           with zipfile.ZipFile(wheels[0]) as wheel:
               names = set(wheel.namelist())
@@ -133,14 +132,14 @@ jobs:
         - ubuntu-latest
     runs-on: ${{ matrix.platform }}
     steps:
-      - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0  # v7.0.0
       - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
         id: setup-python
         with:
           python-version: ${{ matrix.python }}
           cache: 'pip'
       - name: Cache tox environments
-        uses: actions/cache@v5
+        uses: actions/cache@v6
         with:
           path: .tox
           key: ${{ runner.os }}-tox-${{ matrix.python }}-${{ hashFiles('setup.cfg', 'tox.ini', 'pyproject.toml') }}
@@ -153,9 +152,14 @@ jobs:
         env:
           API_FFBB_APP_BEARER_TOKEN: ${{ secrets.API_FFBB_APP_BEARER_TOKEN }}
           MEILISEARCH_BEARER_TOKEN: ${{ secrets.MEILISEARCH_BEARER_TOKEN }}
-        run: >-
-          pipx run --python '${{ steps.setup-python.outputs.python-path }}'
-          tox --installpkg '${{ needs.build.outputs.wheel-distribution }}'
+          MATRIX_PYTHON: ${{ matrix.python }}
+        run: |
+          toxenv="py${MATRIX_PYTHON//./}"
+          pipx run --python '${{ steps.setup-python.outputs.python-path }}' \
+            tox -e "$toxenv" --installpkg '${{ needs.build.outputs.wheel-distribution }}'
+        # Only run the tox environment matching this matrix runner's Python.
+        # Without `-e`, tox executes the full envlist (py310..py314) on a
+        # single-version runner and fails on the missing interpreters.
 
       # ── Coveralls: upload partial report (parallel mode) ─────────────────
       # coverallsapp/github-action@v2 uses the Universal Coverage Reporter

{ffbb_data_client-2.3.2 → ffbb_data_client-2.3.3}/.github/workflows/codeql.yml

@@ -23,13 +23,13 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
 
       - name: Initialize CodeQL
-        uses: github/codeql-action/init@8aad20d150bbac5944a9f9d289da16a4b0d87c1e  # v4
+        uses: github/codeql-action/init@99df26d4f13ea111d4ec1a7dddef6063f76b97e9  # v4
         with:
           languages: python
           queries: security-extended,security-and-quality
 
       - name: Perform CodeQL Analysis
-        uses: github/codeql-action/analyze@8aad20d150bbac5944a9f9d289da16a4b0d87c1e  # v4
+        uses: github/codeql-action/analyze@99df26d4f13ea111d4ec1a7dddef6063f76b97e9  # v4

{ffbb_data_client-2.3.2 → ffbb_data_client-2.3.3}/.github/workflows/deploy-pages.yml

@@ -23,7 +23,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           fetch-depth: 0
 

ffbb_data_client-2.3.3/.github/workflows/keep-ffbb-api-discovery-alive.yml

@@ -0,0 +1,39 @@
+name: Keep FFBB API Discovery Alive
+
+on:
+  schedule:
+    # Safety net: GitHub may silently stop firing the main schedule.
+    # Check every 6h that the discovery workflow ran in the last 22h and
+    # trigger it manually if not, guaranteeing at least one run per day.
+    - cron: '0 */6 * * *'
+  workflow_dispatch:
+
+permissions:
+  actions: write
+
+jobs:
+  ensure-daily-run:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check last discovery run
+        id: check
+        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")
+          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
+            echo "triggered=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "OK: discovery ran at $last_ts, no action needed"
+            echo "triggered=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Report outcome
+        run: |
+          echo "triggered=${{ steps.check.outputs.triggered }}"

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

@@ -22,7 +22,7 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           fetch-depth: 0  # Required for setuptools_scm to resolve version from tags
 
@@ -54,7 +54,6 @@ jobs:
               'ffbb_data_client/data/endpoint_discovery.json',
               'ffbb_data_client/data/indexes.json',
               'ffbb_data_client/data/openapi.json',
-              'ffbb_data_client/data/openapi_full.json',
           }
           with zipfile.ZipFile(wheels[0]) as wheel:
               names = set(wheel.namelist())
@@ -73,7 +72,7 @@ jobs:
           path: dist/
 
       - name: Generate artifact attestation
-        uses: actions/attest@59d89421af93a897026c735860bf21b6eb4f7b26  # v4
+        uses: actions/attest@a1948c3f048ba23858d222213b7c278aabede763  # v4
         with:
           subject-path: dist/*
 
@@ -110,7 +109,7 @@ jobs:
           path: dist/
 
       - name: Create GitHub Release
-        uses: softprops/action-gh-release@b4309332981a82ec1c5618f44dd2e27cc8bfbfda  # v3
+        uses: softprops/action-gh-release@718ea10b132b3b2eba29c1007bb80653f286566b  # v3
         with:
           files: dist/*
           generate_release_notes: true

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

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

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

@@ -23,7 +23,7 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
 
       - name: Set up Python
         uses: actions/setup-python@v6
@@ -81,4 +81,3 @@ jobs:
             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/openapi_full.json

{ffbb_data_client-2.3.2 → ffbb_data_client-2.3.3}/.gitignore

@@ -62,3 +62,6 @@ data/type_discovery_raw.json
 prof/
 .agent/
 graphify-out/
+
+# Local Agent Customizations
+.agents/

{ffbb_data_client-2.3.2 → ffbb_data_client-2.3.3}/.pre-commit-config.yaml

@@ -9,7 +9,7 @@ repos:
   hooks:
   - id: trailing-whitespace
   - id: check-added-large-files
-    exclude: ^src/ffbb_data_client/data/(openapi|openapi_full)\.json$
+    exclude: ^src/ffbb_data_client/data/openapi\.json$
   - id: check-ast
   - id: check-json
   - id: check-merge-conflict

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

@@ -5,6 +5,19 @@ 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).
 
+## [Unreleased]
+
+### 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.
+
+### Changed
+- **Performance**: `recursive_smart_multi_search` / `recursive_smart_multi_search_async`
+  exécutent désormais la pagination Meilisearch en **parallèle** (lots de 10 pages,
+  `asyncio.gather` en async / `ThreadPoolExecutor` en sync) au lieu d'enchaîner les
+  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.
+
 ## [2.3.0] - 2026-05-24
 
 ### Added

{ffbb_data_client-2.3.2/src/ffbb_data_client.egg-info → ffbb_data_client-2.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ffbb-data-client
-Version: 2.3.2
+Version: 2.3.3
 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
@@ -56,12 +56,17 @@ Dynamic: license-file
 
 **SDK Python moderne, typé et asynchrone pour exploiter les données publiques FFBB : clubs, compétitions, rencontres, classements, salles, officiels et recherche Meilisearch.**
 
-[![PyPI](https://img.shields.io/pypi/v/ffbb-data-client?color=blue&label=PyPI&logo=python)](https://pypi.org/project/ffbb-data-client/)
-[![Python](https://img.shields.io/pypi/pyversions/ffbb-data-client?logo=python)](https://pypi.org/project/ffbb-data-client/)
+[![PyPI](https://img.shields.io/pypi/v/ffbb-data-client?color=blue&label=PyPI&logo=python&logoColor=white)](https://pypi.org/project/ffbb-data-client/)
+[![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 Status](https://coveralls.io/repos/github/nickdesi/ffbb-data-client/badge.svg?branch=master)](https://coveralls.io/github/nickdesi/ffbb-data-client?branch=master)
+[![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)
-[![MCP-Ready](https://img.shields.io/badge/MCP-Ready-orange.svg?logo=modelcontextprotocol)](https://github.com/nickdesi/FFBB-MCP-Server)
+[![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)
+[![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)
+[![PRs](https://img.shields.io/github/issues-pr/nickdesi/ffbb-data-client)](https://github.com/nickdesi/ffbb-data-client/pulls)
 
 [Installation](#-installation) •
 [Démarrage rapide](#-démarrage-rapide) •
@@ -361,6 +366,18 @@ 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`
+
+---
+
 <div align="center">
 
 **Si ce projet vous aide, une étoile est appréciée. ⭐**