@factpulse/sdk 2.0.12 → 3.0.1

package/dist/src/helpers/client.js

@@ -0,0 +1,866 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+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());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FactPulseClient = void 0;
+exports.amount = amount;
+exports.invoiceTotals = invoiceTotals;
+exports.invoiceLine = invoiceLine;
+exports.vatLine = vatLine;
+exports.postalAddress = postalAddress;
+exports.electronicAddress = electronicAddress;
+exports.supplier = supplier;
+exports.recipient = recipient;
+exports.beneficiary = beneficiary;
+const axios_1 = __importDefault(require("axios"));
+const form_data_1 = __importDefault(require("form-data"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const exceptions_1 = require("./exceptions");
+/** Converts a value to an amount string for the API. */
+function amount(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';
+}
+/** Creates a simplified InvoiceTotals object. */
+function invoiceTotals(exclTax, vat, inclTax, amountDue, options) {
+    const result = {
+        totalNetAmount: amount(exclTax), vatAmount: amount(vat),
+        totalGrossAmount: amount(inclTax), amountDue: amount(amountDue),
+    };
+    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;
+}
+/** 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) */
+function invoiceLine(lineNumber, itemName, quantity, unitNetPrice, lineNetAmount, options) {
+    var _a, _b, _c;
+    const result = {
+        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',
+    };
+    // Either vatRate (code) or manualVatRate (value)
+    if (options === null || options === void 0 ? void 0 : options.vatRate)
+        result.vatRate = options.vatRate;
+    else
+        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.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;
+}
+/** 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) */
+function vatLine(taxableAmount, vatAmount, options) {
+    var _a, _b;
+    const result = {
+        taxableAmount: amount(taxableAmount), vatAmount: amount(vatAmount), category: (_a = options === null || options === void 0 ? void 0 : options.category) !== null && _a !== void 0 ? _a : 'S',
+    };
+    // Either rate (code) or manualRate (value)
+    if (options === null || options === void 0 ? void 0 : options.rate)
+        result.rate = options.rate;
+    else
+        result.manualRate = amount((_b = options === null || options === void 0 ? void 0 : options.manualRate) !== null && _b !== void 0 ? _b : '20.00');
+    return result;
+}
+/** Creates a postal address for the FactPulse API. */
+function postalAddress(lineOne, postalCode, city, options) {
+    var _a;
+    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;
+}
+/** Creates an electronic address for the FactPulse API. schemeId: "0009"=SIREN, "0225"=SIRET */
+function electronicAddress(identifier, schemeId = '0009') {
+    return { identifier, schemeId };
+}
+/** 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}`;
+}
+/** Creates a supplier (issuer) with auto-computed SIREN, intra-EU VAT number and addresses. */
+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 vatNumber = (_b = opts.vatNumber) !== null && _b !== void 0 ? _b : (siren ? computeVatIntra(siren) : null);
+    const result = {
+        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 (vatNumber)
+        result.vatNumber = vatNumber;
+    if (opts.iban)
+        result.iban = opts.iban;
+    if (opts.supplierServiceId)
+        result.supplierServiceId = opts.supplierServiceId;
+    if (opts.supplierBankDetailsCode)
+        result.supplierBankDetailsCode = opts.supplierBankDetailsCode;
+    return result;
+}
+/** Creates a recipient (customer) with auto-computed SIREN and addresses. */
+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 = {
+        name, siret,
+        electronicAddress: electronicAddress(siret, '0225'),
+        postalAddress: postalAddress(addressLine1, postalCode, city, { countryCode: opts.countryCode, lineTwo: opts.addressLine2 }),
+    };
+    if (siren)
+        result.siren = siren;
+    if (opts.executingServiceCode)
+        result.executingServiceCode = opts.executingServiceCode;
+    return result;
+}
+/**
+ * Creates a beneficiary (factor) for factoring.
+ *
+ * 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).
+ *
+ * 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 name Factor's business name (BT-59)
+ * @param options Options: siret (BT-60), siren (BT-61), iban, bic
+ * @returns Dict ready to be used in a factored invoice
+ *
+ * @example
+ * const factor = beneficiary('FACTOR SAS', {
+ *   siret: '30000000700033',
+ *   iban: 'FR76 3000 4000 0500 0012 3456 789',
+ * });
+ */
+function beneficiary(name, options) {
+    var _a;
+    const opts = options !== null && options !== void 0 ? options : {};
+    // 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 = { name };
+    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;
+}
+// =============================================================================
+// Main client
+// =============================================================================
+const DEFAULT_API_URL = 'https://factpulse.fr';
+const DEFAULT_POLLING_INTERVAL = 2000;
+const DEFAULT_POLLING_TIMEOUT = 120000;
+const DEFAULT_MAX_RETRIES = 1;
+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_1.default.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,
+        };
+    }
+    // Shorter aliases
+    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 exceptions_1.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}`);
+            }
+        });
+    }
+    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 exceptions_1.FactPulsePollingTimeout(taskId, timeoutMs);
+                yield this.ensureAuthenticated();
+                try {
+                    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;
+                    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 exceptions_1.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);
+                }
+                catch (error) {
+                    if (error instanceof exceptions_1.FactPulseValidationError || error instanceof exceptions_1.FactPulsePollingTimeout)
+                        throw error;
+                    const axiosError = error;
+                    if (((_a = axiosError.response) === null || _a === void 0 ? void 0 : _a.status) === 401) {
+                        this.resetAuth();
+                        continue;
+                    }
+                    throw new exceptions_1.FactPulseValidationError(`API Error: ${axiosError.message}`);
+                }
+            }
+        });
+    }
+    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 invoiceData === 'string' ? invoiceData : JSON.stringify(invoiceData);
+            let taskId = null;
+            for (let attempt = 0; attempt <= this.config.maxRetries; attempt++) {
+                yield this.ensureAuthenticated();
+                const form = new form_data_1.default();
+                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/processing/generate-invoice`, form, {
+                        headers: Object.assign(Object.assign({}, form.getHeaders()), { Authorization: `Bearer ${this.accessToken}` }), timeout: 60000,
+                    });
+                    taskId = response.data.task_id;
+                    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;
+                    }
+                    // Extract error details from response body
+                    const responseData = (_b = axiosError.response) === null || _b === void 0 ? void 0 : _b.data;
+                    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 = 'Validation error';
+                            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(`API Error ${(_d = axiosError.response) === null || _d === void 0 ? void 0 : _d.status}:`, responseData);
+                    throw new exceptions_1.FactPulseValidationError(errorMsg, errors);
+                }
+            }
+            if (!taskId)
+                throw new exceptions_1.FactPulseValidationError("No task ID");
+            if (!sync)
+                return taskId;
+            const result = yield this.pollTask(taskId, timeout);
+            if (result.content_b64)
+                return Buffer.from(result.content_b64, 'base64');
+            throw new exceptions_1.FactPulseValidationError('No content');
+        });
+    }
+    static formatAmount(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 and internal helpers
+    // =========================================================================
+    /**
+     * 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;
+            // Zero-trust mode: credentials provided to the constructor
+            if (this.afnorCredentials) {
+                return this.afnorCredentials;
+            }
+            // Stored mode: retrieve credentials via the 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 exceptions_1.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 exceptions_1.FactPulseAuthError(`Failed to retrieve AFNOR credentials: ${axiosError.message}`);
+            }
+        });
+    }
+    /**
+     * 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* () {
+            // Step 1: Get AFNOR credentials
+            const credentials = yield this.getAfnorCredentialsInternal();
+            // Step 2: Perform AFNOR OAuth via the FactPulse proxy
+            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 exceptions_1.FactPulseAuthError('Invalid AFNOR OAuth2 response: access_token missing');
+                }
+                return {
+                    token: tokenData.access_token,
+                    pdpBaseUrl: credentials.flowServiceUrl,
+                };
+            }
+            catch (error) {
+                const axiosError = error;
+                throw new exceptions_1.FactPulseAuthError(`AFNOR OAuth2 failed: ${axiosError.message}`);
+            }
+        });
+    }
+    /**
+     * 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* () {
+            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}`;
+            // ALWAYS use the AFNOR token + X-PDP-Base-URL header
+            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 exceptions_1.FactPulseValidationError(`AFNOR Error: ${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 ====================
+    /**
+     * 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 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
+     */
+    submitInvoiceAfnor(pdfBuffer_1, flowName_1) {
+        return __awaiter(this, arguments, void 0, function* (pdfBuffer, flowName, options = {}) {
+            const { trackingId, flowSyntax = 'CII', flowProfile = 'EN16931' } = options;
+            // Compute SHA-256
+            const crypto = require('crypto');
+            const sha256 = crypto.createHash('sha256').update(pdfBuffer).digest('hex');
+            // Prepare flowInfo
+            const flowInfo = { name: flowName, flowSyntax, flowProfile, sha256 };
+            if (trackingId)
+                flowInfo.trackingId = trackingId;
+            const form = new form_data_1.default();
+            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 });
+        });
+    }
+    searchFlowsAfnor() {
+        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 });
+        });
+    }
+    downloadFlowAfnor(flowId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // 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, {
+                headers: {
+                    'Authorization': `Bearer ${afnorToken}`,
+                    'X-PDP-Base-URL': pdpBaseUrl,
+                },
+                responseType: 'arraybuffer',
+            });
+            return Buffer.from(response.data);
+        });
+    }
+    /**
+     * 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: This endpoint uses FactPulse JWT authentication (not AFNOR OAuth).
+     * The FactPulse server handles calling the PDP with stored credentials.
+     *
+     * @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 invoice = await client.getIncomingInvoiceAfnor("550e8400-...");
+     * console.log(`Supplier: ${invoice.supplier.name}`);
+     * console.log(`Total incl. tax: ${invoice.total_incl_tax} ${invoice.currency}`);
+     */
+    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/incoming-flows/${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 exceptions_1.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}`);
+            }
+        });
+    }
+    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;
+        });
+    }
+    /**
+     * 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* () {
+            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;
+        });
+    }
+    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`, invoiceData, {
+                headers: { Authorization: `Bearer ${this.accessToken}`, 'Content-Type': 'application/json' },
+            });
+            return response.data;
+        });
+    }
+    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: invoiceIdCpp }, {
+                headers: { Authorization: `Bearer ${this.accessToken}`, 'Content-Type': 'application/json' },
+            });
+            return response.data;
+        });
+    }
+    // ==================== Validation ====================
+    /**
+     * 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)
+     */
+    validateFacturxPdf(pdfBuffer_1) {
+        return __awaiter(this, arguments, void 0, function* (pdfBuffer, options = {}) {
+            var _a;
+            yield this.ensureAuthenticated();
+            const form = new form_data_1.default();
+            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/processing/validate-facturx-pdf`, form, {
+                headers: Object.assign(Object.assign({}, form.getHeaders()), { Authorization: `Bearer ${this.accessToken}` }),
+            });
+            return response.data;
+        });
+    }
+    validateFacturxXml(xmlContent_1) {
+        return __awaiter(this, arguments, void 0, function* (xmlContent, profile = 'EN16931') {
+            yield this.ensureAuthenticated();
+            const form = new form_data_1.default();
+            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;
+        });
+    }
+    validatePdfSignature(pdfBuffer) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.ensureAuthenticated();
+            const form = new form_data_1.default();
+            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;
+        });
+    }
+    // ==================== Signature ====================
+    /**
+     * Signs a PDF with the server-configured certificate (via JWT client_uid).
+     * The certificate must be previously configured in Django Admin.
+     */
+    signPdf(pdfBuffer_1) {
+        return __awaiter(this, arguments, void 0, function* (pdfBuffer, options = {}) {
+            yield this.ensureAuthenticated();
+            const form = new form_data_1.default();
+            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/processing/sign-pdf`, form, {
+                headers: Object.assign(Object.assign({}, form.getHeaders()), { Authorization: `Bearer ${this.accessToken}` }),
+            });
+            // 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('Invalid signature response');
+        });
+    }
+    /**
+     * Generates a test certificate (NOT FOR PRODUCTION).
+     * The certificate must then be configured in Django Admin.
+     */
+    generateTestCertificate() {
+        return __awaiter(this, arguments, void 0, function* (options = {}) {
+            yield this.ensureAuthenticated();
+            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',
+                validity_days: options.validityDays || 365,
+                key_size: options.keySize || 2048,
+            }, {
+                headers: { Authorization: `Bearer ${this.accessToken}`, 'Content-Type': 'application/json' },
+            });
+            return response.data;
+        });
+    }
+    // ==================== Workflow complet ====================
+    /**
+     * 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
+     */
+    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. Generation
+            const pdfBuffer = yield this.generateFacturx(invoiceData, pdfPath, profile, 'pdf', true, timeout);
+            result.pdfBuffer = pdfBuffer;
+            // 2. Validation
+            if (validate) {
+                const validation = yield this.validateFacturxPdf(pdfBuffer, { profile });
+                result.validation = validation;
+            }
+            // 3. Signature (uses the server-configured certificate)
+            if (sign) {
+                const signedPdf = yield this.signPdf(result.pdfBuffer);
+                result.pdfBuffer = signedPdf;
+                result.signature = { signed: true };
+            }
+            // 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;
+        });
+    }
+}
+exports.FactPulseClient = FactPulseClient;