@silexpert/core 2.0.120 → 2.0.121

package/dist/server/index.d.mts

@@ -1,5 +1,5 @@
 import { t as __name } from "../rolldown-runtime-BhWHdk3m.mjs";
-import { BJ as CreateMailHeader, HJ as CreatePreSaleDocument, Uq as ReadCommercialDocumentTemplate, Wq as ReadCommercialMailTemplate, eW as IUser, sX as EstimateInvoiceType, zJ as CreateInvoiceDocument } from "../index-BvApezAZ.mjs";
+import { KJ as CreateInvoiceDocument, Xq as ReadCommercialDocumentTemplate, YJ as CreatePreSaleDocument, Zq as ReadCommercialMailTemplate, mX as EstimateInvoiceType, qJ as CreateMailHeader, sW as IUser } from "../index-CQ4tY4GS.mjs";
 import "dayjs/locale/fr.js";
 //#region ts/utils/email.d.ts
 export declare function getHoraires(user: IUser): "Du lundi au vendredi de 9h à 18h" | "Du lundi au jeudi de 9h à 17h<br/>Le vendredi de 9h à 12h";

package/package.json

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

package/ts/api/index.ts

@@ -41,11 +41,28 @@ export const Silex = (params: { url: string; loginWith?: any; setToken?: any })
     },
   });
 
+  const wrappedAxios = wrapAxios(axiosInstance);
+
+  const instantiateResource = (value: any): any => {
+    if (typeof value === 'function') {
+      return new value(wrappedAxios);
+    }
+    if (typeof value === 'object' && value !== null) {
+      return Object.entries(value).reduce(
+        (acc, [k, v]) => ({
+          ...acc,
+          [k]: instantiateResource(v),
+        }),
+        {},
+      );
+    }
+    return value;
+  };
+
   const _resources = Object.entries(resources).reduce(
     (acc, [name, value]) => ({
       ...acc,
-
-      [name]: new value(wrapAxios(axiosInstance)),
+      [name]: instantiateResource(value),
     }),
     {},
   );

package/ts/api/resources/TeamSystemSignature.ts

@@ -0,0 +1,16 @@
+import { SendTeamSystemSignature, ReadTeamSystemSignature } from '../../types/index.js';
+import { Resource } from '../Resource.js';
+
+export class TeamSystemSignature extends Resource {
+  sendForSignature(idDocument: number, payload: SendTeamSystemSignature): Promise<ReadTeamSystemSignature> {
+    return this.axios.$post(`/connectors/team-system/signatures/documents/${idDocument}/send-for-signature`, payload);
+  }
+
+  startSession(token: string): Promise<{ url: string }> {
+    return this.axios.$get(`/connectors/team-system/signatures/start-session/${token}`);
+  }
+
+  getSignatureStatus(idDocument: number): Promise<ReadTeamSystemSignature> {
+    return this.axios.$get(`/connectors/team-system/signatures/documents/${idDocument}/signature-status`);
+  }
+}

package/ts/api/resources.ts

@@ -118,6 +118,8 @@ import { Prestations } from './resources/Prestations.js';
 import { StatisticCustomerSuccess } from './resources/statistic/CustomerSuccess.js';
 import { CommercialImport } from './resources/CommercialImport.js';
 import { Team } from './resources/Team.js';
+import { TeamSystemSignature } from './resources/TeamSystemSignature.js';
+
 import { CashAndExpense } from './resources/CashAndExpense.js';
 import { Archive } from './resources/Archive.js';
 import { AccountsSector } from './resources/AccountsSectors.js';
