mts-booking-library 2.2.3 → 2.3.1

package/lib/SubscriptionBooking.js

@@ -0,0 +1,148 @@
+"use strict";
+// import { MTSEnvs } from "../config";
+// import { ServiceBooking } from "../booking/serviceBooking";
+// import { CreateServiceCartRequest, ServiceCart } from "../types/services/ServiceCart";
+// import { Service, ServiceTripsResponse } from "../types/services/Service";
+// import { GetBuyerPassengersDetailsResponse } from "../types/common/Person";
+// import { GetPaymentInformationFromGatewayResponse, GetSellerGatewaysResponse, PaymentMethods } from "../types/common/Payment";
+// import { useTestState } from "../mtsStorage";
+// import { SubscriptionBooking } from "../booking/subscriptionBooking";
+// // Load .env file
+// require('dotenv').config();
+// // How to run the test: npm run test -- SubscriptionBooking.test.ts
+// describe("SubscriptionBooking", () => {
+//   const timeOut = 120000;
+//   const sub_key = process.env.OCP_SUB_KEY_MTS;
+//   const access_token = process.env.ACCESS_TOKEN;
+//   const sellerId = 8; // ATV
+//   // Define localStorage for local testing
+//   if (typeof localStorage === "undefined" || localStorage === null) {
+//     var LocalStorage = require("node-localstorage").LocalStorage;
+//     global.localStorage = new LocalStorage("./scratch");
+//   }
+//   test("search_tpl", async () => {
+//     const booking = new SubscriptionBooking(MTSEnvs.TEST, sub_key!, true, SubscriptionBooking.Languages.EN, access_token, sellerId);
+//     // First, get the departures and destinations
+//     const departures = await booking.getSubscriptionsDepartures() as string[];
+//     expect(departures.length).toBeGreaterThan(0);
+//     expect(departures).toContain("BARDOLINO AUTOSTAZIONE");
+//     const selectedDeparture = "BARDOLINO AUTOSTAZIONE";
+//     const destinations = await booking.getSubscriptionsDestinations(selectedDeparture) as string[];
+//     expect(destinations.length).toBeGreaterThan(0);
+//     expect(destinations).toContain("GARDA AUTOSTAZIONE");
+//     const selectedDestination = "GARDA AUTOSTAZIONE";
+//     // Then get the validity types
+//     const validityTypes = await booking.getSubscriptionsValidityTypes(selectedDeparture, selectedDestination) as SubscriptionBooking.ValidityTypes[];
+//     expect(validityTypes.length).toBeGreaterThan(0);
+//     for (const validityType of validityTypes) {
+//       // Check that all returned validity types are valid
+//       expect(Object.values(SubscriptionBooking.ValidityTypes).includes(validityType)).toBe(true);
+//     }
+//   }, timeOut);
+//   const createCart = async (booking: ServiceBooking): Promise<ServiceCart> => {
+//     const servicesResponse = await booking.getServices(ServiceBooking.Currencies.EUR);
+//     const services = servicesResponse as Service[];
+//     // Build create cart request
+//     let tariffsMatrix = services[0].tariffsMatrix;
+//     tariffsMatrix[0][0].quantity = 1;
+//     const createServiceCartRequest: CreateServiceCartRequest = {
+//         currency: ServiceBooking.Currencies.EUR,
+//         service: {
+//           serviceId: services[0].id,
+//           tariffsMatrix:  tariffsMatrix
+//       }
+//     };
+//     // Create cart
+//     const cart = await booking.createServiceCart(createServiceCartRequest) as ServiceCart;
+//     return cart;
+//   }
+//   test("create_service_cart", async () => {
+//     const booking = new ServiceBooking(MTSEnvs.TEST, sub_key!, true, ServiceBooking.Languages.EN);
+//     const cart = await createCart(booking);
+//     // Check that the cartId was saved to the local storage
+//     expect(useTestState().getState().cartId).toBe(cart.id);
+//     expect(booking.cartId).toBe(cart.id);
+//     // Test the booking status (we test only the Buyer and passenger data, as it will always be required)
+//     expect(booking.bookingStepsToStatus.get(ServiceBooking.BookingSteps.BUYER_PASSENGERS)).toStrictEqual([ true, false, true ]);
+//     expect(booking.bookingStepsToStatus.get(ServiceBooking.BookingSteps.ISSUE)).toStrictEqual([ false, false, true ]);
+//     // Test booking due date
+//     expect(booking.bookingDueDate?.toISOString()).toBe(new Date(cart.bookingDueDate).toISOString());
+//     // Test expired tickets
+//     expect(cart.hasIssuedTickets).toBe(false);
+//     // Test seller data
+//     expect(booking.getSellerId()).toBe(cart.sellerId);
+//     expect(cart.sellerPrivacyUrl.length).toBeGreaterThan(0);
+//     expect(cart.sellerTermsUrl.length).toBeGreaterThan(0);
+//     // Now try to get the cart
+//     const newBooking = await ServiceBooking.createBooking(MTSEnvs.TEST, sub_key!, true, ServiceBooking.Languages.EN);
+//     expect(newBooking.cartId).toBe(cart.id);
+//     expect(newBooking.getCart()?.id).toBe(cart.id)
+//     expect(newBooking.getSellerId()).toBe(cart.sellerId);
+//     // Finally try to delete the cart
+//     await booking.deleteCart();
+//     expect(booking.getCart()).toBe(undefined);
+//     expect(useTestState().getState().cartId).toBe(undefined);
+//   }, timeOut);
+//   test("get_edit_buyer_data", async () => {
+//     const booking = new ServiceBooking(MTSEnvs.TEST, sub_key!, true, ServiceBooking.Languages.EN);
+//     const cart = await createCart(booking);
+//     // First, try to get the buyer data
+//     let buyerDataResponse = await booking.getBuyerPassengersDetails();
+//     expect((buyerDataResponse as GetBuyerPassengersDetailsResponse).passengers.length).toBe(0);
+//     let buyer = (buyerDataResponse as GetBuyerPassengersDetailsResponse).buyer;
+//     expect(buyer).toBe(null);
+//     // Now try to edit the buyer data
+//     buyer = {
+//       id: 0,
+//       name: "TestName",
+//       lastName: "TestSurname",
+//       email: "testBookingLib@infos.it",
+//       phoneNumber: "+391234567890"
+//     }
+//     await booking.updateBuyerPassengersDetails(buyer);
+//     // Finally, get the buyer data again and check that the data was updated
+//     buyerDataResponse = await booking.getBuyerPassengersDetails();
+//     const updatedBuyer = (buyerDataResponse as GetBuyerPassengersDetailsResponse).buyer;
+//     expect(updatedBuyer.id).toBeGreaterThan(0);
+//     expect(updatedBuyer.name).toBe(buyer.name);
+//     expect(updatedBuyer.lastName).toBe(buyer.lastName);
+//     expect(updatedBuyer.email).toBe(buyer.email);
+//     expect(updatedBuyer.phoneNumber).toBe(buyer.phoneNumber);
+//     // Finally try to delete the cart
+//     await booking.deleteCart();
+//     expect(booking.getCart()).toBe(undefined);
+//     expect(useTestState().getState().cartId).toBe(undefined);
+//   }, timeOut);
+//   test("get_gateway_info", async () => {
+//     const booking = new ServiceBooking(MTSEnvs.TEST, sub_key!, true, ServiceBooking.Languages.EN);
+//     const cart = await createCart(booking);
+//     booking.updateSellerId(cart.sellerId);
+//     // First, try to get the buyer data
+//     let buyerDataResponse = await booking.getBuyerPassengersDetails();
+//     expect((buyerDataResponse as GetBuyerPassengersDetailsResponse).passengers.length).toBe(0);
+//     let buyer = (buyerDataResponse as GetBuyerPassengersDetailsResponse).buyer;
+//     expect(buyer).toBe(null);
+//     // Now try to edit the buyer data
+//     buyer = {
+//       id: 0,
+//       name: "TestName",
+//       lastName: "TestSurname",
+//       email: "testBookingLib@infos.it",
+//       phoneNumber: "+391234567890"
+//     }
+//     await booking.updateBuyerPassengersDetails(buyer);
+//     // Try to get the gateways
+//     const gateways = await booking.getSellerGateways() as GetSellerGatewaysResponse;
+//     if (!gateways.payPalGatewayDTO && !gateways.cardGatewayDTO) {
+//       throw new Error("No gateways found");
+//     }
+//     const gateway = gateways.payPalGatewayDTO ? gateways.payPalGatewayDTO : gateways.cardGatewayDTO;
+//     expect(gateway?.id).toBeGreaterThan(0);
+//     // Now try to get the info
+//     const gatewayInfo = await booking.getPaymentInformationFromGateway(gateway?.id ?? 0) as GetPaymentInformationFromGatewayResponse;
+//     // Finally try to delete the cart
+//     await booking.deleteCart();
+//     expect(booking.getCart()).toBe(undefined);
+//     expect(useTestState().getState().cartId).toBe(undefined);
+//   }, timeOut);
+// });

