mts-booking-library 1.3.23 → 1.3.25

package/lib/booking/booking.d.ts

@@ -20,7 +20,7 @@ export declare abstract class Booking {
      * - The third tells whether the section is required. <br/>
      */
     bookingStepsToStatus: processedStepsToStatus;
-    /** @deprecated Please use {@link Booking.cartGuid} instead */
+    /** @deprecated Please use {@link cartGuid} instead */
     cartId: number | undefined;
     cartGuid: string | undefined;
     bookingDueDate: Date | undefined;
@@ -69,8 +69,8 @@ export declare abstract class Booking {
     getSellerGateways(): Promise<ErrorResponse | GetSellerGatewaysResponse>;
     /**
      * @description This method shall be used to get all necessary informations to initialize a payment with a certain gateway.
-     * @param {number} gatewayId The id of the gateway to use. Its value shall be taken from the response of the {@link Booking.getSellerGateways} API
-     * @param {string} [returnUrl=undefined] The url to which the user will be redirected after the payment. This value shall be set only if the
+     * @param gatewayId The id of the gateway to use. Its value shall be taken from the response of the {@link Booking.getSellerGateways} API
+     * @param returnUrl The url to which the user will be redirected after the payment. This value shall be set only if the
      * chosen gateway is {@link GatewayTypes.PAYPAL} or {@link GatewayTypes.WORLDLINE}
      * @returns An {@link ErrorResponse} object in case of error, a {@link GetPaymentInformationFromGatewayResponse} object otherwise.
      */

package/lib/booking/booking.js

@@ -53,6 +53,7 @@ var ErrorResponse_1 = require("../types/ErrorResponse");
 var Payment_1 = require("../types/common/Payment");
 var apiCall_1 = require("../utils/apiCall");
 var processBookingSteps_1 = require("../utils/processBookingSteps");
+var utils_1 = require("../utils/utils");
 var Booking = /** @class */ (function () {
     /**
      * This is the constructor of the Booking class. See {@link Booking.BookingConfig} for more information.
@@ -160,7 +161,7 @@ var Booking = /** @class */ (function () {
             var _this = this;
             return __generator(this, function (_a) {
                 // First check that it is possible to call this API
-                if (!this.cartId || this.cartId === 0) {
+                if ((0, utils_1.isNullOrWhiteSpace)(this.cartGuid)) {
                     throw Error("Cart is not initialized yet");
                 }
                 currentStepStatus = this.bookingStepsToStatus.get(bookingStep);
@@ -174,7 +175,7 @@ var Booking = /** @class */ (function () {
                 // Booking step is already completed, no need to call the API
                 if (currentStepStatus[0])
                     return [2 /*return*/, true];
-                url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/").concat(this.cartId, "/bookingSteps");
+                url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/bookingSteps");
                 return [2 /*return*/, this.callPostApi(url, { bookingStep: bookingStep }).then(function (response) {
                         if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
                             return response;
@@ -200,7 +201,7 @@ var Booking = /** @class */ (function () {
                 switch (_c.label) {
                     case 0:
                         // First check that it is possible to call this API
-                        if (!this.cartId || this.cartId === 0) {
+                        if (!this.cartGuid || (0, utils_1.isNullOrWhiteSpace)(this.cartGuid)) {
                             throw Error("Cart is not initialized yet");
                         }
                         issueStep = this.bookingStepsToStatus.get(Booking.BookingSteps.ISSUE);
@@ -245,8 +246,8 @@ var Booking = /** @class */ (function () {
     };
     /**
      * @description This method shall be used to get all necessary informations to initialize a payment with a certain gateway.
-     * @param {number} gatewayId The id of the gateway to use. Its value shall be taken from the response of the {@link Booking.getSellerGateways} API
-     * @param {string} [returnUrl=undefined] The url to which the user will be redirected after the payment. This value shall be set only if the
+     * @param gatewayId The id of the gateway to use. Its value shall be taken from the response of the {@link Booking.getSellerGateways} API
+     * @param returnUrl The url to which the user will be redirected after the payment. This value shall be set only if the
      * chosen gateway is {@link GatewayTypes.PAYPAL} or {@link GatewayTypes.WORLDLINE}
      * @returns An {@link ErrorResponse} object in case of error, a {@link GetPaymentInformationFromGatewayResponse} object otherwise.
      */
@@ -255,15 +256,15 @@ var Booking = /** @class */ (function () {
             var issueStep, searchParams, url;
             return __generator(this, function (_a) {
                 // First check that it is possible to call this API
-                if (!this.cartId || this.cartId === 0) {
+                if ((0, utils_1.isNullOrWhiteSpace)(this.cartGuid)) {
                     throw Error("Cart is not initialized yet");
                 }
                 issueStep = this.bookingStepsToStatus.get(Booking.BookingSteps.ISSUE);
                 if (!issueStep || !issueStep[0]) {
                     throw Error("The status of the cart does not allow to call this API");
                 }
-                searchParams = new URLSearchParams(__assign({ gatewayId: gatewayId.toString() }, (returnUrl && { returnUrl: returnUrl })));
-                url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/").concat(this.cartId, "/payment?").concat(searchParams);
+                searchParams = new URLSearchParams(__assign({ gatewayId: gatewayId.toString(), cartGuid: this.cartGuid }, (returnUrl && { returnUrl: returnUrl })));
+                url = "".concat(this.config.API_ENDPOINT, "/v3_payment/paymentInformation?").concat(searchParams);
                 return [2 /*return*/, this.callGetApi(url).then(function (response) {
                         return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response)
                             ? response
@@ -272,6 +273,7 @@ var Booking = /** @class */ (function () {
             });
         });
     };
+    // TODO: Rename this as issueCart
     /**
      * @description This method shall be used to issue the tickets. It must be called after the payment was successful.
      * @param {PaymentMethods} paymentMethod The payment method used to pay the cart. If the chosen method is {@link PaymentMethods.ZERO_COST},

package/lib/booking/journeyBooking.js

@@ -77,6 +77,7 @@ var mtsStorage_1 = require("../mtsStorage");
 var ErrorResponse_1 = require("../types/ErrorResponse");
 var Reduction_1 = require("../types/common/Reduction");
 var processBookingSteps_1 = require("../utils/processBookingSteps");
+var utils_1 = require("../utils/utils");
 var booking_1 = require("./booking");
 var JourneyBooking = /** @class */ (function (_super) {
     __extends(JourneyBooking, _super);
@@ -354,6 +355,7 @@ var JourneyBooking = /** @class */ (function (_super) {
             });
         });
     };
+    // TODO: rename this as getPerson and use personDetails as return type
     /**
      * @description This method shall be called when the user wants to retrieve information about an esisting buyer.
      * @param {GetBuyerRequest} request The object containing the parameters to search the buyer.
@@ -562,7 +564,7 @@ var JourneyBooking = /** @class */ (function (_super) {
                 switch (_c.label) {
                     case 0:
                         // First check that it is possible to call this API
-                        if (!this.cartId || this.cartId === 0) {
+                        if ((0, utils_1.isNullOrWhiteSpace)(this.cartGuid)) {
                             throw Error("Cart is not initialized yet");
                         }
                         discountsStep = this.bookingStepsToStatus.get(booking_1.Booking.BookingSteps.DISCOUNTS);
@@ -590,8 +592,8 @@ var JourneyBooking = /** @class */ (function (_super) {
                         }
                         _c.label = 5;
                     case 5:
-                        url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/").concat(this.cartId, "/payment/reduction");
-                        return [2 /*return*/, this.callPostApi(url, request).then(function (response) {
+                        url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/payment/reduction");
+                        return [2 /*return*/, this.callPostApi(url, __assign(__assign({}, request), { cartId: this.cartId, cartGuid: this.cartGuid })).then(function (response) {
                                 var _a, _b;
                                 if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
                                     return response;
@@ -619,15 +621,15 @@ var JourneyBooking = /** @class */ (function (_super) {
             var _this = this;
             return __generator(this, function (_a) {
                 // First check that it is possible to call this API
-                if (!this.cartId || this.cartId === 0) {
+                if ((0, utils_1.isNullOrWhiteSpace)(this.cartGuid)) {
                     throw Error("Cart is not initialized yet");
                 }
                 discountsStep = this.bookingStepsToStatus.get(booking_1.Booking.BookingSteps.DISCOUNTS);
                 if (!discountsStep || !discountsStep[0]) {
                     throw Error("The status of the cart does not allow to call this API");
                 }
-                queryParams = new URLSearchParams({ tripId: tripId.toString() });
-                url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/").concat(this.cartId, "/payment/reduction?").concat(queryParams);
+                queryParams = new URLSearchParams({ tripId: tripId.toString(), cartId: this.cartId.toString(), cartGuid: this.cartGuid });
+                url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/payment/reduction?").concat(queryParams);
                 return [2 /*return*/, this.callDeleteApi(url).then(function (response) {
                         var _a, _b, _c;
                         if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
@@ -662,7 +664,7 @@ var JourneyBooking = /** @class */ (function (_super) {
                 switch (_c.label) {
                     case 0:
                         // First check that it is possible to call this API
-                        if (!this.cartId || this.cartId === 0) {
+                        if ((0, utils_1.isNullOrWhiteSpace)(this.cartGuid)) {
                             throw Error("Cart is not initialized yet");
                         }
                         issueStep = this.bookingStepsToStatus.get(booking_1.Booking.BookingSteps.ISSUE);
@@ -690,12 +692,12 @@ var JourneyBooking = /** @class */ (function (_super) {
                         // Check again if the discounts step is accessible
                         issueStep = this.bookingStepsToStatus.get(booking_1.Booking.BookingSteps.ISSUE);
                         if (!issueStep || !issueStep[0]) {
-                            throw Error("The status of the cart does not allow to call the API: booking/carts/".concat(this.cartId, "/payment/wallet"));
+                            throw Error("The status of the cart does not allow to call the API: booking/carts/payment/wallet");
                         }
                         _c.label = 5;
                     case 5:
-                        url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/").concat(this.cartId, "/payment/wallet");
-                        return [2 /*return*/, this.callPostApi(url, {}).then(function (response) {
+                        url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/payment/wallet");
+                        return [2 /*return*/, this.callPostApi(url, { cartId: this.cartId, cartGuid: this.cartGuid }).then(function (response) {
                                 var _a, _b;
                                 if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
                                     return response;
@@ -718,14 +720,15 @@ var JourneyBooking = /** @class */ (function (_super) {
      */
     JourneyBooking.prototype.removeWalletReduction = function () {
         return __awaiter(this, void 0, void 0, function () {
-            var url;
+            var queryParams, url;
             var _this = this;
             return __generator(this, function (_a) {
                 // First check that it is possible to call this API
-                if (!this.cartId || this.cartId === 0) {
+                if ((0, utils_1.isNullOrWhiteSpace)(this.cartGuid)) {
                     throw Error("Cart is not initialized yet");
                 }
-                url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/").concat(this.cartId, "/payment/wallet");
+                queryParams = new URLSearchParams({ cartId: this.cartId.toString(), cartGuid: this.cartGuid });
+                url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/payment/wallet?").concat(queryParams);
                 return [2 /*return*/, this.callDeleteApi(url).then(function (response) {
                         var _a, _b, _c;
                         if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {

package/lib/booking/serviceBooking.js

@@ -77,6 +77,7 @@ var mtsStorage_1 = require("../mtsStorage");
 var ErrorResponse_1 = require("../types/ErrorResponse");
 var Reduction_1 = require("../types/common/Reduction");
 var processBookingSteps_1 = require("../utils/processBookingSteps");
+var utils_1 = require("../utils/utils");
 var booking_1 = require("./booking");
 var ServiceBooking = /** @class */ (function (_super) {
     __extends(ServiceBooking, _super);
@@ -419,7 +420,7 @@ var ServiceBooking = /** @class */ (function (_super) {
                 switch (_c.label) {
                     case 0:
                         // First check that it is possible to call this API
-                        if (!this.cartId || this.cartId === 0) {
+                        if ((0, utils_1.isNullOrWhiteSpace)(this.cartGuid)) {
                             throw Error("Cart is not initialized yet");
                         }
                         discountsStep = this.bookingStepsToStatus.get(booking_1.Booking.BookingSteps.DISCOUNTS);
@@ -447,8 +448,8 @@ var ServiceBooking = /** @class */ (function (_super) {
                         }
                         _c.label = 5;
                     case 5:
-                        url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/").concat(this.cartId, "/payment/reduction");
-                        return [2 /*return*/, this.callPostApi(url, request).then(function (response) {
+                        url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/payment/reduction");
+                        return [2 /*return*/, this.callPostApi(url, __assign(__assign({}, request), { cartId: this.cartId, cartGuid: this.cartGuid })).then(function (response) {
                                 var _a, _b;
                                 if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
                                     return response;
@@ -476,15 +477,15 @@ var ServiceBooking = /** @class */ (function (_super) {
             var _this = this;
             return __generator(this, function (_a) {
                 // First check that it is possible to call this API
-                if (!this.cartId || this.cartId === 0) {
+                if ((0, utils_1.isNullOrWhiteSpace)(this.cartGuid)) {
                     throw Error("Cart is not initialized yet");
                 }
                 discountsStep = this.bookingStepsToStatus.get(booking_1.Booking.BookingSteps.DISCOUNTS);
                 if (!discountsStep || !discountsStep[0]) {
                     throw Error("The status of the cart does not allow to call this API");
                 }
-                queryParams = new URLSearchParams({ tripId: tripId.toString() });
-                url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/").concat(this.cartId, "/payment/reduction?").concat(queryParams);
+                queryParams = new URLSearchParams({ tripId: tripId.toString(), cartId: this.cartId.toString(), cartGuid: this.cartGuid });
+                url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/payment/reduction?").concat(queryParams);
                 return [2 /*return*/, this.callDeleteApi(url).then(function (response) {
                         var _a, _b, _c;
                         if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
@@ -519,7 +520,7 @@ var ServiceBooking = /** @class */ (function (_super) {
                 switch (_c.label) {
                     case 0:
                         // First check that it is possible to call this API
-                        if (!this.cartId || this.cartId === 0) {
+                        if ((0, utils_1.isNullOrWhiteSpace)(this.cartGuid)) {
                             throw Error("Cart is not initialized yet");
                         }
                         issueStep = this.bookingStepsToStatus.get(booking_1.Booking.BookingSteps.ISSUE);
@@ -547,12 +548,12 @@ var ServiceBooking = /** @class */ (function (_super) {
                         // Check again if the discounts step is accessible
                         issueStep = this.bookingStepsToStatus.get(booking_1.Booking.BookingSteps.ISSUE);
                         if (!issueStep || !issueStep[0]) {
-                            throw Error("The status of the cart does not allow to call the API: booking/carts/".concat(this.cartId, "/payment/wallet"));
+                            throw Error("The status of the cart does not allow to call the API: booking/carts/payment/wallet");
                         }
                         _c.label = 5;
                     case 5:
-                        url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/").concat(this.cartId, "/payment/wallet");
-                        return [2 /*return*/, this.callPostApi(url, {}).then(function (response) {
+                        url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/payment/wallet");
+                        return [2 /*return*/, this.callPostApi(url, { cartId: this.cartId, cartGuid: this.cartGuid }).then(function (response) {
                                 var _a, _b;
                                 if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
                                     return response;
@@ -575,14 +576,15 @@ var ServiceBooking = /** @class */ (function (_super) {
      */
     ServiceBooking.prototype.removeWalletReduction = function () {
         return __awaiter(this, void 0, void 0, function () {
-            var url;
+            var queryParams, url;
             var _this = this;
             return __generator(this, function (_a) {
                 // First check that it is possible to call this API
-                if (!this.cartId || this.cartId === 0) {
+                if ((0, utils_1.isNullOrWhiteSpace)(this.cartGuid)) {
                     throw Error("Cart is not initialized yet");
                 }
-                url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/").concat(this.cartId, "/payment/wallet");
+                queryParams = new URLSearchParams({ cartId: this.cartId.toString(), cartGuid: this.cartGuid });
+                url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/payment/wallet?").concat(queryParams);
                 return [2 /*return*/, this.callDeleteApi(url).then(function (response) {
                         var _a, _b, _c;
                         if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {

package/lib/booking/subscriptionBooking.js

@@ -77,6 +77,7 @@ var mtsStorage_1 = require("../mtsStorage");
 var ErrorResponse_1 = require("../types/ErrorResponse");
 var Reduction_1 = require("../types/common/Reduction");
 var processBookingSteps_1 = require("../utils/processBookingSteps");
+var utils_1 = require("../utils/utils");
 var booking_1 = require("./booking");
 var SubscriptionBooking = /** @class */ (function (_super) {
     __extends(SubscriptionBooking, _super);
@@ -499,7 +500,7 @@ var SubscriptionBooking = /** @class */ (function (_super) {
                 switch (_c.label) {
                     case 0:
                         // First check that it is possible to call this API
-                        if (!this.cartId || this.cartId === 0) {
+                        if ((0, utils_1.isNullOrWhiteSpace)(this.cartGuid)) {
                             throw Error("Cart is not initialized yet");
                         }
                         discountsStep = this.bookingStepsToStatus.get(booking_1.Booking.BookingSteps.DISCOUNTS);
@@ -527,8 +528,8 @@ var SubscriptionBooking = /** @class */ (function (_super) {
                         }
                         _c.label = 5;
                     case 5:
-                        url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/").concat(this.cartId, "/payment/reduction");
-                        return [2 /*return*/, this.callPostApi(url, request).then(function (response) {
+                        url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/payment/reduction");
+                        return [2 /*return*/, this.callPostApi(url, __assign(__assign({}, request), { cartId: this.cartId, cartGuid: this.cartGuid })).then(function (response) {
                                 var _a, _b;
                                 if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
                                     return response;
@@ -556,15 +557,15 @@ var SubscriptionBooking = /** @class */ (function (_super) {
             var _this = this;
             return __generator(this, function (_a) {
                 // First check that it is possible to call this API
-                if (!this.cartId || this.cartId === 0) {
+                if ((0, utils_1.isNullOrWhiteSpace)(this.cartGuid)) {
                     throw Error("Cart is not initialized yet");
                 }
                 discountsStep = this.bookingStepsToStatus.get(booking_1.Booking.BookingSteps.DISCOUNTS);
                 if (!discountsStep || !discountsStep[0]) {
                     throw Error("The status of the cart does not allow to call this API");
                 }
-                queryParams = new URLSearchParams({ tripId: tripId.toString() });
-                url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/").concat(this.cartId, "/payment/reduction?").concat(queryParams);
+                queryParams = new URLSearchParams({ tripId: tripId.toString(), cartId: this.cartId.toString(), cartGuid: this.cartGuid });
+                url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/payment/reduction?").concat(queryParams);
                 return [2 /*return*/, this.callDeleteApi(url).then(function (response) {
                         var _a, _b, _c;
                         if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
@@ -599,7 +600,7 @@ var SubscriptionBooking = /** @class */ (function (_super) {
                 switch (_c.label) {
                     case 0:
                         // First check that it is possible to call this API
-                        if (!this.cartId || this.cartId === 0) {
+                        if ((0, utils_1.isNullOrWhiteSpace)(this.cartGuid)) {
                             throw Error("Cart is not initialized yet");
                         }
                         issueStep = this.bookingStepsToStatus.get(booking_1.Booking.BookingSteps.ISSUE);
@@ -627,12 +628,12 @@ var SubscriptionBooking = /** @class */ (function (_super) {
                         // Check again if the discounts step is accessible
                         issueStep = this.bookingStepsToStatus.get(booking_1.Booking.BookingSteps.ISSUE);
                         if (!issueStep || !issueStep[0]) {
-                            throw Error("The status of the cart does not allow to call the API: booking/carts/".concat(this.cartId, "/payment/wallet"));
+                            throw Error("The status of the cart does not allow to call the API: booking/carts/payment/wallet");
                         }
                         _c.label = 5;
                     case 5:
-                        url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/").concat(this.cartId, "/payment/wallet");
-                        return [2 /*return*/, this.callPostApi(url, {}).then(function (response) {
+                        url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/payment/wallet");
+                        return [2 /*return*/, this.callPostApi(url, { cartId: this.cartId, cartGuid: this.cartGuid }).then(function (response) {
                                 var _a, _b;
                                 if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
                                     return response;
@@ -655,14 +656,15 @@ var SubscriptionBooking = /** @class */ (function (_super) {
      */
     SubscriptionBooking.prototype.removeWalletReduction = function () {
         return __awaiter(this, void 0, void 0, function () {
-            var url;
+            var queryParams, url;
             var _this = this;
             return __generator(this, function (_a) {
                 // First check that it is possible to call this API
-                if (!this.cartId || this.cartId === 0) {
+                if ((0, utils_1.isNullOrWhiteSpace)(this.cartGuid)) {
                     throw Error("Cart is not initialized yet");
                 }
-                url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/").concat(this.cartId, "/payment/wallet");
+                queryParams = new URLSearchParams({ cartId: this.cartId.toString(), cartGuid: this.cartGuid });
+                url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/payment/wallet?").concat(queryParams);
                 return [2 /*return*/, this.callDeleteApi(url).then(function (response) {
                         var _a, _b, _c;
                         if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {

package/lib/booking/tplBooking.js

@@ -77,6 +77,7 @@ var mtsStorage_1 = require("../mtsStorage");
 var ErrorResponse_1 = require("../types/ErrorResponse");
 var Reduction_1 = require("../types/common/Reduction");
 var processBookingSteps_1 = require("../utils/processBookingSteps");
+var utils_1 = require("../utils/utils");
 var booking_1 = require("./booking");
 var TplBooking = /** @class */ (function (_super) {
     __extends(TplBooking, _super);
@@ -226,6 +227,7 @@ var TplBooking = /** @class */ (function (_super) {
             });
         });
     };
+    // TODO: use v3_resources/superAreas
     /**
      * This method fetches the list of super areas for a given city. A super area is a region of the city in which
      * the TPL service is available at a certain price.
@@ -491,7 +493,7 @@ var TplBooking = /** @class */ (function (_super) {
                 switch (_c.label) {
                     case 0:
                         // First check that it is possible to call this API
-                        if (!this.cartId || this.cartId === 0) {
+                        if ((0, utils_1.isNullOrWhiteSpace)(this.cartGuid)) {
                             throw Error("Cart is not initialized yet");
                         }
                         discountsStep = this.bookingStepsToStatus.get(booking_1.Booking.BookingSteps.DISCOUNTS);
@@ -519,8 +521,8 @@ var TplBooking = /** @class */ (function (_super) {
                         }
                         _c.label = 5;
                     case 5:
-                        url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/").concat(this.cartId, "/payment/reduction");
-                        return [2 /*return*/, this.callPostApi(url, request).then(function (response) {
+                        url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/payment/reduction");
+                        return [2 /*return*/, this.callPostApi(url, __assign(__assign({}, request), { cartId: this.cartId, cartGuid: this.cartGuid })).then(function (response) {
                                 var _a, _b;
                                 if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
                                     return response;
@@ -548,15 +550,15 @@ var TplBooking = /** @class */ (function (_super) {
             var _this = this;
             return __generator(this, function (_a) {
                 // First check that it is possible to call this API
-                if (!this.cartId || this.cartId === 0) {
+                if ((0, utils_1.isNullOrWhiteSpace)(this.cartGuid)) {
                     throw Error("Cart is not initialized yet");
                 }
                 discountsStep = this.bookingStepsToStatus.get(booking_1.Booking.BookingSteps.DISCOUNTS);
                 if (!discountsStep || !discountsStep[0]) {
                     throw Error("The status of the cart does not allow to call this API");
                 }
-                queryParams = new URLSearchParams({ tripId: tripId.toString() });
-                url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/").concat(this.cartId, "/payment/reduction?").concat(queryParams);
+                queryParams = new URLSearchParams({ tripId: tripId.toString(), cartId: this.cartId.toString(), cartGuid: this.cartGuid });
+                url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/payment/reduction?").concat(queryParams);
                 return [2 /*return*/, this.callDeleteApi(url).then(function (response) {
                         var _a, _b, _c;
                         if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
@@ -591,7 +593,7 @@ var TplBooking = /** @class */ (function (_super) {
                 switch (_c.label) {
                     case 0:
                         // First check that it is possible to call this API
-                        if (!this.cartId || this.cartId === 0) {
+                        if ((0, utils_1.isNullOrWhiteSpace)(this.cartGuid)) {
                             throw Error("Cart is not initialized yet");
                         }
                         issueStep = this.bookingStepsToStatus.get(booking_1.Booking.BookingSteps.ISSUE);
@@ -619,12 +621,12 @@ var TplBooking = /** @class */ (function (_super) {
                         // Check again if the discounts step is accessible
                         issueStep = this.bookingStepsToStatus.get(booking_1.Booking.BookingSteps.ISSUE);
                         if (!issueStep || !issueStep[0]) {
-                            throw Error("The status of the cart does not allow to call the API: booking/carts/".concat(this.cartId, "/payment/wallet"));
+                            throw Error("The status of the cart does not allow to call the API: booking/carts/payment/wallet");
                         }
                         _c.label = 5;
                     case 5:
-                        url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/").concat(this.cartId, "/payment/wallet");
-                        return [2 /*return*/, this.callPostApi(url, {}).then(function (response) {
+                        url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/payment/wallet");
+                        return [2 /*return*/, this.callPostApi(url, { cartId: this.cartId, cartGuid: this.cartGuid }).then(function (response) {
                                 var _a, _b;
                                 if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
                                     return response;
@@ -647,14 +649,15 @@ var TplBooking = /** @class */ (function (_super) {
      */
     TplBooking.prototype.removeWalletReduction = function () {
         return __awaiter(this, void 0, void 0, function () {
-            var url;
+            var queryParams, url;
             var _this = this;
             return __generator(this, function (_a) {
                 // First check that it is possible to call this API
-                if (!this.cartId || this.cartId === 0) {
+                if ((0, utils_1.isNullOrWhiteSpace)(this.cartGuid)) {
                     throw Error("Cart is not initialized yet");
                 }
-                url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/").concat(this.cartId, "/payment/wallet");
+                queryParams = new URLSearchParams({ cartId: this.cartId.toString(), cartGuid: this.cartGuid });
+                url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/payment/wallet?").concat(queryParams);
                 return [2 /*return*/, this.callDeleteApi(url).then(function (response) {
                         var _a, _b, _c;
                         if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {

package/lib/index.d.ts

@@ -4,7 +4,7 @@ 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 { 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";

package/lib/mtsStorage.js

@@ -19,7 +19,9 @@ var INITIAL_STATE = {
     cartId: 0,
     cartGuid: undefined
 };
-var useMtsBookingAsyncState = (0, zustand_1.create)((0, middleware_1.persist)(function (set) { return (__assign(__assign({}, INITIAL_STATE), { updateCartId: function (cartId) { return set(function () { return ({ cartId: cartId }); }); }, resetState: function () { return set(function () { return INITIAL_STATE; }); } })); }, {
+var useMtsBookingAsyncState = (0, zustand_1.create)((0, middleware_1.persist)(function (set) { return (__assign(__assign({}, INITIAL_STATE), { updateCartId: function (cartId, cartGuid) {
+        return set(function () { return ({ cartId: cartId, cartGuid: cartGuid }); });
+    }, resetState: function () { return set(function () { return INITIAL_STATE; }); } })); }, {
     name: "mts-booking-storage",
     storage: (0, middleware_1.createJSONStorage)(function () { return async_storage_1.default; })
 }));

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

@@ -54,23 +54,26 @@ export declare enum GatewayTypes {
     PAYPAL = "PAYPAL"
 }
 /**
- * @enum {string} This enum contains the possible values for the `paymentMethod` parameter of the {@link Booking.issueTickets} function.
- *
- * @property {string} ZERO_COST: Only for Sellers: 100% discount
- * @property {string} PAY_LATER: Only for Sellers: Ticket will be paid at the counter/bus
- * @property {string} WALLET: Only for Resellers: the ticket will be paid with the wallet balance
- * @property {string} CARD: Pay with card at the Seller/Reseller counter
- * @property {string} CASH: Pay with cash at the Seller/Reseller counter
- * @property {string} ONLINE_CARD: Pay online using payment gateways
+ * This enum contains the possible values for the `paymentMethod` parameter of the
+ * {@link Booking.issueTickets} function.
  */
 export declare enum PaymentMethods {
+    /** Pay with card at the Seller/Reseller counter */
     CARD = "CARD",
+    /** Pay with cash at the Seller/Reseller counter */
     CASH = "CASH",
+    /** Pay with credit from change*/
     CREDIT_FROM_CHANGE = "CREDIT_FROM_CHANGE",
+    /** Only for Sellers: Ticket will be paid at the counter/bus */
     PAY_LATER = "PAY_LATER",
+    /** Pay online using payment gateways */
     ONLINE_CARD = "ONLINE_CARD",
+    /** Only for Resellers: the ticket will be paid with the wallet balance */
     WALLET = "WALLET",
-    ZERO_COST = "ZERO_COST"
+    /** Only for Sellers: 100% discount */
+    ZERO_COST = "ZERO_COST",
+    /** Pay with a bank transfer */
+    TRANSFER = "TRANSFER"
 }
 export type Wallet = {
     id: number;

package/lib/types/common/Payment.js

@@ -12,22 +12,25 @@ var GatewayTypes;
     GatewayTypes["PAYPAL"] = "PAYPAL";
 })(GatewayTypes || (exports.GatewayTypes = GatewayTypes = {}));
 /**
- * @enum {string} This enum contains the possible values for the `paymentMethod` parameter of the {@link Booking.issueTickets} function.
- *
- * @property {string} ZERO_COST: Only for Sellers: 100% discount
- * @property {string} PAY_LATER: Only for Sellers: Ticket will be paid at the counter/bus
- * @property {string} WALLET: Only for Resellers: the ticket will be paid with the wallet balance
- * @property {string} CARD: Pay with card at the Seller/Reseller counter
- * @property {string} CASH: Pay with cash at the Seller/Reseller counter
- * @property {string} ONLINE_CARD: Pay online using payment gateways
+ * This enum contains the possible values for the `paymentMethod` parameter of the
+ * {@link Booking.issueTickets} function.
  */
 var PaymentMethods;
 (function (PaymentMethods) {
+    /** Pay with card at the Seller/Reseller counter */
     PaymentMethods["CARD"] = "CARD";
+    /** Pay with cash at the Seller/Reseller counter */
     PaymentMethods["CASH"] = "CASH";
+    /** Pay with credit from change*/
     PaymentMethods["CREDIT_FROM_CHANGE"] = "CREDIT_FROM_CHANGE";
+    /** Only for Sellers: Ticket will be paid at the counter/bus */
     PaymentMethods["PAY_LATER"] = "PAY_LATER";
+    /** Pay online using payment gateways */
     PaymentMethods["ONLINE_CARD"] = "ONLINE_CARD";
+    /** Only for Resellers: the ticket will be paid with the wallet balance */
     PaymentMethods["WALLET"] = "WALLET";
+    /** Only for Sellers: 100% discount */
     PaymentMethods["ZERO_COST"] = "ZERO_COST";
+    /** Pay with a bank transfer */
+    PaymentMethods["TRANSFER"] = "TRANSFER";
 })(PaymentMethods || (exports.PaymentMethods = PaymentMethods = {}));

package/lib/types/journeys/JourneyCart.d.ts

@@ -1,22 +1,22 @@
 import { Booking } from "../../booking/booking";
 import { Cart } from "../common/Cart";
-import { TariffsMatrix, TariffSummary } from "../common/Tariffs";
+import { TariffSummary } from "../common/Tariffs";
 import { Stop } from "./Stop";
 import { CartTrip } from "./Trip";
 /**
- * @description Object containing information about a trip of a selected journey. This object is part of the {@link CreateJourneyCartRequest} object
+ * Object containing information about a trip of a selected journey.
+ * This object is part of the {@link CreateJourneyCartRequest} object
  * and describes a single trip of the journey (either outbound or return).
- *
- * @property {number} tripId - The unique identifier for the trip.
- * @property {number} departureStopId - The unique identifier for the departure stop.
- * @property {number} destinationStopId - The unique identifier for the destination stop.
- * @property {TariffsMatrix} tariffsMatrix - The tariff matrix for pricing the outbound journey.
  */
 export type TripBookingInfo = {
+    /** The unique identifier for the trip. */
     tripId: number;
+    /** The unique identifier for the departure stop. */
     departureStopId: number;
+    /** The unique identifier for the destination stop. */
     destinationStopId: number;
-    tariffsMatrix: TariffsMatrix;
+    /** A record containing tariff ids as keys and their respective quantities as values. */
+    tariffIdToQuantity: Record<number, number>;
 };
 /**
  * @description This is the object to be passed to `JourneyBooking.createJourneyCart`, containing information about the selected service.

package/lib/types/services/ServiceCart.d.ts

@@ -1,23 +1,23 @@
 import { Booking } from "../../booking/booking";
 import { Cart } from "../common/Cart";
-import { TariffsMatrix, TariffSummary } from "../common/Tariffs";
+import { TariffSummary } from "../common/Tariffs";
 import { ServiceTrip } from "./Service";
 /**
- * @description This is the object to be passed to `ServiceBooking.createServiceCart`, containing information about the selected service.
- *
- * @property {Booking.Currencies} currency - The currency in which the service is priced.
- * @property {Object} service - Information about the selected service.
- * @property {number} service.serviceId - The unique identifier for the service.
- * @property {TariffsMatrix} service.tariffsMatrix - The tariff matrix for pricing the service.
- * @property {string|undefined} [service.date] - The date for the service in ISO string format (optional).
- * @property {number|undefined} [service.tripId] - The unique identifier for the trip (optional).
+ * This is the object to be passed to `ServiceBooking.createServiceCart`, containing
+ * information about the selected service.
  */
 export type CreateServiceCartRequest = {
+    /** The currency in which the service is priced. */
     currency: Booking.Currencies;
+    /** Information about the selected service. */
     service: {
+        /** The unique identifier for the service. */
         serviceId: number;
-        tariffsMatrix: TariffsMatrix;
+        /** A record containing tariff ids as keys and their respective quantities as values. */
+        tariffIdToQuantity: Record<number, number>;
+        /** The date for the service in ISO string format (optional). */
         date?: string;
+        /** The unique identifier for the trip (optional). */
         tripId?: number;
     };
 };

package/lib/utils/apiCall.js

@@ -81,7 +81,7 @@ var makeGet = function (url) { return __awaiter(void 0, void 0, void 0, function
             throw new Error("MTS Library Error! makeGet: missing OCP SUBSCRIPTION KEY! ".concat(errorReport));
         }
         return [2 /*return*/, new Promise(function (resolve, reject) { return __awaiter(void 0, void 0, void 0, function () {
-                var response, filteredResponse, error_1, resError, resError;
+                var response, filteredResponse, error_1, message, resError, resError;
                 var _a, _b, _c, _d, _e, _f, _g;
                 return __generator(this, function (_h) {
                     switch (_h.label) {
@@ -101,10 +101,13 @@ var makeGet = function (url) { return __awaiter(void 0, void 0, void 0, function
                         case 2:
                             error_1 = _h.sent();
                             if (axios_1.default.isAxiosError(error_1)) {
+                                message = "error" in ((_a = error_1.response) === null || _a === void 0 ? void 0 : _a.data)
+                                    ? (_b = error_1.response) === null || _b === void 0 ? void 0 : _b.data.error.message
+                                    : (_c = error_1.response) === null || _c === void 0 ? void 0 : _c.data.message;
                                 resError = {
-                                    httpStatus: ((_a = error_1.response) === null || _a === void 0 ? void 0 : _a.status) || 0,
-                                    mtsCode: ((_d = (_c = (_b = error_1.response) === null || _b === void 0 ? void 0 : _b.data) === null || _c === void 0 ? void 0 : _c.error) === null || _d === void 0 ? void 0 : _d.code) || 0,
-                                    message: ((_g = (_f = (_e = error_1.response) === null || _e === void 0 ? void 0 : _e.data) === null || _f === void 0 ? void 0 : _f.error) === null || _g === void 0 ? void 0 : _g.message) || "Unknown error"
+                                    httpStatus: ((_d = error_1.response) === null || _d === void 0 ? void 0 : _d.status) || 0,
+                                    mtsCode: ((_g = (_f = (_e = error_1.response) === null || _e === void 0 ? void 0 : _e.data) === null || _f === void 0 ? void 0 : _f.error) === null || _g === void 0 ? void 0 : _g.code) || 0,
+                                    message: message || "Unknown error"
                                 };
                                 if (debug || (0, config_1.getConfig)().ENV === config_1.MTSEnvs.TEST) {
                                     console.log("GET_ResponseAxiosError", url, resError);
@@ -139,7 +142,7 @@ var makePost = function (url, data) { return __awaiter(void 0, void 0, void 0, f
             throw new Error("MTS Library Error! makePost: missing OCP SUBSCRIPTION KEY! ".concat(errorReport));
         }
         return [2 /*return*/, new Promise(function (resolve, reject) { return __awaiter(void 0, void 0, void 0, function () {
-                var response, filteredResponse, error_2, resError, resError;
+                var response, filteredResponse, error_2, message, resError, resError;
                 var _a, _b, _c, _d, _e, _f, _g;
                 return __generator(this, function (_h) {
                     switch (_h.label) {
@@ -159,10 +162,13 @@ var makePost = function (url, data) { return __awaiter(void 0, void 0, void 0, f
                         case 2:
                             error_2 = _h.sent();
                             if (axios_1.default.isAxiosError(error_2)) {
+                                message = "error" in ((_a = error_2.response) === null || _a === void 0 ? void 0 : _a.data)
+                                    ? (_b = error_2.response) === null || _b === void 0 ? void 0 : _b.data.error.message
+                                    : (_c = error_2.response) === null || _c === void 0 ? void 0 : _c.data.message;
                                 resError = {
-                                    httpStatus: ((_a = error_2.response) === null || _a === void 0 ? void 0 : _a.status) || 0,
-                                    mtsCode: ((_d = (_c = (_b = error_2.response) === null || _b === void 0 ? void 0 : _b.data) === null || _c === void 0 ? void 0 : _c.error) === null || _d === void 0 ? void 0 : _d.code) || 0,
-                                    message: ((_g = (_f = (_e = error_2.response) === null || _e === void 0 ? void 0 : _e.data) === null || _f === void 0 ? void 0 : _f.error) === null || _g === void 0 ? void 0 : _g.message) || "Unknown error"
+                                    httpStatus: ((_d = error_2.response) === null || _d === void 0 ? void 0 : _d.status) || 0,
+                                    mtsCode: ((_g = (_f = (_e = error_2.response) === null || _e === void 0 ? void 0 : _e.data) === null || _f === void 0 ? void 0 : _f.error) === null || _g === void 0 ? void 0 : _g.code) || 0,
+                                    message: message || "Unknown error"
                                 };
                                 if (debug || (0, config_1.getConfig)().ENV === config_1.MTSEnvs.TEST) {
                                     console.log("POST_ResponseAxiosError", url, resError);
@@ -197,7 +203,7 @@ var makeDelete = function (url) { return __awaiter(void 0, void 0, void 0, funct
             throw new Error("MTS Library Error! makeDelete: missing OCP SUBSCRIPTION KEY! ".concat(errorReport));
         }
         return [2 /*return*/, new Promise(function (resolve, reject) { return __awaiter(void 0, void 0, void 0, function () {
-                var response, filteredResponse, error_3, resError, resError;
+                var response, filteredResponse, error_3, message, resError, resError;
                 var _a, _b, _c, _d, _e, _f, _g;
                 return __generator(this, function (_h) {
                     switch (_h.label) {
@@ -217,10 +223,13 @@ var makeDelete = function (url) { return __awaiter(void 0, void 0, void 0, funct
                         case 2:
                             error_3 = _h.sent();
                             if (axios_1.default.isAxiosError(error_3)) {
+                                message = "error" in ((_a = error_3.response) === null || _a === void 0 ? void 0 : _a.data)
+                                    ? (_b = error_3.response) === null || _b === void 0 ? void 0 : _b.data.error.message
+                                    : (_c = error_3.response) === null || _c === void 0 ? void 0 : _c.data.message;
                                 resError = {
-                                    httpStatus: ((_a = error_3.response) === null || _a === void 0 ? void 0 : _a.status) || 0,
-                                    mtsCode: ((_d = (_c = (_b = error_3.response) === null || _b === void 0 ? void 0 : _b.data) === null || _c === void 0 ? void 0 : _c.error) === null || _d === void 0 ? void 0 : _d.code) || 0,
-                                    message: ((_g = (_f = (_e = error_3.response) === null || _e === void 0 ? void 0 : _e.data) === null || _f === void 0 ? void 0 : _f.error) === null || _g === void 0 ? void 0 : _g.message) || "Unknown error"
+                                    httpStatus: ((_d = error_3.response) === null || _d === void 0 ? void 0 : _d.status) || 0,
+                                    mtsCode: ((_g = (_f = (_e = error_3.response) === null || _e === void 0 ? void 0 : _e.data) === null || _f === void 0 ? void 0 : _f.error) === null || _g === void 0 ? void 0 : _g.code) || 0,
+                                    message: message || "Unknown error"
                                 };
                                 if (debug || (0, config_1.getConfig)().ENV === config_1.MTSEnvs.TEST) {
                                     console.log("DELETE_ResponseAxiosError", url, resError);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mts-booking-library",
-  "version": "1.3.23",
+  "version": "1.3.25",
   "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"
   }
 }