@@ -392,6 +394,9 @@ export const resources = {
   docoon: Docoon,
   usersHistory: UsersHistory,
   acd: Acd,
+  teamSystem: {
+    signature: TeamSystemSignature,
+  },
   zendesk: Zendesk,
   formalism: Formalism,
   financialProjection: FinancialProjection,
@@ -403,3 +408,14 @@ export const resources = {
 };
 
 export * from './resources/Cache.js';
+export * from './resources/TeamSystemSignature.js';
+
+export type SilexResourceInstance<T> = T extends new (...args: any) => infer R
+  ? R
+  : T extends object
+    ? { [K in keyof T]: SilexResourceInstance<T[K]> }
+    : never;
+
+export type SilexResources = {
+  [K in keyof typeof resources]: SilexResourceInstance<(typeof resources)[K]>;
+};

package/ts/types/Enum/CustomerSignature.ts

@@ -19,6 +19,7 @@ export enum SignatureType {
   EQUIPMENT = 'equipment',
   MANDAT = 'mandat', // N'est plus utilisé, permet de distinguer les mandats signés avant ajout de la signature Clementine
   MANDAT_PA_EC = 'mandat_pa_ec',
+  COMMERCIAL_DOCUMENT = 'commercial_document',
 }
 
 export const SignatureStatusDetail = {

package/ts/types/Enum/LetterType.ts

@@ -47,4 +47,12 @@ export const LetterType = {
     id: 12,
     name: 'Bilan avec observation',
   },
+  RESIGNATION_OF_MISSION_LRAR: {
+    id: 13,
+    name: 'LRAR démission de la mission',
+  },
+  TERMINATION_MANDATE_ELECTRONIC_INVOICING: {
+    id: 14,
+    name: 'Résiliation mandat facturation électronique',
+  },
 };

package/ts/types/Enum/MealExpenseThresholds.ts

@@ -30,4 +30,8 @@ export const MealExpenseThresholds: IMealExpenseThresholds = {
     min: 5.5,
     max: 21.1,
   },
+  2026: {
+    min: 5.5,
+    max: 21.4,
+  },
 };

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

