@factpulse/sdk 3.0.37 → 4.0.1

package/.openapi-generator/FILES

@@ -8,6 +8,7 @@ api/afnorpdppadirectory-service-api.ts
 api/afnorpdppaflow-service-api.ts
 api/cdarcycle-de-vie-api.ts
 api/chorus-pro-api.ts
+api/client-management-api.ts
 api/document-conversion-api.ts
 api/downloads-api.ts
 api/ereporting-api.ts
@@ -130,11 +131,10 @@ docs/AllowanceReasonCode.md
 docs/AllowanceTotalAmount.md
 docs/Amount.md
 docs/Amount1.md
+docs/Amount2.md
 docs/AmountDue.md
 docs/AsyncTaskStatus.md
 docs/BaseAmount.md
-docs/BodySubmitCdarApiV1CdarSubmitPost.md
-docs/BodySubmitCdarXmlApiV1CdarSubmitXmlPost.md
 docs/BoundingBoxSchema.md
 docs/Buyercountry.md
 docs/CDARCycleDeVieApi.md
@@ -145,6 +145,13 @@ docs/ChorusProApi.md
 docs/ChorusProCredentials.md
 docs/ChorusProDestination.md
 docs/ChorusProResult.md
+docs/ClientActivateResponse.md
+docs/ClientCreateRequest.md
+docs/ClientDetail.md
+docs/ClientListResponse.md
+docs/ClientManagementApi.md
+docs/ClientSummary.md
+docs/ClientUpdateRequest.md
 docs/Contact.md
 docs/ConvertResumeRequest.md
 docs/ConvertSuccessResponse.md
@@ -167,15 +174,16 @@ docs/EReportingValidationError.md
 docs/ElectronicAddress.md
 docs/Encaisseamount.md
 docs/Encaisseamount1.md
+docs/EncaisseeRequest.md
 docs/EnrichedInvoiceInfo.md
 docs/ErrorLevel.md
 docs/ErrorSource.md
 docs/ExtractionInfo.md
 docs/FacturXInvoice.md
 docs/FacturXPDFInfo.md
-docs/FactureElectroniqueRestApiSchemasChorusProChorusProCredentials.md
+docs/FactureElectroniqueRestApiSchemasCdarValidationErrorResponse.md
 docs/FactureElectroniqueRestApiSchemasEreportingInvoiceTypeCode.md
-docs/FactureElectroniqueRestApiSchemasValidationValidationErrorResponse.md
+docs/FactureElectroniqueRestApiSchemasProcessingChorusProCredentials.md
 docs/FieldStatus.md
 docs/FileInfo.md
 docs/FilesInfo.md
@@ -228,6 +236,8 @@ docs/OperationNature.md
 docs/OutputFormat.md
 docs/PDFValidationResultAPI.md
 docs/PDFXMLVerificationApi.md
+docs/PDPConfigResponse.md
+docs/PDPConfigUpdateRequest.md
 docs/PDPCredentials.md
 docs/PageDimensionsSchema.md
 docs/Payee.md
@@ -249,6 +259,7 @@ docs/ReasonCodeInfo.md
 docs/ReasonCodesResponse.md
 docs/Recipient.md
 docs/RecipientInput.md
+docs/RefuseeRequest.md
 docs/ReportPeriod.md
 docs/ReportSender.md
 docs/RoundingAmount.md
@@ -259,10 +270,12 @@ docs/SearchFlowResponse.md
 docs/SearchServicesResponse.md
 docs/SearchStructureRequest.md
 docs/SearchStructureResponse.md
+docs/SecretStatus.md
 docs/Sellercountry.md
 docs/SignatureInfo.md
 docs/SignatureInfoAPI.md
 docs/SignatureParameters.md
+docs/SimplifiedCDARResponse.md
 docs/SimplifiedInvoiceData.md
 docs/StatusCodeInfo.md
 docs/StatusCodesResponse.md
@@ -433,12 +446,11 @@ models/allowance-total-amount.ts
 models/amount-due.ts
 models/amount.ts
 models/amount1.ts