package/lib/booking/booking.d.ts

@@ -1,6 +1,6 @@
 import { MTSConfig, MTSEnvs } from "../config";
 import { ErrorResponse } from "../types/ErrorResponse";
-import { Cart, processedStepsToStatus } from "../types/common/Cart";
+import { Cart, CreateUpdateCartRequest, processedStepsToStatus } from "../types/common/Cart";
 import { GetExtrasForBookingResponse, GetExtrasResponse } from "../types/common/Extra";
 import { GetPaymentInformationFromGatewayResponse, GetSellerGatewaysResponse, PaymentMethods, IssueCartResponse } from "../types/common/Payment";
 import { PersonDetails, GetBuyerPassengersDetailsResponse, GetPersonRequest } from "../types/common/Person";
@@ -53,6 +53,7 @@ export declare abstract class Booking {
      * @returns An {@link ErrorResponse} object in case of error, true otherwise.
      */
     markBookingStepCompleted(bookingStep: Booking.BookingSteps, options?: ApiCallOptions): Promise<ErrorResponse | boolean>;
+    abstract createCart(request: CreateUpdateCartRequest): Promise<ErrorResponse | any>;
     abstract deleteCart(): Promise<ErrorResponse | any>;
     abstract resetBooking(): void;
     abstract getBuyerPassengersDetails(): Promise<ErrorResponse | GetBuyerPassengersDetailsResponse>;
@@ -130,7 +131,9 @@ export declare namespace Booking {
         SEATS_SELECTION = "BOOKING_STEP_SEATS_SELECTION",
         EXTRAS = "BOOKING_STEP_EXTRAS",
         DISCOUNTS = "BOOKING_STEP_DISCOUNTS",
-        ISSUE = "BOOKING_STEP_ISSUE"
+        PAYMENT = "BOOKING_STEP_PAYMENT",
+        ISSUE = "BOOKING_STEP_ISSUE",
+        SUMMARY = "BOOKING_STEP_SUMMARY"
     }
     enum BookingTypes {
         MLP = "MLP",

package/lib/booking/booking.js

@@ -470,7 +470,9 @@ exports.Booking = Booking;
         BookingSteps["SEATS_SELECTION"] = "BOOKING_STEP_SEATS_SELECTION";
         BookingSteps["EXTRAS"] = "BOOKING_STEP_EXTRAS";
         BookingSteps["DISCOUNTS"] = "BOOKING_STEP_DISCOUNTS";
+        BookingSteps["PAYMENT"] = "BOOKING_STEP_PAYMENT";
         BookingSteps["ISSUE"] = "BOOKING_STEP_ISSUE";
+        BookingSteps["SUMMARY"] = "BOOKING_STEP_SUMMARY";
     })(BookingSteps = Booking.BookingSteps || (Booking.BookingSteps = {}));
     var BookingTypes;
     (function (BookingTypes) {

package/lib/booking/journeyBooking.d.ts

@@ -1,4 +1,5 @@
 import { ErrorResponse } from "../types/ErrorResponse";
+import { CreateUpdateCartRequest } from "../types/common/Cart";
 import { EditPassengersDetailsRequest, GetBuyerPassengersDetailsResponse } from "../types/common/Person";
 import { AddReductionRequest } from "../types/common/Reduction";
 import { BusMatrix } from "../types/journeys/BusMatrix";
@@ -88,6 +89,12 @@ export declare class JourneyBooking extends Booking {
      * @returns The returned journeys that match the given parameters
      */
     getJourneys(request: JourneySearchRequest, options?: ApiCallOptions): Promise<ErrorResponse | JourneySearchResult[]>;
+    /**
+     * This method creates a journey cart (MLP) for the given parameters.
+     * @returns The created cart
+     */
+    createCart(request: CreateUpdateCartRequest, options?: ApiCallOptions): Promise<ErrorResponse | JourneyCart>;
+    /** @deprecated Use {@link createCart} instead. */
     createJourneyCart(journeyCart: CreateJourneyCartRequest, options?: ApiCallOptions): Promise<ErrorResponse | JourneyCart>;
     /**
      * @description This method shall be called when the user wants to retrieve information about the buyer and the passengers.

package/lib/booking/journeyBooking.js

@@ -259,6 +259,45 @@ var JourneyBooking = /** @class */ (function (_super) {
             });
         });
     };
