mts-booking-library 1.3.24 → 1.4.0

package/lib/booking/booking.d.ts

@@ -1,6 +1,7 @@
 import { MTSConfig, MTSEnvs } from "../config";
 import { ErrorResponse } from "../types/ErrorResponse";
-import { processedStepsToStatus } from "../types/common/Cart";
+import { Cart, processedStepsToStatus } from "../types/common/Cart";
+import { GetExtrasForBookingResponse, GetExtrasResponse } from "../types/common/Extra";
 import { GetPaymentInformationFromGatewayResponse, GetSellerGatewaysResponse, PaymentMethods, IssueTicketsResponse } from "../types/common/Payment";
 import { Buyer, GetBuyerPassengersDetailsResponse, GetBuyerRequest } from "../types/common/Person";
 import { AddReductionRequest } from "../types/common/Reduction";
@@ -20,7 +21,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;
@@ -42,6 +43,7 @@ export declare abstract class Booking {
     renewAccessToken(access_token: string): void;
     callGetApi(url: string): Promise<ErrorResponse | any>;
     callPostApi(url: string, body: any): Promise<any>;
+    callPutApi(url: string, body: any): Promise<any>;
     callDeleteApi(url: string): Promise<ErrorResponse | any>;
     getBookingStepsToStatus(): processedStepsToStatus;
     changeCurrency(currency: Booking.Currencies): void;
@@ -69,8 +71,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.
      */
@@ -82,6 +84,28 @@ export declare abstract class Booking {
      * @returns An {@link IssueTicketsResponse} object.
      */
     issueTickets(paymentMethod: PaymentMethods): Promise<ErrorResponse | IssueTicketsResponse>;
+    getExtras({ extraId, tariffPlanId }?: {
+        /** The extra object identifier. By default, all the extras of the seller are returned. */
+        extraId?: number;
+        /** If present, the extras that are part of that tariff plan are returned. */
+        tariffPlanId?: number;
+    }): Promise<ErrorResponse | GetExtrasResponse>;
+    /**
+     * Fetches extras tariffs for the given cart
+     * @param cartGuid The guid of the cart
+     * @param tripId The ID of the trip for which the extras are requested. Please note that this
+     * parameter is required when adding extras to a MLP or services cart.
+     */
+    getExtrasForBooking(cartGuid: string, tripId?: number): Promise<ErrorResponse | GetExtrasForBookingResponse>;
+    /**
+     * Updates the extras associated with a cart, removing all previous ones.
+     * @param cartGuid The guid of the cart
+     * @param tariffIdToQuantity A map of tariff ids to the quantity of tickets to add for that tariff
+     */
+    updateExtrasForCart(cartGuid: string, tariffIdToQuantity: Record<number, number>): Promise<ErrorResponse | {}>;
+    abstract getCart(): Cart | undefined;
+    abstract fetchAndSetCart(cartGuid: string): Promise<void>;
+    abstract fetchCart(cartGuid: string): Promise<Cart>;
 }
 export declare namespace Booking {
     enum Currencies {

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.
@@ -124,6 +125,13 @@ var Booking = /** @class */ (function () {
             (0, config_1.getConfig)().DB_TYPE && { databaseType: (0, config_1.getConfig)().DB_TYPE }));
         return (0, apiCall_1.makePost)(url, completeBody);
     };
+    Booking.prototype.callPutApi = function (url, body) {
+        var _a, _b, _c, _d;
+        // Add sellerId, resellerId and language to the query string
+        var completeBody = __assign(__assign(__assign({}, body), { sellerId: (_b = (_a = this.sellerId) === null || _a === void 0 ? void 0 : _a.toString()) !== null && _b !== void 0 ? _b : 0, resellerId: (_d = (_c = this.resellerId) === null || _c === void 0 ? void 0 : _c.toString()) !== null && _d !== void 0 ? _d : 0, language: this.language }), ((0, config_1.getConfig)().ENV === config_1.MTSEnvs.DEV &&
+            (0, config_1.getConfig)().DB_TYPE && { databaseType: (0, config_1.getConfig)().DB_TYPE }));
+        return (0, apiCall_1.makePut)(url, completeBody);
+    };
     Booking.prototype.callDeleteApi = function (url) {
         var _a, _b, _c, _d;
         // Add sellerId, resellerId and language to the query string.
@@ -160,7 +168,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 +182,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 +208,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 +253,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 +263,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 +280,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},
@@ -348,6 +357,65 @@ var Booking = /** @class */ (function () {
             });
         });
     };
