@djust-b2b/djust-front-sdk 1.22.2 → 1.23.0

package/README.md

@@ -1,19 +1,50 @@
+# Introduction
 
-DJUST Front SDK
+**DJUST Front SDK** is a JavaScript development kit designed to simplify and optimize API calls to the DJUST backend. It offers a secure, high-performance, and ready-to-use solution for integration partners, thus facilitating the implementation of robust e-commerce solutions for your clients.
 
-Djust Team
+---
 
-DJUST Front SDK is a versatile JavaScript Software Development Kit (SDK) designed for seamless integration with DJUST's Frontend API. This SDK empowers developers by offering a collection of convenient methods for handling common data and executing essential actions required to craft engaging storefronts and streamline checkout processes.
+## 🚀 **Why use DJUST Front SDK ?**
 
-Features
-Universal Compatibility: DJUST Front SDK is built to seamlessly integrate with any JavaScript environment, making it a universal solution for frontend development.
+### **🔒 Secure API Calls**  
+Ensure secure communications between your frontend applications and the DJUST backend through integrated mechanisms for managing requests and responses.
 
-Storefront Creation: Simplify the process of creating captivating storefronts with our SDK's comprehensive set of tools. Effortlessly manage product displays, categories, and customer interactions.
+### **⚡ Performance Optimization**  
+DJUST Front SDK is designed to:
+- Minimize response times through optimized methods.
+- Efficiently manage API calls by avoiding redundancies.
 
-Checkout Flows: Enable smooth and intuitive checkout experiences with DJUST Front SDK. The SDK provides methods to handle various aspects of the checkout process, ensuring a hassle-free journey for users.
+### **🧩 A Simplified Integration**  
+- **Easy to configure** : A clear and documented API for a quick start.  
+- **Universal** : Compatible with all JavaScript environments (Vue.js, React, Nuxt, Angular, etc.).
 
-Customization: Tailor the look and feel of your storefront to match your brand identity. DJUST Front SDK offers customization options for UI elements, ensuring a cohesive and branded user experience.
+### **🔧 Flexibility and Modularity**  
+Use only the methods you need for your projects. The SDK is modular, allowing you to tailor the integration according to your clients' requirements.
 
+---
 
-License
-DJUST Front SDK is licensed under the MIT License. Feel free to use, modify, and distribute it in your projects.
+## 🛡️ **Security and Compliance**  
+
+The SDK incorporates best practices to ensure :  
+- A **secure management of authentication tokens**.  
+- Compliance with security standards to protect data exchanges.  
+- A **reliability** in requests through centralized error handling.
+
+---
+
+## 📈 **Benefits for Partners**
+
+- **Accelerate your integrations** : Save time by using a ready-to-use SDK.  
+- **Secure your projects** : Assure your clients with robust and secure backend calls.  
+- **Maximize performance** : Provide smooth experiences with fast and optimized interactions.
+
+---
+
+## 📄 **Licence**
+
+DJUST Front SDK is distributed under the **MIT license**, providing you with complete freedom to use it in your projects.
+
+
+---
+
+With **DJUST Front SDK**, simplify your backend integrations, ensure exceptional performance, and provide reliable and secure e-commerce solutions for your clients.

package/lib/{src/helpers → helpers}/parameters-validation.js

@@ -4,7 +4,7 @@ exports.oneOfRequired = exports.required = void 0;
 const required = (parameters) => {
     Object.keys(parameters).forEach((parameter) => {
         if (!parameters[parameter]) {
-            throw new Error(`[Djust SDK] '${parameter}' parameter is required`);
+            throw new Error(`'${parameter}' parameter is required`);
         }
     });
 };