+    /**
+     * This method creates a journey cart (MLP) for the given parameters.
+     * @returns The created cart
+     */
+    JourneyBooking.prototype.createCart = function (request, options) {
+        return __awaiter(this, void 0, void 0, function () {
+            var url;
+            var _this = this;
+            return __generator(this, function (_a) {
+                url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts");
+                return [2 /*return*/, this.callPostApi(url, request, options).then(function (response) { return __awaiter(_this, void 0, void 0, function () {
+                        return __generator(this, function (_a) {
+                            switch (_a.label) {
+                                case 0:
+                                    // Check for errors
+                                    if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
+                                        // If there was an error, reset cartGuid and remove it from the mts-storage
+                                        this.resetBooking();
+                                        return [2 /*return*/, response];
+                                    }
+                                    // Fetch the newly created cart & update local properties
+                                    return [4 /*yield*/, this.fetchAndSetCart(response.cartGuid)];
+                                case 1:
+                                    // Fetch the newly created cart & update local properties
+                                    _a.sent();
+                                    if (!this.cart) {
+                                        // Should already be handled, but just in case
+                                        throw new Error("Could not fetch cart");
+                                    }
+                                    // Update storage
+                                    this.getStorage().getState().updateCartGuid(response.cartGuid);
+                                    return [2 /*return*/, this.cart];
+                            }
+                        });
+                    }); })];
+            });
+        });
+    };
+    /** @deprecated Use {@link createCart} instead. */
     JourneyBooking.prototype.createJourneyCart = function (journeyCart, options) {
         return __awaiter(this, void 0, void 0, function () {
             var url, request;

package/lib/booking/serviceBooking.d.ts

@@ -1,4 +1,5 @@
 import { ErrorResponse } from "../types/ErrorResponse";
+import { CreateUpdateCartRequest } from "../types/common/Cart";
 import { PersonDetails, GetBuyerPassengersDetailsResponse } from "../types/common/Person";
 import { AddReductionRequest } from "../types/common/Reduction";
 import { Service, ServiceTripsResponse } from "../types/services/Service";
@@ -90,6 +91,12 @@ export declare class ServiceBooking extends Booking {
      * @returns {ServiceTripsResponse} The returned information about the tour (tripId and hour)
      */
     getServiceTrips(serviceId: number, date: string, options?: ApiCallOptions): Promise<ErrorResponse | ServiceTripsResponse>;
+    /**
+     * This method creates a service cart for the given parameters.
+     * @returns The created cart
+     */
+    createCart(request: CreateUpdateCartRequest, options?: ApiCallOptions): Promise<ErrorResponse | ServiceCart>;
+    /** @deprecated Use {@link createCart} instead. */
     createServiceCart(serviceCart: CreateServiceCartRequest, options?: ApiCallOptions): Promise<ErrorResponse | ServiceCart>;
     /**
      * @description This method shall be called when the user wants to retrieve information about the buyer and the passengers.

package/lib/booking/serviceBooking.js

@@ -258,6 +258,45 @@ var ServiceBooking = /** @class */ (function (_super) {
             });
         });
     };
+    /**
+     * This method creates a service cart for the given parameters.
+     * @returns The created cart
+     */
+    ServiceBooking.prototype.createCart = function (request, options) {
+        return __awaiter(this, void 0, void 0, function () {
+            var url;
+            var _this = this;
+            return __generator(this, function (_a) {
+                url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts");
+                return [2 /*return*/, this.callPostApi(url, request, options).then(function (response) { return __awaiter(_this, void 0, void 0, function () {
+                        return __generator(this, function (_a) {
+                            switch (_a.label) {
+                                case 0:
+                                    // Check for errors
+                                    if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
+                                        // If there was an error, reset cartGuid and remove it from the mts-storage
+                                        this.resetBooking();
+                                        return [2 /*return*/, response];
+                                    }
+                                    // Fetch the newly created cart & update local properties
+                                    return [4 /*yield*/, this.fetchAndSetCart(response.cartGuid)];
+                                case 1:
+                                    // Fetch the newly created cart & update local properties
+                                    _a.sent();
+                                    if (!this.cart) {
+                                        // Should already be handled, but just in case
+                                        throw new Error("Could not fetch cart");
+                                    }
+                                    // Update storage
+                                    this.getStorage().getState().updateCartGuid(response.cartGuid);
+                                    return [2 /*return*/, this.cart];
+                            }
+                        });
+                    }); })];
+            });
+        });
+    };
+    /** @deprecated Use {@link createCart} instead. */
     ServiceBooking.prototype.createServiceCart = function (serviceCart, options) {
         return __awaiter(this, void 0, void 0, function () {
             var url;

package/lib/booking/subscriptionBooking.d.ts

@@ -1,4 +1,5 @@
 import { ErrorResponse } from "../types/ErrorResponse";
+import { CreateUpdateCartRequest } from "../types/common/Cart";
 import { EditPassengersDetailsRequest, GetBuyerPassengersDetailsResponse } from "../types/common/Person";
 import { AddReductionRequest } from "../types/common/Reduction";
 import { GetSubscriptionAvailabilityRequest, GetSubscriptionAvailabilityResponse } from "../types/subscriptions/SubscriptionAvailabilities";
@@ -104,9 +105,9 @@ export declare class SubscriptionBooking extends Booking {
      * @returns The availability of the subscription for the given parameters
      */
     getSubscriptionAvailabilities(request: GetSubscriptionAvailabilityRequest, options?: ApiCallOptions): Promise<ErrorResponse | GetSubscriptionAvailabilityResponse>;
+    createCart(request: CreateUpdateCartRequest): Promise<never>;
     /**
      * This method creates a subscription cart for the given parameters.
-     * @param request the request object containing the parameters for the availability check
      * @returns The created cart
      */
     createSubscriptionCart(request: CreateSubscriptionCartRequest, options?: ApiCallOptions): Promise<ErrorResponse | SubscriptionCart>;

package/lib/booking/subscriptionBooking.js

@@ -314,9 +314,15 @@ var SubscriptionBooking = /** @class */ (function (_super) {
             });
         });
     };
+    SubscriptionBooking.prototype.createCart = function (request) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                throw new Error("Method not available for this booking type. Use createSubscriptionCart instead.");
+            });
+        });
+    };
     /**
      * This method creates a subscription cart for the given parameters.
-     * @param request the request object containing the parameters for the availability check
      * @returns The created cart
      */
     SubscriptionBooking.prototype.createSubscriptionCart = function (request, options) {

package/lib/booking/tplBooking.d.ts

@@ -1,4 +1,5 @@
 import { ErrorResponse } from "../types/ErrorResponse";
+import { CreateUpdateCartRequest } from "../types/common/Cart";
 import { City } from "../types/common/City";
 import { PersonDetails, GetBuyerPassengersDetailsResponse } from "../types/common/Person";
 import { AddReductionRequest } from "../types/common/Reduction";
@@ -103,8 +104,11 @@ export declare class TplBooking extends Booking {
      */
     getTariffs(superAreaId: number, termsTypeId: number | null, onlyTickets: boolean, onlySubscriptions: boolean, options?: ApiCallOptions): Promise<ErrorResponse | GetTariffsResponse>;
     /**
-     * This method allows to create a TPL cart.
+     * This method creates a tpl cart for the given parameters.
+     * @returns The created cart
      */
+    createCart(request: CreateUpdateCartRequest, options?: ApiCallOptions): Promise<ErrorResponse | TplCart>;
+    /** @deprecated Use {@link createCart} instead. */
     createTplCart(tplCart: CreateTplCartRequest, options?: ApiCallOptions): Promise<ErrorResponse | TplCart>;
     /**
      * @description This method shall be called when the user wants to retrieve information about the buyer and the passengers.

package/lib/booking/tplBooking.js

@@ -305,8 +305,44 @@ var TplBooking = /** @class */ (function (_super) {
         });
     };
     /**
-     * This method allows to create a TPL cart.
+     * This method creates a tpl cart for the given parameters.
+     * @returns The created cart
      */
+    TplBooking.prototype.createCart = function (request, options) {
+        return __awaiter(this, void 0, void 0, function () {
+            var url;
+            var _this = this;
+            return __generator(this, function (_a) {
+                url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts");
+                return [2 /*return*/, this.callPostApi(url, request, options).then(function (response) { return __awaiter(_this, void 0, void 0, function () {
+                        return __generator(this, function (_a) {
+                            switch (_a.label) {
+                                case 0:
+                                    // Check for errors
+                                    if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
+                                        // If there was an error, reset cartGuid and remove it from the mts-storage
+                                        this.resetBooking();
+                                        return [2 /*return*/, response];
+                                    }
+                                    // Fetch the newly created cart & update local properties
+                                    return [4 /*yield*/, this.fetchAndSetCart(response.cartGuid)];
+                                case 1:
+                                    // Fetch the newly created cart & update local properties
+                                    _a.sent();
+                                    if (!this.cart) {
+                                        // Should already be handled, but just in case
+                                        throw new Error("Could not fetch cart");
+                                    }
+                                    // Update storage
+                                    this.getStorage().getState().updateCartGuid(response.cartGuid);
+                                    return [2 /*return*/, this.cart];
+                            }
+                        });
+                    }); })];
+            });
+        });
+    };
+    /** @deprecated Use {@link createCart} instead. */
     TplBooking.prototype.createTplCart = function (tplCart, options) {
         return __awaiter(this, void 0, void 0, function () {
             var url, processedTariffIdToQuantity, request;

package/lib/index.d.ts

@@ -4,6 +4,7 @@ export { ServiceBooking } from "./booking/serviceBooking";
 export { SubscriptionBooking } from "./booking/subscriptionBooking";
 export { TplBooking } from "./booking/tplBooking";
 export { useMtsBookingState } from "./mtsStorage";
+export { CreateUpdateCartRequest, CartBooking } from "./types/common/Cart";
 export { Person, PersonDetails, DEFAULT_PERSON, initializePerson } from "./types/common/Person";
 export { GetBuyerPassengersDetailsResponse, GetPersonRequest, GetPassenger, BuyerDataStatus, EditPassengerRequestType, EditPassengersDetailsRequest } from "./types/common/Person";
 export { Tariff, TariffsMatrix, TariffSummary, TariffType, TermsType, PassengerTariff, ExtraTariff } from "./types/common/Tariffs";

package/lib/index.js

@@ -16,9 +16,6 @@ Object.defineProperty(exports, "TplBooking", { enumerable: true, get: function (
 //#region Export Zustand states
 var mtsStorage_1 = require("./mtsStorage");
 Object.defineProperty(exports, "useMtsBookingState", { enumerable: true, get: function () { return mtsStorage_1.useMtsBookingState; } });
-//#endregion
-//#region Export common types
-// @note: Cart is not exported because it is extended by other types
 var Person_1 = require("./types/common/Person");
 Object.defineProperty(exports, "DEFAULT_PERSON", { enumerable: true, get: function () { return Person_1.DEFAULT_PERSON; } });
 Object.defineProperty(exports, "initializePerson", { enumerable: true, get: function () { return Person_1.initializePerson; } });

package/lib/mtsStorage.js

@@ -44,8 +44,7 @@ var useMtsBookingState = function () {
 exports.useMtsBookingState = useMtsBookingState;
 var useTestState = function () {
     if (typeof localStorage === "undefined" || localStorage === null) {
-        var LocalStorage = require("node-localstorage").LocalStorage;
-        global.localStorage = new LocalStorage("./scratch");
+        throw new Error("localStorage is not available");
     }
     return useMtsBookingLocalState;
 };

package/lib/types/common/Cart.d.ts

@@ -7,6 +7,37 @@ export declare enum SellingMethod {
     RESELLER = "RESELLER",
     MTSAPP = "MTSAPP"
 }
+export type CreateUpdateCartRequest = {
+    /** The unique identifier for the cart.
+     * This should be passed during the change process to link the new ticket to the already existing change cart */
+    cartGuid?: string;
+    /** The currency of the cart. See {@link Booking.Currencies} */
+    currency: Booking.Currencies;
+    /** The booking to be added to the cart. */
+    cartBooking: CartBooking;
+    /** The return booking to be added to the cart (e.g. for MLP). */
+    returnCartBooking?: CartBooking;
+};
+export type CartBooking = {
+    /** A record containing tariff ids as keys and their respective quantities as values. */
+    tariffIdToQuantity?: Record<number, number>;
+    /** The date of the booking in ISO string format (optional). */
+    date?: string;
+    /** The id of the trip, if necessary. For example, this is used by services that require a specific trip to be selected, or by MLP booking */
+    tripId?: number;
+    /** The id of the line, if necessary. For example, this is used by Services */
+    lineId?: number;
+    /** The start date of the booking, if necessary. For example, this is used by TPL subscriptions. */
+    startDate?: string;
+    /** If true, then the booking will be the current period (e.g. this month or this year), otherwise it will be the next period. */
+    isCurrentPeriod?: boolean;
+    /** The PNR of the ticket of reference, if necessary. For example, this is used in TPL when renewing a subscription. */
+    pnr?: string;
+    /** The id of the OTA Reseller that sold the ticket */
+    otaResellerId?: number;
+    /** A string in base64 representing the picture of the ticket that was sold */
+    otaTicketPicture?: string;
+};
 /**
  * @description Cart is the object returned by the API when a cart is created.
  * Note that depending on the type of booking, this type will be extended with different fields:

package/lib/types/tpl/GetTariffsResponse.d.ts

@@ -1,6 +1,6 @@
 import { Tariff } from "../common/Tariffs";
 /**
- * This represents the response of the API {@link TplBooking.getTariffs}.
+ * This represents the response of the API {@link TplBooking.getTariffs()}.
  * @param {Tariff[]} tariffs - The list of available tariffs. This is meant to be a fast access for displaying the data.
  * In particular, this array is equivalent to `tariffPlanToTariffs[0]`
  * @param {Map<number, Tariff[]>} tariffPlanToTariffs - A map that associates a tariff plan to the list of tariffs available for that tariff plan.

package/lib/utils/testUtils.d.ts

@@ -0,0 +1,8 @@
+/**
+ * This method return the ISO string of the date without GMT. An ISO string looks like this: YYYY-MM-DDThh:mm:ss.mmmZ
+ * @param {Date | string} date the date to convert
+ * @param {boolean} [removeTimezone=true] if true, the timezone will be removed from the ISO string, meaning
+ * that the string will look like this: YYYY-MM-DDThh:mm:ss.mmm
+ * @returns {string} the ISO string
+ */
+export declare const getISOStringWithoutGMT: (date: Date | string | null | undefined, removeTimezone?: boolean) => string | null;

package/lib/utils/testUtils.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getISOStringWithoutGMT = void 0;
+/**
+ * This method return the ISO string of the date without GMT. An ISO string looks like this: YYYY-MM-DDThh:mm:ss.mmmZ
+ * @param {Date | string} date the date to convert
+ * @param {boolean} [removeTimezone=true] if true, the timezone will be removed from the ISO string, meaning
+ * that the string will look like this: YYYY-MM-DDThh:mm:ss.mmm
+ * @returns {string} the ISO string
+ */
+var getISOStringWithoutGMT = function (date, removeTimezone) {
+    if (removeTimezone === void 0) { removeTimezone = true; }
+    if (!date)
+        return null;
+    var newDate = new Date(date);
+    var isoString = new Date(newDate.valueOf() - newDate.getTimezoneOffset() * 60000).toISOString();
+    return removeTimezone ? isoString.slice(0, -1) : isoString;
+};
+exports.getISOStringWithoutGMT = getISOStringWithoutGMT;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mts-booking-library",
-  "version": "2.2.3",
+  "version": "2.3.1",
   "description": "Library for using MyTicketSolution Booking API",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -16,8 +16,10 @@
   },
   "license": "ISC",
   "devDependencies": {
-    "@types/jest": "^29.5.13",
+    "@types/jest": "^29.5.14",
+    "dotenv": "^16.4.5",
     "jest": "^29.7.0",
+    "node-localstorage": "^3.0.5",
     "prettier": "^3.3.3",
     "ts-jest": "^29.2.5",
     "typescript": "^5.6.3"
@@ -33,8 +35,6 @@
   "dependencies": {
     "@react-native-async-storage/async-storage": "^2.0.0",
     "axios": "^1.7.7",
-    "dotenv": "^16.4.5",
-    "node-localstorage": "^3.0.5",
     "zustand": "^4.5.5"
   }
 }