+    //#endregion
+    // #region Extras
+    Booking.prototype.getExtras = function () {
+        return __awaiter(this, arguments, void 0, function (_a) {
+            var searchParams, url;
+            var _b = _a === void 0 ? {} : _a, extraId = _b.extraId, tariffPlanId = _b.tariffPlanId;
+            return __generator(this, function (_c) {
+                searchParams = new URLSearchParams(__assign(__assign({}, (extraId && { extraId: extraId.toString() })), (tariffPlanId && { tariffPlanId: tariffPlanId.toString() })));
+                url = "".concat(this.config.API_ENDPOINT, "/v3_resources/extras?").concat(searchParams);
+                return [2 /*return*/, this.callGetApi(url)];
+            });
+        });
+    };
+    /**
+     * Fetches extras tariffs for the given cart
+     * @param cartGuid The guid of the cart
+     * @param tripId The ID of the trip for which the extras are requested. Please note that this
+     * parameter is required when adding extras to a MLP or services cart.
+     */
+    Booking.prototype.getExtrasForBooking = function (cartGuid, tripId) {
+        return __awaiter(this, void 0, void 0, function () {
+            var searchParams, url;
+            return __generator(this, function (_a) {
+                searchParams = new URLSearchParams(__assign({ cartGuid: cartGuid }, (tripId && { tripId: tripId.toString() })));
+                url = "".concat(this.config.API_ENDPOINT, "/v3_booking/extras?").concat(searchParams);
+                return [2 /*return*/, this.callGetApi(url)];
+            });
+        });
+    };
+    /**
+     * Updates the extras associated with a cart, removing all previous ones.
+     * @param cartGuid The guid of the cart
+     * @param tariffIdToQuantity A map of tariff ids to the quantity of tickets to add for that tariff
+     */
+    Booking.prototype.updateExtrasForCart = function (cartGuid, tariffIdToQuantity) {
+        return __awaiter(this, void 0, void 0, function () {
+            var body, url, res;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        body = {
+                            cartGuid: cartGuid,
+                            tariffIdToQuantity: tariffIdToQuantity
+                        };
+                        url = "".concat(this.config.API_ENDPOINT, "/v3_booking/extras");
+                        return [4 /*yield*/, this.callPutApi(url, body)];
+                    case 1:
+                        res = _a.sent();
+                        if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(res)) {
+                            return [2 /*return*/, res];
+                        }
+                        return [4 /*yield*/, this.fetchAndSetCart(cartGuid)];
+                    case 2:
+                        _a.sent();
+                        return [2 /*return*/, res];
+                }
+            });
+        });
+    };
     return Booking;
 }());
 exports.Booking = Booking;

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/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/Extra.d.ts

@@ -1,4 +1,4 @@
-import { ExtraTariff } from "./Tariffs";
+import { ExtraTariff, TariffsMatrix } from "./Tariffs";
 /**
  * @description this type represents an extra, which is an additional service that can be added to a cart. Extras are selected in the booking step `EXTRAS`.
  *
@@ -18,3 +18,15 @@ export type Extra = {
     notes: string;
     tariff: ExtraTariff;
 };
+export type GetExtrasResponse = {
+    extras: {
+        id: number;
+        name: string;
+        description: string;
+        requiresNotes: boolean;
+        notes: string | null;
+    }[];
+};
+export type GetExtrasForBookingResponse = {
+    extraIdToTariffsMatrix: Record<number, TariffsMatrix>;
+};

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/common/Tariffs.d.ts

@@ -30,6 +30,8 @@ export type Tariff = {
         chf: number | null;
         id: number;
     };
+    /** The user-friendly label of the tariff */
+    label: string;
     /** The number of passengers to which this tariff applies */
     quantity: number;
     /** The custom code for one-way tickets */

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.d.ts

@@ -8,4 +8,5 @@
 import { ErrorResponse } from "../types/ErrorResponse";
 export declare const makeGet: (url: string) => Promise<ErrorResponse | any>;
 export declare const makePost: (url: string, data: any) => Promise<ErrorResponse | any>;
+export declare const makePut: (url: string, data: any) => Promise<ErrorResponse | any>;
 export declare const makeDelete: (url: string) => Promise<ErrorResponse | any>;

package/lib/utils/apiCall.js

@@ -54,7 +54,7 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
     }
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.makeDelete = exports.makePost = exports.makeGet = void 0;
+exports.makeDelete = exports.makePut = exports.makePost = exports.makeGet = void 0;
 var axios_1 = require("axios");
 var config_1 = require("../config");
 var utils_1 = require("./utils");
@@ -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);
@@ -184,6 +190,67 @@ var makePost = function (url, data) { return __awaiter(void 0, void 0, void 0, f
     });
 }); };
 exports.makePost = makePost;
