@silexpert/core 2.0.119-tsdown.0 → 2.0.120

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@silexpert/core",
-  "version": "2.0.119-tsdown.0",
+  "version": "2.0.120",
   "description": "Silex Core perform HTTP Request and object binding. Silex core helps developers to retrieve and return formatted object",
   "keywords": [
     "accounting",

package/ts/api/resources/Authenticate.ts

@@ -7,6 +7,7 @@ import {
   ReadConnectAs,
   ProviderAuthDto,
   ExchangeExternalAuthenticationLink,
+  ConnectFromUUID,
 } from '../../types/index.js';
 import { Resource } from '../Resource.js';
 
@@ -50,6 +51,11 @@ export class Authenticate extends Resource {
     return this.axios.$put('/authenticate/reset-password', payload);
   }
 
+  /** @deprecated Use exchangeExternalAuthenticationLink instead */
+  async byExternalId(uuid: string, query: ConnectFromUUID): Promise<ReadByExternalId> {
+    return this.axios.$get(`/authenticate/external/${uuid}`, { params: query });
+  }
+
   async exchangeExternalAuthenticationLink(payload: ExchangeExternalAuthenticationLink): Promise<ReadByExternalId> {
     return this.axios.$post(`/authenticate/external/exchange`, payload);
   }

package/ts/api/resources/Follow.ts

@@ -10,4 +10,13 @@ export class Follow extends Resource {
   create(payload: QueryCreateSocietyFollow): Promise<IFollow> {
     return this.axios.$post('/society-follow', payload);
   }
+
+  /**
+   * archive a follow entry
+   * @param { number } id
+   * @returns { Promise<{ success: boolean; follow?: IFollow }> }
+   */
+  archive(id: number): Promise<{ success: boolean; follow?: IFollow }> {
+    return this.axios.$put(`/society-follow/${id}`);
+  }
 }

package/ts/types/Enum/AIPrompt.ts

@@ -120,15 +120,46 @@ export const AIPrompt: Record<AIPromptKey, AIPromptInfo> = {
       Faites particulièrement attention à bien distinguer le montant HT (subAmount), le montant de TVA (vatAmount) et le montant TTC (totalAmount).
 
       CONTEXTE (FACTURE DE VENTE) :
+      - Pour les montants financiers (totalAmount, subAmount, vatAmount) :
+        * Pour le montant total TTC (totalAmount) :
+          - Extrayez le MONTANT TOTAL FINAL GLOBAL TTC de la pièce comptable pour l'ensemble du document (toutes pages confondues).
+          - Termes équivalents : 'Net à Payer', 'Net à payer TTC', 'Total à régler', 'Montant à payer', 'Total général', 'Net à régler', ou montant sur le coupon détachable ('Montant (Euros)'). Tous ces termes désignent le 'totalAmount' TTC.
+          - Pour les avoirs (notes de crédit, remboursements, documents portant la mention 'AVOIR' ou montants avec signe négatif/tiret comme '18,56-', '-18.56', '(18.56)') :
+            Extrayez TOUJOURS la valeur absolue positive du montant (ex: 'AVOIR EUR 18,56-' -> 18.56).
+          - Acomptes et paiements échelonnés : extrayez le montant total TTC facturé de la pièce, et non le reste à payer après déduction d'un acompte antérieur.
+          - Escomptes conditionnels : ne retenez JAMAIS un montant d'escompte pour paiement anticipé (ex: 'Escompte 2% si paiement sous 8 jours').
+          - Tableau de ventilation de TVA : si plusieurs taux existent, le montant total (totalAmount) est le 'Net à Payer' global ou la somme des montants TTC de toutes les lignes. Ne prenez JAMAIS le montant TTC d'une seule ligne.
+          - Régimes sans TVA (franchise en base art. 293 B du CGI, autoliquidation, exonération, vente intracommunautaire) : si la facture mentionne une absence de TVA, positionnez vatAmount à 0 et subAmount égal à totalAmount.
+          - Ne confondez JAMAIS le montant total TTC avec un sous-total partiel d'une page ('SOUS TOTAL ...'), un report ou un acompte.
+        * Pour le montant total HT (subAmount) :
+          - Extrayez le montant total global Hors Taxes de la facture. Si plusieurs taux existent, c'est la somme de tous les montants HT.
+        * Pour le montant total de TVA (vatAmount) :
+          - Extrayez le montant total de la taxe TVA. Si plusieurs taux existent, c'est la somme de toutes les TVA. Si exonéré ou non applicable, renvoyez 0.
+        * Cohérence arithmétique : Vérifiez toujours que subAmount + vatAmount = totalAmount.
+      - Pour le numéro de facture (invoiceNumber) et type de document (isReceipt) :
+        * RÈGLE STRICTE POUR LES TICKETS DE CAISSE : Si le document est un ticket de caisse (ou reçu de magasin, caisse enregistreuse, restaurant...) et non une facture officielle : AUCUN numéro de facture ne doit être extrait. Renvoyez TOUJOURS null pour 'invoiceNumber' et positionnez 'isReceipt' à true. Ne considérez JAMAIS un numéro de ticket, de caisse, de terminal, un code-barres ou une référence interne de caisse comme un numéro de facture.
+        * Pour les factures officielles : extrayez le numéro officiel de la facture émise (ex: 'D260001058', 'F2026-001') et positionnez 'isReceipt' à false.
+        * ATTENTION : Si le document mentionne 'Annule et remplace facture n°...' ou 'Avoir sur facture n°...', retenez TOUJOURS le numéro de la nouvelle facture / avoir actuelle émise et JAMAIS le numéro de la facture précédente annulée ou remplacée.
+        * Ne confondez PAS le numéro de facture avec un numéro de commande ('Commande n°...'), de ticket de caisse, de bon de livraison (BL), de devis, ou une référence client.
+        * Retirez les préfixes textuels tels que 'FACTURE N°', 'Facture :', 'Invoice #', 'Avoir n°'.
+      - Pour la date de la facture (dateValue) :
+        * Extrayez impérativement la DATE D'ÉMISSION de la facture (la date à laquelle la facture a été établie, ex: 'Paris le 16 août 2026' -> '2026-08-16', '20.08.2026' -> '2026-08-20', '1er septembre 2026' -> '2026-09-01', ou 'Date de facture : DD/MM/YYYY').
+        * ATTENTION : Les dates peuvent être séparées par des tirets, des barres obliques ou des points (ex: '20.08.2026' correspond au 20 août 2026 et doit être converti en '2026-08-20'). Pour les documents en français, l'ordre est Jour/Mois/Année (DD/MM/YYYY).
+        * ATTENTION : Ne confondez JAMAIS la date d'émission de la facture avec :
+          - Les dates de lignes d'opérations ou de transactions individuelles figurant dans un tableau ou relevé récapitulatif (ex: dates de vente, de télécollecte ou de paiements unitaires comme 07/08/2026).
+          - Les dates de début ou fin de période de facturation (ex: 'Période du 01/08 au 15/08').
+          - Une date d'échéance, de prélèvement ou de règlement (ex: 'Échéance le...').
+          - Une date de livraison, de commande ou d'impression.
+        * La date comptable officielle est TOUJOURS la date d'émission de la facture elle-même.
       - L'émetteur / vendeur est notre propre entreprise${options?.societyName ? ` (${options.societyName})` : ''}. Renseignez son nom officiel dans 'merchantName'. Il n'y a PAS besoin de chercher un tiers fournisseur.
       - Le tiers cible à identifier et extraire en priorité est le CLIENT / ACHETEUR (customerName) :
         * Extrayez le nom officiel complet du client destinataire à qui est facturée la vente (nom de l'entreprise cliente ou particulier).
         * Ne retournez null QUE si aucun nom de client n'est identifiable.
       - Pour le SIRET ou SIREN (siretOrSiren) :
-        * Extrayez le numéro de SIRET (14 chiffres) ou SIREN (9 chiffres) DU CLIENT / ACHETEUR (destinataire), s'il est mentionné dans le bloc adresse ou mentions du client.
+        * Extrayez le numéro de SIRET (14 chiffres) ou SIREN (9 chiffres) DU CLIENT / ACHETEUR (destinataire), s'il est mentionné dans le bloc adresse ou mentions du client, y compris si mentionné dans le RCS (ex: 'RCS VILLE 123456789' -> 123456789).
         * ATTENTION : Ne retournez JAMAIS le SIRET de notre propre entreprise émettrice ici. Si le client n'a pas de SIRET indiqué (ex: particulier ou non mentionné), retournez null.
       - Pour le numéro de TVA intracommunautaire (vatNumber) :
-        * Extrayez le numéro de TVA intracommunautaire DU CLIENT / ACHETEUR, s'il figure sur le document. Si absent, retournez null. Ne retournez pas celui du vendeur.
+        * Extrayez le numéro de TVA intracommunautaire DU CLIENT / ACHETEUR, s'il figure sur le document (supporte tous les indicatifs européens : FR, IE, DE, ES, IT, BE, NL, etc.). Si absent, retournez null. Ne retournez pas celui du vendeur.
 
       Pour la classification comptable (categoryCode & categoryName) :
       - Il s'agit d'une opération de PRODUITS / VENTES :
@@ -142,22 +173,58 @@ export const AIPrompt: Record<AIPromptKey, AIPromptInfo> = {
       }
 
       return `
-      Vous êtes un expert-comptable spécialisé en extraction et classification de données comptables. Analysez cette facture d'achat (ou reçu, note de frais, avoir fournisseur) reçue${societyContext} et extrayez les informations demandées avec la plus grande précision.
+      Vous êtes un expert-comptable spécialisé en extraction et classification de données comptables. Analysez cette facture d'achat (ou reçu, ticket de caisse, note de frais, avoir fournisseur) reçue${societyContext} et extrayez les informations demandées avec la plus grande précision.
       Faites particulièrement attention à bien distinguer le montant HT (subAmount), le montant de TVA (vatAmount) et le montant TTC (totalAmount).
 
-      CONTEXTE (FACTURE D'ACHAT) :
-      - Le client destinataire (customerName) est notre propre entreprise${options?.societyName ? ` (${options.societyName})` : ''} : donnez le nom officiel de l'acheteur tel qu'indiqué sur la facture.
+      CONTEXTE (FACTURE D'ACHAT OU TICKET DE CAISSE) :
+      - Pour les montants financiers (totalAmount, subAmount, vatAmount) :
+        * Pour le montant total TTC (totalAmount) :
+          - Extrayez le MONTANT TOTAL FINAL GLOBAL TTC de la pièce comptable pour l'ensemble du document (toutes pages confondues, ex: 364.83).
+          - Termes équivalents : 'Net à Payer', 'Net à payer TTC', 'Total à régler', 'Montant à payer', 'Total général', 'Net à régler', ou montant figurant sur un talon de règlement / coupon détachable ('Montant (Euros)'). Tous ces termes désignent le 'totalAmount' TTC.
+          - Pour les avoirs (notes de crédit, remboursements, documents portant la mention 'AVOIR' ou montants avec signe négatif/tiret comme '18,56-', '-18.56', '(18.56)') :
+            Extrayez TOUJOURS la valeur absolue positive du montant (ex: 'AVOIR EUR 18,56-' -> 18.56).
+          - Acomptes et paiements échelonnés : extrayez le montant total TTC facturé de la pièce, et non le solde restant à payer après déduction d'un acompte antérieur.
+          - Escomptes conditionnels : ne retenez JAMAIS un montant d'escompte pour paiement anticipé (ex: 'Escompte 2% si paiement sous 8 jours').
+          - Tableau récapitulatif de TVA multi-taux : si la facture comporte un tableau avec une colonne 'Montant TTC' par taux (ex: une ligne à 20% avec 24,55 € et une ligne à 5,5% avec 340,28 €), ne prenez JAMAIS le montant TTC d'une seule ligne : le montant total (totalAmount) est le 'Net à Payer' global ou la somme des montants TTC de toutes les lignes (ex: 364,83 €).
+          - Régimes sans TVA (franchise en base art. 293 B du CGI, autoliquidation BTP art. 283 du CGI, exonération, achat intracommunautaire / reverse charge) : si la facture mentionne une absence de TVA, positionnez vatAmount à 0 et subAmount égal à totalAmount.
+          - Ne confondez JAMAIS le montant total avec un sous-total partiel d'une page ('SOUS TOTAL ...'), un report ou un acompte.
+        * Pour le montant total HT (subAmount) :
+          - Extrayez le montant total global Hors Taxes de la facture. Si plusieurs taux existent, c'est la somme de tous les montants HT (ex: 20,46 + 322,54 = 343.00).
+        * Pour le montant total de TVA (vatAmount) :
+          - Extrayez le montant total de la taxe TVA. Si plusieurs taux existent, c'est la somme de toutes les TVA (ex: 4,09 + 17,74 = 21.83). Si exonéré ou non applicable, renvoyez 0.
+        * Cohérence arithmétique : Vérifiez toujours que subAmount + vatAmount = totalAmount.
+      - Pour le numéro de facture (invoiceNumber) et type de document (isReceipt) :
+        * RÈGLE STRICTE POUR LES TICKETS DE CAISSE / REÇUS DE CAISSE :
+          Si le document est un ticket de caisse (ou reçu de supermarché, magasin, restaurant, automate de carburant, parking, péage...) et non une facture officielle avec les mentions légales obligatoires de facturation :
+          AUCUN numéro de facture ne doit être extrait. Vous DEVEZ renvoyer OBLIGATOIREMENT null pour 'invoiceNumber', et positionner 'isReceipt' à true.
+          Ne considérez JAMAIS un numéro de ticket de caisse, numéro de caisse, numéro d'opération/terminal (ex: 'M01611 C001 O0001 T0065'), code-barres (ex: '202608141043006500101611'), numéro de carte de fidélité ou référence interne de caisse comme un numéro de facture.
+        * Pour les factures officielles : extrayez le numéro officiel de la facture émise par le fournisseur (ex: 'D260001058', 'INV-2026-042') et positionnez 'isReceipt' à false.
+          ATTENTION : Si le document mentionne 'Annule et remplace facture n°...' ou 'Avoir sur facture n°...', retenez TOUJOURS le numéro de la nouvelle facture / avoir actuel en cours, et JAMAIS le numéro de la facture précédente annulée ou remplacée.
+          Ne confondez PAS le numéro de facture avec un numéro de commande ('Commande n°...', PO), de ticket de caisse, de bon de livraison (BL), de devis, une référence de virement ou un IBAN.
+          Retirez les préfixes textuels tels que 'FACTURE N°', 'Facture :', 'Invoice #', 'Avoir n°'.
+      - Pour la date de la facture ou du ticket (dateValue) :
+        * Extrayez impérativement la DATE D'ÉMISSION de la facture ou la date d'achat du ticket (la date à laquelle la pièce a été établie, ex: 'Paris le 16 août 2026' -> '2026-08-16', '20.08.2026' -> '2026-08-20', '1er septembre 2026' -> '2026-09-01', ou '14/08/2026' -> '2026-08-14').
+        * ATTENTION : Les dates peuvent être séparées par des tirets, des barres obliques ou des points (ex: '20.08.2026' correspond au 20 août 2026 et doit être converti en '2026-08-20'). Pour les documents en français, l'ordre est Jour/Mois/Année (DD/MM/YYYY).
+        * ATTENTION : Ne confondez JAMAIS la date d'émission de la facture avec :
+          - Les dates de lignes d'opérations ou de transactions individuelles figurant dans un tableau ou relevé récapitulatif (ex: dates de vente, de télécollecte ou de paiements unitaires comme 07/08/2026).
+          - Les dates de début ou fin de période de facturation (ex: 'Période du 01/08 au 15/08').
+          - Une date d'échéance, de prélèvement ou de règlement (ex: 'Échéance le...').
+          - Une date de livraison, de commande ou d'impression.
+        * La date comptable officielle est TOUJOURS la date d'émission de la facture elle-même ou la date d'achat du ticket.
+      - Le client destinataire (customerName) est notre propre entreprise${options?.societyName ? ` (${options.societyName})` : ''} ou le client livré/facturé (ex: 'DEKKER TIM') : donnez le nom officiel de l'acheteur tel qu'indiqué sur la facture.
       - Le tiers cible à identifier et extraire en priorité est le FOURNISSEUR / ÉMETTEUR (merchantName) :
         * Extrayez le nom officiel complet de l'entité juridique qui vend ou facture (le vendeur, prestataire ou fournisseur).
+        * Si un document comporte à la fois une enseigne commerciale (ex: 'E.Leclerc DRIVE', 'Carrefour') et une entité juridique exploitante (ex: 'SAS CHAUMONDIS') avec RCS/SIRET/TVA : l'entité juridique émettrice est le fournisseur (merchantName), et son SIRET/TVA doivent être extraits dans 'siretOrSiren' et 'vatNumber'. Ne considérez JAMAIS l'entité émettrice comme étant le client destinataire !
+        * Marketplaces : si la facture mentionne une vente sur une place de marché (ex: 'Vendu par TechStore SARL, expédié par Amazon'), le fournisseur réel est le vendeur tiers ('TechStore SARL').
         * ATTENTION : Ne confondez PAS le nom du fournisseur avec :
           - Des logos de constructeurs ou marques partenaires distribuées (ex: 'Canon', 'HP Partner', 'Dell Partner', 'Apple', 'Konica Minolta').
           - Des intitulés de services ou de sections (ex: 'Service Maintenance', 'Service Client', 'Support Technique', 'Facture').
         * Le fournisseur réel est l'entreprise prestataire/vendeuse mentionnée dans les mentions légales (en pied de page ou en-tête), avec son capital social, RCS, SIRET/SIREN, TVA intracommunautaire, ou identifiable par son domaine email / site web officiel.
         * Ne retournez null QUE si aucun nom de fournisseur ou d'émetteur n'est présent sur le document.
       - Pour le SIRET ou SIREN (siretOrSiren) :
-        * Extrayez le numéro de SIRET (14 chiffres) ou SIREN (9 chiffres) DU FOURNISSEUR / ÉMETTEUR.
+        * Extrayez le numéro de SIRET (14 chiffres) ou SIREN (9 chiffres) DU FOURNISSEUR / ÉMETTEUR, y compris si mentionné dans le RCS (ex: 'RCS CRETEIL 316807015' -> 316807015).
       - Pour le numéro de TVA intracommunautaire (vatNumber) :
-        * Extrayez le numéro de TVA intracommunautaire DU FOURNISSEUR / ÉMETTEUR (ex: FR...).
+        * Extrayez le numéro de TVA intracommunautaire DU FOURNISSEUR / ÉMETTEUR (supporte tous les indicatifs européens : FR, IE, DE, ES, IT, BE, NL, etc.).
 
       Pour la classification comptable (categoryCode & categoryName) :
       - Il s'agit d'une opération de CHARGES / ACHATS :

package/ts/types/Enum/EInvoicingReasonType.ts

@@ -391,8 +391,9 @@ export const einvoicingReasonList: EInvocingReasonListType = {
   REJ_UNI: {
     id: EInvoicingReasonType.REJ_UNI,
     reasonCode: EInvoicingReasonTypeCode.REJ_UNI,
-    label: 'Rejet sur contrôle unicité',
-    description: "Contrôle d'unicité de la facture",
+    label: "Rejet sur contrôle d'unicité",
+    description:
+      "Le contrôle d'unicité de la facture a échoué. La date d'émission peut être dans le futur ou une facture portant la même référence peut déjà être connue de la plateforme agréée. Vérifiez la date d'émission et la numérotation de votre facture.",
     acceptedStatus: [EInvoicingStatusCode.REJECTED],
   },
   REJ_COH: {

package/ts/types/Enum/Kyc.ts

@@ -5,4 +5,6 @@ export enum MandateStatus {
   REJECTED_ATTACHED_MANDATE_LEGAL_ENTITY = 'REJECTED_ATTACHED_MANDATE_LEGAL_ENTITY',
   REJECTED_STEP = 'REJECTED_STEP',
   REJECTED_DUPLICATE = 'REJECTED_DUPLICATE',
+  REJECTED_DIRECTORY_LINE = 'REJECTED_DIRECTORY_LINE',
+  SUSPENDED_OTHER_LINE_PROCESS = 'SUSPENDED_OTHER_LINE_PROCESS',
 }

package/ts/types/Enum/PrestationType.ts

@@ -2054,7 +2054,7 @@ export const PrestationDetail: PrestationDetailEnum = {
     minimumPrice: null,
     price: 0,
     isCatalog: false,
-    isPlannable: true,
+    isPlannable: false,
     hidden: true,
     isComplementary: false,
     signaturePosition: null,

package/ts/types/Form/FormConnector.ts

@@ -1,6 +1,7 @@
 import { IsString, IsOptional, IsNumber, IsDate, IsEnum } from 'class-validator';
 import { ConnectorType } from '../Enum/ConnectorType.js';
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { ToNumericEnum } from '../../utils/transforms/numericEnum.transform.js';
 
 export class FormConnector {
   @ApiPropertyOptional()
@@ -49,6 +50,7 @@ export class FormConnector {
   date?: Date;
 
   @ApiProperty()
+  @ToNumericEnum()
   @IsEnum(ConnectorType)
   idTypeConnector: ConnectorType;
 

package/ts/types/Interface/api/SocietyApproval.ts

@@ -3,6 +3,7 @@ import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
 import { RegulatedConventionType, SocietyApprovalDocumentType } from '../../Enum/SocietyApproval.js';
 import { ISocietyApproval } from '../models/ISocietyApproval.js';
 import { ToBoolean } from '../../../utils/transforms/boolean.transform.js';
+import { ToNumericEnum } from '../../../utils/transforms/numericEnum.transform.js';
 
 export class SocietyApprovalJsonDatas {
   @ApiPropertyOptional()
@@ -69,6 +70,7 @@ export class CreateDocument {
 
 export class ResetDocument {
   @ApiProperty()
+  @ToNumericEnum()
   @IsEnum(SocietyApprovalDocumentType)
   idDocumentType: SocietyApprovalDocumentType;
 }

package/ts/types/Interface/api/acceptance/CreateAcceptance.ts

@@ -1,6 +1,7 @@
 import { IsEnum, IsString } from 'class-validator';
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
 import { AcceptanceType } from '../../../Enum/Acceptance.js';
+import { ToNumericEnum } from '../../../../utils/transforms/numericEnum.transform.js';
 
 export class CreateCustomerAcceptance {
   @ApiProperty()
@@ -8,6 +9,7 @@ export class CreateCustomerAcceptance {
   token: string;
 
   @ApiProperty()
+  @ToNumericEnum()
   @IsEnum(AcceptanceType)
   state: AcceptanceType;
 

package/ts/types/Interface/api/accountingTransaction/QueryTransaction.ts

@@ -3,6 +3,7 @@ import { TypeCustomerProviderOperation } from '../../../Enum/TypeCustomerProvide
 import { AccountingJournal } from '../../../Enum/AccountingJournal.js';
 import { IsBoolean, IsDateString, IsInt, IsOptional } from 'class-validator';
 import { ToBoolean } from '../../../../utils/transforms/boolean.transform.js';
+import { ToNumericEnum } from '../../../../utils/transforms/numericEnum.transform.js';
 
 export class QueryTransaction {
   id: number;
@@ -67,6 +68,7 @@ export class QueryTransaction {
 
 export class QueryGetAllTransactions {
   @ApiPropertyOptional()
+  @ToNumericEnum()
   typeOperation?: TypeCustomerProviderOperation;
 
   @ApiPropertyOptional()

package/ts/types/Interface/api/acd/ExportRefreshFailures.ts

@@ -0,0 +1,15 @@
+import { ApiPropertyOptional } from '@nestjs/swagger';
+import { ArrayUnique, IsArray, IsInt, IsOptional, IsPositive } from 'class-validator';
+
+export class ExportAcdRefreshFailures {
+  @ApiPropertyOptional({
+    type: [Number],
+    description: 'Connecteurs ACD à tester. Sans valeur, tous les connecteurs ACD sont testés.',
+  })
+  @IsOptional()
+  @IsArray()
+  @ArrayUnique()
+  @IsInt({ each: true })
+  @IsPositive({ each: true })
+  idConnectors?: number[];
+}

package/ts/types/Interface/api/adjustment/Create.ts

@@ -1,9 +1,11 @@
 import { IsNumber, IsOptional } from 'class-validator';
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
 import { AdjustmentTypeId } from '../../../Enum/AdjustmentType.js';
+import { ToNumericEnum } from '../../../../utils/transforms/numericEnum.transform.js';
 
 export class UpdateOrCreateAdjustment {
   @ApiProperty()
+  @ToNumericEnum()
   @IsNumber()
   idAdjustmentType: AdjustmentTypeId;
 

package/ts/types/Interface/api/appointment/Appointment.ts

@@ -2,6 +2,7 @@ import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
 import { IsDate, IsInt, IsOptional, IsString, MaxLength } from 'class-validator';
 import type { TimeSlots } from '../workingSchedule/QueryDailyHour.js';
 import { TimeSlot } from '../../../Enum/TimeSlot.js';
+import { ToNumericEnum } from '../../../../utils/transforms/numericEnum.transform.js';
 
 export interface AppointmentSession {
   token: string;
@@ -15,6 +16,7 @@ export class CreateAppointmentLink {
   idSociety: number;
 
   @ApiPropertyOptional({ enum: TimeSlot })
+  @ToNumericEnum()
   @IsOptional()
   @IsInt()
   idType?: TimeSlot;

package/ts/types/Interface/api/authentification/ExchangeExternalAuthenticationLink.ts

@@ -1,15 +1,19 @@
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-import { IsOptional, IsString, Length, Matches } from 'class-validator';
+import { IsOptional, IsString, Matches } from 'class-validator';
+
+// Legacy society externalId (UUID) is temporarily accepted until internal apps are migrated to link secrets.
+const EXTERNAL_AUTHENTICATION_TOKEN_PATTERN =
+  /^(?:[A-Za-z0-9_-]{43}|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$/i;
 
 export class ExchangeExternalAuthenticationLink {
   @ApiProperty({
-    description: 'Secret base64url du lien de connexion',
-    minLength: 43,
+    description:
+      'Secret base64url du lien de connexion (43 caractères) ou, temporairement, externalId de la société (UUID, déprécié)',
+    minLength: 36,
     maxLength: 43,
   })
   @IsString()
-  @Length(43, 43)
-  @Matches(/^[A-Za-z0-9_-]{43}$/)
+  @Matches(EXTERNAL_AUTHENTICATION_TOKEN_PATTERN)
   token: string;
 
   @ApiPropertyOptional()

package/ts/types/Interface/api/balanceSheet/UpdateBalanceSheet.ts

@@ -1,6 +1,7 @@
 import { IsDate, IsNumber, IsOptional, IsString } from 'class-validator';
 import { ApiPropertyOptional } from '@nestjs/swagger';
 import { BalanceSheetState } from '../../../Enum/BalanceSheet.js';
+import { ToNumericEnum } from '../../../../utils/transforms/numericEnum.transform.js';
 
 export class UpdateBalanceSheet {
   @ApiPropertyOptional()
@@ -39,6 +40,7 @@ export class UpdateBalanceSheet {
   idFile?: number;
 
   @ApiPropertyOptional()
+  @ToNumericEnum()
   @IsNumber()
   @IsOptional()
   state?: BalanceSheetState;

package/ts/types/Interface/api/bankAccount/Create.ts

@@ -1,9 +1,11 @@
 import { IsInt, IsString, IsDateString, IsOptional } from 'class-validator';
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
 import { BankAccountType } from '../../../Enum/BankAccountType.js';
+import { ToNumericEnum } from '../../../../utils/transforms/numericEnum.transform.js';
 
 export class CreateBankAccount {
   @ApiProperty()
+  @ToNumericEnum()
   @IsInt()
   idBankAccountType: BankAccountType;
 

package/ts/types/Interface/api/bankAccount/Query.ts

@@ -2,6 +2,7 @@ import { IsBoolean, IsNumber, IsOptional, IsString, IsInt, IsEnum, IsDateString
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
 import { PartnerTransactionType } from '../../../Enum/PartnerTransactionType.js';
 import { ToBoolean } from '../../../../utils/transforms/boolean.transform.js';
+import { ToNumericEnum } from '../../../../utils/transforms/numericEnum.transform.js';
 import { Nature } from '../../../Enum/Nature.js';
 import { BankAccountType } from '../../../Enum/BankAccountType.js';
 
@@ -47,6 +48,7 @@ export class QueryTransactionsForComparisonPaginated {
   descending?: boolean;
 
   @ApiPropertyOptional()
+  @ToNumericEnum()
   @IsOptional()
   filterByType?: Nature;
 
@@ -80,6 +82,7 @@ export class QueryBankAccount {
   idBankAccountType?: number;
 
   @ApiPropertyOptional()
+  @ToNumericEnum()
   @IsOptional()
   @IsInt()
   @IsEnum(PartnerTransactionType)

package/ts/types/Interface/api/calendarEvent/createCalendarEventForUsers.ts

@@ -1,6 +1,7 @@
 import { IsBoolean, IsEnum, IsOptional } from 'class-validator';
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
 import { ToBoolean } from '../../../../utils/transforms/boolean.transform.js';
+import { ToNumericEnum } from '../../../../utils/transforms/numericEnum.transform.js';
 import { TimeSlot } from '../../../Enum/TimeSlot.js';
 
 export class CreateCalendarEventForUsers {
@@ -72,6 +73,7 @@ export class CreateCalendarEventForUsers {
   hasToConfirmRdvOnboardingToCustomer: boolean;
 
   @ApiPropertyOptional()
+  @ToNumericEnum()
   @IsOptional()
   @IsEnum(TimeSlot)
   idTimeSlot?: TimeSlot;

package/ts/types/Interface/api/card/UpdateCard.ts

@@ -1,13 +1,16 @@
 import { IsEnum, IsInt, IsOptional, IsString } from 'class-validator';
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
 import { CardState, CardType, TransactionRangeFilter } from '../../../Enum/Card.js';
+import { ToNumericEnum } from '../../../../utils/transforms/numericEnum.transform.js';
 
 export class AssignCard {
   @ApiProperty()
+  @ToNumericEnum()
   @IsEnum(CardType)
   type: CardType;
 
   @ApiPropertyOptional()
+  @ToNumericEnum()
   @IsOptional()
   @IsEnum(TransactionRangeFilter)
   transactionRangeFilter?: TransactionRangeFilter;
@@ -15,6 +18,7 @@ export class AssignCard {
 
 export class UpdateCardV2 {
   @ApiPropertyOptional()
+  @ToNumericEnum()
   @IsOptional()
   @IsEnum(CardState)
   state?: CardState;

package/ts/types/Interface/api/cashAndExpense/Create.ts

@@ -5,6 +5,7 @@ import { FormEntry } from '../accountingEntry/AnnotateAccountingTransaction.js';
 import { type TFile } from '../file/TFile.js';
 import { AccountingJournal } from '../../../Enum/AccountingJournal.js';
 import { ToBoolean } from '../../../../utils/transforms/boolean.transform.js';
+import { ToNumericEnum } from '../../../../utils/transforms/numericEnum.transform.js';
 
 export class CreateCashDesk {
   @ApiProperty()
@@ -19,6 +20,7 @@ export class CreateCashAndExpenseTransaction {
   dateValue: string;
 
   @ApiProperty()
+  @ToNumericEnum()
   idAccountingJournal: AccountingJournal;
 
   @ApiProperty()
@@ -29,6 +31,7 @@ export class CreateCashAndExpenseTransaction {
   idSocietyPartner?: number;
 
   @ApiPropertyOptional()
+  @ToNumericEnum()
   @IsOptional()
   cashDeskTransactionType?: CashDeskTransactionType;
 

package/ts/types/Interface/api/checklist/Query.ts

@@ -12,6 +12,7 @@ import {
 } from 'class-validator';
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
 import { ToBoolean } from '../../../../utils/transforms/boolean.transform.js';
+import { ToNumericEnum } from '../../../../utils/transforms/numericEnum.transform.js';
 import { ChecklistTypeEnum } from '../../../Enum/ChecklistType.js';
 import { IChecklistDetail } from '../../models/IChecklistDetail.js';
 import { IChecklistType } from '../../models/IChecklistType.js';
@@ -150,6 +151,7 @@ export class QueryChecklistGetStats {
 
 export class QueryGetAllQuestions {
   @ApiPropertyOptional()
+  @ToNumericEnum()
   @IsOptional()
   @IsEnum(ChecklistTypeEnum)
   type?: ChecklistTypeEnum;

package/ts/types/Interface/api/checklist/Update.ts

@@ -3,6 +3,7 @@ import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
 import { ChecklistDetailValue, ChecklistTypeEnum } from '../../../Enum/ChecklistType.js';
 import { IChecklist } from '../../models/IChecklist.js';
 import { ToBoolean } from '../../../../utils/transforms/boolean.transform.js';
+import { ToNumericEnum } from '../../../../utils/transforms/numericEnum.transform.js';
 
 export class UpdateAnswer {
   @ApiProperty()
@@ -10,6 +11,7 @@ export class UpdateAnswer {
   name: string;
 
   @ApiProperty()
+  @ToNumericEnum()
   @IsEnum(ChecklistDetailValue)
   value: ChecklistDetailValue;
 }
@@ -42,6 +44,7 @@ export class UpdateChecklist implements Partial<IChecklist> {
   isConfirmed?: boolean;
 
   @ApiPropertyOptional()
+  @ToNumericEnum()
   @IsOptional()
   @IsEnum(ChecklistTypeEnum)
   type?: ChecklistTypeEnum;

package/ts/types/Interface/api/collaboraterDetail/CreateCollaboraterDetail.ts

@@ -4,6 +4,7 @@ import { ICollaboraterDetail } from '../../models/ICollaboraterDetail.js';
 import { MaritalStatus } from '../../../Enum/MaritalStatus.js';
 import { CountryId, NationalityId } from '../../../Enum/Country.js';
 import { ToBoolean } from '../../../../utils/transforms/boolean.transform.js';
+import { ToNumericEnum } from '../../../../utils/transforms/numericEnum.transform.js';
 import { EnglishLevel } from '../../../Enum/EnglishLevel.js';
 
 export class CreateCollaboraterDetail implements Omit<ICollaboraterDetail, 'id'> {
@@ -12,14 +13,17 @@ export class CreateCollaboraterDetail implements Omit<ICollaboraterDetail, 'id'>
   idUser: number;
 
   @ApiProperty()
+  @ToNumericEnum()
   @IsEnum(MaritalStatus)
   idMaritalStatus: MaritalStatus;
 
   @ApiProperty()
+  @ToNumericEnum()
   @IsEnum(NationalityId)
   idNationality: NationalityId;
 
   @ApiProperty()
+  @ToNumericEnum()
   @IsEnum(CountryId)
   idCountryOfBirth: CountryId;
 

package/ts/types/Interface/api/commercialManagement/Create.ts

@@ -28,6 +28,7 @@ import { ISocietyGescom } from '../../models/ISocietyGescom.js';
 import { IThirdParty } from '../../models/IThirdParty.js';
 import { IEstimateInvoice } from '../../models/IEstimateInvoice.js';
 import { ToBoolean } from '../../../../utils/transforms/boolean.transform.js';
+import { ToNumericEnum } from '../../../../utils/transforms/numericEnum.transform.js';
 
 export type IProductInvoiceToCreate = IProductInvoice & { save?: boolean };
 
@@ -220,6 +221,7 @@ export class CreateCommercialSetting {
   areColumnsSeparationHidden?: boolean;
 
   @ApiPropertyOptional()
+  @ToNumericEnum()
   @IsOptional()
   accountingCategory?: AccountingCategoryId;
 
@@ -504,9 +506,11 @@ export class CommercialDocumentInputs {
   isDraft: boolean;
 
   @ApiProperty()
+  @ToNumericEnum()
   idEstimateInvoiceType: EstimateInvoiceType;
 
   @ApiProperty()
+  @ToNumericEnum()
   accountingCategory: AccountingCategoryId;
 
   @ApiProperty()
@@ -735,6 +739,7 @@ export class CreateSaleDocumentTemplate {
   template: CreateInvoiceDocument | CreatePreSaleDocument;
 
   @ApiProperty()
+  @ToNumericEnum()
   @IsEnum(EstimateInvoiceType)
   idEstimateInvoiceType: EstimateInvoiceType;
 

package/ts/types/Interface/api/commercialManagement/Query.ts

@@ -2,6 +2,7 @@ import { IsArray, IsBoolean, IsDateString, IsInt, IsNumber, IsOptional, IsString
 import { EInvoicingStatusCode, Order } from '../../../index.js';
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
 import { ToBoolean } from '../../../../utils/transforms/boolean.transform.js';
+import { ToNumericEnum } from '../../../../utils/transforms/numericEnum.transform.js';
 import { DiscountType, EstimateStatus, InvoiceStatus } from '../../../Enum/CommercialManagement.js';
 import { EstimateInvoiceType } from '../../../Enum/EstimateInvoice.js';
 import { QueryPaginate } from '../BasePaginate.js';
@@ -67,6 +68,7 @@ export interface ParamPaginatedInvoices {
 
 export class QueryGetDefaultPayload {
   @ApiProperty()
+  @ToNumericEnum()
   @IsNumber()
   idEstimateInvoiceType: EstimateInvoiceType;
 
@@ -77,6 +79,7 @@ export class QueryGetDefaultPayload {
 
 export class QueryNextReference {
   @ApiProperty()
+  @ToNumericEnum()
   idEstimateInvoiceType: EstimateInvoiceType;
 
   @ApiPropertyOptional()
@@ -93,6 +96,7 @@ export interface Discount {
 
 export class QueryPreviewDocument {
   @ApiProperty()
+  @ToNumericEnum()
   idEstimateInvoiceType: EstimateInvoiceType;
 }