@@ -13,7 +13,7 @@ const oneOfRequired = (parameters) => {
     const parametersNames = Object.keys(parameters);
     const matchingParameters = parametersNames.filter((parameter) => parameters[parameter]);
     if (matchingParameters.length !== 1) {
-        throw new Error(`[Djust SDK] Only one of ${parametersNames
+        throw new Error(`Only one of ${parametersNames
             .map((parameter) => `'${parameter}'`)
             .join(", ")} parameters is required`);
     }

package/lib/{src/index.d.ts → index.d.ts}

@@ -1,35 +1,6 @@
-import "../instrument";
 export declare const DjustSDK: {
-    initialize: (initConfig: {
-        baseUrl: string;
-        clientId: string;
-        apiKey: string;
-        timeout?: number;
-        locale?: string;
-        headers?: Headers;
-        accessToken?: string;
-        storeId?: string;
-        storeViewId?: string;
-        customerAccountId?: string;
-        clientName?: string;
-        dsn?: string;
-        env?: string;
-    }) => void;
-    updateConfiguration: (newConfig: Partial<{
-        baseUrl: string;
-        clientId: string;
-        apiKey: string;
-        timeout?: number;
-        locale?: string;
-        headers?: Headers;
-        accessToken?: string;
-        storeId?: string;
-        storeViewId?: string;
-        customerAccountId?: string;
-        clientName?: string;
-        dsn?: string;
-        env?: string;
-    }>) => void;
+    initialize: (initConfig: import("./settings/fetch-instance").ClientConfig) => void;
+    updateConfiguration: (newConfig: Partial<import("./settings/fetch-instance").ClientConfig>) => void;
     getIncidents({ customerAccountIds, linkedType, ids, status, idType, page, size, sort, }: import("./services/incident/definitions").getIncidentsParameters): Promise<import("./services/incident/definitions").getIncidentsResponse>;
     getIncident({ incidentId, idType, }: import("./services/incident/definitions").getIncidentParameters): Promise<import("./services/incident/definitions").getIncidentResponse>;
     createOrderLogisticIncident({ logisticOrderId, idType, customField, reasonCode, }: import("./services/incident/definitions").createOrderLogisticIncidentParameters): Promise<import("./services/incident/definitions").createOrderLogisticIncidentResponse>;
@@ -37,7 +8,9 @@ export declare const DjustSDK: {
     createOrderLogisticIncidentThread({ logisticOrderId, incidentId, idType, customField, message, name, reasonCode, }: import("./services/incident/definitions").createOrderLogisticIncidentThreadParameters): Promise<import("./services/incident/definitions").createOrderLogisticIncidentThreadResponse>;
     getCommercialOrders({ locale, nbPreviewLines, }: import("./interfaces").GetCommercialOrdersParameters): Promise<import("./interfaces").GetCommercialOrdersResponse>;
     createCommercialOrder({ nbPreviewLines, channel, customFields, locale, origin, originId, paymentInfo, }: import("./interfaces").CreateCommercialOrderParameters): Promise<import("./interfaces").CreateCommercialOrderResponse>;
+    createCommercialOrderV2({ customFieldIdType, customFields, }: import("./interfaces").CreateCommercialOrderV2Parameters): Promise<import("./interfaces").CreateCommercialOrderV2Response>;
     getCommercialOrder({ orderId, idType, locale, nbPreviewLines, }: import("./interfaces").GetCommercialOrderParameters): Promise<import("./interfaces").GetCommercialOrderResponse>;
+    updateCommercialOrder({ commercialOrderId, customFieldIdType, customFields, }: import("./interfaces").UpdateCommercialOrderParameters): Promise<void>;
     createCommercialOrderCardRegistration({ orderId, paymentProvider, currency, }: import("./interfaces").CreateCommercialOrderCardRegistrationParameters): Promise<import("./interfaces").CreateCommercialOrderCardRegistrationResponse>;
     updateCommercialOrderBillingInformation({ orderId, billingAddressId, }: import("./interfaces").UpdateCommercialOrderBillingInformationParameters): Promise<void>;
     setCommercialOrderStatusAsCreated({ orderId, paymentInfo, }: import("./interfaces").SetCommercialOrderStatusAsCreatedParameters): Promise<void>;
@@ -47,7 +20,11 @@ export declare const DjustSDK: {
     updateCommercialOrderShippingAddress({ orderId, shippingAddressId, }: import("./interfaces").UpdateCommercialOrderShippingAddressParameters): Promise<void>;
     updateCommercialOrderShippingInformation({ orderId, shippingAddressId, shippingType, }: import("./interfaces").UpdateCommercialOrderShippingInformationParameters): Promise<void>;
     updateCommercialOrderShippingType({ orderId, shippingType, }: import("./interfaces").UpdateCommercialOrderShippingTypeParameters): Promise<void>;
+    deleteCommercialOrder(commercialOrderId: string): Promise<void>;
+    updateCommercialOrderLines({ commercialOrderId, customFieldIdType, lineIdType, lineType, updateOrderCommercialLines, updateOrderLineIdType, updateOrderLineType, }: import("./interfaces").UpdateCommercialOrderLinesParameters): Promise<import("./interfaces").UpdateCommercialOrderLinesResponse>;
+    deleteCommercialOrderLines({ commercialOrderId, body, }: import("./interfaces").DeleteCommercialOrderLinesParameters): Promise<import("./interfaces").DeleteCommercialOrderLinesResponse>;
     getLogisticOrders({ approvalIds, locale, logisticStatus, incident, paymentOptions, nbPreviewLines, page, size, sort, }: import("./interfaces").GetLogisticOrdersParameters): Promise<import("./interfaces").GetLogisticOrdersResponse>;
+    logisticOrdersPaginatedList({ page, size, sort, nbPreviewLines, accountCustomFieldValueCriteria, approvalIds, connectedUserOnly, creationDateFrom, creationDateTo, customerAccountIds, incident, locale, logisticStatus, offerCustomFieldValueCriteria, orderLogisticCustomFieldValueCriteria, paymentOptions, supplierIds, updateDateFrom, updateDateTo, }: import("./interfaces").GetPaginatedLogisticOrdersParameters): Promise<import("./interfaces").GetPaginatedLogisticOrdersResponse>;
     getLogisticOrderCustomFields({ customFieldIds, page, size, sort, }: import("./interfaces").GetLogisticOrderCustomFieldsParameters): Promise<import("./interfaces").GetLogisticOrderCustomFieldsResponse>;
     getLogisticOrderLineCustomFields({ customFieldIds, page, size, sort, }: import("./interfaces").GetLogisticOrderLineCustomFieldsParameters): Promise<import("./interfaces").GetLogisticOrderLineCustomFieldsResponse>;
     getLogisticOrder({ orderId, locale, nbPreviewLines, }: import("./interfaces").GetLogisticOrderParameters): Promise<import("./interfaces").GetLogisticOrderResponse>;
@@ -72,6 +49,15 @@ export declare const DjustSDK: {
     updateLogisticOrderShippingInformation({ orderId, shippingAddressId, shippingType, }: import("./interfaces").UpdateLogisticOrderShippingInformationParameters): Promise<void>;
     updateLogisticOrderShippingType({ orderId, shippingType, }: import("./interfaces").UpdateLogisticOrderShippingTypeParameters): Promise<void>;
     createLogisticOrderThread({ orderId, lineId, message, reasonCode, }: import("./interfaces").CreateLogisticOrderThreadParameters): Promise<import("./interfaces").CreateLogisticOrderThreadResponse>;
+    createLogisticOrderThreadV2({ logisticOrderId, idType, message, reasonCode, }: import("./interfaces").CreateLogisticOrderThreadParametersV2): Promise<import("./interfaces").CreateLogisticOrderThreadResponseV2>;
+    getLogisticOrderThreads({ logisticOrderId, pageable, }: import("./interfaces").GetLogisticOrderThreadsParams): Promise<import("./interfaces").GetLogisticOrderThreadsResponse>;
+    getLogisticOrderThread({ logisticOrderId, threadId, }: import("./interfaces").GetLogisticOrderThreadParams): Promise<import("./interfaces").GetLogisticOrderThreadResponse>;
+    createOrderLogisticThreadMessages({ logisticOrderId, threadId, body, customField, }: import("./interfaces").CreateLogisticOrderThreadMessagesParams): Promise<import("./interfaces").CreateLogisticOrderThreadMessagesResponse>;
+    updateOrderLogisticThreadMessage({ logisticOrderId, threadId, messageId, customFieldValues, idType, }: import("./interfaces").UpdateLogisticOrderThreadMessageParams): Promise<void>;
+    createLogisticOrderIncidentThreads({ logisticOrderId, incidentId, customField, message, name, reasonCode, }: import("./interfaces").CreateLogisticOrderIncidentThreadsParams): Promise<import("./interfaces").CreateLogisticOrderIncidentThreadsResponse>;
+    getLogisticOrderIncidentThread({ logisticOrderId, incidentId, threadId, }: import("./interfaces").GetLogisticOrderIncidentThreadParams): Promise<import("./interfaces").GetLogisticOrderIncidentThreadResponse>;
+    createLogisticOrderIncidentThreadMessages({ logisticOrderId, incidentId, threadId, body, customField, }: import("./interfaces").CreateLogisticOrderIncidentThreadMessagesParams): Promise<import("./interfaces").CreateLogisticOrderIncidentThreadMessagesResponse>;
+    updateLogisticOrderIncidentThreadMessage({ logisticOrderId, incidentId, threadId, messageId, customFieldValues, idType, }: import("./interfaces").UpdateLogisticOrderIncidentThreadMessageParams): Promise<void>;
     getLogisticOrderReview({ orderId, }: import("./interfaces").GetLogisticOrderReviewParameters): Promise<import("./interfaces").GetLogisticOrderReviewResponse>;
     addLogisticOrderReview({ orderId, comment, grade, }: import("./interfaces").AddLogisticOrderReviewParameters): Promise<import("./interfaces").AddLogisticOrderReviewResponse>;
     getThreadReasonTypes(): Promise<import("./interfaces").GetThreadReasonTypesResponse>;
@@ -116,6 +102,7 @@ export declare const DjustSDK: {
     getCustomerUserOrganisations(): Promise<import("./interfaces").GetCustomerUserOrganisationsResponse>;
     sendCustomerUserActivationRequest({ redirectUrl, token, }: import("./interfaces").SendCustomerUserActivationRequestParameters): Promise<void>;
     getCustomerAccount(config?: import("./interfaces/models/common").DjustConfig): Promise<import("./interfaces").GetCustomerAccountResponse>;
+    getCustomerAccountV2(pageable: import("./interfaces/models/common").PageableParameters): Promise<import("./interfaces").GetCustomerAccountResponseV2>;
     createCustomerAccount({ createAddressRequests, createCustomerUserRequest, createObjectCustomerAccountRequest, customFieldValues, customerTagList, fromFO, legalUser, ...config }: import("./interfaces").CreateCustomerAccountParameters & import("./interfaces/models/common").DjustConfig): Promise<import("./interfaces").CreateCustomerAccountResponse>;
     updateCustomerAccount({ accountManager, businessRegistrationNumber, companyRegistrationName, customFieldValues, customerTagList, legalUser, name, vatNumber, website, ...config }: import("./interfaces").UpdateCustomerAccountParameters & import("./interfaces/models/common").DjustConfig): Promise<import("./interfaces").UpdateCustomerAccountResponse>;
     getCustomerAccountAddresses(params: import("./interfaces").GetCustomerAccountAddressesParameters & import("./interfaces/models/common").DjustConfig): Promise<import("./interfaces").GetCustomerAccountAddressesResponse>;

package/lib/{src/index.js → index.js}

@@ -37,7 +37,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DjustSDK = void 0;
-require("../instrument");
 const AuthServices = __importStar(require("./services/auth"));
 const BuyingListServices = __importStar(require("./services/buying-list"));
 const CartServices = __importStar(require("./services/cart"));
@@ -47,8 +46,8 @@ const NavigationCategoryServices = __importStar(require("./services/navigation-c
 const ProductServices = __importStar(require("./services/product"));
 const QuoteServices = __importStar(require("./services/quote"));
 const SupplierServices = __importStar(require("./services/supplier"));
-const LogisticOrderServices = __importStar(require("./services/logistic-order"));
 const CommercialOrderServices = __importStar(require("./services/commercial-order"));
+const LogisticOrderServices = __importStar(require("./services/logistic-order"));
 const IncidentServices = __importStar(require("./services/incident"));
 const fetch_instance_1 = require("./settings/fetch-instance");
 exports.DjustSDK = {

package/lib/{src/interfaces → interfaces}/models/common.d.ts

@@ -5,6 +5,7 @@ export type SortDirection = "ASC" | "DESC";
 export type NullHandling = "NATIVE" | "NULLS_FIRST" | "NULLS_LAST";
 export type ExternalSource = "MIRAKL" | "CLIENT" | "NOT_DEFINED" | "EXTERN" | "SYSTEM";
 export type Channel = "DESKTOP" | "MOBILE" | "TABLET" | "CALL_CENTER" | "UNKNOWN";
+export type IdType = "DJUST_ID" | "EXTERNAL_ID";
 export type PageableParameters = {
     page?: number;
     size?: number;
@@ -18,7 +19,7 @@ export interface PageableObject {
     sort: Order[];
     unpaged: boolean;
 }
-interface SingleWarningReportDto {
+export interface SingleWarningReportDto {
     detail: string;
     id: string;
 }
@@ -53,4 +54,3 @@ export interface DjustConfig {
     storeId?: string;
     storeViewId?: string;
 }
-export {};

package/lib/{src/interfaces → interfaces}/models/customer-user.d.ts

@@ -104,6 +104,6 @@ export interface SimpleUserView {
 export interface UserInfoDto {
     account: CustomerAccountDto;
     accounts: CustomerAccountDto[];
-    user: CustomerUserDto;
+    user: CustomerUser;
 }
 export {};

package/lib/{src/interfaces → interfaces}/models/order.d.ts

@@ -1,14 +1,16 @@
-import { CustomFieldValueObject } from "./custom-field";
+import { CustomFieldValueObject, CustomFieldValueRequest } from "./custom-field";
 import { OfferPriceType, PackingType } from "./offer";
 import { ProductMediaInfoDTO, ProductSpecification } from "./product";
 import { SupplierSnapshot } from "./supplier";
 import { AddressSnapshot } from "./address";
-import { Channel, Currency, ExternalSource, Lang, Order, PageableObject } from "./common";
+import { Channel, Country, Currency, ExternalSource, IdType, Lang, Order, PageableObject } from "./common";
 import { CustomerUserDto, CustomerUserSnapshot } from "./customer-user";
 import { PaymentOption, PaymentStatus } from "./payment";
+import { UpdateCartLineType } from "./cart";
 type OrderLogisticLinePaymentStatus = "WAITING_REFUND" | "WAITING_PARTIAL_REFUND" | "PARTIALLY_REFUNDED" | "REFUNDED";
 type OrderLineStatus = "CANCELED" | "PARTIALLY_CANCELED" | "DECLINED_BY_SUPPLIER" | "OTHER" | "DELETED";
 export type OrderLogisticStatusType = "CREATING" | "DRAFT_ORDER" | "DRAFT_ORDER_ON_HOLD" | "ORDER_CREATED" | "WAITING_CUSTOMER_APPROVAL" | "WAITING_SUPPLIER_APPROVAL" | "DECLINED_BY_CUSTOMER" | "DECLINED_BY_SUPPLIER" | "ACCEPTED_BY_SUPPLIER" | "WAITING_SHIPMENT" | "PARTIALLY_SHIPPED" | "SHIPPED" | "COMPLETED" | "PARTIALLY_CANCELED" | "CANCELED";
+export type OrderLineType = "PRODUCT_VARIANT" | "OFFER_PRICE";
 export type OrderOrigin = "CART" | "SUPPLIER_QUOTE";
 export type OrderIdType = "BUSINESS_ID" | "CART_ID";
 export type ApprovalStatus = "APPROVED" | "REFUSED" | "WAITING_APPROVAL";
@@ -81,7 +83,15 @@ export interface OrderLogisticLineUpdate {
     customFieldValues: CustomFieldValueObject[];
     id: string;
     quantity: number;
-    updateAction: string;
+    updateAction: UpdateCartLineType;
+}
+export interface updateCommercialOrderLinesRequest {
+    customFieldIdType?: IdType;
+    lineIdType?: IdType;
+    lineType?: string;
+    updateOrderCommercialLines?: OrderLogisticLineUpdate[];
+    updateOrderLineIdType?: IdType;
+    updateOrderLineType?: string;
 }
 interface OfferCustomFieldSnapshot {
     externalId: string;
@@ -289,6 +299,17 @@ export interface OrderRatingResponse {
     comment: string;
     grade: number;
 }
+export interface OrderLogisticThreadResponse {
+    createdAt: string;
+    externalId: string;
+    id: string;
+    messages: ThreadMessageDto;
+    name: string;
+    reasons: string[];
+    status: string;
+    type: string;
+    updatedAt: string;
+}
 export interface ThreadReasonTypeDto {
     claimReasonType: ThreadReasonType;
     label: string;
@@ -301,6 +322,59 @@ export interface ThreadReasonDto {
     label: string;
     type: ThreadReasonTypeDto;
 }
+export interface ThreadMessageDto {
+    body: string;
+    createdAt: string;
+    customFieldValues: ThreadCustomFiedValuesDto[];
+    externalId: string;
+    from: ThreadMessageFromToDto;
+    id: string;
+    to: ThreadMessageFromToDto;
+    updatedAt: string;
+}
+export interface ThreadMessageFromToDto {
+    account: ThreadMessageAccountDto;
+    accounts: ThreadMessageAccountDto[];
+    user: ThreadMessageFromUserDto;
+}
+export interface ThreadMessageAccountDto {
+    externalId: string;
+    id: string;
+    name: string;
+}
+export interface ThreadMessageFromUserDto {
+    civility: string;
+    createdAt: string;
+    customFieldValues: ThreadCustomFiedValuesDto[];
+    email: string;
+    externalId: string;
+    firstName: string;
+    groups: string[];
+    id: string;
+    lastName: string;
+    locale: Country;
+    password: string;
+    phone: string;
+    status: string;
+    updatedAt: string;
+}
+export interface ThreadCustomFiedValuesDto {
+    customField: {
+        externalId: string;
+        externalSource: ExternalSource;
+        faceted: boolean;
+        id: string;
+        indexable: boolean;
+        mandatory: boolean;
+        name: object;
+        role: string;
+        sealedTarget: string;
+        searchable: boolean;
+        sortable: boolean;
+        status: string;
+    };
+    value: unknown;
+}
 export interface RequestGetAccountingDocumentLinkbyID {
     orderLogisticId: string;
     docId: string;
@@ -399,4 +473,17 @@ export interface PreauthorizationDto {
     Status: string;
     Tag: string;
 }
+export interface OfferToDelete {
+    offerPriceId: string;
+}
+export interface logisticOrderIncidentThreadsCustomFieldValueRequest {
+    customFieldValues: CustomFieldValueRequest[];
+    idType: IdType;
+}
+export interface logisticOrderIncidentThreadsRequest {
+    customField?: logisticOrderIncidentThreadsCustomFieldValueRequest;
+    message?: string;
+    name?: string;
+    reasonCode: string;
+}
 export {};

package/lib/{src/services → services}/auth/definitions.requests.js

@@ -1,2 +1,5 @@
 "use strict";
+/**
+ * Request parameters type definitions
+ */
 Object.defineProperty(exports, "__esModule", { value: true });

package/lib/{src/services → services}/cart/index.d.ts

@@ -31,8 +31,8 @@ export declare function deleteCarts(): Promise<DeleteCartsResponse>;
  * |------------------|----------------------|------------|------------------------------------------------------------|
  * | `currency`       | `string`             | ✅         | The currency in which to display the carts.                |
  * | `pageable`       | `object`             | ✅         | The pagination parameters.                                 |
- * | `status`         | `string[]`           | ❌         | The status of the carts to retrieve.                       |
- * | `type`           | `string[]`           | ❌         | The type of carts to retrieve (e.g. `CART`, `BUYING_LIST`).                             |
+ * | `status`         | `CartStatusDto[]`    | ❌         | The status of the carts to retrieve.                       |
+ * | `type`           | `CartTypeDto[]`      | ❌         | The type of carts to retrieve (e.g. `CART`, `BUYING_LIST`).                             |
  *
  * 📤 **Returns**:
  * A `Promise` resolving to a `GetCartsResponse` object, containing the list of carts and pagination information.

package/lib/{src/services → services}/cart/index.js

@@ -51,8 +51,8 @@ async function deleteCarts() {
  * |------------------|----------------------|------------|------------------------------------------------------------|
  * | `currency`       | `string`             | ✅         | The currency in which to display the carts.                |
  * | `pageable`       | `object`             | ✅         | The pagination parameters.                                 |
- * | `status`         | `string[]`           | ❌         | The status of the carts to retrieve.                       |
- * | `type`           | `string[]`           | ❌         | The type of carts to retrieve (e.g. `CART`, `BUYING_LIST`).                             |
+ * | `status`         | `CartStatusDto[]`    | ❌         | The status of the carts to retrieve.                       |
+ * | `type`           | `CartTypeDto[]`      | ❌         | The type of carts to retrieve (e.g. `CART`, `BUYING_LIST`).                             |
  *
  * 📤 **Returns**:
  * A `Promise` resolving to a `GetCartsResponse` object, containing the list of carts and pagination information.

package/lib/{src/services → services}/commercial-order/definitions.d.ts

@@ -1,6 +1,7 @@
-import { Channel, Currency } from "../../interfaces/models/common";
+import { Channel, Currency, IdType } from "../../interfaces/models/common";
 import { CustomFieldValueRequest } from "../../interfaces/models/custom-field";
-import { BrowserInfo, CardInformationDto, OrderCommercialDto, OrderIdType, OrderLogisticDto, OrderOrigin, PageOrderCommercialDto, PaymentCardInfo, PreauthorizationDto } from "../../interfaces/models/order";
+import { BrowserInfo, CardInformationDto, OrderCommercialDto, OrderIdType, OrderLogisticDto, OrderOrigin, PageOrderCommercialDto, PaymentCardInfo, PreauthorizationDto, OfferToDelete, OrderLogisticLineUpdate, OrderLineType } from "../../interfaces/models/order";
+import { SingleWarningReportDto } from "../../interfaces/models/common";
 import { PaymentInfoRequest, PaymentOption, PaymentProvider } from "../../interfaces/models/payment";
 /**
  * Request parameters type definitions
@@ -18,6 +19,17 @@ export interface CreateCommercialOrderParameters {
     originId: string;
     paymentInfo?: PaymentInfoRequest;
 }
+export interface CreateCommercialOrderV2Parameters {
+    customFieldIdType?: IdType;
+    customFields?: CustomFieldValueRequest[];
+}
+export interface UpdateCommercialOrderParameters extends CreateCommercialOrderV2Parameters {
+    commercialOrderId: string;
+}
+export interface DeleteCommercialOrderLinesParameters {
+    commercialOrderId: string;
+    body: OfferToDelete[];
+}
 export interface GetCommercialOrderParameters {
     orderId: string;
     locale: string;
@@ -77,6 +89,19 @@ export interface GetCommercialOrdersResponse extends PageOrderCommercialDto {
 }
 export interface CreateCommercialOrderResponse extends OrderCommercialDto {
 }
+export interface CreateCommercialOrderV2Response {
+    id: string;
+    reference: string;
+}
+export interface UpdateCommercialOrderLinesParameters {
+    commercialOrderId: string;
+    customFieldIdType?: IdType;
+    lineIdType?: IdType;
+    lineType?: string;
+    updateOrderCommercialLines?: OrderLogisticLineUpdate[];
+    updateOrderLineIdType?: IdType;
+    updateOrderLineType?: OrderLineType;
+}
 export interface GetCommercialOrderResponse extends OrderCommercialDto {
 }
 export interface CreateCommercialOrderCardRegistrationResponse extends CardInformationDto {
@@ -85,3 +110,9 @@ export interface CreateCommercialOrderPreauthorizationResponse extends Preauthor
 }
 export interface UpdateOrderLogisticCustomFieldResponse extends OrderLogisticDto {
 }
+export interface DeleteCommercialOrderLinesResponse {
+    singleWarningReportDtos: SingleWarningReportDto[];
+}
+export interface UpdateCommercialOrderLinesResponse {
+    singleWarningReportDtos: SingleWarningReportDto[];
+}

package/lib/{src/services → services}/commercial-order/index.d.ts

@@ -1,4 +1,4 @@
-import { CreateCommercialOrderCardRegistrationParameters, CreateCommercialOrderCardRegistrationResponse, CreateCommercialOrderParameters, CreateCommercialOrderPreauthorizationParameters, CreateCommercialOrderPreauthorizationResponse, CreateCommercialOrderResponse, GetCommercialOrderParameters, GetCommercialOrderPaymentPageUrlParameters, GetCommercialOrderResponse, GetCommercialOrdersParameters, GetCommercialOrdersResponse, SetCommercialOrderStatusAsCreatedParameters, SetCommercialOrderStatusAsOnHoldParameters, UpdateCommercialOrderBillingInformationParameters, UpdateCommercialOrderShippingAddressParameters, UpdateCommercialOrderShippingInformationParameters, UpdateCommercialOrderShippingTypeParameters } from "./definitions";
+import { CreateCommercialOrderCardRegistrationParameters, CreateCommercialOrderCardRegistrationResponse, CreateCommercialOrderParameters, CreateCommercialOrderResponse, CreateCommercialOrderV2Parameters, CreateCommercialOrderV2Response, UpdateCommercialOrderParameters, DeleteCommercialOrderLinesParameters, DeleteCommercialOrderLinesResponse, UpdateCommercialOrderLinesParameters, UpdateCommercialOrderLinesResponse, CreateCommercialOrderPreauthorizationParameters, CreateCommercialOrderPreauthorizationResponse, GetCommercialOrderParameters, GetCommercialOrderPaymentPageUrlParameters, GetCommercialOrderResponse, GetCommercialOrdersParameters, GetCommercialOrdersResponse, SetCommercialOrderStatusAsCreatedParameters, SetCommercialOrderStatusAsOnHoldParameters, UpdateCommercialOrderBillingInformationParameters, UpdateCommercialOrderShippingAddressParameters, UpdateCommercialOrderShippingInformationParameters, UpdateCommercialOrderShippingTypeParameters } from "./definitions";
 /**
  * COMMERCIAL ORDER ENDPOINT
  */
@@ -64,6 +64,38 @@ export declare function getCommercialOrders({ locale, nbPreviewLines, }: GetComm
  * @returns {Promise<CreateCommercialOrderResponse>} A promise resolving to the response containing the commercial orders.
  */
 export declare function createCommercialOrder({ nbPreviewLines, channel, customFields, locale, origin, originId, paymentInfo, }: CreateCommercialOrderParameters): Promise<CreateCommercialOrderResponse>;
+/**
+ * 🚚 Creates commercial orders V2.
+ *
+ * This function creates a commercial order (Version 2).
+ *
+ * 🛠 **Endpoint**: `POST /v2/shop/commercial-orders [ORDER-108]`
+ *
+ * | Parameter            | Type                                 | Required  | Description                                               |
+ * |----------------------|--------------------------------------|-----------------------------------------------------------------------|
+ * | `customFieldIdType`  | `IdType`                             |     ❌    | The custom field id type to use.                          |
+ * | `customFields`       | `CustomFieldValueRequest[]`          |     ❌    | The custom fields to add to the created commercial order. |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving to a single `CreateCommercialOrderV2Response` object representing the created commercial orders [ORDER-108].
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const orders = await createCommercialOrderV2({
+ *   customFieldIdType: "DJUST_ID",
+ *   customFields: [
+ *     {
+ *       "customFieldId": "string",
+ *       "customFieldValue": "string"
+ *     }
+ *   ],
+ * });
+ * ```
+ *
+ * @param {CreateCommercialOrderV2Parameters} params - The body of the request.
+ * @returns {Promise<CreateCommercialOrderV2Response>} A promise resolving to the response containing the created commercial orders.
+ */
+export declare function createCommercialOrderV2({ customFieldIdType, customFields, }: CreateCommercialOrderV2Parameters): Promise<CreateCommercialOrderV2Response>;
 /**
  * 🚚 Gets a specific commercial order.
  *
@@ -96,6 +128,39 @@ export declare function createCommercialOrder({ nbPreviewLines, channel, customF
  * @returns {Promise<GetCommercialOrderResponse>} A promise resolving to the response containing the commercial order.
  */
 export declare function getCommercialOrder({ orderId, idType, locale, nbPreviewLines, }: GetCommercialOrderParameters): Promise<GetCommercialOrderResponse>;
+/**
+ * 🚚 Update commercial orders.
+ *
+ * This function update a commercial order.
+ *
+ * 🛠 **Endpoint**: `POST /v2/shop/commercial-orders/${commercialOrderId} [ORDER-222]`
+ *
+ * | Parameter            | Type                                 | Required  | Description                                              |
+ * |----------------------|--------------------------------------|----------------------------------------------------------------------|
+ * | `commercialOrderId`  | `string`                             |     ✅    | The commercial order Id.                                 |
+ * | `customFieldIdType`  | `IdType`                             |     ❌    | The custom field id type to use.                          |
+ * | `customFields`       | `CustomFieldValueRequest[]`          |     ❌    | The custom fields to add to the created commercial order. |
+ *
+ * 📤 **Returns**:
+ * A `Promise<void>` when the commercialOrder is successfully updated. No additional data is returned.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const orders = await updateCommercialOrder({
+ *   customFieldIdType: "EXTERNAL_ID",
+ *   customFields: [
+ *     {
+ *       "customFieldId": "string",
+ *       "customFieldValue": "string"
+ *     }
+ *   ],
+ * });
+ * ```
+ *
+ * @param {UpdateCommercialOrderParameters} params - The params of the request.
+ * @returns {Promise<void>}
+ */
+export declare function updateCommercialOrder({ commercialOrderId, customFieldIdType, customFields, }: UpdateCommercialOrderParameters): Promise<void>;
 /**
  * 🚚 Creates a specific commercial order's card registration.
  *
@@ -389,3 +454,104 @@ export declare function updateCommercialOrderShippingInformation({ orderId, ship
  * @returns {Promise<void>} A promise resolving when shipping type of the commercial order is updated.
  */
 export declare function updateCommercialOrderShippingType({ orderId, shippingType, }: UpdateCommercialOrderShippingTypeParameters): Promise<void>;
+/**
+ * ❌ Deletes a specific commercial order.
+ *
+ * This function deletes a commercial order identified by the `commercialOrderId`.
+ * The `commercialOrderId` parameter is required and validated before the request is executed.
+ *
+ * 🛠 **Endpoint**: `DELETE /v2/shop/commercial-orders/${commercialOrderId}` [ORDER-300]
+ *
+ * | Parameter            | Type     | Required | Description                                   |
+ * |----------------------|--------- |----------|-----------------------------------------------|
+ * | `commercialOrderId`  | `string` | ✅       | The ID of the commercial order to be deleted. |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving with an empty response (`204 No Content`) when the commercial order is successfully deleted.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * await deleteCommercialOrder("commercialOrder123");
+ * ```
+ *
+ * @param {string} commercialOrderId - The ID of the commercial order to be deleted.
+ * @throws {Error} If `commercialOrderId` is missing.
+ * @returns {Promise<void>} A promise resolving when the commercial order is successfully deleted.
+ */
+export declare function deleteCommercialOrder(commercialOrderId: string): Promise<void>;
+/**
+ * 🚚 Update specific commercial order lines.
+ *
+ * This function update commercial order lines identified by the `commercialOrderId`.
+ * This `commercialOrderId` parameter is required and validated before the request is executed.
+ *
+ * 🛠 **Endpoint**: `PUT /v2/shop/commercial-orders/${commercialOrderId}/lines` [ORDER-150]
+ *
+ * | Parameter                          | Type                                 | Required        | Description                                                    |
+ * |------------------------------------|--------------------------------------|-----------------|----------------------------------------------------------------|
+ * | `commercialOrderId`                | `string`                             | ✅              | The ID of the commercial order whose lines are to be deleted   |
+ * | `customFieldIdType`                | `IdType`                             | ❌              | The custom field id type to use.                               |
+ * | `lineIdType`                       | `string`                             | ❌              | The line id type to use.                                       |
+ * | `lineType`                         | `string`                             | ❌              | The line type to use.                                          |
+ * | `updateOrderCommercialLines`       | `OrderLogisticLineUpdate[]`          | ❌              | Attributes to update. Can be empty object.                     |
+ * | `updateOrderLineIdType`            | `IdType`                             | ❌              | The line id type to use.                                       |
+ * | `updateOrderLineType`              | `OrderLineType`                             | ❌              | The line type to use.                                          |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving when the commercial order lines are successfully updated.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const response = await updateCommercialOrderLines("commercialOrder123", {
+ *    customFieldType: "DJUST_ID",
+ *    lineIdType: "string",
+ *    lineType: "string",
+ *    updateOrderCommercialLines: [
+ *      {
+ *        customFields: [
+ *          {
+ *            customFieldId: "string",
+ *            value: "string"
+ *          }
+ *        ],
+ *        id: "string",
+ *        quantity: 0,
+ *        updateAction: "ADD_QUANTITY"
+ *      }
+ *    ],
+ *    updateOrderLineIdType: "EXTERNAL_ID",
+ *    updateOrderLineType: "PRODUCT_VARIANT"
+ * });
+ * ```
+ *
+ * @param {UpdateCommercialOrderLinesParameters} params - The parameters for the request.
+ * @throws {Error} If `commercialOrderId` is missing.
+ * @returns {Promise<UpdateCommercialOrderLinesResponse>} A promise resolving when the commercial order lines are successfully updated.
+ */
+export declare function updateCommercialOrderLines({ commercialOrderId, customFieldIdType, lineIdType, lineType, updateOrderCommercialLines, updateOrderLineIdType, updateOrderLineType, }: UpdateCommercialOrderLinesParameters): Promise<UpdateCommercialOrderLinesResponse>;
+/**
+ * ❌ Deletes specific commercial order lines.
+ *
+ * This function deletes commercial order lines identified by the `commercialOrderId`.
+ * The `commercialOrderId` parameter is mandatory and validated before the request is executed.
+ *
+ * 🛠 **Endpoint**: `DELETE /v2/shop/commercial-orders/${commercialOrderId}/lines` [ORDER-350]
+ *
+ * | Parameter            | Type               | Required | Description                                                   |
+ * |----------------------|------------------- |----------|---------------------------------------------------------------|
+ * | `commercialOrderId`  | `string`           | ✅       | The ID of the commercial order whose lines are to be deleted  |
+ * | `body`               | `OfferToDelete[]`  | ❌       | The list of offers to delete. Can be empty.                   |
+ *
+ * 📤 **Returns**:
+ * A `Promise` resolving when the commercial order lines are successfully deleted.
+ *
+ * 🛠 **Example usage**:
+ * ```ts
+ * const response = await deleteCommercialOrderLines("commercialOrder123", [{ offerPriceId: "price456" }]);
+ * ```
+ *
+ * @param {DeleteCommercialOrderLinesParameters} params - The parameters for the request.
+ * @throws {Error} If `commercialOrderId` is missing.
+ * @returns {Promise<DeleteCommercialOrderLinesResponse>} A promise resolving when the commercial order lines are successfully deleted.
+ */
+export declare function deleteCommercialOrderLines({ commercialOrderId, body, }: DeleteCommercialOrderLinesParameters): Promise<DeleteCommercialOrderLinesResponse>;