@djust-b2b/djust-front-sdk 2.1.1 → 2.3.0

package/lib/services/customer-account/index.d.ts

@@ -48,7 +48,7 @@ export declare function getCustomerAccountV2(pageable: PageableParameters): Prom
  *
  * This function allows the creation of a new customer account with relevant details including addresses, user information, and custom fields.
  *
- * 🛠 **Endpoint**: `POST /v1/shop/customer-accounts`
+ * 🛠 **Endpoint**: `POST /v1/shop/customer-accounts` [ACCOUNT-100]
  *
  * | Parameter                        | Type                           | Required | Description |
  * |-----------------------------------|--------------------------------|----------|-------------|
@@ -58,82 +58,59 @@ export declare function getCustomerAccountV2(pageable: PageableParameters): Prom
  * | `customFieldValues`               | `object[]`                     | ✅        | List of custom fields with their `customFieldId` and `customFieldValue`. |
  * | `customerTagList`                 | `string[]`                     | ✅        | List of customer tags. |
  * | `fromFO`                          | `boolean`                      | ✅        | Flag indicating if the account is created from the front-office (FO). |
- * | `legalUser`                       | `object[]`                     | ✅        | Information about the legal user including `birthday`, `countryOfResidence`, `email`, `firstName`, `lastName`, and `nationality`. |
-
+ * | `legalUser`                       | `object`                     | ✅        | Information about the legal user including `birthday`, `countryOfResidence`, `email`, `firstName`, `lastName`, and `nationality`. |
+ *
  * 📤 **Returns**:
  * A `Promise<CreateCustomerAccountResponse>` containing the details of the created customer account.
  *
  * 🛠 **Example usage**:
  * ```ts
  * const response = await createCustomerAccount({
- *    createAddressRequests: [
- *      {
- *        additionalAddress: "string",
- *        address: "string",
- *        billing: true,
- *        city: "string",
- *        company: "string",
- *        country: "string",
- *        externalId: "string",
- *        fullName: "string",
- *        id: "string",
- *        label: "string",
- *        phone: "string",
- *        shipping: true,
- *        state: "string",
- *        zipcode: "string"
- *      }
- *    ],
- *    createCustomerUserRequest: {
- *      civility: "MR",
- *      email: "string",
- *      customFieldValues: [
- *        {
- *          customFieldId: 'string',
- *          customFieldValue: 'string'
- *        }
- *      ],
- *      externalId: "string",
- *      firstName: "string",
- *      groups: ["group1", "group2"],
- *      lastName: "string",
- *      mainOrganisationsId: "orgId",
- *      mainSubOrganisationsId: "subOrgId",
- *      organisationsIds: ['orgId1', 'orgId2'],
- *      password: "password123",
- *      phone: "123456789",
- *      subOrganisationsIds: ['subOrgId1', 'subOrgId2']
- *    },
- *    createObjectCustomerAccountRequest: {
- *      accountManager: "string",
- *      businessRegistrationNumber: "string",
- *      companyRegistrationName: "string",
- *      externalId: "string",
- *      name: "string",
- *      vatNumber: "string",
- *      website: "string"
- *    },
- *    customFieldValues: [
- *      {
- *        customFieldId: "string",
- *        customFieldValue: "value"
- *      }
- *    ],
- *    customerTagList: ["tag1", "tag2"],
- *    fromFO: true,
- *    legalUser: [
- *      {
- *        birthday: "2024-12-11T09:46:27.656Z",
- *        countryOfResidence: "FR",
- *        email: "user@example.com",
- *        firstName: "John",
- *        id: "userId",
- *        lastName: "Doe",
- *        nationality: "FR"
- *      }
- *    ],
+ *   createAddressRequests: [
+ *     {
+ *       address: "123 Main Street",
+ *       city: "Paris",
+ *       country: "FR",
+ *       billing: true,
+ *       shipping: true,
+ *       fullName: "John Doe",
+ *       zipcode: "75001"
+ *     }
+ *   ],
+ *   createCustomerUserRequest: {
+ *     email: "john.doe@example.com",
+ *     firstName: "John",
+ *     lastName: "Doe",
+ *     password: "securePassword123",
+ *     phone: "+33123456789"
+ *   },
+ *   createObjectCustomerAccountRequest: {
+ *     name: "Acme Corporation",
+ *     externalId: "acme-corp-001",
+ *     vatNumber: "FR12345678901"
+ *   },
+ *   customFieldValues: [
+ *     {
+ *       customFieldId: "industry",
+ *       customFieldValue: "technology"
+ *     }
+ *   ],
+ *   customerTagList: ["premium", "enterprise"],
+ *   fromFO: true,
+ *   legalUser: {
+ *     birthday: "1990-01-01T00:00:00.000Z",
+ *     countryOfResidence: "FR",
+ *     email: "john.doe@example.com",
+ *     firstName: "John",
+ *     lastName: "Doe",
+ *     nationality: "FR"
+ *   }
  * });
  * ```
