feat(client): switch repositories to API v2

[KepoParis]

Issues liées

Issues numéro: #2423, #2422

---

Quel est le comportement actuel ?

Le client consomme les routes v1 des dépôts via apiClient.Repositories :

• listRepositories({ query: { projectId } })
• createRepository({ body: { ...repoData, projectId } })
• updateRepository({ params: { repositoryId }, body: { ...repoData, projectId } })
• deleteRepository({ params: { repositoryId } })
• syncRepository({ params: { repositoryId }, body: { branchName, syncAllBranches } })

Le projectId transite donc dans la query string ou dans le body. Le formulaire envoie par ailleurs son résultat brut au gestionnaire : sur une mise à jour, les champs non modifiables (id, projectId, internalRepoName, horodatages) et la clé de formulaire isStandalone partent dans le body, et le placeholder fakeToken — affiché à la place du token existant, jamais renvoyé par l'API — est réémis tel quel.

Quel est le nouveau comportement ?

Le client passe sur apiClient.RepositoriesV2, aligné sur les routes /api/v2/projects/:projectId/repositories :

• listRepositoriesV2({ params: { projectId } })
• createRepositoryV2({ params: { projectId }, body })
• updateRepositoryV2({ params: { projectId, repositoryId }, body })
• deleteRepositoryV2({ params: { projectId, repositoryId } })
• syncRepositoryV2({ params: { projectId, repositoryId }, body })

projectId est un paramètre de chemin, plus un champ de query/body.

Deux adaptateurs isolent la conversion « résultat de formulaire → corps v2 » dans apps/client/src/utils/repository-utils.ts :

• toCreateRepositoryBody construit la branche attendue par l'union discriminée du contrat v2 : isPrivate: true porte externalUserName / externalToken, isPrivate: false ne les envoie pas.
• toUpdateRepositoryBody retire les champs que la route v2 refuse (id, projectId, createdAt, updatedAt, internalRepoName, isStandalone) et n'envoie externalToken que s'il a réellement été saisi : un token vide ou resté à fakeToken est omis, ce qui signale « inchangé » au back-end (💡 [REQUEST] - Expliciter l'intention de mise à jour des credentials de dépôt (API v2) #2422) au lieu d'écraser le secret en Vault par un placeholder.

La synchronisation construit désormais un body conforme à l'union du contrat : { syncAllBranches: true } ou { syncAllBranches: false, branchName }, au lieu d'un branchName potentiellement undefined.

Fichiers touchés :

• apps/client/src/utils/project-utils.ts — appels et types du gestionnaire Repositories
• apps/client/src/utils/repository-utils.ts — nouveau, les deux adaptateurs
• apps/client/src/components/ProjectResources.vue — saveRepo / syncRepository passent par les adaptateurs
• apps/client/src/stores/project.spec.ts — le spy cible RepositoriesV2.listRepositoriesV2
• packages/shared/src/contracts/v2/repository.ts — export des types de body (ClientInferRequest, donc les entrées des schémas avant transformation)

Vérifications : vue-tsc --noEmit passe ; repository-utils.spec.ts (8 tests, nouveaux) et project.spec.ts (4 tests) passent.

Cette PR introduit-elle un breaking change ?

Non côté utilisateur : mêmes écrans, mêmes formulaires, mêmes actions. Le changement est interne au transport HTTP.

Correction de comportement au passage : modifier un dépôt privé sans toucher au champ token ne réécrit plus le secret avec fakeToken.

Prérequis de déploiement : les routes /api/v2/projects/:projectId/repositories doivent être servies (bloc nginx générique /api/v2 + back-end v2). Sans cela, les écrans dépôts retournent 404.

Autres informations

• PR empilée sur feat(server-nestjs): await project reconciliation on repositories mutations #2440 (feat/repository-v2-await-reconciliation) : à merger après.
• Les mutations de dépôts deviennent synchrones du fait de feat(server-nestjs): await project reconciliation on repositories mutations #2440 : une erreur de service remonte maintenant dans le snackbar au lieu de rester silencieuse.

[KepoParis]

MQ ✅ https://github.com/cloud-pi-native/console/actions/runs/31191923422

[cloud-pi-native-sonarqube]

Quality Gate passed

Issues

• 0 New Issues
• 0 Fixed Issues
• 0 Accepted Issues

Measures

• 0 Security Hotspots
• 73.90% Coverage (43.90% Estimated after merge)
• 0.00% Duplicated Code (4.10% Estimated after merge)

Project ID: cloud-pi-native_console_AYsa46O31ebDtzs-pYyZ

View in SonarQube