@factpulse/sdk 2.0.12 → 2.0.49

package/.github/SETUP_GITHUB_ACTIONS.md

@@ -1,12 +1,74 @@
-# Configuration GitHub Actions
+# Configuration GitHub Actions - npm Trusted Publishing
 
-## Secret npm requis
+Ce SDK utilise **npm Trusted Publishing** avec OIDC. **Aucun token npm n'est requis après la configuration initiale !**
 
-1. Allez sur https://github.com/factpulse/sdk-typescript/settings/secrets/actions
-2. Cliquez sur "New repository secret"
-3. Nom : `NPM_TOKEN`
-4. Valeur : Votre token npm (obtenu sur https://www.npmjs.com/settings/YOUR_USERNAME/tokens)
+## Prérequis : Première publication manuelle
 
-## Déploiement
+⚠️ **IMPORTANT** : Trusted Publishing ne fonctionne que pour les packages qui existent déjà sur npm.
+La première publication doit être faite manuellement.
 
-Le workflow se déclenche automatiquement lors de la création d'un tag `v*` (exemple : `v1.0.0`).
+### 1. Créer l'organisation npm (si pas déjà fait)
+
+Allez sur https://www.npmjs.com/org/create et créez l'organisation `factpulse`.
+
+### 2. Première publication manuelle
+
+```bash
+cd sdk-typescript
+
+# Se connecter à npm
+npm login
+
+# Publier la première version
+npm publish --access public
+```
+
+## Étape 1 : Configurer Trusted Publishing sur npmjs.com
+
+Après la première publication :
+
+1. Connectez-vous sur https://www.npmjs.com/
+2. Allez sur le package `@factpulse/sdk` > **Settings** > **Publishing access**
+3. Dans la section **Trusted Publisher**, cliquez sur **GitHub Actions**
+4. Remplissez :
+   - **Organization or user**: `factpulse`
+   - **Repository**: `sdk-typescript`
+   - **Workflow filename**: `publish-npm.yml`
+   - **Environment name**: (laisser vide)
+5. Cliquez **Add**
+
+## Étape 2 (Recommandé) : Désactiver les tokens classiques
+
+Pour une sécurité maximale, après avoir vérifié que Trusted Publishing fonctionne :
+
+1. Allez dans **Settings** > **Publishing access**
+2. Sélectionnez **"Require two-factor authentication and disallow tokens"**
+3. Cliquez **Update Package Settings**
+
+## Déploiement automatique (après configuration)
+
+Le workflow se déclenche automatiquement lors de la création d'un tag `v*` :
+
+```bash
+git tag -a v1.0.0 -m "Release v1.0.0"
+git push origin v1.0.0
+```
+
+## Comment ça marche ?
+
+- Le workflow utilise `id-token: write` pour générer un token OIDC
+- npm vérifie que la requête vient bien du workflow configuré
+- La provenance est générée automatiquement
+- Aucun secret npm à gérer ou à faire tourner
+
+## Dépendances privées (si nécessaire)
+
+Si vous avez des dépendances npm privées, ajoutez un token read-only :
+
+```yaml
+- run: npm install
+  env:
+    NODE_AUTH_TOKEN: ${{ secrets.NPM_READ_TOKEN }}
+```
+
+Le publish utilise OIDC, pas besoin de token pour cette étape.

package/.github/workflows/publish-npm.yml

@@ -6,8 +6,8 @@ on:
       - 'v*'
 
 permissions:
+  id-token: write  # Required for npm Trusted Publishing (OIDC)
   contents: write
-  packages: write
 
 jobs:
   build-and-publish:
@@ -21,19 +21,17 @@ jobs:
     - name: Setup Node.js
       uses: actions/setup-node@v4
       with:
-        node-version: '18'
+        node-version: '24'
         registry-url: 'https://registry.npmjs.org'
 
     - name: Install dependencies
       run: npm install
 
     - name: Build
-      run: npm run build || echo "No build script found, skipping..."
+      run: npm run build --if-present
 
-    - name: Publish to npm
-      run: npm publish --access public
-      env:
-        NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+    - name: Publish to npm (Trusted Publishing - no token needed)
+      run: npm publish --access public --provenance
 
     - name: Create GitHub Release
       uses: softprops/action-gh-release@v1

package/.openapi-generator/FILES

@@ -10,28 +10,22 @@ api/chorus-pro-api.ts
 api/sant-api.ts
 api/traitement-facture-api.ts
 api/utilisateur-api.ts
+api/vrification-pdfxmlapi.ts
 base.ts
 common.ts
 configuration.ts
 docs/AFNORPDPPAApi.md
 docs/AFNORPDPPADirectoryServiceApi.md
 docs/AFNORPDPPAFlowServiceApi.md
+docs/APIError.md
 docs/AdresseElectronique.md
 docs/AdressePostale.md
-docs/BodyAjouterFichierApiV1ChorusProTransversesAjouterFichierPost.md
-docs/BodyCompleterFactureApiV1ChorusProFacturesCompleterPost.md
-docs/BodyListerServicesStructureApiV1ChorusProStructuresIdStructureCppServicesGet.md
-docs/BodyRechercherFacturesDestinataireApiV1ChorusProFacturesRechercherDestinatairePost.md
-docs/BodyRechercherFacturesFournisseurApiV1ChorusProFacturesRechercherFournisseurPost.md
-docs/BodyRecyclerFactureApiV1ChorusProFacturesRecyclerPost.md
-docs/BodyTelechargerGroupeFacturesApiV1ChorusProFacturesTelechargerGroupePost.md
-docs/BodyTraiterFactureRecueApiV1ChorusProFacturesTraiterFactureRecuePost.md
-docs/BodyValideurConsulterFactureApiV1ChorusProFacturesValideurConsulterPost.md
-docs/BodyValideurRechercherFacturesApiV1ChorusProFacturesValideurRechercherPost.md
-docs/BodyValideurTraiterFactureApiV1ChorusProFacturesValideurTraiterPost.md
+docs/Beneficiaire.md
+docs/BoundingBoxSchema.md
 docs/CadreDeFacturation.md
 docs/CategorieTVA.md
 docs/CertificateInfoResponse.md
+docs/ChampVerifieSchema.md
 docs/ChorusProApi.md
 docs/ChorusProCredentials.md
 docs/CodeCadreFacturation.md
@@ -46,11 +40,19 @@ docs/Destinataire.md
 docs/Destination.md
 docs/DestinationAFNOR.md
 docs/DestinationChorusPro.md
+docs/DimensionPageSchema.md
+docs/DirectionFlux.md
 docs/DonneesFactureSimplifiees.md
+docs/ErrorLevel.md
+docs/ErrorSource.md
 docs/FactureEnrichieInfo.md
+docs/FactureEntrante.md
 docs/FactureFacturX.md
+docs/FluxResume.md
+docs/FormatFacture.md
 docs/FormatSortie.md
 docs/Fournisseur.md
+docs/FournisseurEntrant.md
 docs/GenerateCertificateRequest.md
 docs/GenerateCertificateResponse.md
 docs/HTTPValidationError.md
@@ -73,24 +75,33 @@ docs/MontantTva.md
 docs/MontantTvaLigne.md
 docs/MontantTvaTotal.md
 docs/MontantUnitaireHt.md
+docs/NatureOperation.md
 docs/Note.md
+docs/NoteObligatoireSchema.md
 docs/ObtenirIdChorusProRequest.md
 docs/ObtenirIdChorusProResponse.md
 docs/OptionsProcessing.md
 docs/PDFFacturXInfo.md
+docs/PDPCredentials.md
 docs/ParametresSignature.md
 docs/ParametresStructure.md
 docs/PieceJointeComplementaire.md
 docs/ProfilAPI.md
+docs/ProfilFlux.md
 docs/Quantite.md
-docs/QuotaInfo.md
 docs/RechercherServicesResponse.md
 docs/RechercherStructureRequest.md
 docs/RechercherStructureResponse.md
 docs/References.md
+docs/ReponseHealthcheckAFNOR.md
+docs/ReponseRechercheFlux.md
+docs/ReponseSoumissionFlux.md
 docs/ReponseTache.md
 docs/ReponseValidationErreur.md
 docs/ReponseValidationSucces.md
+docs/ReponseVerificationSucces.md
+docs/RequeteRechercheFlux.md
+docs/RequeteSoumissionFlux.md
 docs/ResultatAFNOR.md
 docs/ResultatChorusPro.md
 docs/ResultatValidationPDFAPI.md
@@ -102,37 +113,36 @@ docs/SoumettreFactureCompleteRequest.md
 docs/SoumettreFactureCompleteResponse.md
 docs/SoumettreFactureRequest.md
 docs/SoumettreFactureResponse.md
+docs/StatutAcquittement.md
 docs/StatutCelery.md
+docs/StatutChampAPI.md
 docs/StatutFacture.md
 docs/StatutTache.md
 docs/StructureInfo.md
+docs/SyntaxeFlux.md
 docs/Tauxmanuel.md
 docs/TraitementFactureApi.md
+docs/TypeDocument.md
 docs/TypeFacture.md
+docs/TypeFlux.md
 docs/TypeTVA.md
 docs/Unite.md
-docs/Utilisateur.md
 docs/UtilisateurApi.md
 docs/ValidationError.md
+docs/ValidationErrorDetail.md
 docs/ValidationErrorLocInner.md
+docs/VrificationPDFXMLApi.md
 git_push.sh
 index.ts
 models/adresse-electronique.ts
 models/adresse-postale.ts
-models/body-ajouter-fichier-api-v1-chorus-pro-transverses-ajouter-fichier-post.ts
-models/body-completer-facture-api-v1-chorus-pro-factures-completer-post.ts
-models/body-lister-services-structure-api-v1-chorus-pro-structures-id-structure-cpp-services-get.ts
-models/body-rechercher-factures-destinataire-api-v1-chorus-pro-factures-rechercher-destinataire-post.ts
-models/body-rechercher-factures-fournisseur-api-v1-chorus-pro-factures-rechercher-fournisseur-post.ts
-models/body-recycler-facture-api-v1-chorus-pro-factures-recycler-post.ts
-models/body-telecharger-groupe-factures-api-v1-chorus-pro-factures-telecharger-groupe-post.ts
-models/body-traiter-facture-recue-api-v1-chorus-pro-factures-traiter-facture-recue-post.ts
-models/body-valideur-consulter-facture-api-v1-chorus-pro-factures-valideur-consulter-post.ts
-models/body-valideur-rechercher-factures-api-v1-chorus-pro-factures-valideur-rechercher-post.ts
-models/body-valideur-traiter-facture-api-v1-chorus-pro-factures-valideur-traiter-post.ts
+models/apierror.ts
+models/beneficiaire.ts
+models/bounding-box-schema.ts
 models/cadre-de-facturation.ts
 models/categorie-tva.ts
 models/certificate-info-response.ts
+models/champ-verifie-schema.ts
 models/chorus-pro-credentials.ts
 models/code-cadre-facturation.ts
 models/code-raison-reduction.ts
@@ -146,10 +156,18 @@ models/destinataire.ts
 models/destination-afnor.ts
 models/destination-chorus-pro.ts
 models/destination.ts
+models/dimension-page-schema.ts
+models/direction-flux.ts
 models/donnees-facture-simplifiees.ts
+models/error-level.ts
+models/error-source.ts
 models/facture-enrichie-info.ts
+models/facture-entrante.ts
 models/facture-factur-x.ts
+models/flux-resume.ts
+models/format-facture.ts
 models/format-sortie.ts
+models/fournisseur-entrant.ts
 models/fournisseur.ts
 models/generate-certificate-request.ts
 models/generate-certificate-response.ts
@@ -174,6 +192,8 @@ models/montant-tva-ligne.ts
 models/montant-tva-total.ts
 models/montant-tva.ts
 models/montant-unitaire-ht.ts
+models/nature-operation.ts
+models/note-obligatoire-schema.ts
 models/note.ts
 models/obtenir-id-chorus-pro-request.ts
 models/obtenir-id-chorus-pro-response.ts
@@ -181,17 +201,24 @@ models/options-processing.ts
 models/parametres-signature.ts
 models/parametres-structure.ts
 models/pdffactur-xinfo.ts
+models/pdpcredentials.ts
 models/piece-jointe-complementaire.ts
 models/profil-api.ts
+models/profil-flux.ts
 models/quantite.ts
-models/quota-info.ts
 models/rechercher-services-response.ts
 models/rechercher-structure-request.ts
 models/rechercher-structure-response.ts
 models/references.ts
+models/reponse-healthcheck-afnor.ts
+models/reponse-recherche-flux.ts
+models/reponse-soumission-flux.ts
 models/reponse-tache.ts
 models/reponse-validation-erreur.ts
 models/reponse-validation-succes.ts
+models/reponse-verification-succes.ts
+models/requete-recherche-flux.ts
+models/requete-soumission-flux.ts
 models/resultat-afnor.ts
 models/resultat-chorus-pro.ts
 models/resultat-validation-pdfapi.ts
@@ -202,15 +229,20 @@ models/soumettre-facture-complete-request.ts
 models/soumettre-facture-complete-response.ts
 models/soumettre-facture-request.ts
 models/soumettre-facture-response.ts
+models/statut-acquittement.ts
 models/statut-celery.ts
+models/statut-champ-api.ts
 models/statut-facture.ts
 models/statut-tache.ts
 models/structure-info.ts
+models/syntaxe-flux.ts
 models/tauxmanuel.ts
+models/type-document.ts
 models/type-facture.ts
+models/type-flux.ts
 models/type-tva.ts
 models/unite.ts
-models/utilisateur.ts
+models/validation-error-detail.ts
 models/validation-error-loc-inner.ts
 models/validation-error.ts
 package.json

package/CHANGELOG.md

@@ -7,7 +7,7 @@ et ce projet adhère au [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## [Unreleased]
 
-## [2.0.12] - 2025-11-26
+## [2.0.49] - 2025-12-19
 
 ### Added
 - Version initiale du SDK typescript
@@ -24,5 +24,5 @@ et ce projet adhère au [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 - Guide d'authentification JWT
 - Configuration avancée (timeout, proxy, debug)
 
-[Unreleased]: https://github.com/factpulse/sdk-typescript/compare/v2.0.12...HEAD
-[2.0.12]: https://github.com/factpulse/sdk-typescript/releases/tag/v2.0.12
+[Unreleased]: https://github.com/factpulse/sdk-typescript/compare/v2.0.49...HEAD
+[2.0.49]: https://github.com/factpulse/sdk-typescript/releases/tag/v2.0.49