@factpulse/sdk 2.0.12 → 3.0.1

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

@@ -7,212 +7,244 @@ api/afnorpdppaapi.ts
 api/afnorpdppadirectory-service-api.ts
 api/afnorpdppaflow-service-api.ts
 api/chorus-pro-api.ts
-api/sant-api.ts
-api/traitement-facture-api.ts
-api/utilisateur-api.ts
+api/health-api.ts
+api/invoice-processing-api.ts
+api/pdfxmlverification-api.ts
+api/user-api.ts
 base.ts
 common.ts
 configuration.ts
+docs/AFNORCredentials.md
+docs/AFNORDestination.md
+docs/AFNORHealthCheckResponse.md
 docs/AFNORPDPPAApi.md
 docs/AFNORPDPPADirectoryServiceApi.md
 docs/AFNORPDPPAFlowServiceApi.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/CadreDeFacturation.md
-docs/CategorieTVA.md
+docs/AFNORResult.md
+docs/APIError.md
+docs/APIProfile.md
+docs/AcknowledgmentStatus.md
+docs/AllowanceReasonCode.md
+docs/AmountDue.md
+docs/BoundingBoxSchema.md
+docs/CeleryStatus.md
 docs/CertificateInfoResponse.md
 docs/ChorusProApi.md
-docs/ChorusProCredentials.md
-docs/CodeCadreFacturation.md
-docs/CodeRaisonReduction.md
-docs/ConsulterFactureRequest.md
-docs/ConsulterFactureResponse.md
-docs/ConsulterStructureRequest.md
-docs/ConsulterStructureResponse.md
-docs/CredentialsAFNOR.md
-docs/CredentialsChorusPro.md
-docs/Destinataire.md
+docs/ChorusProDestination.md
+docs/ChorusProResult.md
 docs/Destination.md
-docs/DestinationAFNOR.md
-docs/DestinationChorusPro.md
-docs/DonneesFactureSimplifiees.md
-docs/FactureEnrichieInfo.md
+docs/DocumentType.md
+docs/ElectronicAddress.md
+docs/EnrichedInvoiceInfo.md
+docs/ErrorLevel.md
+docs/ErrorSource.md
+docs/FacturXPDFInfo.md
+docs/FactureElectroniqueRestApiSchemasChorusProChorusProCredentials.md
+docs/FactureElectroniqueRestApiSchemasProcessingChorusProCredentials.md
 docs/FactureFacturX.md
-docs/FormatSortie.md
-docs/Fournisseur.md
+docs/FieldStatus.md
+docs/FlowDirection.md
+docs/FlowProfile.md
+docs/FlowSummary.md
+docs/FlowSyntax.md
+docs/FlowType.md
 docs/GenerateCertificateRequest.md
 docs/GenerateCertificateResponse.md
+docs/GetChorusProIdRequest.md
+docs/GetChorusProIdResponse.md
+docs/GetInvoiceRequest.md
+docs/GetInvoiceResponse.md
+docs/GetStructureRequest.md
+docs/GetStructureResponse.md
+docs/GlobalAllowanceAmount.md
 docs/HTTPValidationError.md
-docs/InformationSignatureAPI.md
-docs/LigneDePoste.md
-docs/LigneDePosteMontantRemiseHt.md
-docs/LigneDePosteTauxTvaManuel.md
-docs/LigneDeTVA.md
-docs/ModeDepot.md
-docs/ModePaiement.md
-docs/MontantAPayer.md
-docs/MontantBaseHt.md
-docs/MontantHtTotal.md
-docs/MontantRemiseGlobaleTtc.md
-docs/MontantTotal.md
-docs/MontantTotalAcompte.md
-docs/MontantTotalLigneHt.md
-docs/MontantTtcTotal.md
-docs/MontantTva.md
-docs/MontantTvaLigne.md
-docs/MontantTvaTotal.md
-docs/MontantUnitaireHt.md
-docs/Note.md
-docs/ObtenirIdChorusProRequest.md
-docs/ObtenirIdChorusProResponse.md
-docs/OptionsProcessing.md
-docs/PDFFacturXInfo.md
-docs/ParametresSignature.md
-docs/ParametresStructure.md
-docs/PieceJointeComplementaire.md
-docs/ProfilAPI.md
-docs/Quantite.md
-docs/QuotaInfo.md
-docs/RechercherServicesResponse.md
-docs/RechercherStructureRequest.md
-docs/RechercherStructureResponse.md
-docs/References.md
-docs/ReponseTache.md
-docs/ReponseValidationErreur.md
-docs/ReponseValidationSucces.md
-docs/ResultatAFNOR.md
-docs/ResultatChorusPro.md
-docs/ResultatValidationPDFAPI.md
-docs/SantApi.md
+docs/HealthApi.md
+docs/IncomingInvoice.md
+docs/IncomingSupplier.md
+docs/InvoiceFormat.md
+docs/InvoiceLine.md
+docs/InvoiceLineAllowanceAmount.md
+docs/InvoiceNote.md
+docs/InvoiceProcessingApi.md
+docs/InvoiceReferences.md
+docs/InvoiceStatus.md
+docs/InvoiceTotals.md
+docs/InvoiceTotalsPrepayment.md
+docs/InvoiceTypeCode.md
+docs/InvoicingFramework.md
+docs/InvoicingFrameworkCode.md
+docs/LineNetAmount.md
+docs/MandatoryNoteSchema.md
+docs/ManualRate.md
+docs/ManualVatRate.md
+docs/OperationNature.md
+docs/OutputFormat.md
+docs/PDFValidationResultAPI.md
+docs/PDFXMLVerificationApi.md
+docs/PDPCredentials.md
+docs/PageDimensionsSchema.md
+docs/Payee.md
+docs/PaymentMeans.md
+docs/PostalAddress.md
+docs/ProcessingOptions.md
+docs/Quantity.md
+docs/Recipient.md
 docs/SchemeID.md
