@factpulse/sdk 2.0.11 → 2.0.49

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

@@ -0,0 +1,817 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import axios from 'axios';
+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) {
+    if (value === null || value === undefined)
+        return '0.00';
+    if (typeof value === 'number')
+        return value.toFixed(2);
+    if (typeof value === 'string')
+        return value;
+    return '0.00';
+}
+/** Crée un objet MontantTotal simplifié. */
+export function montantTotal(ht, tva, ttc, aPayer, options) {
+    const result = {
+        montantHtTotal: montant(ht), montantTva: montant(tva),
+        montantTtcTotal: montant(ttc), montantAPayer: montant(aPayer),
+    };
+    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);
+    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) {
+    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',
+    };
+    // Soit tauxTva (code) soit tauxTvaManuel (valeur)
+    if (options === null || options === void 0 ? void 0 : options.tauxTva)
+        result.tauxTva = options.tauxTva;
+    else
+        result.tauxTvaManuel = montant((_c = options === null || options === void 0 ? void 0 : options.tauxTvaManuel) !== 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;
+    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) {
+    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',
+    };
+    // Soit taux (code) soit tauxManuel (valeur)
+    if (options === null || options === void 0 ? void 0 : options.taux)
+        result.taux = options.taux;
+    else
+        result.tauxManuel = montant((_b = options === null || options === void 0 ? void 0 : options.tauxManuel) !== 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) {
+    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;
+    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 };
+}
+/** Calcule le numéro TVA intracommunautaire français depuis un SIREN. */
+function calculerTvaIntra(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) {
+    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 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 }),
+    };
+    if (siren)
+        result.siren = siren;
+    if (numeroTvaIntra)
+        result.numeroTvaIntra = numeroTvaIntra;
+    if (opts.iban)
+        result.iban = opts.iban;
+    if (opts.codeService)
+        result.idServiceFournisseur = opts.codeService;
+    if (opts.codeCoordonnesBancaires)
+        result.codeCoordonnesBancairesFournisseur = opts.codeCoordonnesBancaires;
+    return result;
+}
+/** Crée un destinataire (client) avec auto-calcul SIREN et adresses. */
+export function destinataire(nom, siret, adresseLigne1, codePostal, ville, 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 }),
+    };
+    if (siren)
+        result.siren = siren;
+    if (opts.codeServiceExecutant)
+        result.codeServiceExecutant = opts.codeServiceExecutant;
+    return result;
+}
+/**
+ * Crée un bénéficiaire (factor) pour l'affacturage.
+ *
+ * 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).
+ *
+ * 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
+ *
+ * @param nom Raison sociale du factor (BT-59)
+ * @param options Options: siret (BT-60), siren (BT-61), iban, bic
+ * @returns Dict prêt à être utilisé dans une facture affacturée
+ *
+ * @example
+ * const factor = beneficiaire('FACTOR SAS', {
+ *   siret: '30000000700033',
+ *   iban: 'FR76 3000 4000 0500 0012 3456 789',
+ * });
+ */
+export function beneficiaire(nom, options) {
+    var _a;
+    const opts = options !== null && options !== void 0 ? options : {};
+    // Auto-calcul SIREN depuis 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 };
+    if (opts.siret)
+        result.siret = opts.siret;
+    if (siren)
+        result.siren = siren;
+    if (opts.iban)
+        result.iban = opts.iban;
+    if (opts.bic)
+        result.bic = opts.bic;
+    return result;
+}
+// =============================================================================
+// Client principal
+// =============================================================================
+const DEFAULT_API_URL = 'https://factpulse.fr';
+const DEFAULT_POLLING_INTERVAL = 2000;
+const DEFAULT_POLLING_TIMEOUT = 120000;
+const DEFAULT_MAX_RETRIES = 1;
+export class FactPulseClient {
+    constructor(config) {
+        var _a;
+        this.accessToken = null;
+        this.refreshToken = null;
+        this.tokenExpiresAt = null;
+        this.config = {
+            email: config.email, password: config.password,
+            apiUrl: (config.apiUrl || DEFAULT_API_URL).replace(/\/$/, ''),
+            clientUid: config.clientUid || '',
+            chorusCredentials: config.chorusCredentials,
+            afnorCredentials: config.afnorCredentials,
+            pollingInterval: config.pollingInterval || DEFAULT_POLLING_INTERVAL,
+            pollingTimeout: config.pollingTimeout || DEFAULT_POLLING_TIMEOUT,
+            maxRetries: (_a = config.maxRetries) !== null && _a !== void 0 ? _a : DEFAULT_MAX_RETRIES,
+        };
+        this.chorusCredentials = config.chorusCredentials;
+        this.afnorCredentials = config.afnorCredentials;
+        this.httpClient = axios.create({ timeout: 30000, headers: { 'Content-Type': 'application/json' } });
+    }
+    getChorusCredentialsForApi() {
+        var _a;
+        if (!this.chorusCredentials)
+            return undefined;
+        return {
+            piste_client_id: this.chorusCredentials.pisteClientId,
+            piste_client_secret: this.chorusCredentials.pisteClientSecret,
+            chorus_pro_login: this.chorusCredentials.chorusProLogin,
+            chorus_pro_password: this.chorusCredentials.chorusProPassword,
+            sandbox: (_a = this.chorusCredentials.sandbox) !== null && _a !== void 0 ? _a : true,
+        };
+    }
+    getAfnorCredentialsForApi() {
+        if (!this.afnorCredentials)
+            return undefined;
+        return {
+            client_id: this.afnorCredentials.clientId,
+            client_secret: this.afnorCredentials.clientSecret,
+            flow_service_url: this.afnorCredentials.flowServiceUrl,
+        };
+    }
+    // Alias plus courts
+    getChorusProCredentials() { return this.getChorusCredentialsForApi(); }
+    getAfnorCredentials() { return this.getAfnorCredentialsForApi(); }
+    obtainToken() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            const payload = { username: this.config.email, password: this.config.password };
+            if (this.config.clientUid)
+                payload.client_uid = this.config.clientUid;
+            try {
+                const response = yield this.httpClient.post(`${this.config.apiUrl}/api/token/`, payload);
+                return response.data;
+            }
+            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}`);
+            }
+        });
+    }
+    ensureAuthenticated() {
+        return __awaiter(this, arguments, void 0, function* (forceRefresh = false) {
+            const now = Date.now();
+            if (forceRefresh || !this.accessToken || (this.tokenExpiresAt && now >= this.tokenExpiresAt)) {
+                const tokens = yield this.obtainToken();
+                this.accessToken = tokens.access;
+                this.refreshToken = tokens.refresh;
+                this.tokenExpiresAt = now + 28 * 60 * 1000;
+            }
+        });
+    }
+    resetAuth() { this.accessToken = this.refreshToken = null; this.tokenExpiresAt = null; }
+    pollTask(taskId, timeout, interval) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const timeoutMs = timeout !== null && timeout !== void 0 ? timeout : this.config.pollingTimeout;
+            const intervalMs = interval !== null && interval !== void 0 ? interval : this.config.pollingInterval;
+            const startTime = Date.now();
+            let currentInterval = intervalMs;
+            while (true) {
+                if (Date.now() - startTime > timeoutMs)
+                    throw new FactPulsePollingTimeout(taskId, timeoutMs);
+                yield this.ensureAuthenticated();
+                try {
+                    const response = yield this.httpClient.get(`${this.config.apiUrl}/api/v1/traitement/taches/${taskId}/statut`, {
+                        headers: { Authorization: `Bearer ${this.accessToken}` },
+                    });
+                    const { statut, resultat } = response.data;
+                    if (statut === 'SUCCESS')
+                        return resultat || {};
+                    if (statut === 'FAILURE') {
+                        // 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);
+                    }
+                    yield new Promise(resolve => setTimeout(resolve, currentInterval));
+                    currentInterval = Math.min(currentInterval * 1.5, 10000);
+                }
+                catch (error) {
+                    if (error instanceof FactPulseValidationError || error instanceof FactPulsePollingTimeout)
+                        throw error;
+                    const axiosError = error;
+                    if (((_a = axiosError.response) === null || _a === void 0 ? void 0 : _a.status) === 401) {
+                        this.resetAuth();
+                        continue;
+                    }
+                    throw new FactPulseValidationError(`Erreur API: ${axiosError.message}`);
+                }
+            }
+        });
+    }
+    genererFacturx(factureData_1, pdfPath_1) {
+        return __awaiter(this, arguments, void 0, function* (factureData, pdfPath, profil = 'EN16931', formatSortie = 'pdf', sync = true, timeout) {
+            var _a, _b, _c, _d;
+            const jsonData = typeof factureData === 'string' ? factureData : JSON.stringify(factureData);
+            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('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, {
+                        headers: Object.assign(Object.assign({}, form.getHeaders()), { Authorization: `Bearer ${this.accessToken}` }), timeout: 60000,
+                    });
+                    taskId = response.data.id_tache;
+                    break;
+                }
+                catch (error) {
+                    const axiosError = error;
+                    if (((_a = axiosError.response) === null || _a === void 0 ? void 0 : _a.status) === 401 && attempt < this.config.maxRetries) {
+                        this.resetAuth();
+                        continue;
+                    }
+                    // Extraire les détails d'erreur du corps de la réponse
+                    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}`;
+                    const errors = [];
+                    if (responseData) {
+                        // Format FastAPI/Pydantic: {"detail": [{"loc": [...], "msg": "...", "type": "..."}]}
+                        if (Array.isArray(responseData.detail)) {
+                            errorMsg = 'Erreur de validation';
+                            for (const err of responseData.detail) {
+                                if (typeof err === 'object' && err !== null) {
+                                    const loc = err.loc || [];
+                                    errors.push({
+                                        level: 'ERROR',
+                                        item: loc.map(String).join(' -> '),
+                                        reason: err.msg || String(err),
+                                        source: 'validation',
+                                        code: err.type,
+                                    });
+                                }
+                            }
+                        }
+                        else if (typeof responseData.detail === 'string') {
+                            errorMsg = responseData.detail;
+                        }
+                        else if (responseData.errorMessage) {
+                            errorMsg = responseData.errorMessage;
+                        }
+                    }
+                    console.error(`Erreur API ${(_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");
+            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');
+        });
+    }
+    static formatMontant(m) {
+        if (m === null || m === undefined)
+            return '0.00';
+        if (typeof m === 'number')
+            return m.toFixed(2);
+        if (typeof m === 'string')
+            return m;
+        return '0.00';
+    }
+    // =========================================================================
+    // AFNOR - Authentication et helpers internes
+    // =========================================================================
+    /**
+     * 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.
+     */
+    getAfnorCredentialsInternal() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            // Mode zero-trust : credentials fournis au constructeur
+            if (this.afnorCredentials) {
+                return this.afnorCredentials;
+            }
+            // Mode stored : recuperer les credentials via l'API
+            yield this.ensureAuthenticated();
+            try {
+                const response = yield this.httpClient.get(`${this.config.apiUrl}/api/v1/afnor/credentials`, {
+                    headers: { Authorization: `Bearer ${this.accessToken}` },
+                });
+                const creds = response.data;
+                return {
+                    flowServiceUrl: creds.flow_service_url,
+                    tokenUrl: creds.token_url,
+                    clientId: creds.client_id,
+                    clientSecret: creds.client_secret,
+                    directoryServiceUrl: creds.directory_service_url,
+                };
+            }
+            catch (error) {
+                const axiosError = error;
+                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(`Echec recuperation credentials AFNOR: ${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
+     */
+    getAfnorTokenAndUrl() {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Etape 1: Obtenir les credentials AFNOR
+            const credentials = yield this.getAfnorCredentialsInternal();
+            // Etape 2: Faire l'OAuth AFNOR via le proxy FactPulse
+            const oauthData = new URLSearchParams({
+                grant_type: 'client_credentials',
+                client_id: credentials.clientId,
+                client_secret: credentials.clientSecret,
+            });
+            try {
+                const response = yield this.httpClient.post(`${this.config.apiUrl}/api/v1/afnor/oauth/token`, oauthData.toString(), {
+                    headers: {
+                        'Content-Type': 'application/x-www-form-urlencoded',
+                        'X-PDP-Token-URL': credentials.tokenUrl,
+                    },
+                });
+                const tokenData = response.data;
+                if (!tokenData.access_token) {
+                    throw new FactPulseAuthError('Reponse OAuth2 AFNOR invalide: access_token manquant');
+                }
+                return {
+                    token: tokenData.access_token,
+                    pdpBaseUrl: credentials.flowServiceUrl,
+                };
+            }
+            catch (error) {
+                const axiosError = error;
+                throw new FactPulseAuthError(`Echec OAuth2 AFNOR: ${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!
+     */
+    makeAfnorRequest(method, endpoint, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d;
+            // 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
+            const headers = {
+                'Authorization': `Bearer ${afnorToken}`,
+                'X-PDP-Base-URL': pdpBaseUrl,
+            };
+            try {
+                let response;
+                if (options === null || options === void 0 ? void 0 : options.files) {
+                    response = yield this.httpClient.request({
+                        method,
+                        url,
+                        data: options.files,
+                        headers: Object.assign(Object.assign({}, options.files.getHeaders()), headers),
+                        params: options === null || options === void 0 ? void 0 : options.params,
+                        timeout: 60000,
+                    });
+                }
+                else {
+                    response = yield this.httpClient.request({
+                        method,
+                        url,
+                        data: options === null || options === void 0 ? void 0 : options.data,
+                        headers: Object.assign(Object.assign({}, headers), { 'Content-Type': 'application/json' }),
+                        params: options === null || options === void 0 ? void 0 : options.params,
+                        timeout: 30000,
+                    });
+                }
+                return response.data;
+            }
+            catch (error) {
+                const axiosError = error;
+                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}`);
+            }
+        });
+    }
+    // ==================== AFNOR Directory ====================
+    rechercherSiretAfnor(siret) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.makeAfnorRequest('GET', `/directory/siret/${siret}`);
+        });
+    }
+    rechercherSirenAfnor(siren) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.makeAfnorRequest('GET', `/directory/siren/${siren}`);
+        });
+    }
+    listerCodesRoutageAfnor(siren) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.makeAfnorRequest('GET', `/directory/siren/${siren}/routing-codes`);
+        });
+    }
+    // ==================== 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).
+     *
+     * @param pdfBuffer Buffer du PDF Factur-X a soumettre
+     * @param flowName Nom du flux (ex: "Facture FAC-2025-001")
+     * @param options Options: trackingId, flowSyntax (CII/UBL), flowProfile
+     */
+    soumettreFactureAfnor(pdfBuffer_1, flowName_1) {
+        return __awaiter(this, arguments, void 0, function* (pdfBuffer, flowName, options = {}) {
+            const { trackingId, flowSyntax = 'CII', flowProfile = 'EN16931' } = options;
+            // Calculer SHA-256
+            const crypto = require('crypto');
+            const sha256 = crypto.createHash('sha256').update(pdfBuffer).digest('hex');
+            // Preparer flowInfo
+            const flowInfo = { name: flowName, flowSyntax, flowProfile, sha256 };
+            if (trackingId)
+                flowInfo.trackingId = trackingId;
+            const form = new FormData();
+            form.append('file', pdfBuffer, { filename: 'facture.pdf', contentType: 'application/pdf' });
+            form.append('flowInfo', JSON.stringify(flowInfo), { contentType: 'application/json' });
+            return this.makeAfnorRequest('POST', '/flow/v1/flows', { files: form });
+        });
+    }
+    rechercherFluxAfnor() {
+        return __awaiter(this, arguments, void 0, function* (criteria = {}) {
+            var _a, _b;
+            const searchBody = {
+                offset: (_a = criteria.offset) !== null && _a !== void 0 ? _a : 0,
+                limit: (_b = criteria.limit) !== null && _b !== void 0 ? _b : 25,
+                where: {},
+            };
+            if (criteria.trackingId)
+                searchBody.where.trackingId = criteria.trackingId;
+            if (criteria.status)
+                searchBody.where.status = criteria.status;
+            return this.makeAfnorRequest('POST', '/flow/v1/flows/search', { data: searchBody });
+        });
+    }
+    telechargerFluxAfnor(flowId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Pour le telechargement, on doit gerer le type de reponse differemment
+            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, {
+                headers: {
+                    'Authorization': `Bearer ${afnorToken}`,
+                    'X-PDP-Base-URL': pdpBaseUrl,
+                },
+                responseType: 'arraybuffer',
+            });
+            return Buffer.from(response.data);
+        });
+    }
+    /**
+     * 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.
+     *
+     * 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.
+     *
+     * @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.)
+     *
+     * @example
+     * const facture = await client.obtenirFactureEntranteAfnor("550e8400-...");
+     * console.log(`Fournisseur: ${facture.fournisseur.nom}`);
+     * console.log(`Montant TTC: ${facture.montant_ttc} ${facture.devise}`);
+     */
+    obtenirFactureEntranteAfnor(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 params = {};
+            if (includeDocument) {
+                params.include_document = 'true';
+            }
+            try {
+                const response = yield this.httpClient.get(url, {
+                    headers: { 'Authorization': `Bearer ${this.accessToken}` },
+                    params: Object.keys(params).length > 0 ? params : undefined,
+                    timeout: 60000,
+                });
+                return response.data;
+            }
+            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}`);
+            }
+        });
+    }
+    healthcheckAfnor() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.makeAfnorRequest('GET', '/flow/v1/healthcheck');
+        });
+    }
+    // ==================== Chorus Pro ====================
+    rechercherStructureChorus(criteria) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.ensureAuthenticated();
+            const response = yield this.httpClient.post(`${this.config.apiUrl}/api/v1/chorus-pro/structures/rechercher`, criteria, {
+                headers: { Authorization: `Bearer ${this.accessToken}`, 'Content-Type': 'application/json' },
+            });
+            return response.data;
+        });
+    }
+    consulterStructureChorus(idStructureCpp) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.ensureAuthenticated();
+            const response = yield this.httpClient.post(`${this.config.apiUrl}/api/v1/chorus-pro/structures/consulter`, { id_structure_cpp: idStructureCpp }, {
+                headers: { Authorization: `Bearer ${this.accessToken}`, 'Content-Type': 'application/json' },
+            });
+            return response.data;
+        });
+    }
+    /**
+     * Liste les services d'une structure Chorus Pro.
+     * @param idStructureCpp ID Chorus Pro de la structure
+     * @returns Objet avec listeServices, total, codeRetour, libelle
+     */
+    listerServicesStructureChorus(idStructureCpp) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.ensureAuthenticated();
+            const response = yield this.httpClient.get(`${this.config.apiUrl}/api/v1/chorus-pro/structures/${idStructureCpp}/services`, {
+                headers: { Authorization: `Bearer ${this.accessToken}` },
+            });
+            return response.data;
+        });
+    }
+    obtenirIdChorusDepuisSiret(siret) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const results = yield this.rechercherStructureChorus({ identifiant_structure: siret, type_identifiant: 'SIRET' });
+            if (results.length > 0 && results[0].id_structure_cpp)
+                return results[0].id_structure_cpp;
+            return null;
+        });
+    }
+    soumettreFactureChorus(factureData) {
+        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, {
+                headers: { Authorization: `Bearer ${this.accessToken}`, 'Content-Type': 'application/json' },
+            });
+            return response.data;
+        });
+    }
+    consulterFactureChorus(identifiantFactureCpp) {
+        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 }, {
+                headers: { Authorization: `Bearer ${this.accessToken}`, 'Content-Type': 'application/json' },
+            });
+            return response.data;
+        });
+    }
+    // ==================== 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)
+     */
+    validerPdfFacturx(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('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, {
+                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') {
+            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, {
+                headers: Object.assign(Object.assign({}, form.getHeaders()), { Authorization: `Bearer ${this.accessToken}` }),
+            });
+            return response.data;
+        });
+    }
+    validerSignaturePdf(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, {
+                headers: Object.assign(Object.assign({}, form.getHeaders()), { Authorization: `Bearer ${this.accessToken}` }),
+            });
+            return response.data;
+        });
+    }
+    // ==================== 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.
+     */
+    signerPdf(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);
+            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, {
+                headers: Object.assign(Object.assign({}, form.getHeaders()), { Authorization: `Bearer ${this.accessToken}` }),
+            });
+            // L'API retourne du JSON avec 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');
+        });
+    }
+    /**
+     * Génère un certificat de test (NON PRODUCTION).
+     * Le certificat doit ensuite être configuré dans Django Admin.
+     */
+    genererCertificatTest() {
+        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`, {
+                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,
+            }, {
+                headers: { Authorization: `Bearer ${this.accessToken}`, 'Content-Type': 'application/json' },
+            });
+            return response.data;
+        });
+    }
+    // ==================== 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
+     */
+    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;
+            const result = { pdfBuffer: Buffer.alloc(0) };
+            // 1. Génération
+            const pdfBuffer = yield this.genererFacturx(factureData, pdfPath, profil, 'pdf', true, timeout);
+            result.pdfBuffer = pdfBuffer;
+            // 2. Validation
+            if (valider) {
+                const validation = yield this.validerPdfFacturx(pdfBuffer, { profil });
+                result.validation = validation;
+            }
+            // 3. Signature (utilise le certificat configuré côté serveur)
+            if (signer) {
+                const signedPdf = yield this.signerPdf(result.pdfBuffer);
+                result.pdfBuffer = signedPdf;
+                result.signature = { signe: 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 });
+                result.afnor = afnorResult;
+            }
+            return result;
+        });
+    }
+}