mts-booking-library 1.3.22 → 1.3.24

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

@@ -2,7 +2,7 @@ import { MTSConfig, MTSEnvs } from "../config";
 import { ErrorResponse } from "../types/ErrorResponse";
 import { processedStepsToStatus } from "../types/common/Cart";
 import { GetPaymentInformationFromGatewayResponse, GetSellerGatewaysResponse, PaymentMethods, IssueTicketsResponse } from "../types/common/Payment";
-import { GetBuyerPassengersDetailsResponse, Person } from "../types/common/Person";
+import { Buyer, GetBuyerPassengersDetailsResponse, GetBuyerRequest } from "../types/common/Person";
 import { AddReductionRequest } from "../types/common/Reduction";
 export declare abstract class Booking {
     private sellerId?;
@@ -55,7 +55,7 @@ export declare abstract class Booking {
     abstract deleteCart(): Promise<ErrorResponse | any>;
     abstract resetBooking(): void;
     abstract getBuyerPassengersDetails(): Promise<ErrorResponse | GetBuyerPassengersDetailsResponse>;
-    abstract getBuyerFromLinkavelCard(linkavelCardNumber?: string, linkavelCardPhoneNumber?: string): Promise<ErrorResponse | Person>;
+    abstract getBuyer(request: GetBuyerRequest): Promise<ErrorResponse | Buyer>;
     abstract updateBuyerPassengersDetails(request: any): Promise<ErrorResponse | boolean>;
     abstract addReduction(request: AddReductionRequest): Promise<ErrorResponse | boolean>;
     abstract removeReduction(tripId: number): Promise<ErrorResponse | boolean>;

package/lib/booking/journeyBooking.d.ts

@@ -1,5 +1,5 @@
 import { ErrorResponse } from "../types/ErrorResponse";
-import { Buyer, EditPassengersDetailsRequest, GetBuyerPassengersDetailsResponse } from "../types/common/Person";
+import { Buyer, EditPassengersDetailsRequest, GetBuyerPassengersDetailsResponse, GetBuyerRequest } from "../types/common/Person";
 import { AddReductionRequest } from "../types/common/Reduction";
 import { BusMatrix } from "../types/journeys/BusMatrix";
 import { CreateJourneyCartRequest, JourneyCart } from "../types/journeys/JourneyCart";
@@ -103,12 +103,10 @@ export declare class JourneyBooking extends Booking {
     getBuyerPassengersDetails(): Promise<ErrorResponse | GetBuyerPassengersDetailsResponse>;
     /**
      * @description This method shall be called when the user wants to retrieve information about an esisting buyer.
-     * @param linkavelCard The linkavel card number of the buyer. This parameter is required if phoneNumber is not set.
-     * @param phoneNumber The phone number of the buyer. This parameter is required if linkavelCard is not set.
-     * @returns An object of type {@link GetBuyerPassengersDetailsResponse} containing the buyer and the passengers information,
-     * as well as a list of the available tariffs for each trip.
+     * @param {GetBuyerRequest} request The object containing the parameters to search the buyer.
+     * @returns An object of type {@link Buyer} containing the buyer information, or an {@link ErrorResponse} object in case of error.
      */
-    getBuyerFromLinkavelCard(linkavelCard?: string, phoneNumber?: string): Promise<ErrorResponse | Buyer>;
+    getBuyer(request: GetBuyerRequest): Promise<ErrorResponse | Buyer>;
     /**
      * @description This methosd shall be called when the user wants to update the buyer and the passengers information.
      * @param {EditPassengersDetailsRequest} passengersDetails The object containing the buyer and the passengers information.

package/lib/booking/journeyBooking.js

@@ -258,14 +258,7 @@ var JourneyBooking = /** @class */ (function (_super) {
                 if (request.departureStopName === undefined || request.destinationStopName === undefined) {
                     throw Error("Fields departureStopName and destinationStopName are required");
                 }
-                searchParams = new URLSearchParams({
-                    departureStopName: request.departureStopName,
-                    destinationStopName: request.destinationStopName,
-                    passengersNumber: request.passengersNumber.toString(),
-                    date: request.date,
-                    roundTripDate: request.roundTripDate ? request.roundTripDate : "null",
-                    currency: request.currency
-                });
+                searchParams = new URLSearchParams(__assign(__assign({ departureStopName: request.departureStopName, destinationStopName: request.destinationStopName, passengersNumber: request.passengersNumber.toString(), date: request.date, roundTripDate: request.roundTripDate ? request.roundTripDate : "null", currency: request.currency }, (this.cartId && { cartId: this.cartId.toString() })), (this.cartGuid && { cartGuid: this.cartGuid })));
                 url = "".concat(this.config.API_ENDPOINT, "/v3_booking/journeys?").concat(searchParams);
                 return [2 /*return*/, this.callGetApi(url).then(function (response) {
                         return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response)
@@ -363,15 +356,14 @@ var JourneyBooking = /** @class */ (function (_super) {
     };
     /**
      * @description This method shall be called when the user wants to retrieve information about an esisting buyer.
-     * @param linkavelCard The linkavel card number of the buyer. This parameter is required if phoneNumber is not set.
-     * @param phoneNumber The phone number of the buyer. This parameter is required if linkavelCard is not set.
-     * @returns An object of type {@link GetBuyerPassengersDetailsResponse} containing the buyer and the passengers information,
-     * as well as a list of the available tariffs for each trip.
+     * @param {GetBuyerRequest} request The object containing the parameters to search the buyer.
+     * @returns An object of type {@link Buyer} containing the buyer information, or an {@link ErrorResponse} object in case of error.
      */
-    JourneyBooking.prototype.getBuyerFromLinkavelCard = function (linkavelCard, phoneNumber) {
+    JourneyBooking.prototype.getBuyer = function (request) {
         return __awaiter(this, void 0, void 0, function () {
             var buyerPassengersDetails, searchParams, url;
-            return __generator(this, function (_a) {
+            var _a;
+            return __generator(this, function (_b) {
                 // First check that it is possible to call this API
                 if (!this.cart) {
                     throw Error("Cart is not initialized yet");
@@ -380,17 +372,17 @@ var JourneyBooking = /** @class */ (function (_super) {
                 if (!buyerPassengersDetails || !buyerPassengersDetails[0]) {
                     throw Error("The status of the cart does not allow to call this API");
                 }
-                if (!linkavelCard && !phoneNumber) {
-                    throw Error("At least one of the parameters linkavelCard or phoneNumber must be set");
+                if (!request.personId && !request.personCode && !request.phoneNumber) {
+                    throw Error("At least one of the parameters personId, personCode or phoneNumber must be set");
                 }
-                searchParams = new URLSearchParams(__assign(__assign({}, (linkavelCard && { linkavelCard: linkavelCard })), (phoneNumber && { phoneNumber: phoneNumber })));
-                url = "".concat(this.config.API_ENDPOINT, "/v3_resources/buyers?").concat(searchParams);
+                searchParams = new URLSearchParams(__assign(__assign(__assign({}, (request.personId && { personId: (_a = request.personId) === null || _a === void 0 ? void 0 : _a.toString() })), (request.personCode && { personCode: request.personCode })), (request.phoneNumber && { phoneNumber: request.phoneNumber })));
+                url = "".concat(this.config.API_ENDPOINT, "/v3_customers/persons?").concat(searchParams);
                 return [2 /*return*/, this.callGetApi(url).then(function (response) {
                         // Check for errors
                         if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
                             return response;
                         }
-                        return response.buyers[0];
+                        return response.persons[0];
                     })];
             });
         });

package/lib/booking/serviceBooking.d.ts

@@ -1,5 +1,5 @@
 import { ErrorResponse } from "../types/ErrorResponse";
-import { Buyer, GetBuyerPassengersDetailsResponse } from "../types/common/Person";
+import { Buyer, GetBuyerPassengersDetailsResponse, GetBuyerRequest } from "../types/common/Person";
 import { AddReductionRequest } from "../types/common/Reduction";
 import { Service, ServiceTripsResponse } from "../types/services/Service";
 import { CreateServiceCartRequest, ServiceCart } from "../types/services/ServiceCart";
@@ -105,12 +105,10 @@ export declare class ServiceBooking extends Booking {
     getBuyerPassengersDetails(): Promise<ErrorResponse | GetBuyerPassengersDetailsResponse>;
     /**
      * @description This method shall be called when the user wants to retrieve information about an esisting buyer.
-     * @param linkavelCard The linkavel card number of the buyer. This parameter is required if linkavelCardPhoneNumber is not set.
-     * @param phoneNumber The phone number of the buyer. This parameter is required if linkavelCard is not set.
-     * @returns An object of type {@link GetBuyerPassengersDetailsResponse} containing the buyer and the passengers information,
-     * as well as a list of the available tariffs for each trip.
+     * @param {GetBuyerRequest} request The object containing the parameters to search the buyer.
+     * @returns An object of type {@link Buyer} containing the buyer information, or an {@link ErrorResponse} object in case of error.
      */
-    getBuyerFromLinkavelCard(linkavelCard?: string, phoneNumber?: string): Promise<ErrorResponse | Buyer>;
+    getBuyer(request: GetBuyerRequest): Promise<ErrorResponse | Buyer>;
     /**
      * @description This method shall be called when the user wants to update the buyer information.
      * @param buyerDetails The object containing the buyer information.

package/lib/booking/serviceBooking.js

@@ -336,15 +336,14 @@ var ServiceBooking = /** @class */ (function (_super) {
     };
     /**
      * @description This method shall be called when the user wants to retrieve information about an esisting buyer.
-     * @param linkavelCard The linkavel card number of the buyer. This parameter is required if linkavelCardPhoneNumber is not set.
-     * @param phoneNumber The phone number of the buyer. This parameter is required if linkavelCard is not set.
-     * @returns An object of type {@link GetBuyerPassengersDetailsResponse} containing the buyer and the passengers information,
-     * as well as a list of the available tariffs for each trip.
+     * @param {GetBuyerRequest} request The object containing the parameters to search the buyer.
+     * @returns An object of type {@link Buyer} containing the buyer information, or an {@link ErrorResponse} object in case of error.
      */
-    ServiceBooking.prototype.getBuyerFromLinkavelCard = function (linkavelCard, phoneNumber) {
+    ServiceBooking.prototype.getBuyer = function (request) {
         return __awaiter(this, void 0, void 0, function () {
             var buyerPassengersDetails, searchParams, url;
-            return __generator(this, function (_a) {
+            var _a;
+            return __generator(this, function (_b) {
                 // First check that it is possible to call this API
                 if (!this.cart) {
                     throw Error("Cart is not initialized yet");
@@ -353,17 +352,17 @@ var ServiceBooking = /** @class */ (function (_super) {
                 if (!buyerPassengersDetails || !buyerPassengersDetails[0]) {
                     throw Error("The status of the cart does not allow to call this API");
                 }
-                if (!linkavelCard && !phoneNumber) {
-                    throw Error("At least one of the parameters linkavelCardNumber and linkavelCardPhoneNumber must be set");
+                if (!request.personId && !request.personCode && !request.phoneNumber) {
+                    throw Error("At least one of the parameters personId, personCode or phoneNumber must be set");
                 }
-                searchParams = new URLSearchParams(__assign(__assign({}, (linkavelCard && { linkavelCard: linkavelCard })), (phoneNumber && { phoneNumber: phoneNumber })));
-                url = "".concat(this.config.API_ENDPOINT, "/v3_resources/buyers?").concat(searchParams);
+                searchParams = new URLSearchParams(__assign(__assign(__assign({}, (request.personId && { personId: (_a = request.personId) === null || _a === void 0 ? void 0 : _a.toString() })), (request.personCode && { personCode: request.personCode })), (request.phoneNumber && { phoneNumber: request.phoneNumber })));
+                url = "".concat(this.config.API_ENDPOINT, "/v3_customers/persons?").concat(searchParams);
                 return [2 /*return*/, this.callGetApi(url).then(function (response) {
                         // Check for errors
                         if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
                             return response;
                         }
-                        return response.buyers[0];
+                        return response.persons[0];
                     })];
             });
         });

package/lib/booking/subscriptionBooking.d.ts

@@ -1,5 +1,5 @@
 import { ErrorResponse } from "../types/ErrorResponse";
-import { Buyer, EditPassengersDetailsRequest, GetBuyerPassengersDetailsResponse } from "../types/common/Person";
+import { Buyer, EditPassengersDetailsRequest, GetBuyerPassengersDetailsResponse, GetBuyerRequest } from "../types/common/Person";
 import { AddReductionRequest } from "../types/common/Reduction";
 import { GetSubscriptionAvailabilityRequest, GetSubscriptionAvailabilityResponse } from "../types/subscriptions/SubscriptionAvailabilities";
 import { CreateSubscriptionCartRequest, SubscriptionCart } from "../types/subscriptions/SubscriptionCart";
@@ -124,12 +124,10 @@ export declare class SubscriptionBooking extends Booking {
     getBuyerPassengersDetails(): Promise<ErrorResponse | GetBuyerPassengersDetailsResponse>;
     /**
      * @description This method shall be called when the user wants to retrieve information about an esisting buyer.
-     * @param linkavelCard The linkavel card number of the buyer. This parameter is required if linkavelCardPhoneNumber is not set.
-     * @param phoneNumber The phone number of the buyer. This parameter is required if linkavelCard is not set.
-     * @returns An object of type {@link GetBuyerPassengersDetailsResponse} containing the buyer and the passengers information,
-     * as well as a list of the available tariffs for each trip.
+     * @param {GetBuyerRequest} request The object containing the parameters to search the buyer.
+     * @returns An object of type {@link Buyer} containing the buyer information, or an {@link ErrorResponse} object in case of error.
      */
-    getBuyerFromLinkavelCard(linkavelCard?: string, phoneNumber?: string): Promise<ErrorResponse | Buyer>;
+    getBuyer(request: GetBuyerRequest): Promise<ErrorResponse | Buyer>;
     /**
      * @description This methosd shall be called when the user wants to update the buyer and the passengers information.
      * @param {EditPassengersDetailsRequest} passengersDetails The object containing the buyer and the passengers information.

package/lib/booking/subscriptionBooking.js

@@ -415,15 +415,14 @@ var SubscriptionBooking = /** @class */ (function (_super) {
     };
     /**
      * @description This method shall be called when the user wants to retrieve information about an esisting buyer.
-     * @param linkavelCard The linkavel card number of the buyer. This parameter is required if linkavelCardPhoneNumber is not set.
-     * @param phoneNumber The phone number of the buyer. This parameter is required if linkavelCard is not set.
-     * @returns An object of type {@link GetBuyerPassengersDetailsResponse} containing the buyer and the passengers information,
-     * as well as a list of the available tariffs for each trip.
+     * @param {GetBuyerRequest} request The object containing the parameters to search the buyer.
+     * @returns An object of type {@link Buyer} containing the buyer information, or an {@link ErrorResponse} object in case of error.
      */
-    SubscriptionBooking.prototype.getBuyerFromLinkavelCard = function (linkavelCard, phoneNumber) {
+    SubscriptionBooking.prototype.getBuyer = function (request) {
         return __awaiter(this, void 0, void 0, function () {
             var buyerPassengersDetails, searchParams, url;
-            return __generator(this, function (_a) {
+            var _a;
+            return __generator(this, function (_b) {
                 // First check that it is possible to call this API
                 if (!this.cart) {
                     throw Error("Cart is not initialized yet");
@@ -432,17 +431,17 @@ var SubscriptionBooking = /** @class */ (function (_super) {
                 if (!buyerPassengersDetails || !buyerPassengersDetails[0]) {
                     throw Error("The status of the cart does not allow to call this API");
                 }
-                if (!linkavelCard && !phoneNumber) {
-                    throw Error("At least one of the parameters linkavelCardNumber and linkavelCardPhoneNumber must be set");
+                if (!request.personId && !request.personCode && !request.phoneNumber) {
+                    throw Error("At least one of the parameters personId, personCode or phoneNumber must be set");
                 }
-                searchParams = new URLSearchParams(__assign(__assign({}, (linkavelCard && { linkavelCard: linkavelCard })), (phoneNumber && { phoneNumber: phoneNumber })));
-                url = "".concat(this.config.API_ENDPOINT, "/v3_resources/buyers?").concat(searchParams);
+                searchParams = new URLSearchParams(__assign(__assign(__assign({}, (request.personId && { personId: (_a = request.personId) === null || _a === void 0 ? void 0 : _a.toString() })), (request.personCode && { personCode: request.personCode })), (request.phoneNumber && { phoneNumber: request.phoneNumber })));
+                url = "".concat(this.config.API_ENDPOINT, "/v3_customers/persons?").concat(searchParams);
                 return [2 /*return*/, this.callGetApi(url).then(function (response) {
                         // Check for errors
                         if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
                             return response;
                         }
-                        return response.buyers[0];
+                        return response.persons[0];
                     })];
             });
         });

package/lib/booking/tplBooking.d.ts

@@ -1,6 +1,6 @@
 import { ErrorResponse } from "../types/ErrorResponse";
 import { City } from "../types/common/City";
-import { Buyer, GetBuyerPassengersDetailsResponse } from "../types/common/Person";
+import { Buyer, GetBuyerPassengersDetailsResponse, GetBuyerRequest } from "../types/common/Person";
 import { AddReductionRequest } from "../types/common/Reduction";
 import { TariffType, TermsType } from "../types/common/Tariffs";
 import { GetTariffsResponse } from "../types/tpl/GetTariffsResponse";
@@ -125,12 +125,10 @@ export declare class TplBooking extends Booking {
     getBuyerPassengersDetails(): Promise<ErrorResponse | GetBuyerPassengersDetailsResponse>;
     /**
      * @description This method shall be called when the user wants to retrieve information about an esisting buyer.
-     * @param linkavelCard The linkavel card number of the buyer. This parameter is required if linkavelCardPhoneNumber is not set.
-     * @param phoneNumber The phone number of the buyer. This parameter is required if linkavelCard is not set.
-     * @returns An object of type {@link GetBuyerPassengersDetailsResponse} containing the buyer and the passengers information,
-     * as well as a list of the available tariffs for each trip.
+     * @param {GetBuyerRequest} request The object containing the parameters to search the buyer.
+     * @returns An object of type {@link Buyer} containing the buyer information, or an {@link ErrorResponse} object in case of error.
      */
-    getBuyerFromLinkavelCard(linkavelCard?: string, phoneNumber?: string): Promise<ErrorResponse | Buyer>;
+    getBuyer(request: GetBuyerRequest): Promise<ErrorResponse | Buyer>;
     /**
      * @description This method shall be called when the user wants to update the buyer information.
      * @param buyerDetails The object containing the buyer information.

package/lib/booking/tplBooking.js

@@ -396,15 +396,14 @@ var TplBooking = /** @class */ (function (_super) {
     };
     /**
      * @description This method shall be called when the user wants to retrieve information about an esisting buyer.
-     * @param linkavelCard The linkavel card number of the buyer. This parameter is required if linkavelCardPhoneNumber is not set.
-     * @param phoneNumber The phone number of the buyer. This parameter is required if linkavelCard is not set.
-     * @returns An object of type {@link GetBuyerPassengersDetailsResponse} containing the buyer and the passengers information,
-     * as well as a list of the available tariffs for each trip.
+     * @param {GetBuyerRequest} request The object containing the parameters to search the buyer.
+     * @returns An object of type {@link Buyer} containing the buyer information, or an {@link ErrorResponse} object in case of error.
      */
-    TplBooking.prototype.getBuyerFromLinkavelCard = function (linkavelCard, phoneNumber) {
+    TplBooking.prototype.getBuyer = function (request) {
         return __awaiter(this, void 0, void 0, function () {
             var buyerPassengersDetails, searchParams, url;
-            return __generator(this, function (_a) {
+            var _a;
+            return __generator(this, function (_b) {
                 // First check that it is possible to call this API
                 if (!this.cart) {
                     throw Error("Cart is not initialized yet");
@@ -413,17 +412,17 @@ var TplBooking = /** @class */ (function (_super) {
                 if (!buyerPassengersDetails || !buyerPassengersDetails[0]) {
                     throw Error("The status of the cart does not allow to call this API");
                 }
-                if (!linkavelCard && !phoneNumber) {
-                    throw Error("At least one of the parameters linkavelCardNumber and linkavelCardPhoneNumber must be set");
+                if (!request.personId && !request.personCode && !request.phoneNumber) {
+                    throw Error("At least one of the parameters personId, personCode or phoneNumber must be set");
                 }
-                searchParams = new URLSearchParams(__assign(__assign({}, (linkavelCard && { linkavelCard: linkavelCard })), (phoneNumber && { phoneNumber: phoneNumber })));
-                url = "".concat(this.config.API_ENDPOINT, "/v3_resources/buyers?").concat(searchParams);
+                searchParams = new URLSearchParams(__assign(__assign(__assign({}, (request.personId && { personId: (_a = request.personId) === null || _a === void 0 ? void 0 : _a.toString() })), (request.personCode && { personCode: request.personCode })), (request.phoneNumber && { phoneNumber: request.phoneNumber })));
+                url = "".concat(this.config.API_ENDPOINT, "/v3_customers/persons?").concat(searchParams);
                 return [2 /*return*/, this.callGetApi(url).then(function (response) {
                         // Check for errors
                         if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
                             return response;
                         }
-                        return response.buyers[0];
+                        return response.persons[0];
                     })];
             });
         });

package/lib/index.d.ts

@@ -4,9 +4,8 @@ export { ServiceBooking } from "./booking/serviceBooking";
 export { SubscriptionBooking } from "./booking/subscriptionBooking";
 export { TplBooking } from "./booking/tplBooking";
 export { useMtsBookingState } from "./mtsStorage";
-export { Person, DEFAULT_PERSON, initializePerson } from "./types/common/Person";
-export { GetBuyerPassengersDetailsResponse, GetPassenger, BuyerDataStatus } from "./types/common/Person";
-export { EditPassengerRequestType, EditPassengersDetailsRequest } from "./types/common/Person";
+export { Person, Buyer, DEFAULT_PERSON, initializePerson } from "./types/common/Person";
+export { GetBuyerPassengersDetailsResponse, GetBuyerRequest, GetPassenger, BuyerDataStatus, EditPassengerRequestType, EditPassengersDetailsRequest } from "./types/common/Person";
 export { Tariff, TariffsMatrix, TariffSummary, TariffType, TermsType, PassengerTariff, ExtraTariff } from "./types/common/Tariffs";
 export { Reduction, AddReductionRequest } from "./types/common/Reduction";
 export { Gateway, GetSellerGatewaysResponse, GetPaymentInformationFromGatewayResponse, IssueTicketsResponse, GatewayTypes, PaymentMethods } from "./types/common/Payment";

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

@@ -25,7 +25,18 @@ export type Buyer = Person & {
 export declare const DEFAULT_PERSON: Person;
 export declare const initializePerson: (person?: Person | undefined | null) => Person;
 /**
- * @description Represents a passenger in the response of the {@link getPassengersDetails} method. This type extends the {@link Person} type
+ * @description Represents the request for the {@link Booking.getBuyerFromLinkavelCard} method.
+ * @property {number} personId - The unique identifier of the buyer.
+ * @property {string} personCode - The person code of the person (the old linkAvelCardNumber)
+ * @property {string} phoneNumber - The phone number of the person.
+ */
+export type GetBuyerRequest = {
+    personId?: number;
+    personCode?: string;
+    phoneNumber?: string;
+};
+/**
+ * @description Represents a passenger in the response of the {@link Booking.getPassengersDetails} method. This type extends the {@link Person} type
  * with the `outboundTariffs` and `returnTariffs` properties.
  *
  * @property {string} outboundNotes - The notes for the outbound trip.

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": "1.3.22",
+  "version": "1.3.24",
   "description": "Library for using MyTicketSolution Booking API",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -19,7 +19,7 @@
     "@types/jest": "^29.5.12",
     "jest": "^29.7.0",
     "prettier": "^3.3.3",
-    "ts-jest": "^29.2.3",
+    "ts-jest": "^29.2.4",
     "typescript": "^5.5.4"
   },
   "files": [
@@ -31,10 +31,10 @@
   ],
   "author": "Infoservice s.r.l.",
   "dependencies": {
-    "@react-native-async-storage/async-storage": "^1.23.1",
-    "axios": "^1.7.2",
+    "@react-native-async-storage/async-storage": "^1.24.0",
+    "axios": "^1.7.4",
     "dotenv": "^16.4.5",
     "node-localstorage": "^3.0.5",
-    "zustand": "^4.5.4"
+    "zustand": "^4.5.5"
   }
 }