@factpulse/sdk 3.0.36 → 4.0.0

package/.openapi-generator/FILES

@@ -173,8 +173,8 @@ docs/ErrorSource.md
 docs/ExtractionInfo.md
 docs/FacturXInvoice.md
 docs/FacturXPDFInfo.md
+docs/FactureElectroniqueModelsInvoiceTypeCode.md
 docs/FactureElectroniqueRestApiSchemasCdarValidationErrorResponse.md
-docs/FactureElectroniqueRestApiSchemasEreportingInvoiceTypeCode.md
 docs/FactureElectroniqueRestApiSchemasProcessingChorusProCredentials.md
 docs/FieldStatus.md
 docs/FileInfo.md
@@ -472,8 +472,8 @@ models/error-source.ts
 models/extraction-info.ts
 models/factur-xinvoice.ts
 models/factur-xpdfinfo.ts
+models/facture-electronique-models-invoice-type-code.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-processing-chorus-pro-credentials.ts
 models/field-status.ts
 models/file-info.ts

package/CHANGELOG.md

@@ -7,18 +7,15 @@ et ce projet adhère au [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## [Unreleased]
 
-## [3.0.36] - 2026-01-17
+## [4.0.0] - 2026-01-19
 
 ### 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
-
-
-[Unreleased]: https://github.com/factpulse/sdk-typescript/compare/v3.0.36...HEAD
-[3.0.36]: https://github.com/factpulse/sdk-typescript/releases/tag/v3.0.36
+- Gestion automatique des taches asynchrones
+- Gestion automatique du décodage des documents renvoyés en base 64.
+
+### Changed
+- Rework complet du fonctionnement des SDK, fonctionnement totalement générique et transparent
+
+
+[Unreleased]: https://github.com/factpulse/sdk-typescript/compare/v4.0.0...HEAD
+[4.0.0]: https://github.com/factpulse/sdk-typescript/releases/tag/v4.0.0

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

package/dist/esm/models/{facture-electronique-rest-api-schemas-ereporting-invoice-type-code.d.ts → facture-electronique-models-invoice-type-code.d.ts}

@@ -10,13 +10,72 @@
  * Do not edit the class manually.
  */
 /**
- * Invoice type codes (UNTDID 1001).
+ * Document type according to BR-FR-04 (UNTDID 1001 codes).  | Code | Name | Description | |------|------|-------------| | 380 | INVOICE | Commercial invoice | | 389 | SELF_BILLED_INVOICE | Self-billed invoice | | 393 | FACTORED_INVOICE | Factored invoice | | 501 | SELF_BILLED_FACTORED_INVOICE | Self-billed factored invoice | | 386 | PREPAYMENT_INVOICE | Prepayment invoice | | 500 | SELF_BILLED_PREPAYMENT_INVOICE | Self-billed prepayment invoice | | 384 | CORRECTIVE_INVOICE | Corrective invoice | | 471 | SELF_BILLED_CORRECTIVE_INVOICE | Self-billed corrective invoice | | 472 | FACTORED_CORRECTIVE_INVOICE | Factored corrective invoice | | 473 | SELF_BILLED_FACTORED_CORRECTIVE_INVOICE | Self-billed factored corrective invoice | | 381 | CREDIT_NOTE | Credit note | | 261 | SELF_BILLED_CREDIT_NOTE | Self-billed credit note | | 262 | GLOBAL_ALLOWANCE_CREDIT_NOTE | Credit note for global allowance | | 396 | FACTORED_CREDIT_NOTE | Factored credit note | | 502 | SELF_BILLED_FACTORED_CREDIT_NOTE | Self-billed factored credit note | | 503 | PREPAYMENT_CREDIT_NOTE | Credit note for prepayment invoice |
  */
-export declare const FactureElectroniqueRestApiSchemasEreportingInvoiceTypeCode: {
-    readonly _380: "380";
-    readonly _381: "381";
-    readonly _384: "384";
-    readonly _389: "389";
-    readonly _386: "386";
+export declare const FactureElectroniqueModelsInvoiceTypeCode: {
+    /**
+    * Commercial Invoice
+    */
+    readonly INVOICE: "380";
+    /**
+    * Self-billed Invoice
+    */
+    readonly SELF_BILLED_INVOICE: "389";
+    /**
+    * Factored Invoice
+    */
+    readonly FACTORED_INVOICE: "393";
+    /**
+    * Self-billed Factored Invoice
+    */
+    readonly SELF_BILLED_FACTORED_INVOICE: "501";
+    /**
+    * Prepayment Invoice
+    */
+    readonly PREPAYMENT_INVOICE: "386";
+    /**
+    * Self-billed Prepayment Invoice
+    */
+    readonly SELF_BILLED_PREPAYMENT_INVOICE: "500";
+    /**
+    * Corrective Invoice
+    */
+    readonly CORRECTIVE_INVOICE: "384";
+    /**
+    * Self-billed Corrective Invoice
+    */
+    readonly SELF_BILLED_CORRECTIVE_INVOICE: "471";
+    /**
+    * Factored Corrective Invoice
+    */
+    readonly FACTORED_CORRECTIVE_INVOICE: "472";
+    /**
+    * Self-billed Factored Corrective Invoice
+    */
+    readonly SELF_BILLED_FACTORED_CORRECTIVE_INVOICE: "473";
+    /**
+    * Credit Note
+    */
+    readonly CREDIT_NOTE: "381";
+    /**
+    * Self-billed Credit Note
+    */
+    readonly SELF_BILLED_CREDIT_NOTE: "261";
+    /**
+    * Global Allowance Credit Note
+    */
+    readonly GLOBAL_ALLOWANCE_CREDIT_NOTE: "262";
+    /**
+    * Factored Credit Note
+    */
+    readonly FACTORED_CREDIT_NOTE: "396";
+    /**
+    * Self-billed Factored Credit Note
+    */
+    readonly SELF_BILLED_FACTORED_CREDIT_NOTE: "502";
+    /**
+    * Prepayment Credit Note
+    */
+    readonly PREPAYMENT_CREDIT_NOTE: "503";
 };
-export type FactureElectroniqueRestApiSchemasEreportingInvoiceTypeCode = typeof FactureElectroniqueRestApiSchemasEreportingInvoiceTypeCode[keyof typeof FactureElectroniqueRestApiSchemasEreportingInvoiceTypeCode];
+export type FactureElectroniqueModelsInvoiceTypeCode = typeof FactureElectroniqueModelsInvoiceTypeCode[keyof typeof FactureElectroniqueModelsInvoiceTypeCode];

package/dist/esm/models/{facture-electronique-rest-api-schemas-ereporting-invoice-type-code.js → facture-electronique-models-invoice-type-code.js}

@@ -12,12 +12,71 @@
  * Do not edit the class manually.
  */
 /**
- * Invoice type codes (UNTDID 1001).
+ * Document type according to BR-FR-04 (UNTDID 1001 codes).  | Code | Name | Description | |------|------|-------------| | 380 | INVOICE | Commercial invoice | | 389 | SELF_BILLED_INVOICE | Self-billed invoice | | 393 | FACTORED_INVOICE | Factored invoice | | 501 | SELF_BILLED_FACTORED_INVOICE | Self-billed factored invoice | | 386 | PREPAYMENT_INVOICE | Prepayment invoice | | 500 | SELF_BILLED_PREPAYMENT_INVOICE | Self-billed prepayment invoice | | 384 | CORRECTIVE_INVOICE | Corrective invoice | | 471 | SELF_BILLED_CORRECTIVE_INVOICE | Self-billed corrective invoice | | 472 | FACTORED_CORRECTIVE_INVOICE | Factored corrective invoice | | 473 | SELF_BILLED_FACTORED_CORRECTIVE_INVOICE | Self-billed factored corrective invoice | | 381 | CREDIT_NOTE | Credit note | | 261 | SELF_BILLED_CREDIT_NOTE | Self-billed credit note | | 262 | GLOBAL_ALLOWANCE_CREDIT_NOTE | Credit note for global allowance | | 396 | FACTORED_CREDIT_NOTE | Factored credit note | | 502 | SELF_BILLED_FACTORED_CREDIT_NOTE | Self-billed factored credit note | | 503 | PREPAYMENT_CREDIT_NOTE | Credit note for prepayment invoice |
  */
-export const FactureElectroniqueRestApiSchemasEreportingInvoiceTypeCode = {
-    _380: '380',
-    _381: '381',
-    _384: '384',
-    _389: '389',
-    _386: '386'
+export const FactureElectroniqueModelsInvoiceTypeCode = {
+    /**
+    * Commercial Invoice
+    */
+    INVOICE: '380',
+    /**
+    * Self-billed Invoice
+    */
+    SELF_BILLED_INVOICE: '389',
+    /**
+    * Factored Invoice
+    */
+    FACTORED_INVOICE: '393',
+    /**
+    * Self-billed Factored Invoice
+    */
+    SELF_BILLED_FACTORED_INVOICE: '501',
+    /**
+    * Prepayment Invoice
+    */
+    PREPAYMENT_INVOICE: '386',
+    /**
+    * Self-billed Prepayment Invoice
+    */
+    SELF_BILLED_PREPAYMENT_INVOICE: '500',
+    /**
+    * Corrective Invoice
+    */
+    CORRECTIVE_INVOICE: '384',
+    /**
+    * Self-billed Corrective Invoice
+    */
+    SELF_BILLED_CORRECTIVE_INVOICE: '471',
+    /**
+    * Factored Corrective Invoice
+    */
+    FACTORED_CORRECTIVE_INVOICE: '472',
+    /**
+    * Self-billed Factored Corrective Invoice
+    */
+    SELF_BILLED_FACTORED_CORRECTIVE_INVOICE: '473',
+    /**
+    * Credit Note
+    */
+    CREDIT_NOTE: '381',
+    /**
+    * Self-billed Credit Note
+    */
+    SELF_BILLED_CREDIT_NOTE: '261',
+    /**
+    * Global Allowance Credit Note
+    */
+    GLOBAL_ALLOWANCE_CREDIT_NOTE: '262',
+    /**
+    * Factored Credit Note
+    */
+    FACTORED_CREDIT_NOTE: '396',
+    /**
+    * Self-billed Factored Credit Note
+    */
+    SELF_BILLED_FACTORED_CREDIT_NOTE: '502',
+    /**
+    * Prepayment Credit Note
+    */
+    PREPAYMENT_CREDIT_NOTE: '503'
 };

package/dist/esm/models/index.d.ts

@@ -145,8 +145,8 @@ export * from './error-source';
 export * from './extraction-info';
 export * from './factur-xinvoice';
 export * from './factur-xpdfinfo';
+export * from './facture-electronique-models-invoice-type-code';
 export * from './facture-electronique-rest-api-schemas-cdar-validation-error-response';
-export * from './facture-electronique-rest-api-schemas-ereporting-invoice-type-code';
 export * from './facture-electronique-rest-api-schemas-processing-chorus-pro-credentials';
 export * from './field-status';
 export * from './file-info';

package/dist/esm/models/index.js

@@ -145,8 +145,8 @@ export * from './error-source';
 export * from './extraction-info';
 export * from './factur-xinvoice';
 export * from './factur-xpdfinfo';
+export * from './facture-electronique-models-invoice-type-code';
 export * from './facture-electronique-rest-api-schemas-cdar-validation-error-response';
-export * from './facture-electronique-rest-api-schemas-ereporting-invoice-type-code';
 export * from './facture-electronique-rest-api-schemas-processing-chorus-pro-credentials';
 export * from './field-status';
 export * from './file-info';

package/dist/esm/models/invoice-input.d.ts

@@ -11,7 +11,7 @@
  */
 import type { Buyercountry } from './buyercountry';
 import type { Currency } from './currency';
-import type { FactureElectroniqueRestApiSchemasEreportingInvoiceTypeCode } from './facture-electronique-rest-api-schemas-ereporting-invoice-type-code';
+import type { InvoiceTypeCode } from './invoice-type-code';
 import type { Sellercountry } from './sellercountry';
 import type { TaxBreakdownInput } from './tax-breakdown-input';
 import type { Taxamount1 } from './taxamount1';
@@ -31,7 +31,7 @@ export interface InvoiceInput {
     /**
      * Invoice type code
      */
-    'typeCode'?: FactureElectroniqueRestApiSchemasEreportingInvoiceTypeCode;
+    'typeCode'?: InvoiceTypeCode;
     'currency'?: Currency;
     'dueDate'?: string | null;
     /**