+models/amount2.ts
 models/apierror.ts
 models/apiprofile.ts
 models/async-task-status.ts
 models/base-amount.ts
-models/body-submit-cdar-api-v1-cdar-submit-post.ts
-models/body-submit-cdar-xml-api-v1-cdar-submit-xml-post.ts
 models/bounding-box-schema.ts
 models/buyercountry.ts
 models/celery-status.ts
@@ -447,6 +459,12 @@ models/charge-total-amount.ts
 models/chorus-pro-credentials.ts
 models/chorus-pro-destination.ts
 models/chorus-pro-result.ts
+models/client-activate-response.ts
+models/client-create-request.ts
+models/client-detail.ts
+models/client-list-response.ts
+models/client-summary.ts
+models/client-update-request.ts
 models/contact.ts
 models/convert-resume-request.ts
 models/convert-success-response.ts
@@ -464,6 +482,7 @@ models/document-type-info.ts
 models/electronic-address.ts
 models/encaisseamount.ts
 models/encaisseamount1.ts
+models/encaissee-request.ts
 models/enriched-invoice-info.ts
 models/ereporting-flow-type.ts
 models/ereporting-validation-error.ts
@@ -472,9 +491,9 @@ models/error-source.ts
 models/extraction-info.ts
 models/factur-xinvoice.ts
 models/factur-xpdfinfo.ts
-models/facture-electronique-rest-api-schemas-chorus-pro-chorus-pro-credentials.ts
+models/facture-electronique-rest-api-schemas-cdar-validation-error-response.ts
 models/facture-electronique-rest-api-schemas-ereporting-invoice-type-code.ts
-models/facture-electronique-rest-api-schemas-validation-validation-error-response.ts
+models/facture-electronique-rest-api-schemas-processing-chorus-pro-credentials.ts
 models/field-status.ts
 models/file-info.ts
 models/files-info.ts
@@ -530,6 +549,8 @@ models/payment-amount-by-rate.ts
 models/payment-card.ts
 models/payment-means.ts
 models/pdfvalidation-result-api.ts
+models/pdpconfig-response.ts
+models/pdpconfig-update-request.ts
 models/pdpcredentials.ts
 models/percentage.ts
 models/postal-address.ts
@@ -546,6 +567,7 @@ models/reason-code-info.ts
 models/reason-codes-response.ts
 models/recipient-input.ts
 models/recipient.ts
+models/refusee-request.ts
 models/report-period.ts
 models/report-sender.ts
 models/rounding-amount.ts
@@ -556,10 +578,12 @@ models/search-flow-response.ts
 models/search-services-response.ts
 models/search-structure-request.ts
 models/search-structure-response.ts
+models/secret-status.ts
 models/sellercountry.ts
 models/signature-info-api.ts
 models/signature-info.ts
 models/signature-parameters.ts
+models/simplified-cdarresponse.ts
 models/simplified-invoice-data.ts
 models/status-code-info.ts
 models/status-codes-response.ts

package/.openapi-generator/VERSION

@@ -1 +1 @@
-7.19.0-SNAPSHOT
+7.20.0-SNAPSHOT

package/CHANGELOG.md