+var makePut = function (url, data) { return __awaiter(void 0, void 0, void 0, function () {
+    var debug, subKey, errorReport;
+    return __generator(this, function (_a) {
+        debug = (0, config_1.getConfig)().DEBUG;
+        if (debug) {
+            console.log("PUT_RequestData", url, data);
+        }
+        subKey = (0, config_1.getConfig)().OCP_SUBSCRIPTION_KEY;
+        if ((0, utils_1.isNullOrWhiteSpace)(subKey)) {
+            errorReport = "Sub Key: ".concat(subKey, ", url: ").concat(url, ", access token: ").concat((0, config_1.getConfig)().ACCESS_TOKEN);
+            throw new Error("MTS Library Error! makePut: 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, message, resError, resError;
+                var _a, _b, _c, _d, _e, _f, _g;
+                return __generator(this, function (_h) {
+                    switch (_h.label) {
+                        case 0:
+                            _h.trys.push([0, 2, , 3]);
+                            return [4 /*yield*/, axios_1.default.put(url, data, {
+                                    headers: __assign(__assign({ "Content-Type": "application/json", "Ocp-Apim-Subscription-Key": subKey }, ((0, config_1.getConfig)().ACCESS_TOKEN && { Authorization: "Bearer ".concat((0, config_1.getConfig)().ACCESS_TOKEN) })), ((0, config_1.getConfig)().SESSION_ID && { SessionId: (0, config_1.getConfig)().SESSION_ID }))
+                                })];
+                        case 1:
+                            response = _h.sent();
+                            filteredResponse = removeNullError(response.data);
+                            if (debug) {
+                                console.log("PUT_ResponseData", url, filteredResponse);
+                            }
+                            resolve(filteredResponse);
+                            return [3 /*break*/, 3];
+                        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: ((_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("PUT_ResponseAxiosError", url, resError);
+                                }
+                                reject(resError);
+                            }
+                            else {
+                                resError = __assign(__assign({}, error_3), { httpStatus: 0, mtsCode: 0, message: "Unknown error" });
+                                if (debug || (0, config_1.getConfig)().ENV === config_1.MTSEnvs.TEST) {
+                                    console.log("PUT_ResponseError", url, resError);
+                                }
+                                reject(resError);
+                            }
+                            return [3 /*break*/, 3];
+                        case 3: return [2 /*return*/];
+                    }
+                });
+            }); })];
+    });
+}); };
+exports.makePut = makePut;
 var makeDelete = function (url) { return __awaiter(void 0, void 0, void 0, function () {
     var debug, subKey, errorReport;
     return __generator(this, function (_a) {
@@ -197,7 +264,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_4, message, resError, resError;
                 var _a, _b, _c, _d, _e, _f, _g;
                 return __generator(this, function (_h) {
                     switch (_h.label) {
@@ -215,12 +282,15 @@ var makeDelete = function (url) { return __awaiter(void 0, void 0, void 0, funct
                             resolve(filteredResponse);
                             return [3 /*break*/, 3];
                         case 2:
-                            error_3 = _h.sent();
-                            if (axios_1.default.isAxiosError(error_3)) {
+                            error_4 = _h.sent();
+                            if (axios_1.default.isAxiosError(error_4)) {
+                                message = "error" in ((_a = error_4.response) === null || _a === void 0 ? void 0 : _a.data)
+                                    ? (_b = error_4.response) === null || _b === void 0 ? void 0 : _b.data.error.message
+                                    : (_c = error_4.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_4.response) === null || _d === void 0 ? void 0 : _d.status) || 0,
+                                    mtsCode: ((_g = (_f = (_e = error_4.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);
@@ -228,7 +298,7 @@ var makeDelete = function (url) { return __awaiter(void 0, void 0, void 0, funct
                                 reject(resError);
                             }
                             else {
-                                resError = __assign(__assign({}, error_3), { httpStatus: 0, mtsCode: 0, message: "Unknown error" });
+                                resError = __assign(__assign({}, error_4), { httpStatus: 0, mtsCode: 0, message: "Unknown error" });
                                 if (debug || (0, config_1.getConfig)().ENV === config_1.MTSEnvs.TEST) {
                                     console.log("DELETE_ResponseError", url, resError);
                                 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mts-booking-library",
-  "version": "1.3.24",
+  "version": "1.4.0",
   "description": "Library for using MyTicketSolution Booking API",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

package/lib/SubscriptionBooking.js

@@ -1,148 +0,0 @@
-"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/utils/testUtils.d.ts

@@ -1,8 +0,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
- */
-export declare const getISOStringWithoutGMT: (date: Date | string | null | undefined, removeTimezone?: boolean) => string | null;

package/lib/utils/testUtils.js

@@ -1,19 +0,0 @@
-"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;