+ *
+ * @param {CreateCustomerAccountParameters} params - The parameters for creating a customer account
+ * @throws {Error} If required parameters are missing
+ * @returns {Promise<CreateCustomerAccountResponse>} A promise resolving to the response containing the created customer account
  */
 export declare function createCustomerAccount({ createAddressRequests, createCustomerUserRequest, createObjectCustomerAccountRequest, customFieldValues, customerTagList, fromFO, legalUser, ...config }: CreateCustomerAccountParameters & DjustConfig): Promise<CreateCustomerAccountResponse>;
 /**
@@ -291,7 +268,7 @@ export declare function updateCustomerAccountAddress({ addressId, additionalAddr
  *
  * This function retrieves custom fields for a customer account.
  *
- * 🛠 **Endpoint**: `GET /v1/shop/customer-accounts/custom-fields`
+ * 🛠 **Endpoint**: `GET /v1/shop/customer-accounts/custom-fields` [ACCOUNT-554]
  *
  * | **Parameter**        | **Type**   | **Required** | **Description**                                                           |
  * |----------------------|------------|--------------|---------------------------------------------------------------------------|

package/lib/services/customer-account/index.js

@@ -88,7 +88,7 @@ async function getCustomerAccountV2(pageable) {
  *
  * This function allows the creation of a new customer account with relevant details including addresses, user information, and custom fields.
  *
- * 🛠 **Endpoint**: `POST /v1/shop/customer-accounts`
+ * 🛠 **Endpoint**: `POST /v1/shop/customer-accounts` [ACCOUNT-100]
  *
  * | Parameter                        | Type                           | Required | Description |
  * |-----------------------------------|--------------------------------|----------|-------------|
@@ -98,82 +98,59 @@ async function getCustomerAccountV2(pageable) {
  * | `customFieldValues`               | `object[]`                     | ✅        | List of custom fields with their `customFieldId` and `customFieldValue`. |
  * | `customerTagList`                 | `string[]`                     | ✅        | List of customer tags. |
  * | `fromFO`                          | `boolean`                      | ✅        | Flag indicating if the account is created from the front-office (FO). |
- * | `legalUser`                       | `object[]`                     | ✅        | Information about the legal user including `birthday`, `countryOfResidence`, `email`, `firstName`, `lastName`, and `nationality`. |
-
+ * | `legalUser`                       | `object`                     | ✅        | Information about the legal user including `birthday`, `countryOfResidence`, `email`, `firstName`, `lastName`, and `nationality`. |
+ *
  * 📤 **Returns**:
  * A `Promise<CreateCustomerAccountResponse>` containing the details of the created customer account.
  *
  * 🛠 **Example usage**:
  * ```ts
  * const response = await createCustomerAccount({
- *    createAddressRequests: [
- *      {
- *        additionalAddress: "string",
- *        address: "string",
- *        billing: true,
- *        city: "string",
- *        company: "string",
- *        country: "string",
- *        externalId: "string",
- *        fullName: "string",
- *        id: "string",
- *        label: "string",
- *        phone: "string",
- *        shipping: true,
- *        state: "string",
- *        zipcode: "string"
- *      }
- *    ],
- *    createCustomerUserRequest: {
- *      civility: "MR",
- *      email: "string",
- *      customFieldValues: [
- *        {
- *          customFieldId: 'string',
- *          customFieldValue: 'string'
- *        }
- *      ],
- *      externalId: "string",
- *      firstName: "string",
- *      groups: ["group1", "group2"],
- *      lastName: "string",
- *      mainOrganisationsId: "orgId",
- *      mainSubOrganisationsId: "subOrgId",
- *      organisationsIds: ['orgId1', 'orgId2'],
- *      password: "password123",
- *      phone: "123456789",
- *      subOrganisationsIds: ['subOrgId1', 'subOrgId2']
- *    },
- *    createObjectCustomerAccountRequest: {
- *      accountManager: "string",
- *      businessRegistrationNumber: "string",
- *      companyRegistrationName: "string",
- *      externalId: "string",
- *      name: "string",
- *      vatNumber: "string",
- *      website: "string"
- *    },
- *    customFieldValues: [
- *      {
- *        customFieldId: "string",
- *        customFieldValue: "value"
- *      }
- *    ],
- *    customerTagList: ["tag1", "tag2"],
- *    fromFO: true,
- *    legalUser: [
- *      {
- *        birthday: "2024-12-11T09:46:27.656Z",
- *        countryOfResidence: "FR",
- *        email: "user@example.com",
- *        firstName: "John",
- *        id: "userId",
- *        lastName: "Doe",
- *        nationality: "FR"
- *      }
- *    ],
+ *   createAddressRequests: [
+ *     {
+ *       address: "123 Main Street",
+ *       city: "Paris",
+ *       country: "FR",
+ *       billing: true,
+ *       shipping: true,
+ *       fullName: "John Doe",
+ *       zipcode: "75001"
+ *     }
+ *   ],
+ *   createCustomerUserRequest: {
+ *     email: "john.doe@example.com",
+ *     firstName: "John",
+ *     lastName: "Doe",
+ *     password: "securePassword123",
+ *     phone: "+33123456789"
+ *   },
+ *   createObjectCustomerAccountRequest: {
+ *     name: "Acme Corporation",
+ *     externalId: "acme-corp-001",
+ *     vatNumber: "FR12345678901"
+ *   },
+ *   customFieldValues: [
+ *     {
+ *       customFieldId: "industry",
+ *       customFieldValue: "technology"
+ *     }
+ *   ],
+ *   customerTagList: ["premium", "enterprise"],
+ *   fromFO: true,
+ *   legalUser: {
+ *     birthday: "1990-01-01T00:00:00.000Z",
+ *     countryOfResidence: "FR",
+ *     email: "john.doe@example.com",
+ *     firstName: "John",
+ *     lastName: "Doe",
+ *     nationality: "FR"
+ *   }
  * });
  * ```
+ *
+ * @param {CreateCustomerAccountParameters} params - The parameters for creating a customer account
+ * @throws {Error} If required parameters are missing
+ * @returns {Promise<CreateCustomerAccountResponse>} A promise resolving to the response containing the created customer account
  */
 async function createCustomerAccount({ createAddressRequests, createCustomerUserRequest, createObjectCustomerAccountRequest, customFieldValues, customerTagList, fromFO, legalUser, ...config }) {
     (0, parameters_validation_1.required)({
@@ -419,7 +396,7 @@ async function updateCustomerAccountAddress({ addressId, additionalAddress, addr
  *
  * This function retrieves custom fields for a customer account.
  *
- * 🛠 **Endpoint**: `GET /v1/shop/customer-accounts/custom-fields`
+ * 🛠 **Endpoint**: `GET /v1/shop/customer-accounts/custom-fields` [ACCOUNT-554]
  *
  * | **Parameter**        | **Type**   | **Required** | **Description**                                                           |
  * |----------------------|------------|--------------|---------------------------------------------------------------------------|

package/lib/services/incident/definitions.d.ts

@@ -12,6 +12,7 @@ export interface getIncidentsParameters {
     page: number;
     size: number;
     sort: String[];
+    supplierIds?: String[];
 }
 export interface getIncidentParameters {
     incidentId: string;

package/lib/services/incident/index.d.ts

@@ -4,7 +4,7 @@ import { getIncidentsParameters, getIncidentParameters, createOrderLogisticIncid
  *
  * This function allows you to fetch incidents with detailed filtering options, such as customer account IDs, status, and sorting preferences.
  *
- * 🛠 **Endpoint**: `GET /v1/shop/incidents [ORDER-559]`
+ * 🛠 **Endpoint**: `GET /v1/shop/incidents`
  *
  * | Parameter             | Type               | Required | Description                                                                 |
  * |-----------------------|--------------------|----------|-----------------------------------------------------------------------------|
@@ -221,3 +221,43 @@ export declare function createOrderLogisticIncidentThread({ logisticOrderId, inc
  * @returns {Promise<createIncidentResponse>} A promise that resolves to the created incident details.
  */
 export declare function createIncident({ customField, externalId, logisticOrderId, reasonCodes, idType, }: createIncidentParameters): Promise<createIncidentResponse>;
+/**
+ * 🚚 Retrieves a list of incidents based on various filter criteria.
+ *
+ * This function allows you to fetch incidents with detailed filtering options, such as customer account IDs, supplier IDs, status, and sorting preferences.
+ *
+ * 🛠 **Endpoint**: `GET /v2/shop/incidents` [ORDER-559]
+ *
+ * | Parameter             | Type               | Required | Description                                                                 |
+ * |-----------------------|--------------------|----------|-----------------------------------------------------------------------------|
+ * | `customerAccountIds`  | `string[]`        | ❌       | List of customer account IDs to filter incidents by.                       |
+ * | `linkedType`          | `string`          | ✅       | Type of entity linked to the incident (e.g., ORDER or ORDER_LINES).     |
+ * | `ids`                 | `string[]`        | ❌       | Specific incident IDs to retrieve.                                         |
+ * | `status`              | `IncidentStatus[]`| ❌       | List of statuses to filter incidents by (e.g., OPEN, ON_GOING, CLOSED).              |
+ * | `idType`              | `IncidentIdType`  | ❌       | Type of ID used for filtering (e.g., DJUST_ID, EXTERNAL_ID).                  |
+ * | `page`                | `number`          | ❌       | Page number for paginated results (starting at 0).                         |
+ * | `size`                | `number`          | ❌       | Number of incidents per page.                                              |
+ * | `sort`                | `string[]`        | ❌       | Sorting criteria in the format `field,(asc|desc)` (e.g., `status,desc`).   |
+ * | `supplierIds`         | `string[]`        | ❌       | List of supplier IDs to filter incidents by.                               |
+ *
+ * 📤 **Returns**:
+ * A `Promise<getIncidentsResponse>` containing a paginated list of incidents matching the filter criteria.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const incidents = await getIncidentsV2({
+ *   customerAccountIds: ["acc123", "acc456"],
+ *   linkedType: "ORDER",
+ *   status: ["OPEN", "ON_GOING"],
+ *   supplierIds: ["supplier1", "supplier2"],
+ *   page: 0,
+ *   size: 10,
+ *   sort: ["createdAt,desc"],
+ * });
+ * ```
+ *
+ * @param {getIncidentsParameters} params - The parameters for filtering and retrieving incidents.
+ * @throws {Error} If the required `linkedType` is missing.
+ * @returns {Promise<getIncidentsResponse>} A promise that resolves to a response object containing the incidents.
+ */
+export declare function getIncidentsV2({ customerAccountIds, linkedType, ids, status, idType, page, size, sort, supplierIds, }: getIncidentsParameters): Promise<getIncidentsResponse>;

package/lib/services/incident/index.js

@@ -6,6 +6,7 @@ exports.createOrderLogisticIncident = createOrderLogisticIncident;
 exports.createOrderLogisticLineIncident = createOrderLogisticLineIncident;
 exports.createOrderLogisticIncidentThread = createOrderLogisticIncidentThread;
 exports.createIncident = createIncident;
+exports.getIncidentsV2 = getIncidentsV2;
 const parameters_validation_1 = require("../../helpers/parameters-validation");
 const fetch_instance_1 = require("../../settings/fetch-instance");
 /**
@@ -13,7 +14,7 @@ const fetch_instance_1 = require("../../settings/fetch-instance");
  *
  * This function allows you to fetch incidents with detailed filtering options, such as customer account IDs, status, and sorting preferences.
  *
- * 🛠 **Endpoint**: `GET /v1/shop/incidents [ORDER-559]`
+ * 🛠 **Endpoint**: `GET /v1/shop/incidents`
  *
  * | Parameter             | Type               | Required | Description                                                                 |
  * |-----------------------|--------------------|----------|-----------------------------------------------------------------------------|
@@ -318,3 +319,61 @@ async function createIncident({ customField, externalId, logisticOrderId, reason
     });
     return data;
 }
+/**
+ * 🚚 Retrieves a list of incidents based on various filter criteria.
+ *
+ * This function allows you to fetch incidents with detailed filtering options, such as customer account IDs, supplier IDs, status, and sorting preferences.
+ *
+ * 🛠 **Endpoint**: `GET /v2/shop/incidents` [ORDER-559]
+ *
+ * | Parameter             | Type               | Required | Description                                                                 |
+ * |-----------------------|--------------------|----------|-----------------------------------------------------------------------------|
+ * | `customerAccountIds`  | `string[]`        | ❌       | List of customer account IDs to filter incidents by.                       |
+ * | `linkedType`          | `string`          | ✅       | Type of entity linked to the incident (e.g., ORDER or ORDER_LINES).     |
+ * | `ids`                 | `string[]`        | ❌       | Specific incident IDs to retrieve.                                         |
+ * | `status`              | `IncidentStatus[]`| ❌       | List of statuses to filter incidents by (e.g., OPEN, ON_GOING, CLOSED).              |
+ * | `idType`              | `IncidentIdType`  | ❌       | Type of ID used for filtering (e.g., DJUST_ID, EXTERNAL_ID).                  |
+ * | `page`                | `number`          | ❌       | Page number for paginated results (starting at 0).                         |
+ * | `size`                | `number`          | ❌       | Number of incidents per page.                                              |
+ * | `sort`                | `string[]`        | ❌       | Sorting criteria in the format `field,(asc|desc)` (e.g., `status,desc`).   |
+ * | `supplierIds`         | `string[]`        | ❌       | List of supplier IDs to filter incidents by.                               |
+ *
+ * 📤 **Returns**:
+ * A `Promise<getIncidentsResponse>` containing a paginated list of incidents matching the filter criteria.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const incidents = await getIncidentsV2({
+ *   customerAccountIds: ["acc123", "acc456"],
+ *   linkedType: "ORDER",
+ *   status: ["OPEN", "ON_GOING"],
+ *   supplierIds: ["supplier1", "supplier2"],
+ *   page: 0,
+ *   size: 10,
+ *   sort: ["createdAt,desc"],
+ * });
+ * ```
+ *
+ * @param {getIncidentsParameters} params - The parameters for filtering and retrieving incidents.
+ * @throws {Error} If the required `linkedType` is missing.
+ * @returns {Promise<getIncidentsResponse>} A promise that resolves to a response object containing the incidents.
+ */
+async function getIncidentsV2({ customerAccountIds, linkedType, ids, status, idType, page, size, sort, supplierIds, }) {
+    (0, parameters_validation_1.required)({ linkedType });
+    const { data } = await (0, fetch_instance_1.enhancedFetch)({
+        method: "GET",
+        path: `/v2/shop/incidents`,
+        params: {
+            customerAccountIds,
+            linkedType,
+            ids,
+            status,
+            idType,
+            page,
+            size,
+            sort,
+            supplierIds,
+        },
+    });
+    return data;
+}

package/lib/services/offer-prices/__mocks__/offer-prices.mocks.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Mocks centralisés pour les tests du module offer-prices
+ */
+import { GetPaginatedOfferPricesParameters, GetOfferPricesResponse } from "../definitions";
+import { OfferPrice } from "../../../interfaces/models/offer";
+import { Order, PageableObject } from "../../../interfaces/models/common";
+export declare const mockProductPrices: {
+    standard: {
+        itemPrice: number;
+        unitPrice: number;
+        itemPriceTTC: number;
+        unitPriceTTC: number;
+    };
+    discounted: {
+        itemPrice: number;
+        unitPrice: number;
+        itemPriceTTC: number;
+        unitPriceTTC: number;
+    };
+};
+export declare const mockPriceRanges: {
+    single: {
+        quantity: number;
+        price: {
+            itemPrice: number;
+            unitPrice: number;
+            itemPriceTTC: number;
+            unitPriceTTC: number;
+        };
+        discountPrice: {
+            itemPrice: number;
+            unitPrice: number;
+            itemPriceTTC: number;
+            unitPriceTTC: number;
+        };
+    }[];
+    multiple: {
+        quantity: number;
+        price: {
+            itemPrice: number;
+            unitPrice: number;
+            itemPriceTTC: number;
+            unitPriceTTC: number;
+        };
+        discountPrice: {
+            itemPrice: number;
+            unitPrice: number;
+            itemPriceTTC: number;
+            unitPriceTTC: number;
+        };
+    }[];
+};
+export declare const mockOfferPrices: OfferPrice[];
+export declare const mockParameters: {
+    getPaginatedOfferPrices: {
+        valid: GetPaginatedOfferPricesParameters;
+        withPagination: GetPaginatedOfferPricesParameters;
+        withSorting: GetPaginatedOfferPricesParameters;
+        missingRequired: Partial<GetPaginatedOfferPricesParameters>;
+    };
+};
+export declare const mockPageableObject: PageableObject;
+export declare const mockOrder: Order;
+export declare const mockResponses: {
+    getPaginatedOfferPrices: {
+        success: {
+            data: GetOfferPricesResponse;
+            headers: Headers;
+            status: number;
+        };
+        empty: {
+            data: GetOfferPricesResponse;
+            headers: Headers;
+            status: number;
+        };
+        singleItem: {
+            data: GetOfferPricesResponse;
+            headers: Headers;
+            status: number;
+        };
+    };
+};
+export declare const mockErrors: {
+    networkError: Error;
+    unauthorized: Error;
+    badRequest: Error;
+    notFound: Error;
+    serverError: Error;
+    missingParameter: Error;
+};
+export declare const mockHttpErrors: {
+    400: {
+        status: number;
+        message: string;
+    };
+    401: {
+        status: number;
+        message: string;
+    };
+    404: {
+        status: number;
+        message: string;
+    };
+    500: {
+        status: number;
+        message: string;
+    };
+};