@factpulse/sdk 2.0.49 → 3.0.2

package/dist/esm/src/helpers/client.js

@@ -12,8 +12,8 @@ import FormData from 'form-data';
 import * as fs from 'fs';
 import * as path from 'path';
 import { FactPulseAuthError, FactPulsePollingTimeout, FactPulseValidationError } from './exceptions';
-/** Convertit une valeur en string de montant pour l'API. */
-export function montant(value) {
+/** Converts a value to an amount string for the API. */
+export function amount(value) {
     if (value === null || value === undefined)
         return '0.00';
     if (typeof value === 'number')
@@ -22,150 +22,150 @@ export function montant(value) {
         return value;
     return '0.00';
 }
-/** Crée un objet MontantTotal simplifié. */
-export function montantTotal(ht, tva, ttc, aPayer, options) {
+/** Creates a simplified InvoiceTotals object. */
+export function invoiceTotals(exclTax, vat, inclTax, amountDue, options) {
     const result = {
-        montantHtTotal: montant(ht), montantTva: montant(tva),
-        montantTtcTotal: montant(ttc), montantAPayer: montant(aPayer),
+        totalNetAmount: amount(exclTax), vatAmount: amount(vat),
+        totalGrossAmount: amount(inclTax), amountDue: amount(amountDue),
     };
-    if ((options === null || options === void 0 ? void 0 : options.remiseTtc) !== undefined)
-        result.montantRemiseGlobaleTtc = montant(options.remiseTtc);
-    if ((options === null || options === void 0 ? void 0 : options.motifRemise) !== undefined)
-        result.motifRemiseGlobaleTtc = options.motifRemise;
-    if ((options === null || options === void 0 ? void 0 : options.acompte) !== undefined)
-        result.acompte = montant(options.acompte);
+    if ((options === null || options === void 0 ? void 0 : options.globalAllowanceAmount) !== undefined)
+        result.globalAllowanceAmount = amount(options.globalAllowanceAmount);
+    if ((options === null || options === void 0 ? void 0 : options.globalAllowanceReason) !== undefined)
+        result.globalAllowanceReason = options.globalAllowanceReason;
+    if ((options === null || options === void 0 ? void 0 : options.prepayment) !== undefined)
+        result.prepayment = amount(options.prepayment);
     return result;
 }
-/** Crée une ligne de poste (aligné sur LigneDePoste de models.py).
- * Pour le taux TVA: soit tauxTva (code ex: "TVA20") soit tauxTvaManuel (valeur ex: 20.00) */
-export function ligneDePoste(numero, denomination, quantite, montantUnitaireHt, montantTotalLigneHt, options) {
+/** Creates an invoice line (aligned with InvoiceLine in models.py).
+ * For VAT rate: either vatRate (code e.g.: "VAT20") or manualVatRate (value e.g.: 20.00) */
+export function invoiceLine(lineNumber, itemName, quantity, unitNetPrice, lineNetAmount, options) {
     var _a, _b, _c;
     const result = {
-        numero, denomination, quantite: montant(quantite), montantUnitaireHt: montant(montantUnitaireHt),
-        montantTotalLigneHt: montant(montantTotalLigneHt),
-        categorieTva: (_a = options === null || options === void 0 ? void 0 : options.categorieTva) !== null && _a !== void 0 ? _a : 'S', unite: (_b = options === null || options === void 0 ? void 0 : options.unite) !== null && _b !== void 0 ? _b : 'FORFAIT',
+        lineNumber, itemName, quantity: amount(quantity), unitNetPrice: amount(unitNetPrice),
+        lineNetAmount: amount(lineNetAmount),
+        vatCategory: (_a = options === null || options === void 0 ? void 0 : options.vatCategory) !== null && _a !== void 0 ? _a : 'S', unit: (_b = options === null || options === void 0 ? void 0 : options.unit) !== null && _b !== void 0 ? _b : 'LUMP_SUM',
     };
-    // Soit tauxTva (code) soit tauxTvaManuel (valeur)
-    if (options === null || options === void 0 ? void 0 : options.tauxTva)
-        result.tauxTva = options.tauxTva;
+    // Either vatRate (code) or manualVatRate (value)
+    if (options === null || options === void 0 ? void 0 : options.vatRate)
+        result.vatRate = options.vatRate;
     else
-        result.tauxTvaManuel = montant((_c = options === null || options === void 0 ? void 0 : options.tauxTvaManuel) !== null && _c !== void 0 ? _c : '20.00');
+        result.manualVatRate = amount((_c = options === null || options === void 0 ? void 0 : options.manualVatRate) !== null && _c !== void 0 ? _c : '20.00');
     if (options === null || options === void 0 ? void 0 : options.reference)
         result.reference = options.reference;
-    if ((options === null || options === void 0 ? void 0 : options.montantRemiseHt) !== undefined)
-        result.montantRemiseHt = montant(options.montantRemiseHt);
-    if (options === null || options === void 0 ? void 0 : options.codeRaisonReduction)
-        result.codeRaisonReduction = options.codeRaisonReduction;
-    if (options === null || options === void 0 ? void 0 : options.raisonReduction)
-        result.raisonReduction = options.raisonReduction;
-    if (options === null || options === void 0 ? void 0 : options.dateDebutPeriode)
-        result.dateDebutPeriode = options.dateDebutPeriode;
-    if (options === null || options === void 0 ? void 0 : options.dateFinPeriode)
-        result.dateFinPeriode = options.dateFinPeriode;
+    if ((options === null || options === void 0 ? void 0 : options.lineAllowanceAmount) !== undefined)
+        result.lineAllowanceAmount = amount(options.lineAllowanceAmount);
+    if (options === null || options === void 0 ? void 0 : options.allowanceReasonCode)
+        result.allowanceReasonCode = options.allowanceReasonCode;
+    if (options === null || options === void 0 ? void 0 : options.allowanceReason)
+        result.allowanceReason = options.allowanceReason;
+    if (options === null || options === void 0 ? void 0 : options.periodStartDate)
+        result.periodStartDate = options.periodStartDate;
+    if (options === null || options === void 0 ? void 0 : options.periodEndDate)
+        result.periodEndDate = options.periodEndDate;
     return result;
 }
-/** Crée une ligne de TVA (aligné sur LigneDeTVA de models.py).
- * Pour le taux: soit taux (code ex: "TVA20") soit tauxManuel (valeur ex: 20.00) */
-export function ligneDeTva(montantBaseHt, montantTva, options) {
+/** Creates a VAT line (aligned with VATLine in models.py).
+ * For rate: either rate (code e.g.: "VAT20") or manualRate (value e.g.: 20.00) */
+export function vatLine(taxableAmount, vatAmount, options) {
     var _a, _b;
     const result = {
-        montantBaseHt: montant(montantBaseHt), montantTva: montant(montantTva), categorie: (_a = options === null || options === void 0 ? void 0 : options.categorie) !== null && _a !== void 0 ? _a : 'S',
+        taxableAmount: amount(taxableAmount), vatAmount: amount(vatAmount), category: (_a = options === null || options === void 0 ? void 0 : options.category) !== null && _a !== void 0 ? _a : 'S',
     };
-    // Soit taux (code) soit tauxManuel (valeur)
-    if (options === null || options === void 0 ? void 0 : options.taux)
-        result.taux = options.taux;
+    // Either rate (code) or manualRate (value)
+    if (options === null || options === void 0 ? void 0 : options.rate)
+        result.rate = options.rate;
     else
-        result.tauxManuel = montant((_b = options === null || options === void 0 ? void 0 : options.tauxManuel) !== null && _b !== void 0 ? _b : '20.00');
+        result.manualRate = amount((_b = options === null || options === void 0 ? void 0 : options.manualRate) !== null && _b !== void 0 ? _b : '20.00');
     return result;
 }
-/** Crée une adresse postale pour l'API FactPulse. */
-export function adressePostale(ligne1, codePostal, ville, options) {
+/** Creates a postal address for the FactPulse API. */
+export function postalAddress(lineOne, postalCode, city, options) {
     var _a;
-    const result = { ligneUn: ligne1, codePostal, nomVille: ville, paysCodeIso: (_a = options === null || options === void 0 ? void 0 : options.pays) !== null && _a !== void 0 ? _a : 'FR' };
-    if (options === null || options === void 0 ? void 0 : options.ligne2)
-        result.ligneDeux = options.ligne2;
-    if (options === null || options === void 0 ? void 0 : options.ligne3)
-        result.ligneTrois = options.ligne3;
+    const result = { lineOne, postalCode, city, countryCode: (_a = options === null || options === void 0 ? void 0 : options.countryCode) !== null && _a !== void 0 ? _a : 'FR' };
+    if (options === null || options === void 0 ? void 0 : options.lineTwo)
+        result.lineTwo = options.lineTwo;
+    if (options === null || options === void 0 ? void 0 : options.lineThree)
+        result.lineThree = options.lineThree;
     return result;
 }
-/** Crée une adresse électronique pour l'API FactPulse. schemeId: "0009"=SIREN, "0225"=SIRET */
-export function adresseElectronique(identifiant, schemeId = '0009') {
-    return { identifiant, schemeId };
+/** Creates an electronic address for the FactPulse API. schemeId: "0009"=SIREN, "0225"=SIRET */
+export function electronicAddress(identifier, schemeId = '0009') {
+    return { identifier, schemeId };
 }
-/** Calcule le numéro TVA intracommunautaire français depuis un SIREN. */
-function calculerTvaIntra(siren) {
+/** Computes the French intra-community VAT number from a SIREN. */
+function computeVatIntra(siren) {
     if (siren.length !== 9 || !/^\d+$/.test(siren))
         return null;
     const cle = (12 + 3 * (parseInt(siren, 10) % 97)) % 97;
     return `FR${cle.toString().padStart(2, '0')}${siren}`;
 }
-/** Crée un fournisseur (émetteur) avec auto-calcul SIREN, TVA intracommunautaire et adresses. */
-export function fournisseur(nom, siret, adresseLigne1, codePostal, ville, options) {
+/** Creates a supplier (issuer) with auto-computed SIREN, intra-EU VAT number and addresses. */
+export function supplier(name, siret, addressLine1, postalCode, city, options) {
     var _a, _b, _c;
     const opts = options !== null && options !== void 0 ? options : {};
     const siren = (_a = opts.siren) !== null && _a !== void 0 ? _a : (siret.length === 14 ? siret.slice(0, 9) : undefined);
-    const numeroTvaIntra = (_b = opts.numeroTvaIntra) !== null && _b !== void 0 ? _b : (siren ? calculerTvaIntra(siren) : null);
+    const vatNumber = (_b = opts.vatNumber) !== null && _b !== void 0 ? _b : (siren ? computeVatIntra(siren) : null);
     const result = {
-        nom, idFournisseur: (_c = opts.idFournisseur) !== null && _c !== void 0 ? _c : 0, siret,
-        adresseElectronique: adresseElectronique(siret, '0225'),
-        adressePostale: adressePostale(adresseLigne1, codePostal, ville, { pays: opts.pays, ligne2: opts.adresseLigne2 }),
+        name, supplierId: (_c = opts.supplierId) !== null && _c !== void 0 ? _c : 0, siret,
+        electronicAddress: electronicAddress(siret, '0225'),
+        postalAddress: postalAddress(addressLine1, postalCode, city, { countryCode: opts.countryCode, lineTwo: opts.addressLine2 }),
     };
     if (siren)
         result.siren = siren;
-    if (numeroTvaIntra)
-        result.numeroTvaIntra = numeroTvaIntra;
+    if (vatNumber)
+        result.vatNumber = vatNumber;
     if (opts.iban)
         result.iban = opts.iban;
-    if (opts.codeService)
-        result.idServiceFournisseur = opts.codeService;
-    if (opts.codeCoordonnesBancaires)
-        result.codeCoordonnesBancairesFournisseur = opts.codeCoordonnesBancaires;
+    if (opts.supplierServiceId)
+        result.supplierServiceId = opts.supplierServiceId;
+    if (opts.supplierBankDetailsCode)
+        result.supplierBankDetailsCode = opts.supplierBankDetailsCode;
     return result;
 }
-/** Crée un destinataire (client) avec auto-calcul SIREN et adresses. */
-export function destinataire(nom, siret, adresseLigne1, codePostal, ville, options) {
+/** Creates a recipient (customer) with auto-computed SIREN and addresses. */
+export function recipient(name, siret, addressLine1, postalCode, city, options) {
     var _a;
     const opts = options !== null && options !== void 0 ? options : {};
     const siren = (_a = opts.siren) !== null && _a !== void 0 ? _a : (siret.length === 14 ? siret.slice(0, 9) : undefined);
     const result = {
-        nom, siret,
-        adresseElectronique: adresseElectronique(siret, '0225'),
-        adressePostale: adressePostale(adresseLigne1, codePostal, ville, { pays: opts.pays, ligne2: opts.adresseLigne2 }),
+        name, siret,
+        electronicAddress: electronicAddress(siret, '0225'),
+        postalAddress: postalAddress(addressLine1, postalCode, city, { countryCode: opts.countryCode, lineTwo: opts.addressLine2 }),
     };
     if (siren)
         result.siren = siren;
-    if (opts.codeServiceExecutant)
-        result.codeServiceExecutant = opts.codeServiceExecutant;
+    if (opts.executingServiceCode)
+        result.executingServiceCode = opts.executingServiceCode;
     return result;
 }
 /**
- * Crée un bénéficiaire (factor) pour l'affacturage.
+ * Creates a beneficiary (factor) for factoring.
  *
- * Le bénéficiaire (BG-10 / PayeeTradeParty) est utilisé lorsque le paiement
- * doit être effectué à un tiers différent du fournisseur, typiquement un
- * factor (société d'affacturage).
+ * The beneficiary (BG-10 / PayeeTradeParty) is used when payment
+ * must be made to a third party different from the supplier, typically
+ * a factor (factoring company).
  *
- * Pour les factures affacturées, il faut aussi:
- * - Utiliser un type de document affacturé (393, 396, 501, 502, 472, 473)
- * - Ajouter une note ACC avec la mention de subrogation
- * - L'IBAN du bénéficiaire sera utilisé pour le paiement
+ * For factored invoices, you also need to:
+ * - Use a factored document type (393, 396, 501, 502, 472, 473)
+ * - Add an ACC note with the subrogation mention
+ * - The beneficiary's IBAN will be used for payment
  *
- * @param nom Raison sociale du factor (BT-59)
+ * @param name Factor's business name (BT-59)
  * @param options Options: siret (BT-60), siren (BT-61), iban, bic
- * @returns Dict prêt à être utilisé dans une facture affacturée
+ * @returns Dict ready to be used in a factored invoice
  *
  * @example
- * const factor = beneficiaire('FACTOR SAS', {
+ * const factor = beneficiary('FACTOR SAS', {
  *   siret: '30000000700033',
  *   iban: 'FR76 3000 4000 0500 0012 3456 789',
  * });
  */
-export function beneficiaire(nom, options) {
+export function beneficiary(name, options) {
     var _a;
     const opts = options !== null && options !== void 0 ? options : {};
-    // Auto-calcul SIREN depuis SIRET
+    // Auto-compute SIREN from SIRET
     const siren = (_a = opts.siren) !== null && _a !== void 0 ? _a : (opts.siret && opts.siret.length === 14 ? opts.siret.slice(0, 9) : undefined);
-    const result = { nom };
+    const result = { name };
     if (opts.siret)
         result.siret = opts.siret;
     if (siren)
@@ -177,7 +177,7 @@ export function beneficiaire(nom, options) {
     return result;
 }
 // =============================================================================
-// Client principal
+// Main client
 // =============================================================================
 const DEFAULT_API_URL = 'https://factpulse.fr';
 const DEFAULT_POLLING_INTERVAL = 2000;
@@ -224,7 +224,7 @@ export class FactPulseClient {
             flow_service_url: this.afnorCredentials.flowServiceUrl,
         };
     }
-    // Alias plus courts
+    // Shorter aliases
     getChorusProCredentials() { return this.getChorusCredentialsForApi(); }
     getAfnorCredentials() { return this.getAfnorCredentialsForApi(); }
     obtainToken() {
@@ -239,7 +239,7 @@ export class FactPulseClient {
             }
             catch (error) {
                 const axiosError = error;
-                throw new FactPulseAuthError(`Impossible d'obtenir le token JWT: ${((_b = (_a = axiosError.response) === null || _a === void 0 ? void 0 : _a.data) === null || _b === void 0 ? void 0 : _b.detail) || axiosError.message}`);
+                throw new FactPulseAuthError(`Unable to obtain JWT token: ${((_b = (_a = axiosError.response) === null || _a === void 0 ? void 0 : _a.data) === null || _b === void 0 ? void 0 : _b.detail) || axiosError.message}`);
             }
         });
     }
@@ -267,7 +267,7 @@ export class FactPulseClient {
                     throw new FactPulsePollingTimeout(taskId, timeoutMs);
                 yield this.ensureAuthenticated();
                 try {
-                    const response = yield this.httpClient.get(`${this.config.apiUrl}/api/v1/traitement/taches/${taskId}/statut`, {
+                    const response = yield this.httpClient.get(`${this.config.apiUrl}/api/v1/processing/tasks/${taskId}/status`, {
                         headers: { Authorization: `Bearer ${this.accessToken}` },
                     });
                     const { statut, resultat } = response.data;
@@ -277,7 +277,7 @@ export class FactPulseClient {
                         // Format AFNOR: errorMessage, details
                         const result = resultat;
                         const errors = Array.isArray(result === null || result === void 0 ? void 0 : result.details) ? result.details.filter((e) => typeof e === 'object' && e !== null) : [];
-                        throw new FactPulseValidationError(`La tâche ${taskId} a échoué: ${(result === null || result === void 0 ? void 0 : result.errorMessage) || 'Erreur inconnue'}`, errors);
+                        throw new FactPulseValidationError(`Task ${taskId} failed: ${(result === null || result === void 0 ? void 0 : result.errorMessage) || 'Unknown error'}`, errors);
                     }
                     yield new Promise(resolve => setTimeout(resolve, currentInterval));
                     currentInterval = Math.min(currentInterval * 1.5, 10000);
@@ -290,28 +290,28 @@ export class FactPulseClient {
                         this.resetAuth();
                         continue;
                     }
-                    throw new FactPulseValidationError(`Erreur API: ${axiosError.message}`);
+                    throw new FactPulseValidationError(`API Error: ${axiosError.message}`);
                 }
             }
         });
     }
-    genererFacturx(factureData_1, pdfPath_1) {
-        return __awaiter(this, arguments, void 0, function* (factureData, pdfPath, profil = 'EN16931', formatSortie = 'pdf', sync = true, timeout) {
+    generateFacturx(invoiceData_1, pdfPath_1) {
+        return __awaiter(this, arguments, void 0, function* (invoiceData, pdfPath, profile = 'EN16931', outputFormat = 'pdf', sync = true, timeout) {
             var _a, _b, _c, _d;
-            const jsonData = typeof factureData === 'string' ? factureData : JSON.stringify(factureData);
+            const jsonData = typeof invoiceData === 'string' ? invoiceData : JSON.stringify(invoiceData);
             let taskId = null;
             for (let attempt = 0; attempt <= this.config.maxRetries; attempt++) {
                 yield this.ensureAuthenticated();
                 const form = new FormData();
-                form.append('donnees_facture', jsonData);
-                form.append('profil', profil);
-                form.append('format_sortie', formatSortie);
+                form.append('invoice_data', jsonData);
+                form.append('profile', profile);
+                form.append('output_format', outputFormat);
                 form.append('source_pdf', fs.createReadStream(pdfPath), { filename: path.basename(pdfPath), contentType: 'application/pdf' });
                 try {
-                    const response = yield this.httpClient.post(`${this.config.apiUrl}/api/v1/traitement/generer-facture`, form, {
+                    const response = yield this.httpClient.post(`${this.config.apiUrl}/api/v1/processing/generate-invoice`, form, {
                         headers: Object.assign(Object.assign({}, form.getHeaders()), { Authorization: `Bearer ${this.accessToken}` }), timeout: 60000,
                     });
-                    taskId = response.data.id_tache;
+                    taskId = response.data.task_id;
                     break;
                 }
                 catch (error) {
@@ -320,14 +320,14 @@ export class FactPulseClient {
                         this.resetAuth();
                         continue;
                     }
-                    // Extraire les détails d'erreur du corps de la réponse
+                    // Extract error details from response body
                     const responseData = (_b = axiosError.response) === null || _b === void 0 ? void 0 : _b.data;
-                    let errorMsg = `Erreur API (${((_c = axiosError.response) === null || _c === void 0 ? void 0 : _c.status) || 'unknown'}): ${axiosError.message}`;
+                    let errorMsg = `API Error (${((_c = axiosError.response) === null || _c === void 0 ? void 0 : _c.status) || 'unknown'}): ${axiosError.message}`;
                     const errors = [];
                     if (responseData) {
                         // Format FastAPI/Pydantic: {"detail": [{"loc": [...], "msg": "...", "type": "..."}]}
                         if (Array.isArray(responseData.detail)) {
-                            errorMsg = 'Erreur de validation';
+                            errorMsg = 'Validation error';
                             for (const err of responseData.detail) {
                                 if (typeof err === 'object' && err !== null) {
                                     const loc = err.loc || [];
@@ -348,21 +348,21 @@ export class FactPulseClient {
                             errorMsg = responseData.errorMessage;
                         }
                     }
-                    console.error(`Erreur API ${(_d = axiosError.response) === null || _d === void 0 ? void 0 : _d.status}:`, responseData);
+                    console.error(`API Error ${(_d = axiosError.response) === null || _d === void 0 ? void 0 : _d.status}:`, responseData);
                     throw new FactPulseValidationError(errorMsg, errors);
                 }
             }
             if (!taskId)
-                throw new FactPulseValidationError("Pas d'ID de tâche");
+                throw new FactPulseValidationError("No task ID");
             if (!sync)
                 return taskId;
             const result = yield this.pollTask(taskId, timeout);
-            if (result.contenu_b64)
-                return Buffer.from(result.contenu_b64, 'base64');
-            throw new FactPulseValidationError('Pas de contenu');
+            if (result.content_b64)
+                return Buffer.from(result.content_b64, 'base64');
+            throw new FactPulseValidationError('No content');
         });
     }
-    static formatMontant(m) {
+    static formatAmount(m) {
         if (m === null || m === undefined)
             return '0.00';
         if (typeof m === 'number')
@@ -372,21 +372,21 @@ export class FactPulseClient {
         return '0.00';
     }
     // =========================================================================
-    // AFNOR - Authentication et helpers internes
+    // AFNOR - Authentication and internal helpers
     // =========================================================================
     /**
-     * Recupere les credentials AFNOR (mode stored ou zero-trust).
-     * Mode zero-trust: Retourne les afnorCredentials fournis au constructeur.
-     * Mode stored: Recupere les credentials via GET /api/v1/afnor/credentials.
+     * Retrieves AFNOR credentials (stored or zero-trust mode).
+     * Zero-trust mode: Returns the afnorCredentials provided to the constructor.
+     * Stored mode: Retrieves credentials via GET /api/v1/afnor/credentials.
      */
     getAfnorCredentialsInternal() {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b;
-            // Mode zero-trust : credentials fournis au constructeur
+            // Zero-trust mode: credentials provided to the constructor
             if (this.afnorCredentials) {
                 return this.afnorCredentials;
             }
-            // Mode stored : recuperer les credentials via l'API
+            // Stored mode: retrieve credentials via the API
             yield this.ensureAuthenticated();
             try {
                 const response = yield this.httpClient.get(`${this.config.apiUrl}/api/v1/afnor/credentials`, {
@@ -406,27 +406,27 @@ export class FactPulseClient {
                 if (((_a = axiosError.response) === null || _a === void 0 ? void 0 : _a.status) === 400) {
                     const detail = (_b = axiosError.response.data) === null || _b === void 0 ? void 0 : _b.detail;
                     if (typeof detail === 'object' && (detail === null || detail === void 0 ? void 0 : detail.error) === 'NO_CLIENT_UID') {
-                        throw new FactPulseAuthError("Aucun client_uid dans le JWT. Pour utiliser les endpoints AFNOR, soit:\n" +
-                            "1. Generez un token avec un client_uid (mode stored)\n" +
-                            "2. Fournissez AFNORCredentials au constructeur du client (mode zero-trust)");
+                        throw new FactPulseAuthError("No client_uid in JWT. To use AFNOR endpoints, either:\n" +
+                            "1. Generate a token with a client_uid (stored mode)\n" +
+                            "2. Provide AFNORCredentials to the client constructor (zero-trust mode)");
                     }
                 }
-                throw new FactPulseAuthError(`Echec recuperation credentials AFNOR: ${axiosError.message}`);
+                throw new FactPulseAuthError(`Failed to retrieve AFNOR credentials: ${axiosError.message}`);
             }
         });
     }
     /**
-     * Obtient le token OAuth2 AFNOR et l'URL de la PDP.
-     * Cette methode:
-     * 1. Recupere les credentials AFNOR (mode stored ou zero-trust)
-     * 2. Fait l'OAuth AFNOR pour obtenir un token
-     * 3. Retourne le token et l'URL de la PDP
+     * Obtains the AFNOR OAuth2 token and the PDP URL.
+     * This method:
+     * 1. Retrieves AFNOR credentials (stored or zero-trust mode)
+     * 2. Performs AFNOR OAuth to obtain a token
+     * 3. Returns the token and the PDP URL
      */
     getAfnorTokenAndUrl() {
         return __awaiter(this, void 0, void 0, function* () {
-            // Etape 1: Obtenir les credentials AFNOR
+            // Step 1: Get AFNOR credentials
             const credentials = yield this.getAfnorCredentialsInternal();
-            // Etape 2: Faire l'OAuth AFNOR via le proxy FactPulse
+            // Step 2: Perform AFNOR OAuth via the FactPulse proxy
             const oauthData = new URLSearchParams({
                 grant_type: 'client_credentials',
                 client_id: credentials.clientId,
@@ -441,7 +441,7 @@ export class FactPulseClient {
                 });
                 const tokenData = response.data;
                 if (!tokenData.access_token) {
-                    throw new FactPulseAuthError('Reponse OAuth2 AFNOR invalide: access_token manquant');
+                    throw new FactPulseAuthError('Invalid AFNOR OAuth2 response: access_token missing');
                 }
                 return {
                     token: tokenData.access_token,
@@ -450,13 +450,13 @@ export class FactPulseClient {
             }
             catch (error) {
                 const axiosError = error;
-                throw new FactPulseAuthError(`Echec OAuth2 AFNOR: ${axiosError.message}`);
+                throw new FactPulseAuthError(`AFNOR OAuth2 failed: ${axiosError.message}`);
             }
         });
     }
     /**
-     * Effectue une requete vers l'API AFNOR avec gestion d'auth et d'erreurs.
-     * IMPORTANT: Cette methode utilise le token OAuth AFNOR, PAS le JWT FactPulse!
+     * Performs a request to the AFNOR API with auth and error handling.
+     * IMPORTANT: This method uses the AFNOR OAuth token, NOT the FactPulse JWT!
      */
     makeAfnorRequest(method, endpoint, options) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -464,7 +464,7 @@ export class FactPulseClient {
             // Obtenir le token AFNOR et l'URL de la PDP
             const { token: afnorToken, pdpBaseUrl } = yield this.getAfnorTokenAndUrl();
             const url = `${this.config.apiUrl}/api/v1/afnor${endpoint}`;
-            // TOUJOURS utiliser le token AFNOR + header X-PDP-Base-URL
+            // ALWAYS use the AFNOR token + X-PDP-Base-URL header
             const headers = {
                 'Authorization': `Bearer ${afnorToken}`,
                 'X-PDP-Base-URL': pdpBaseUrl,
@@ -498,7 +498,7 @@ export class FactPulseClient {
                 const errorMsg = ((_b = (_a = axiosError.response) === null || _a === void 0 ? void 0 : _a.data) === null || _b === void 0 ? void 0 : _b.errorMessage) ||
                     ((_d = (_c = axiosError.response) === null || _c === void 0 ? void 0 : _c.data) === null || _d === void 0 ? void 0 : _d.detail) ||
                     axiosError.message;
-                throw new FactPulseValidationError(`Erreur AFNOR: ${errorMsg}`);
+                throw new FactPulseValidationError(`AFNOR Error: ${errorMsg}`);
             }
         });
     }
@@ -520,22 +520,22 @@ export class FactPulseClient {
     }
     // ==================== AFNOR Flow ====================
     /**
-     * Soumet une facture a une PDP via l'API AFNOR.
-     * L'authentification utilise le token OAuth AFNOR (obtenu automatiquement),
-     * soit via les credentials stockes (mode stored), soit via les afnorCredentials
-     * fournis au constructeur (mode zero-trust).
+     * Submits an invoice to a PDP via the AFNOR API.
+     * Authentication uses the AFNOR OAuth token (obtained automatically),
+     * either via stored credentials (stored mode), or via the afnorCredentials
+     * provided to the constructor (zero-trust mode).
      *
-     * @param pdfBuffer Buffer du PDF Factur-X a soumettre
-     * @param flowName Nom du flux (ex: "Facture FAC-2025-001")
+     * @param pdfBuffer Buffer of the Factur-X PDF to submit
+     * @param flowName Flow name (e.g.: "Invoice INV-2025-001")
      * @param options Options: trackingId, flowSyntax (CII/UBL), flowProfile
      */
-    soumettreFactureAfnor(pdfBuffer_1, flowName_1) {
+    submitInvoiceAfnor(pdfBuffer_1, flowName_1) {
         return __awaiter(this, arguments, void 0, function* (pdfBuffer, flowName, options = {}) {
             const { trackingId, flowSyntax = 'CII', flowProfile = 'EN16931' } = options;
-            // Calculer SHA-256
+            // Compute SHA-256
             const crypto = require('crypto');
             const sha256 = crypto.createHash('sha256').update(pdfBuffer).digest('hex');
-            // Preparer flowInfo
+            // Prepare flowInfo
             const flowInfo = { name: flowName, flowSyntax, flowProfile, sha256 };
             if (trackingId)
                 flowInfo.trackingId = trackingId;
@@ -545,7 +545,7 @@ export class FactPulseClient {
             return this.makeAfnorRequest('POST', '/flow/v1/flows', { files: form });
         });
     }
-    rechercherFluxAfnor() {
+    searchFlowsAfnor() {
         return __awaiter(this, arguments, void 0, function* (criteria = {}) {
             var _a, _b;
             const searchBody = {
@@ -560,9 +560,9 @@ export class FactPulseClient {
             return this.makeAfnorRequest('POST', '/flow/v1/flows/search', { data: searchBody });
         });
     }
-    telechargerFluxAfnor(flowId) {
+    downloadFlowAfnor(flowId) {
         return __awaiter(this, void 0, void 0, function* () {
-            // Pour le telechargement, on doit gerer le type de reponse differemment
+            // For downloading, we need to handle the response type differently
             const { token: afnorToken, pdpBaseUrl } = yield this.getAfnorTokenAndUrl();
             const url = `${this.config.apiUrl}/api/v1/afnor/flow/v1/flows/${flowId}`;
             const response = yield this.httpClient.get(url, {
@@ -576,27 +576,27 @@ export class FactPulseClient {
         });
     }
     /**
-     * Récupère les métadonnées JSON d'un flux entrant (facture fournisseur).
-     * Télécharge un flux entrant depuis la PDP AFNOR et extrait les métadonnées
-     * de la facture vers un format JSON unifié. Supporte Factur-X, CII et UBL.
+     * Retrieves JSON metadata of an incoming flow (supplier invoice).
+     * Downloads an incoming flow from the AFNOR PDP and extracts invoice
+     * metadata into a unified JSON format. Supports Factur-X, CII and UBL.
      *
-     * Note: Cet endpoint utilise l'authentification JWT FactPulse (pas OAuth AFNOR).
-     * Le serveur FactPulse se charge d'appeler la PDP avec les credentials stockés.
+     * Note: This endpoint uses FactPulse JWT authentication (not AFNOR OAuth).
+     * The FactPulse server handles calling the PDP with stored credentials.
      *
-     * @param flowId Identifiant du flux (UUID)
-     * @param includeDocument Si true, inclut le document original encodé en base64
-     * @returns Métadonnées de la facture (fournisseur, montants, dates, etc.)
+     * @param flowId Flow identifier (UUID)
+     * @param includeDocument If true, includes the original document encoded in base64
+     * @returns Invoice metadata (supplier, amounts, dates, etc.)
      *
      * @example
-     * const facture = await client.obtenirFactureEntranteAfnor("550e8400-...");
-     * console.log(`Fournisseur: ${facture.fournisseur.nom}`);
-     * console.log(`Montant TTC: ${facture.montant_ttc} ${facture.devise}`);
+     * const invoice = await client.getIncomingInvoiceAfnor("550e8400-...");
+     * console.log(`Supplier: ${invoice.supplier.name}`);
+     * console.log(`Total incl. tax: ${invoice.total_incl_tax} ${invoice.currency}`);
      */
-    obtenirFactureEntranteAfnor(flowId_1) {
+    getIncomingInvoiceAfnor(flowId_1) {
         return __awaiter(this, arguments, void 0, function* (flowId, includeDocument = false) {
             var _a, _b;
             yield this.ensureAuthenticated();
-            const url = `${this.config.apiUrl}/api/v1/afnor/flux-entrants/${flowId}`;
+            const url = `${this.config.apiUrl}/api/v1/afnor/incoming-flows/${flowId}`;
             const params = {};
             if (includeDocument) {
                 params.include_document = 'true';
@@ -611,7 +611,7 @@ export class FactPulseClient {
             }
             catch (error) {
                 const axiosError = error;
-                throw new FactPulseValidationError(`Erreur flux entrant: ${((_b = (_a = axiosError.response) === null || _a === void 0 ? void 0 : _a.data) === null || _b === void 0 ? void 0 : _b.detail) || axiosError.message}`);
+                throw new FactPulseValidationError(`Incoming flow error: ${((_b = (_a = axiosError.response) === null || _a === void 0 ? void 0 : _a.data) === null || _b === void 0 ? void 0 : _b.detail) || axiosError.message}`);
             }
         });
     }
@@ -640,9 +640,9 @@ export class FactPulseClient {
         });
     }
     /**
-     * Liste les services d'une structure Chorus Pro.
-     * @param idStructureCpp ID Chorus Pro de la structure
-     * @returns Objet avec listeServices, total, codeRetour, libelle
+     * Lists the services of a Chorus Pro structure.
+     * @param idStructureCpp Chorus Pro ID of the structure
+     * @returns Object with listeServices, total, codeRetour, libelle
      */
     listerServicesStructureChorus(idStructureCpp) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -661,19 +661,19 @@ export class FactPulseClient {
             return null;
         });
     }
-    soumettreFactureChorus(factureData) {
+    submitInvoiceChorus(invoiceData) {
         return __awaiter(this, void 0, void 0, function* () {
             yield this.ensureAuthenticated();
-            const response = yield this.httpClient.post(`${this.config.apiUrl}/api/v1/chorus/factures/soumettre`, factureData, {
+            const response = yield this.httpClient.post(`${this.config.apiUrl}/api/v1/chorus/factures/soumettre`, invoiceData, {
                 headers: { Authorization: `Bearer ${this.accessToken}`, 'Content-Type': 'application/json' },
             });
             return response.data;
         });
     }
-    consulterFactureChorus(identifiantFactureCpp) {
+    lookupInvoiceChorus(invoiceIdCpp) {
         return __awaiter(this, void 0, void 0, function* () {
             yield this.ensureAuthenticated();
-            const response = yield this.httpClient.post(`${this.config.apiUrl}/api/v1/chorus/factures/consulter`, { identifiant_facture_cpp: identifiantFactureCpp }, {
+            const response = yield this.httpClient.post(`${this.config.apiUrl}/api/v1/chorus/factures/consulter`, { identifiant_facture_cpp: invoiceIdCpp }, {
                 headers: { Authorization: `Bearer ${this.accessToken}`, 'Content-Type': 'application/json' },
             });
             return response.data;
@@ -681,46 +681,46 @@ export class FactPulseClient {
     }
     // ==================== Validation ====================
     /**
-     * Valide un PDF Factur-X.
-     * @param pdfBuffer - Contenu du PDF en Buffer
-     * @param options - Options de validation
-     * @param options.profil - Profil Factur-X (MINIMUM, BASIC, EN16931, EXTENDED). Si non spécifié, auto-détecté.
-     * @param options.useVerapdf - Active la validation stricte PDF/A avec VeraPDF (défaut: false)
+     * Validates a Factur-X PDF.
+     * @param pdfBuffer - PDF content as Buffer
+     * @param options - Validation options
+     * @param options.profile - Factur-X profile (MINIMUM, BASIC, EN16931, EXTENDED). If not specified, auto-detected.
+     * @param options.useVerapdf - Enable strict PDF/A validation with VeraPDF (default: false)
      */
-    validerPdfFacturx(pdfBuffer_1) {
+    validateFacturxPdf(pdfBuffer_1) {
         return __awaiter(this, arguments, void 0, function* (pdfBuffer, options = {}) {
             var _a;
             yield this.ensureAuthenticated();
             const form = new FormData();
-            form.append('fichier_pdf', pdfBuffer, { filename: 'facture.pdf', contentType: 'application/pdf' });
-            if (options.profil) {
-                form.append('profil', options.profil);
+            form.append('pdf_file', pdfBuffer, { filename: 'facture.pdf', contentType: 'application/pdf' });
+            if (options.profile) {
+                form.append('profile', options.profile);
             }
             form.append('use_verapdf', String((_a = options.useVerapdf) !== null && _a !== void 0 ? _a : false));
-            const response = yield this.httpClient.post(`${this.config.apiUrl}/api/v1/traitement/valider-pdf-facturx`, form, {
+            const response = yield this.httpClient.post(`${this.config.apiUrl}/api/v1/processing/validate-facturx-pdf`, form, {
                 headers: Object.assign(Object.assign({}, form.getHeaders()), { Authorization: `Bearer ${this.accessToken}` }),
             });
             return response.data;
         });
     }
-    validerXmlFacturx(xmlContent_1) {
-        return __awaiter(this, arguments, void 0, function* (xmlContent, profil = 'EN16931') {
+    validateFacturxXml(xmlContent_1) {
+        return __awaiter(this, arguments, void 0, function* (xmlContent, profile = 'EN16931') {
             yield this.ensureAuthenticated();
             const form = new FormData();
-            form.append('fichier_xml', Buffer.from(xmlContent, 'utf-8'), { filename: 'facture.xml', contentType: 'application/xml' });
-            form.append('profil', profil);
-            const response = yield this.httpClient.post(`${this.config.apiUrl}/api/v1/traitement/valider-xml`, form, {
+            form.append('xml_file', Buffer.from(xmlContent, 'utf-8'), { filename: 'facture.xml', contentType: 'application/xml' });
+            form.append('profile', profile);
+            const response = yield this.httpClient.post(`${this.config.apiUrl}/api/v1/processing/validate-xml`, form, {
                 headers: Object.assign(Object.assign({}, form.getHeaders()), { Authorization: `Bearer ${this.accessToken}` }),
             });
             return response.data;
         });
     }
-    validerSignaturePdf(pdfBuffer) {
+    validatePdfSignature(pdfBuffer) {
         return __awaiter(this, void 0, void 0, function* () {
             yield this.ensureAuthenticated();
             const form = new FormData();
-            form.append('fichier_pdf', pdfBuffer, { filename: 'document.pdf', contentType: 'application/pdf' });
-            const response = yield this.httpClient.post(`${this.config.apiUrl}/api/v1/traitement/valider-signature-pdf`, form, {
+            form.append('pdf_file', pdfBuffer, { filename: 'document.pdf', contentType: 'application/pdf' });
+            const response = yield this.httpClient.post(`${this.config.apiUrl}/api/v1/processing/validate-pdf-signature`, form, {
                 headers: Object.assign(Object.assign({}, form.getHeaders()), { Authorization: `Bearer ${this.accessToken}` }),
             });
             return response.data;
@@ -728,48 +728,48 @@ export class FactPulseClient {
     }
     // ==================== Signature ====================
     /**
-     * Signe un PDF avec le certificat configuré côté serveur (via client_uid du JWT).
-     * Le certificat doit être préalablement configuré dans Django Admin.
+     * Signs a PDF with the server-configured certificate (via JWT client_uid).
+     * The certificate must be previously configured in Django Admin.
      */
-    signerPdf(pdfBuffer_1) {
+    signPdf(pdfBuffer_1) {
         return __awaiter(this, arguments, void 0, function* (pdfBuffer, options = {}) {
             yield this.ensureAuthenticated();
             const form = new FormData();
-            form.append('fichier_pdf', pdfBuffer, { filename: 'document.pdf', contentType: 'application/pdf' });
-            if (options.raison)
-                form.append('raison', options.raison);
-            if (options.localisation)
-                form.append('localisation', options.localisation);
+            form.append('pdf_file', pdfBuffer, { filename: 'document.pdf', contentType: 'application/pdf' });
+            if (options.reason)
+                form.append('reason', options.reason);
+            if (options.location)
+                form.append('location', options.location);
             if (options.contact)
                 form.append('contact', options.contact);
             if (options.usePadesLt !== undefined)
                 form.append('use_pades_lt', String(options.usePadesLt));
             if (options.useTimestamp !== undefined)
                 form.append('use_timestamp', String(options.useTimestamp));
-            const response = yield this.httpClient.post(`${this.config.apiUrl}/api/v1/traitement/signer-pdf`, form, {
+            const response = yield this.httpClient.post(`${this.config.apiUrl}/api/v1/processing/sign-pdf`, form, {
                 headers: Object.assign(Object.assign({}, form.getHeaders()), { Authorization: `Bearer ${this.accessToken}` }),
             });
-            // L'API retourne du JSON avec pdf_signe_base64
+            // The API returns JSON with pdf_signe_base64
             const data = response.data;
             if (data.pdf_signe_base64) {
                 return Buffer.from(data.pdf_signe_base64, 'base64');
             }
-            throw new Error('Réponse de signature invalide');
+            throw new Error('Invalid signature response');
         });
     }
     /**
-     * Génère un certificat de test (NON PRODUCTION).
-     * Le certificat doit ensuite être configuré dans Django Admin.
+     * Generates a test certificate (NOT FOR PRODUCTION).
+     * The certificate must then be configured in Django Admin.
      */
-    genererCertificatTest() {
+    generateTestCertificate() {
         return __awaiter(this, arguments, void 0, function* (options = {}) {
             yield this.ensureAuthenticated();
-            const response = yield this.httpClient.post(`${this.config.apiUrl}/api/v1/traitement/generer-certificat-test`, {
+            const response = yield this.httpClient.post(`${this.config.apiUrl}/api/v1/processing/generate-test-certificate`, {
                 cn: options.cn || 'Test Organisation',
                 organisation: options.organisation || 'Test Organisation',
                 email: options.email || 'test@example.com',
-                duree_jours: options.dureeJours || 365,
-                taille_cle: options.tailleClé || 2048,
+                validity_days: options.validityDays || 365,
+                key_size: options.keySize || 2048,
             }, {
                 headers: { Authorization: `Bearer ${this.accessToken}`, 'Content-Type': 'application/json' },
             });
@@ -778,37 +778,37 @@ export class FactPulseClient {
     }
     // ==================== Workflow complet ====================
     /**
-     * Workflow complet : génération + validation + signature + soumission AFNOR.
-     * Note: La signature utilise le certificat configuré côté serveur (via client_uid du JWT).
-     * @param factureData Données de la facture
-     * @param pdfPath Chemin vers le PDF source
-     * @param options Options du workflow
-     * @returns Résultat avec pdfBuffer, validation, signature et afnor
+     * Complete workflow: generation + validation + signature + AFNOR submission.
+     * Note: Signature uses the server-configured certificate (via JWT client_uid).
+     * @param invoiceData Invoice data
+     * @param pdfPath Path to the source PDF
+     * @param options Workflow options
+     * @returns Result with pdfBuffer, validation, signature and afnor
      */
-    genererFacturxComplet(factureData_1, pdfPath_1) {
-        return __awaiter(this, arguments, void 0, function* (factureData, pdfPath, options = {}) {
-            const { profil = 'EN16931', valider = true, signer = false, soumettreAfnor = false, afnorFlowName, afnorTrackingId, timeout, } = options;
+    generateCompleteFacturx(invoiceData_1, pdfPath_1) {
+        return __awaiter(this, arguments, void 0, function* (invoiceData, pdfPath, options = {}) {
+            const { profile = 'EN16931', validate = true, sign = false, submitAfnor = false, afnorFlowName, afnorTrackingId, timeout, } = options;
             const result = { pdfBuffer: Buffer.alloc(0) };
-            // 1. Génération
-            const pdfBuffer = yield this.genererFacturx(factureData, pdfPath, profil, 'pdf', true, timeout);
+            // 1. Generation
+            const pdfBuffer = yield this.generateFacturx(invoiceData, pdfPath, profile, 'pdf', true, timeout);
             result.pdfBuffer = pdfBuffer;
             // 2. Validation
-            if (valider) {
-                const validation = yield this.validerPdfFacturx(pdfBuffer, { profil });
+            if (validate) {
+                const validation = yield this.validateFacturxPdf(pdfBuffer, { profile });
                 result.validation = validation;
             }
-            // 3. Signature (utilise le certificat configuré côté serveur)
-            if (signer) {
-                const signedPdf = yield this.signerPdf(result.pdfBuffer);
+            // 3. Signature (uses the server-configured certificate)
+            if (sign) {
+                const signedPdf = yield this.signPdf(result.pdfBuffer);
                 result.pdfBuffer = signedPdf;
-                result.signature = { signe: true };
+                result.signature = { signed: true };
             }
-            // 4. Soumission AFNOR
-            if (soumettreAfnor) {
-                const numeroFacture = (factureData.numeroFacture || factureData.numero_facture || 'FACTURE');
-                const flowName = afnorFlowName || `Facture ${numeroFacture}`;
-                const trackingId = afnorTrackingId || numeroFacture;
-                const afnorResult = yield this.soumettreFactureAfnor(result.pdfBuffer, flowName, { trackingId });
+            // 4. AFNOR submission
+            if (submitAfnor) {
+                const invoiceNumber = (invoiceData.invoiceNumber || invoiceData.invoice_number || 'INVOICE');
+                const flowName = afnorFlowName || `Invoice ${invoiceNumber}`;
+                const trackingId = afnorTrackingId || invoiceNumber;
+                const afnorResult = yield this.submitInvoiceAfnor(result.pdfBuffer, flowName, { trackingId });
                 result.afnor = afnorResult;
             }
             return result;