@@ -7,18 +7,11 @@ et ce projet adhère au [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## [Unreleased]
 
-## [3.0.37] - 2026-01-17
+## [4.0.1] - 2026-01-20
 
-### Added
-- Version initiale du SDK typescript
-- Support complet de l'API FactPulse
-- Endpoints Factur-X (génération, validation)
-- Endpoints AFNOR PDP/PA (Flow Service, Directory Service)
-- Endpoints Chorus Pro (recherche entreprise, soumission factures)
-- Endpoints Signature électronique (PAdES-B-B, PAdES-B-T, PAdES-B-LT)
-- Support des deux modes d'authentification (stored credentials et zero-trust)
-- Documentation complète et exemples
+### Fixed
+- Gestion post multipart
 
 
-[Unreleased]: https://github.com/factpulse/sdk-typescript/compare/v3.0.37...HEAD
-[3.0.37]: https://github.com/factpulse/sdk-typescript/releases/tag/v3.0.37
+[Unreleased]: https://github.com/factpulse/sdk-typescript/compare/v4.0.1...HEAD
+[4.0.1]: https://github.com/factpulse/sdk-typescript/releases/tag/v4.0.1

package/README.md

@@ -8,7 +8,7 @@ Official TypeScript/JavaScript client for the FactPulse API - French electronic
 - **Chorus Pro**: Integration with the French public invoicing platform
 - **AFNOR PDP/PA**: Submission of flows compliant with XP Z12-013 standard
 - **Electronic signature**: PDF signing (PAdES-B-B, PAdES-B-T, PAdES-B-LT)
-- **Simplified client**: JWT authentication and polling integrated via `helpers`
+- **Thin HTTP wrapper**: Generic `post()` and `get()` methods with automatic JWT auth and polling
 
 ## Installation
 
@@ -20,8 +20,6 @@ yarn add @factpulse/sdk
 
 ## Quick Start
 
-The `helpers` module provides a simplified API with automatic authentication and polling:
-
 ```typescript
 import { FactPulseClient } from '@factpulse/sdk/helpers';
 import * as fs from 'fs';
@@ -29,189 +27,178 @@ import * as fs from 'fs';
 // Create the client
 const client = new FactPulseClient({
   email: 'your_email@example.com',
-  password: 'your_password'
+  password: 'your_password',
+  clientUid: 'your-client-uuid', // From dashboard: Configuration > Clients
 });
 
-// Build the invoice using simplified format (auto-calculates totals)
-const invoiceData = {
-  number: 'INV-2025-001',
-  supplier: {
-    name: 'My Company SAS',
-    siret: '12345678901234',
-    iban: 'FR7630001007941234567890185',
-  },
-  recipient: {
-    name: 'Client SARL',
-    siret: '98765432109876',
+// Read your source PDF
+const pdfB64 = fs.readFileSync('source_invoice.pdf').toString('base64');
+
+// Generate Factur-X and submit to PDP in one call
+const result = await client.post('processing/invoices/submit-complete-async', {
+  invoiceData: {
+    number: 'INV-2025-001',
+    supplier: {
+      siret: '12345678901234',
+      iban: 'FR7630001007941234567890185',
+      routing_address: '12345678901234',
+    },
+    recipient: {
+      siret: '98765432109876',
+      routing_address: '98765432109876',
+    },
+    lines: [
+      {
+        description: 'Consulting services',
+        quantity: 10,
+        unitPrice: 100.0,
+        vatRate: 20.0,
+      },
+    ],
   },
-  lines: [
-    {
-      description: 'Consulting services',
-      quantity: 10,
-      unitPrice: 100.0,
-      vatRate: 20,
-    }
-  ],
-};
-
-// Generate the Factur-X PDF
-const pdfBytes = await client.generateFacturx(invoiceData, 'source_invoice.pdf');
-
-fs.writeFileSync('facturx_invoice.pdf', pdfBytes);
-```
-
-## Available Helpers
-
-### amount(value)
+  sourcePdf: pdfB64,
+  profile: 'EN16931',
+  destination: { type: 'afnor' },
+});
 
-Converts a value to a formatted string for monetary amounts.
+// PDF is in result.content (auto-polled, auto-decoded from base64)
+fs.writeFileSync('facturx_invoice.pdf', result.content);
 
-```typescript
-import { amount } from '@factpulse/sdk/helpers';
-
-amount(1234.5);      // "1234.50"
-amount("1234.56");   // "1234.56"
-amount(null);        // "0.00"
+console.log(`Flow ID: ${result.afnorResult?.flowId}`);
 ```
 
-### invoiceTotals(exclTax, vat, inclTax, amountDue, options?)
+## API Methods
 