@@ -24,12 +24,12 @@ export class CreateAppointmentLink {
 
 export interface AppointmentContext {
   isProspect: boolean;
-  isSoftware: boolean;
   isInCreation: boolean;
   hasAcceptedLab: boolean;
   hasJuridicalPrestation: boolean;
   hasExpertAccountantPrestation: boolean;
   existingAppointments: Array<{ id: number; idTimeSlot: number; startDate: Date }>;
+  hasSocietyCreation: boolean;
 }
 
 export class QueryAppointmentAvailability {

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

@@ -29,6 +29,8 @@ 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';
+import { ValidateNestedArrayOf } from '../../../../utils/validators/nestedArray.validator.js';
+import { CreateProductInvoice } from './CreateProductInvoice.js';
 
 export type IProductInvoiceToCreate = IProductInvoice & { save?: boolean };
 
@@ -430,8 +432,11 @@ export class CommercialDocumentInputs {
   @ApiProperty({ description: 'Conditions de réglement' })
   termsOfPayment: string | null;
 
-  @ApiProperty()
+  @ApiProperty({ type: [CreateProductInvoice] })
   @IsArray()
+  @ValidateNestedArrayOf(CreateProductInvoice)
+  // Lines are validated as CreateProductInvoice, but stay typed as IProductInvoice because the same objects feed the
+  // document rendering helpers (ReadProductEditing) shared with the front-end apps
   products: Array<IProductInvoiceToCreate>;
 
   @ApiProperty({ description: 'Escompte' })

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

@@ -0,0 +1,60 @@
+import { IsBoolean, IsEnum, IsIn, IsInt, IsNumber, IsOptional, IsString } from 'class-validator';
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { DiscountType } from '../../../Enum/CommercialManagement.js';
+import { Vat } from '../../../Enum/Vat.js';
+import type { VatType } from '../../../Enum/Vat.js';
+import { ProductLineInputs } from '../product/ProductLineInputs.js';
+
+const VAT_IDS: number[] = (Object.values(Vat) as VatType[]).map((vat) => vat.id);
+
+export class CreateProductInvoice extends ProductLineInputs {
+  @ApiPropertyOptional({
+    description: 'Absente lorsque la société ne facture pas la TVA : la ligne est alors Hors-Taxe',
+  })
+  @IsIn(VAT_IDS)
+  @IsOptional()
+  idVat?: number | null;
+
+  @ApiProperty({ description: 'Peut être négatif (remise, avoir)' })
+  @IsNumber()
+  priceTaxExcluded: number;
+
+  @ApiProperty()
+  @IsNumber()
+  quantity: number;
+
+  @ApiPropertyOptional()
+  @IsString()
+  @IsOptional()
+  itemSaleName?: string | null;
+
+  @ApiPropertyOptional({ description: "Référence de l'article" })
+  @IsString()
+  @IsOptional()
+  itemCodeProduct?: string | null;
+
+  @ApiPropertyOptional()
+  @IsInt()
+  @IsOptional()
+  idProduct?: number | null;
+
+  @ApiPropertyOptional()
+  @IsNumber()
+  @IsOptional()
+  discount2?: number | null;
+
+  @ApiPropertyOptional({ enum: DiscountType })
+  @IsEnum(DiscountType)
+  @IsOptional()
+  discountType?: DiscountType | null;
+
+  @ApiPropertyOptional()
+  @IsInt()
+  @IsOptional()
+  reorder?: number | null;
+
+  @ApiPropertyOptional({ description: "Enregistre l'article dans le catalogue de produits" })
+  @IsBoolean()
+  @IsOptional()
+  save?: boolean;
+}

package/ts/types/Interface/api/product/CreateProduct.ts

@@ -1,10 +1,9 @@
-import { IsBoolean, IsInt, IsNumber, IsOptional, IsString, Min } from 'class-validator';
-import { ProductType, Unit } from '../../../index.js';
+import { IsBoolean, IsNumber, IsOptional, IsString, Min } from 'class-validator';
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
 import { ToBoolean } from '../../../../utils/transforms/boolean.transform.js';
-import { IsObjectId } from '../../../../utils/validators/objectId.validator.js';
+import { ProductLineInputs } from './ProductLineInputs.js';
 
-export class CreateProduct {
+export class CreateProduct extends ProductLineInputs {
   @ApiProperty()
   @IsString()
   name: string;
@@ -19,44 +18,14 @@ export class CreateProduct {
   @IsNumber()
   idVat: number;
 
-  @ApiPropertyOptional()
-  @IsNumber()
-  @IsOptional()
-  marginVatType?: number;
-
-  @ApiPropertyOptional()
-  @IsNumber()
-  @IsOptional()
-  amountOfPurchase?: number;
-
   @ApiPropertyOptional()
   @IsBoolean()
   @ToBoolean()
   @IsOptional()
   isFree?: boolean;
 
-  @ApiProperty()
-  @IsNumber()
-  @IsObjectId(Unit)
-  unit: number;
-
-  @ApiProperty()
-  @IsNumber()
-  @IsObjectId(ProductType)
-  type: number;
-
-  @ApiPropertyOptional()
-  @IsString()
-  @IsOptional()
-  comment?: string;
-
   @ApiPropertyOptional()
   @IsString()
   @IsOptional()
   codeProduct?: string;
-
-  @ApiPropertyOptional()
-  @IsInt()
-  @IsOptional()
-  idAccount?: number;
 }

package/ts/types/Interface/api/product/ProductLineInputs.ts

@@ -0,0 +1,37 @@
+import { IsInt, IsNumber, IsOptional, IsString } from 'class-validator';
+import { ProductType, Unit } from '../../../index.js';
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { IsObjectId } from '../../../../utils/validators/objectId.validator.js';
+
+// Fields shared by a catalog product and a commercial document line, validated the same way in both contexts
+export class ProductLineInputs {
+  @ApiProperty()
+  @IsNumber()
+  @IsObjectId(Unit)
+  unit: number;
+
+  @ApiProperty()
+  @IsNumber()
+  @IsObjectId(ProductType)
+  type: number;
+
+  @ApiPropertyOptional()
+  @IsNumber()
+  @IsOptional()
+  marginVatType?: number;
+
+  @ApiPropertyOptional()
+  @IsNumber()
+  @IsOptional()
+  amountOfPurchase?: number | null;
+
+  @ApiPropertyOptional()
+  @IsString()
+  @IsOptional()
+  comment?: string | null;
+
+  @ApiPropertyOptional()
+  @IsInt()
+  @IsOptional()
+  idAccount?: number | null;
+}

package/ts/types/Interface/api/refund/QueryRefundPaginated.ts

@@ -14,6 +14,11 @@ export class QueryRefundPaginated extends RequiredQueryPaginate implements Order
   @IsOptional()
   motif?: number;
 
+  @ApiPropertyOptional()
+  @IsOptional()
+  @IsInt()
+  idSociety?: number;
+
   @ApiPropertyOptional()
   @IsOptional()
   startDate?: Date;

package/ts/types/Interface/api/teamSystemSignature/ReadTeamSystemSignature.ts

@@ -0,0 +1,18 @@
+import { ApiPropertyOptional } from '@nestjs/swagger';
+
+export class ReadTeamSystemSignature {
+  @ApiPropertyOptional()
+  tsDocumentId?: string | null;
+
+  @ApiPropertyOptional()
+  tsSignStatus?: string | null;
+
+  @ApiPropertyOptional()
+  tsSignUrl?: string | null;
+
+  @ApiPropertyOptional()
+  tsSignedAt?: Date | null;
+
+  @ApiPropertyOptional()
+  success?: boolean;
+}

package/ts/types/Interface/api/teamSystemSignature/SendTeamSystemSignature.ts

@@ -0,0 +1,23 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { IsEmail, IsNotEmpty, IsString } from 'class-validator';
+
+export class SendTeamSystemSignature {
+  @ApiProperty({ description: 'Prénom du signataire' })
+  @IsString()
+  @IsNotEmpty()
+  signerFirstName: string;
+
+  @ApiProperty({ description: 'Nom du signataire' })
+  @IsString()
+  @IsNotEmpty()
+  signerLastName: string;
+
+  @ApiProperty({ description: 'Email du signataire' })
+  @IsEmail()
+  signerEmail: string;
+
+  @ApiProperty({ description: 'Numéro de téléphone du signataire' })
+  @IsString()
+  @IsNotEmpty()
+  signerPhone: string;
+}

package/ts/types/Interface/api/teamSystemSignature/index.ts

@@ -0,0 +1,2 @@
+export * from './SendTeamSystemSignature.js';
+export * from './ReadTeamSystemSignature.js';

package/ts/types/Interface/models/ICustomerSignature.ts

@@ -16,6 +16,8 @@ export class ICustomerSignature {
   tokenSigner?: string;
   mailSigner: string;
   phoneSigner: string;
+  firstNameSigner?: string | null;
+  lastNameSigner?: string | null;
   idSendMethod: number;
   idStatusSignature: number;
   idPrestation?: number | null;

package/ts/types/Interface/models/IEstimateInvoice.ts

@@ -8,6 +8,7 @@ import { IInvoiceRecurrence } from './IInvoiceRecurrence.js';
 import type { ReadEstimateInvoiceStatus } from '../api/commercialManagement/Read.js';
 import { AccountingCategoryId, InvoiceLanguage } from '../../Enum/CommercialManagement.js';
 import { IReminder } from './IReminder.js';
+import { ICustomerSignature } from './ICustomerSignature.js';
 
 // estimatesInvoices
 export class IEstimateInvoice {
@@ -57,9 +58,12 @@ export class IEstimateInvoice {
   updatedAt?: Date | null;
   deletedAt?: Date | null;
 
+  idCustomerSignature?: number | null;
+
   // Associations
   products?: IProductInvoice[];
   thirdParty?: IThirdParty;
+  signature?: ICustomerSignature | null;
   type?: IEstimateInvoiceType;
   customerPayment?: IPaymentExpectationCustomer;
   society?: ISociety;

package/ts/types/index.ts

@@ -289,6 +289,7 @@ export * from './Interface/models/IRevenueMovement.js';
 export * from './Interface/models/IRevenueSnapshot.js';
 export * from './Interface/models/IEInvoicingEligibilityRequest.js';
 export * from './Interface/models/IUsersHistory.js';
+export * from './Interface/api/teamSystemSignature/index.js';
 export * from './Interface/models/IEInvoicingKycAndMandate.js';
 export * from './Interface/models/IConnectorTracking.js';
 export * from './Interface/models/IEInvoicing.js';
@@ -894,6 +895,7 @@ export * from './Interface/api/vehicle/CreateSocietyVehicle.js';
 export * from './Interface/api/vehicle/UpdateSocietyVehicle.js';
 export * from './Interface/api/fecFile/QueryFecFile.js';
 export * from './Interface/api/product/CreateProduct.js';
+export * from './Interface/api/product/ProductLineInputs.js';
 export * from './Interface/api/product/UpdateProduct.js';
 export * from './Interface/api/product/QueryProduct.js';
 export * from './Interface/api/registration/ReadRegistration.js';
@@ -983,6 +985,7 @@ export * from './Interface/api/customerActivity/CreateCustomerActivityReport.js'
 export * from './Interface/api/customerActivity/Query.js';
 export * from './Interface/api/customerActivity/Create.js';
 export * from './Interface/api/commercialManagement/Create.js';
+export * from './Interface/api/commercialManagement/CreateProductInvoice.js';
 export * from './Interface/api/commercialManagement/Read.js';
 export * from './Interface/api/commercialManagement/Query.js';
 export * from './Interface/api/commercialManagement/Update.js';

package/ts/utils/tests/payment.spec.ts

@@ -13,7 +13,6 @@ describe('Payment', () => {
     const idSociety = 1;
     const yearlyAmountNonExpress = 1800;
     const nextYearlyAmountNonExpress = 1800;
-    const appCost = 14.9;
 
     const firstExerciceNonExpresssEndDate = dayjs().add(11, 'month').endOf('month').toDate();
     const prestationList = {
@@ -290,39 +289,6 @@ describe('Payment', () => {
     });
     // annual price increase
     // @ts-ignore
-    test('should apply annual price increase (2,75%) if signed before last 3 months of civil year', () => {
-      const mockedDate = dayjs('2024-08-15').toDate();
-      MockDate.set(mockedDate);
-
-      const newFirstExerciceNonExpresssEndDate = dayjs().add(11, 'month').endOf('month').toDate();
-
-      const payments = calculatePaymentsAuto({
-        idTypeBrand: 1,
-        firstExerciceNonExpresssEndDate: newFirstExerciceNonExpresssEndDate,
-        idPrestation,
-        prestationList,
-        idVat,
-        listPartialExercicePrestationExpress: [],
-        listRegulations: [
-          {
-            amount: 50,
-            amountUsed: 0,
-          } as IRegulation,
-        ],
-        yearlyAmountNonExpress,
-        nextYearlyAmountNonExpress,
-      });
-
-      const listNonExpressPayments = payments.filter(
-        (p) => dayjs(p.closingDate).diff(newFirstExerciceNonExpresssEndDate) === 0,
-      );
-      const firstPaymentWithTaxRateForced = listNonExpressPayments[1].amount * 1.0275;
-      // @ts-ignore
-      expect(firstPaymentWithTaxRateForced - listNonExpressPayments.splice(-2)[0].amount).toBeLessThanOrEqual(0.01); //Permet de gérer le pb d'arrondi
-
-      MockDate.reset();
-    });
-    // @ts-ignore
     test('should not apply annual price increase (2,75%) if signed in last 3 months of civil year', () => {
       const mockedDate = dayjs('2024-11-15').toDate();
       MockDate.set(mockedDate);
@@ -353,42 +319,6 @@ describe('Payment', () => {
       MockDate.reset();
     });
 
-    // @ts-ignore
-    test('should apply 14,9€ HT increase for the second exercice created (only offered on first exo) (no rules for 3 last months)', () => {
-      const mockedDate = dayjs('2024-06-15').toDate();
-      MockDate.set(mockedDate);
-
-      const newFirstExerciceNonExpresssEndDate = dayjs().add(12, 'month').endOf('month').toDate();
-
-      const payments = calculatePaymentsAuto({
-        idTypeBrand: 1,
-        firstExerciceNonExpresssEndDate: newFirstExerciceNonExpresssEndDate,
-        idPrestation,
-        prestationList,
-        idVat,
-        listPartialExercicePrestationExpress: [],
-        listRegulations: [
-          {
-            amount: 50,
-            amountUsed: 50,
-          } as IRegulation,
-        ],
-        yearlyAmountNonExpress,
-        nextYearlyAmountNonExpress,
-      });
-
-      const paymentsOfFirstExo =
-        payments.filter((p) => dayjs(p.datePayment).diff(dayjs('2025-06-01')) === 0)[0].amount ?? 0;
-      const paymentsOfSecondExo =
-        payments.filter((p) => dayjs(p.datePayment).diff(dayjs('2025-07-01')) === 0).splice(-1)[0].amount ?? 0;
-      // @ts-ignore
-      expect(
-        Math.round(100 * (paymentsOfFirstExo + getTaxesIncludedAmount(appCost, idVat) * 1.0275)) / 100,
-      ).toStrictEqual(paymentsOfSecondExo);
-
-      MockDate.reset();
-    });
-
     // misc
     // @ts-ignore
     test('should payments been generated sorted by exercices start date', () => {

package/ts/utils/validators/nestedArray.validator.ts

@@ -0,0 +1,42 @@
+import { plainToInstance } from 'class-transformer';
+import type { ClassConstructor } from 'class-transformer';
+import { registerDecorator, validateSync } from 'class-validator';
+import type { ValidationArguments, ValidationError, ValidationOptions } from 'class-validator';
+
+function getItemErrors<T extends object>(cls: ClassConstructor<T>, item: unknown): string[] {
+  if (typeof item !== 'object' || item === null) return ['must be an object'];
+
+  // Spread into a plain object: the API implicit conversion may have rebuilt the item as an Array instance
+  const errors: ValidationError[] = validateSync(plainToInstance(cls, { ...item }));
+  return errors.flatMap((error) =>
+    Object.values(error.constraints ?? {}).map((constraint) => `${error.property}: ${constraint}`),
+  );
+}
+
+// Validates each array item against `cls`. Replaces `@ValidateNested()` + `@Type()`: `@Type()` requires `reflect-metadata`
+// at runtime (breaks browser / SSR consumers), and without it the implicit conversion does not instantiate the items.
+export function ValidateNestedArrayOf<T extends object>(
+  cls: ClassConstructor<T>,
+  validationOptions?: ValidationOptions,
+) {
+  return function validator(object: object, propertyName: string) {
+    registerDecorator({
+      name: 'ValidateNestedArrayOf',
+      target: object.constructor,
+      propertyName,
+      options: validationOptions,
+      validator: {
+        validate(value: unknown) {
+          return Array.isArray(value) && value.every((item) => getItemErrors(cls, item).length === 0);
+        },
+        defaultMessage(args: ValidationArguments) {
+          if (!Array.isArray(args.value)) return `${propertyName} must be an array`;
+
+          return (args.value as unknown[])
+            .flatMap((item, index) => getItemErrors(cls, item).map((error) => `${propertyName}[${index}].${error}`))
+            .join(', ');
+        },
+      },
+    });
+  };
+}