-docs/ServiceStructure.md
+docs/SearchFlowRequest.md
+docs/SearchFlowResponse.md
+docs/SearchServicesResponse.md
+docs/SearchStructureRequest.md
+docs/SearchStructureResponse.md
 docs/SignatureInfo.md
-docs/SoumettreFactureCompleteRequest.md
-docs/SoumettreFactureCompleteResponse.md
-docs/SoumettreFactureRequest.md
-docs/SoumettreFactureResponse.md
-docs/StatutCelery.md
-docs/StatutFacture.md
-docs/StatutTache.md
+docs/SignatureInfoAPI.md
+docs/SignatureParameters.md
+docs/SimplifiedInvoiceData.md
 docs/StructureInfo.md
-docs/Tauxmanuel.md
-docs/TraitementFactureApi.md
-docs/TypeFacture.md
-docs/TypeTVA.md
-docs/Unite.md
-docs/Utilisateur.md
-docs/UtilisateurApi.md
+docs/StructureParameters.md
+docs/StructureService.md
+docs/SubmissionMode.md
+docs/SubmitCompleteInvoiceRequest.md
+docs/SubmitCompleteInvoiceResponse.md
+docs/SubmitFlowRequest.md
+docs/SubmitFlowResponse.md
+docs/SubmitInvoiceRequest.md
+docs/SubmitInvoiceResponse.md
+docs/SupplementaryAttachment.md
+docs/Supplier.md
+docs/TaskResponse.md
+docs/TaskStatus.md
+docs/TaxableAmount.md
+docs/TotalGrossAmount.md
+docs/TotalNetAmount.md
+docs/TotalVATAmount.md
+docs/UnitNetPrice.md
+docs/UnitOfMeasure.md
+docs/UserApi.md
+docs/VATAccountingCode.md
+docs/VATAmount.md
+docs/VATCategory.md
+docs/VATLine.md
 docs/ValidationError.md
+docs/ValidationErrorDetail.md
 docs/ValidationErrorLocInner.md
+docs/ValidationErrorResponse.md
+docs/ValidationSuccessResponse.md
+docs/VatAmount.md
+docs/VerificationSuccessResponse.md
+docs/VerifiedFieldSchema.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/cadre-de-facturation.ts
-models/categorie-tva.ts
+models/acknowledgment-status.ts
+models/afnorcredentials.ts
+models/afnordestination.ts
+models/afnorhealth-check-response.ts
+models/afnorresult.ts
+models/allowance-reason-code.ts
+models/amount-due.ts
+models/apierror.ts
+models/apiprofile.ts
+models/bounding-box-schema.ts
+models/celery-status.ts
 models/certificate-info-response.ts
-models/chorus-pro-credentials.ts
-models/code-cadre-facturation.ts
-models/code-raison-reduction.ts
-models/consulter-facture-request.ts
-models/consulter-facture-response.ts
-models/consulter-structure-request.ts
-models/consulter-structure-response.ts
-models/credentials-afnor.ts
-models/credentials-chorus-pro.ts
-models/destinataire.ts
-models/destination-afnor.ts
-models/destination-chorus-pro.ts
+models/chorus-pro-destination.ts
+models/chorus-pro-result.ts
 models/destination.ts
-models/donnees-facture-simplifiees.ts
-models/facture-enrichie-info.ts
+models/document-type.ts
+models/electronic-address.ts
+models/enriched-invoice-info.ts
+models/error-level.ts
+models/error-source.ts
+models/factur-xpdfinfo.ts
+models/facture-electronique-rest-api-schemas-chorus-pro-chorus-pro-credentials.ts
+models/facture-electronique-rest-api-schemas-processing-chorus-pro-credentials.ts
 models/facture-factur-x.ts