-Creates a complete invoice totals object.
+The SDK provides two generic methods that map directly to API endpoints:
 
 ```typescript
-import { invoiceTotals } from '@factpulse/sdk/helpers';
+// POST /api/v1/{path}
+const result = await client.post('path/to/endpoint', { key1: value1, key2: value2 });
 
-const totals = invoiceTotals(1000.00, 200.00, 1200.00, 1200.00, {
-  globalAllowanceAmount: 50.00,   // Optional
-  globalAllowanceReason: 'Loyalty', // Optional
-  prepayment: 100.00,             // Optional
-});
+// GET /api/v1/{path}
+const result = await client.get('path/to/endpoint', { param1: value1 });
 ```
 
-### invoiceLine(lineNumber, itemName, quantity, unitNetPrice, lineNetAmount, options?)
+### Common Endpoints
 
-Creates an invoice line.
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `processing/invoices/submit-complete-async` | POST | Generate Factur-X + submit to PDP |
+| `processing/generate-invoice` | POST | Generate Factur-X XML or PDF |
+| `processing/validate-xml` | POST | Validate Factur-X XML |
+| `processing/validate-facturx-pdf` | POST | Validate Factur-X PDF |
+| `processing/sign-pdf` | POST | Sign PDF with certificate |
+| `afnor/flow/v1/flows` | POST | Submit flow to AFNOR PDP |
+| `afnor/incoming-flows/{flow_id}` | GET | Get incoming invoice |
+| `chorus-pro/factures/soumettre` | POST | Submit to Chorus Pro |
 
-```typescript
-import { invoiceLine } from '@factpulse/sdk/helpers';
-
-const line = invoiceLine(
-  1,
-  'Consulting services',
-  5,
-  200.00,
-  1000.00,
-  {
-    vatRate: 'TVA20',        // Or manualVatRate: '20.00'
-    vatCategory: 'S',        // S, Z, E, AE, K
-    unit: 'HOUR',            // LUMP_SUM, PIECE, HOUR, DAY...
-    reference: 'REF-001',    // Optional
-  }
-);
-```
+## Webhooks
 
-### vatLine(taxableAmount, vatAmount, options?)
-
-Creates a VAT breakdown line.
+Instead of polling, you can receive results via webhook by adding `callbackUrl`:
 
 ```typescript
-import { vatLine } from '@factpulse/sdk/helpers';
-
-const vat = vatLine(1000.00, 200.00, {
-  rate: 'TVA20',       // Or manualRate: '20.00'
-  category: 'S',       // S, Z, E, AE, K
+// Submit with webhook - returns immediately
+const result = await client.post('processing/invoices/submit-complete-async', {
+  invoiceData,
+  sourcePdf: pdfB64,
+  destination: { type: 'afnor' },
+  callbackUrl: 'https://your-server.com/webhook/factpulse',
+  webhookMode: 'INLINE', // or 'DOWNLOAD_URL'
 });
-```
 
-### postalAddress(line1, postalCode, city, options?)
+const taskId = result.taskId;
+// Result will be POSTed to your webhook URL
+```
 
-Creates a structured postal address.
+### Webhook Receiver Example (Express.js)
 
 ```typescript
-import { postalAddress } from '@factpulse/sdk/helpers';
-
-const address = postalAddress('123 Republic Street', '75001', 'Paris', {
-  country: 'FR',       // Default: 'FR'
-  line2: 'Building A'  // Optional
-});
-```
-
-### electronicAddress(identifier, schemeId?)
+import express from 'express';
+import crypto from 'crypto';
+
+const app = express();
+app.use(express.json({ verify: (req, res, buf) => (req.rawBody = buf) }));
+
+const WEBHOOK_SECRET = 'your-shared-secret';
+
+function verifySignature(payload: Buffer, signature: string): boolean {
+  if (!signature.startsWith('sha256=')) return false;
+  const expected = crypto
+    .createHmac('sha256', WEBHOOK_SECRET)
+    .update(payload)
+    .digest('hex');
+  return crypto.timingSafeEqual(
+    Buffer.from(signature.slice(7)),
+    Buffer.from(expected)
+  );
+}
+
+app.post('/webhook/factpulse', (req, res) => {
+  const signature = req.headers['x-webhook-signature'] as string || '';
+  if (!verifySignature(req.rawBody, signature)) {
+    return res.status(401).json({ error: 'Invalid signature' });
+  }
 
-Creates an electronic address (digital identifier).
+  const event = req.body;
+  const eventType = event.event_type;
+  const data = event.data;
 
-```typescript
-import { electronicAddress } from '@factpulse/sdk/helpers';
+  if (eventType === 'submission.completed') {
+    console.log(`Invoice submitted: ${data.afnorResult?.flowId}`);
+  } else if (eventType === 'submission.failed') {
+    console.log(`Submission failed: ${data.error}`);
+  }
 