-models/format-sortie.ts
-models/fournisseur.ts
+models/field-status.ts
+models/flow-direction.ts
+models/flow-profile.ts
+models/flow-summary.ts
+models/flow-syntax.ts
+models/flow-type.ts
 models/generate-certificate-request.ts
 models/generate-certificate-response.ts
+models/get-chorus-pro-id-request.ts
+models/get-chorus-pro-id-response.ts
+models/get-invoice-request.ts
+models/get-invoice-response.ts
+models/get-structure-request.ts
+models/get-structure-response.ts
+models/global-allowance-amount.ts
 models/httpvalidation-error.ts
+models/incoming-invoice.ts
+models/incoming-supplier.ts
 models/index.ts
-models/information-signature-api.ts
-models/ligne-de-poste-montant-remise-ht.ts
-models/ligne-de-poste-taux-tva-manuel.ts
-models/ligne-de-poste.ts
-models/ligne-de-tva.ts
-models/mode-depot.ts
-models/mode-paiement.ts
-models/montant-apayer.ts
-models/montant-base-ht.ts
-models/montant-ht-total.ts
-models/montant-remise-globale-ttc.ts
-models/montant-total-acompte.ts
-models/montant-total-ligne-ht.ts
-models/montant-total.ts
-models/montant-ttc-total.ts
-models/montant-tva-ligne.ts
-models/montant-tva-total.ts
-models/montant-tva.ts
-models/montant-unitaire-ht.ts
-models/note.ts
-models/obtenir-id-chorus-pro-request.ts
-models/obtenir-id-chorus-pro-response.ts
-models/options-processing.ts
-models/parametres-signature.ts
-models/parametres-structure.ts
-models/pdffactur-xinfo.ts
-models/piece-jointe-complementaire.ts
-models/profil-api.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-tache.ts
-models/reponse-validation-erreur.ts
-models/reponse-validation-succes.ts
-models/resultat-afnor.ts
-models/resultat-chorus-pro.ts
-models/resultat-validation-pdfapi.ts
+models/invoice-format.ts
+models/invoice-line-allowance-amount.ts
+models/invoice-line.ts
+models/invoice-note.ts
+models/invoice-references.ts
+models/invoice-status.ts
+models/invoice-totals-prepayment.ts
+models/invoice-totals.ts
+models/invoice-type-code.ts
+models/invoicing-framework-code.ts
+models/invoicing-framework.ts
+models/line-net-amount.ts
+models/mandatory-note-schema.ts
+models/manual-rate.ts
+models/manual-vat-rate.ts
+models/operation-nature.ts
+models/output-format.ts
+models/page-dimensions-schema.ts
+models/payee.ts
+models/payment-means.ts
+models/pdfvalidation-result-api.ts
+models/pdpcredentials.ts
+models/postal-address.ts
+models/processing-options.ts
+models/quantity.ts
+models/recipient.ts
 models/scheme-id.ts
-models/service-structure.ts
+models/search-flow-request.ts
+models/search-flow-response.ts
+models/search-services-response.ts
+models/search-structure-request.ts
+models/search-structure-response.ts
+models/signature-info-api.ts
 models/signature-info.ts
-models/soumettre-facture-complete-request.ts
-models/soumettre-facture-complete-response.ts
-models/soumettre-facture-request.ts
-models/soumettre-facture-response.ts
-models/statut-celery.ts
-models/statut-facture.ts
-models/statut-tache.ts
+models/signature-parameters.ts
+models/simplified-invoice-data.ts
 models/structure-info.ts
-models/tauxmanuel.ts
-models/type-facture.ts
-models/type-tva.ts
-models/unite.ts
-models/utilisateur.ts
+models/structure-parameters.ts
+models/structure-service.ts
+models/submission-mode.ts
+models/submit-complete-invoice-request.ts
+models/submit-complete-invoice-response.ts
+models/submit-flow-request.ts
+models/submit-flow-response.ts
+models/submit-invoice-request.ts
+models/submit-invoice-response.ts
+models/supplementary-attachment.ts
+models/supplier.ts
+models/task-response.ts
+models/task-status.ts
+models/taxable-amount.ts
+models/total-gross-amount.ts
+models/total-net-amount.ts
+models/total-vatamount.ts
+models/unit-net-price.ts
+models/unit-of-measure.ts
+models/validation-error-detail.ts
 models/validation-error-loc-inner.ts
+models/validation-error-response.ts
 models/validation-error.ts
+models/validation-success-response.ts
+models/vat-amount.ts
+models/vataccounting-code.ts
+models/vatamount.ts
+models/vatcategory.ts
+models/vatline.ts
+models/verification-success-response.ts
+models/verified-field-schema.ts
 package.json
 tsconfig.esm.json
 tsconfig.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
+## [3.0.1] - 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/v3.0.1...HEAD
+[3.0.1]: https://github.com/factpulse/sdk-typescript/releases/tag/v3.0.1