-// SIRET (schemeId="0225")
-const address = electronicAddress('12345678901234', '0225');
+  res.json({ status: 'received' });
+});
 
-// SIREN (schemeId="0009", default)
-const address = electronicAddress('123456789');
+app.listen(3000);
 ```
 
-### supplier(name, siret, addressLine1, postalCode, city, options?)
+### Webhook Event Types
 
-Creates a complete supplier with automatic SIREN and intra-EU VAT calculation.
+| Event | Description |
+|-------|-------------|
+| `generation.completed` | Factur-X generated successfully |
+| `generation.failed` | Generation failed |
+| `validation.completed` | Validation passed |
+| `validation.failed` | Validation failed |
+| `signature.completed` | PDF signed |
+| `submission.completed` | Submitted to PDP/Chorus |
+| `submission.failed` | Submission failed |
 
-```typescript
-import { supplier } from '@factpulse/sdk/helpers';
-
-const s = supplier(
-  'My Company SAS',
-  '12345678901234',
-  '123 Example Street',
-  '75001',
-  'Paris',
-  { iban: 'FR7630006000011234567890189' }
-);
-// SIREN and intra-EU VAT number calculated automatically
-```
-
-### recipient(name, siret, addressLine1, postalCode, city, options?)
+## Zero-Storage Mode
 
-Creates a recipient (customer) with automatic SIREN calculation.
+Pass PDP credentials directly in the request (no server-side storage):
 
 ```typescript
-import { recipient } from '@factpulse/sdk/helpers';
-
-const r = recipient(
-  'Client SARL',
-  '98765432109876',
-  '456 Test Avenue',
-  '69001',
-  'Lyon'
-);
+const result = await client.post('processing/invoices/submit-complete-async', {
+  invoiceData,
+  sourcePdf: pdfB64,
+  destination: {
+    type: 'afnor',
+    flowServiceUrl: 'https://api.pdp.example.com/flow/v1',
+    tokenUrl: 'https://auth.pdp.example.com/oauth/token',
+    clientId: 'your_pdp_client_id',
+    clientSecret: 'your_pdp_client_secret',
+  },
+});
 ```
 
-## Zero-Trust Mode (Chorus Pro / AFNOR)
-
-To pass your own credentials without server-side storage:
+## Error Handling
 
 ```typescript
-import {
-  FactPulseClient,
-  ChorusProCredentials,
-  AFNORCredentials,
-} from '@factpulse/sdk/helpers';
-
-const client = new FactPulseClient({
-  email: 'your_email@example.com',
-  password: 'your_password',
-  chorusCredentials: {
-    pisteClientId: 'your_client_id',
-    pisteClientSecret: 'your_client_secret',
-    chorusProLogin: 'your_login',
-    chorusProPassword: 'your_password',
-    sandbox: true,
-  },
-  afnorCredentials: {
-    flowServiceUrl: 'https://api.pdp.fr/flow/v1',
-    tokenUrl: 'https://auth.pdp.fr/oauth/token',
-    clientId: 'your_client_id',
-    clientSecret: 'your_client_secret',
-  },
-});
+import { FactPulseClient, FactPulseError } from '@factpulse/sdk/helpers';
+
+try {
+  const result = await client.post('processing/validate-xml', { xmlContent });
+} catch (e) {
+  if (e instanceof FactPulseError) {
+    console.log(`Error: ${e.message}`);
+    console.log(`Status code: ${e.statusCode}`);
+    console.log(`Details: ${e.details}`); // Validation errors list
+  }
+}
 ```
 
 ## Resources