mts-booking-library 1.2.10 → 1.2.11

package/lib/booking/booking.d.ts

@@ -4,7 +4,7 @@ import { GetPaymentInformationFromGatewayResponse, GetSellerGatewaysResponse, Pa
 import { GetBuyerPassengersDetailsResponse, Person } from "../types/common/Person";
 import { AddReductionRequest } from "../types/common/Reduction";
 export declare abstract class Booking {
-    readonly sellerId?: number | undefined;
+    private sellerId?;
     readonly resellerId?: number | undefined;
     readonly bookingType: Booking.BookingTypes;
     readonly config: MTSConfig;
@@ -35,6 +35,12 @@ export declare abstract class Booking {
     * @param {number} [resellerId=undefined] The id of the reseller.
     */
     constructor(env: MTSEnvs, sub_key: string, onCartExpiration: () => void, bookingType: Booking.BookingTypes, debug?: boolean, language?: string, access_token?: string, sellerId?: number, resellerId?: number);
+    /**
+     * This method allows to update the sellerId. It is mostly important for Linkavel, as we start with sellerId = 0
+     * but then it changes to the actual sellerId once the cart is created.
+     * @param sellerId The id of the seller.
+     */
+    updateSellerId(sellerId: number): void;
     /**
      * This method allows to renew the access token for calling MTS APIs
      * @param {string} access_token The new access token
@@ -46,31 +52,37 @@ export declare abstract class Booking {
     changeCurrency(currency: Booking.Currencies): void;
     changeLanguage(language: string): void;
     getCartExpirationTimeInMs(): Promise<number>;
+    /**
+     * This API allows to mark a non-required booking step as completed. It is useful for example for the seats selection step.
+     * @param bookingStep The booking step to mark as completed
+     * @returns An {@link ErrorResponse} object in case of error, true otherwise.
+     */
+    markBookingStepCompleted(bookingStep: Booking.BookingSteps): Promise<ErrorResponse | boolean>;
     abstract deleteCart(): Promise<ErrorResponse | any>;
     abstract getBuyerPassengersDetails(): Promise<ErrorResponse | GetBuyerPassengersDetailsResponse>;
     abstract getBuyerFromLinkavelCard(linkavelCardNumber?: string, linkavelCardPhoneNumber?: string): Promise<ErrorResponse | Person>;
-    abstract updateBuyerPassengersDetails(request: any): Promise<ErrorResponse | any>;
+    abstract updateBuyerPassengersDetails(request: any): Promise<ErrorResponse | boolean>;
     /**
-     * @description This method allows to add a reduction to the cart
+     * @description This method allows to add a reduction to the whole cart or to a single trip in the cart.
      * @param {AddReductionRequest} request The information about the reduction to add
-     * @returns An {@link ErrorResponse} object in case of error, nothing otherwise.
+     * @returns An {@link ErrorResponse} object in case of error, true otherwise.
      */
-    addReduction(request: AddReductionRequest): Promise<ErrorResponse | any>;
+    addReduction(request: AddReductionRequest): Promise<ErrorResponse | boolean>;
     /**
      * @description This method allows the user to use the balance in his wallet to pay the cart. If the balance of
      * the wallet is enough to pay the cart, the cart will be paid fully. Otherwise, the user will be asked to pay the
      * remaining amount with another payment method.
-     * @returns An {@link ErrorResponse} object in case of error, nothing otherwise.
+     * @returns An {@link ErrorResponse} object in case of error, true otherwise.
      */
-    useWallet(): Promise<ErrorResponse | any>;
+    useWallet(): Promise<ErrorResponse | boolean>;
     /**
      * @description This method allows the user to use a voucher to pay the cart.
      * If the balance of the value of the voucher is enough to pay the cart, the cart will be paid fully.
      * Otherwise, the user will be asked to pay the remaining amount with another payment method.
      * @param {string} voucherCode The code of the voucher to use
-     * @returns An {@link ErrorResponse} object in case of error, nothing otherwise.
+     * @returns An {@link ErrorResponse} object in case of error, true otherwise.
      */
-    useVoucher(voucherCode: string): Promise<ErrorResponse | any>;
+    useVoucher(voucherCode: string): Promise<ErrorResponse | boolean>;
     /**
      * @description This method shall be used to get the available payment methods for the cart. They depend on the seller configuration.
      * @returns An {@link ErrorResponse} object in case of error, a {@link GetSellerGatewaysResponse} object otherwise.
@@ -86,9 +98,11 @@ export declare abstract class Booking {
     getPaymentInformationFromGateway(gatewayId: number, returnUrl?: string): Promise<ErrorResponse | GetPaymentInformationFromGatewayResponse>;
     /**
      * @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},
+     * first the {@link Booking.addReduction} API is called with a 100% discount, then tickets are issued with the {@link PaymentMethods.CASH} method.
      * @returns An {@link ErrorResponse} object in case of error, nothing otherwise.
      */
-    issueTickets(paymentMethod: PaymentMethods): Promise<ErrorResponse | any>;
+    issueTickets(paymentMethod: PaymentMethods): Promise<ErrorResponse | boolean>;
 }
 export declare namespace Booking {
     enum Currencies {

package/lib/booking/booking.js

@@ -52,6 +52,7 @@ var config_1 = require("../config");
 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 Booking = /** @class */ (function () {
     /**
     * This is the constructor of the Booking class.
@@ -86,6 +87,14 @@ var Booking = /** @class */ (function () {
         this.onCartExpiration = onCartExpiration;
         this.changeLanguage(language);
     }
+    /**
+     * This method allows to update the sellerId. It is mostly important for Linkavel, as we start with sellerId = 0
+     * but then it changes to the actual sellerId once the cart is created.
+     * @param sellerId The id of the seller.
+     */
+    Booking.prototype.updateSellerId = function (sellerId) {
+        this.sellerId = sellerId;
+    };
     /**
      * This method allows to renew the access token for calling MTS APIs
      * @param {string} access_token The new access token
@@ -134,54 +143,161 @@ var Booking = /** @class */ (function () {
             });
         });
     };
-    //#endregion
-    //#region Reductions APIs
     /**
-     * @description This method allows to add a reduction to the cart
-     * @param {AddReductionRequest} request The information about the reduction to add
-     * @returns An {@link ErrorResponse} object in case of error, nothing otherwise.
+     * This API allows to mark a non-required booking step as completed. It is useful for example for the seats selection step.
+     * @param bookingStep The booking step to mark as completed
+     * @returns An {@link ErrorResponse} object in case of error, true otherwise.
      */
-    Booking.prototype.addReduction = function (request) {
+    Booking.prototype.markBookingStepCompleted = function (bookingStep) {
         return __awaiter(this, void 0, void 0, function () {
-            var discountsStep, url;
+            var currentStepStatus, 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) {
                     throw Error("Cart is not initialized yet");
                 }
-                discountsStep = this.bookingStepsToStatus.get(Booking.BookingSteps.DISCOUNTS);
-                if (!discountsStep || !discountsStep[0]) {
-                    throw Error("The status of the cart does not allow to call this API");
+                currentStepStatus = this.bookingStepsToStatus.get(bookingStep);
+                if (!currentStepStatus || currentStepStatus[2]) {
+                    throw Error("The step ".concat(bookingStep, " cannot be marked as completed because it is required"));
                 }
-                url = "".concat(this.config.API_ENDPOINT, "/booking/cart/").concat(this.cartId, "/reduction");
-                return [2 /*return*/, this.callPostApi(url, request).then(function (response) {
-                        return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response) ? response : response;
+                // Booking step is already completedm, no need to call the API
+                if (currentStepStatus[0])
+                    return [2 /*return*/, true];
+                url = "".concat(this.config.API_ENDPOINT, "/booking/cart/").concat(this.cartId, "/bookingSteps");
+                return [2 /*return*/, this.callPostApi(url, { bookingStep: bookingStep }).then(function (response) {
+                        if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
+                            return response;
+                        }
+                        // Update the booking process status
+                        _this.bookingStepsToStatus = (0, processBookingSteps_1.processBookingSteps)(response.stepsToStatus);
+                        return true;
                     })];
             });
         });
     };
+    //#endregion
+    //#region Reductions APIs
+    /**
+     * @description This method allows to add a reduction to the whole cart or to a single trip in the cart.
+     * @param {AddReductionRequest} request The information about the reduction to add
+     * @returns An {@link ErrorResponse} object in case of error, true otherwise.
+     */
+    Booking.prototype.addReduction = function (request) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function () {
+            var discountsStep, _b, _c, _d, _i, step, url;
+            var _this = this;
+            return __generator(this, function (_e) {
+                switch (_e.label) {
+                    case 0:
+                        // First check that it is possible to call this API
+                        if (!this.cartId || this.cartId === 0) {
+                            throw Error("Cart is not initialized yet");
+                        }
+                        discountsStep = this.bookingStepsToStatus.get(Booking.BookingSteps.DISCOUNTS);
+                        if (!discountsStep)
+                            throw Error("Booking step not found!");
+                        if (!!discountsStep[0]) return [3 /*break*/, 5];
+                        _b = [Booking.BookingSteps.SEATS_SELECTION, Booking.BookingSteps.EXTRAS];
+                        _c = [];
+                        for (_d in _b)
+                            _c.push(_d);
+                        _i = 0;
+                        _e.label = 1;
+                    case 1:
+                        if (!(_i < _c.length)) return [3 /*break*/, 4];
+                        _d = _c[_i];
+                        if (!(_d in _b)) return [3 /*break*/, 3];
+                        step = _d;
+                        if (!!((_a = this.bookingStepsToStatus.get(step)) !== null && _a !== void 0 ? _a : [false])[0]) return [3 /*break*/, 3];
+                        return [4 /*yield*/, this.markBookingStepCompleted(step)];
+                    case 2:
+                        _e.sent();
+                        _e.label = 3;
+                    case 3:
+                        _i++;
+                        return [3 /*break*/, 1];
+                    case 4:
+                        // Check again if the discounts step is accessible
+                        discountsStep = this.bookingStepsToStatus.get(Booking.BookingSteps.DISCOUNTS);
+                        if (!discountsStep || !discountsStep[0]) {
+                            throw Error("The status of the cart does not allow to call this API");
+                        }
+                        _e.label = 5;
+                    case 5:
+                        url = "".concat(this.config.API_ENDPOINT, "/booking/cart/").concat(this.cartId, "/reduction");
+                        return [2 /*return*/, this.callPostApi(url, request).then(function (response) {
+                                if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
+                                    return response;
+                                }
+                                // Update the booking process status
+                                _this.bookingStepsToStatus = (0, processBookingSteps_1.processBookingSteps)(response.stepsToStatus);
+                                return true;
+                            })];
+                }
+            });
+        });
+    };
     /**
      * @description This method allows the user to use the balance in his wallet to pay the cart. If the balance of
      * the wallet is enough to pay the cart, the cart will be paid fully. Otherwise, the user will be asked to pay the
      * remaining amount with another payment method.
-     * @returns An {@link ErrorResponse} object in case of error, nothing otherwise.
+     * @returns An {@link ErrorResponse} object in case of error, true otherwise.
      */
     Booking.prototype.useWallet = function () {
+        var _a;
         return __awaiter(this, void 0, void 0, function () {
-            var discountsStep, url;
-            return __generator(this, function (_a) {
-                // First check that it is possible to call this API
-                if (!this.cartId || this.cartId === 0) {
-                    throw Error("Cart is not initialized yet");
-                }
-                discountsStep = this.bookingStepsToStatus.get(Booking.BookingSteps.DISCOUNTS);
-                if (!discountsStep || !discountsStep[0]) {
-                    throw Error("The status of the cart does not allow to call this API");
+            var discountsStep, _b, _c, _d, _i, step, url;
+            var _this = this;
+            return __generator(this, function (_e) {
+                switch (_e.label) {
+                    case 0:
+                        // First check that it is possible to call this API
+                        if (!this.cartId || this.cartId === 0) {
+                            throw Error("Cart is not initialized yet");
+                        }
+                        discountsStep = this.bookingStepsToStatus.get(Booking.BookingSteps.DISCOUNTS);
+                        if (!discountsStep)
+                            throw Error("Booking step not found!");
+                        if (!!discountsStep[0]) return [3 /*break*/, 5];
+                        _b = [Booking.BookingSteps.SEATS_SELECTION, Booking.BookingSteps.EXTRAS];
+                        _c = [];
+                        for (_d in _b)
+                            _c.push(_d);
+                        _i = 0;
+                        _e.label = 1;
+                    case 1:
+                        if (!(_i < _c.length)) return [3 /*break*/, 4];
+                        _d = _c[_i];
+                        if (!(_d in _b)) return [3 /*break*/, 3];
+                        step = _d;
+                        if (!!((_a = this.bookingStepsToStatus.get(step)) !== null && _a !== void 0 ? _a : [false])[0]) return [3 /*break*/, 3];
+                        return [4 /*yield*/, this.markBookingStepCompleted(step)];
+                    case 2:
+                        _e.sent();
+                        _e.label = 3;
+                    case 3:
+                        _i++;
+                        return [3 /*break*/, 1];
+                    case 4:
+                        // Check again if the discounts step is accessible
+                        discountsStep = this.bookingStepsToStatus.get(Booking.BookingSteps.DISCOUNTS);
+                        if (!discountsStep || !discountsStep[0]) {
+                            throw Error("The status of the cart does not allow to call this API");
+                        }
+                        _e.label = 5;
+                    case 5:
+                        url = "".concat(this.config.API_ENDPOINT, "/booking/cart/").concat(this.cartId, "/payment/wallet");
+                        return [2 /*return*/, this.callPostApi(url, {}).then(function (response) {
+                                if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
+                                    return response;
+                                }
+                                // Update the booking process status
+                                _this.bookingStepsToStatus = (0, processBookingSteps_1.processBookingSteps)(response.stepsToStatus);
+                                return true;
+                            })];
                 }
-                url = "".concat(this.config.API_ENDPOINT, "/booking/cart/").concat(this.cartId, "/payment/wallet");
-                return [2 /*return*/, this.callPostApi(url, {}).then(function (response) {
-                        return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response) ? response : response;
-                    })];
             });
         });
     };
@@ -190,24 +306,61 @@ var Booking = /** @class */ (function () {
      * If the balance of the value of the voucher is enough to pay the cart, the cart will be paid fully.
      * Otherwise, the user will be asked to pay the remaining amount with another payment method.
      * @param {string} voucherCode The code of the voucher to use
-     * @returns An {@link ErrorResponse} object in case of error, nothing otherwise.
+     * @returns An {@link ErrorResponse} object in case of error, true otherwise.
      */
     Booking.prototype.useVoucher = function (voucherCode) {
+        var _a;
         return __awaiter(this, void 0, void 0, function () {
-            var discountsStep, url;
-            return __generator(this, function (_a) {
-                // First check that it is possible to call this API
-                if (!this.cartId || this.cartId === 0) {
-                    throw Error("Cart is not initialized yet");
+            var discountsStep, _b, _c, _d, _i, step, url;
+            var _this = this;
+            return __generator(this, function (_e) {
+                switch (_e.label) {
+                    case 0:
+                        // First check that it is possible to call this API
+                        if (!this.cartId || this.cartId === 0) {
+                            throw Error("Cart is not initialized yet");
+                        }
+                        discountsStep = this.bookingStepsToStatus.get(Booking.BookingSteps.DISCOUNTS);
+                        if (!discountsStep)
+                            throw Error("Booking step not found!");
+                        if (!!discountsStep[0]) return [3 /*break*/, 5];
+                        _b = [Booking.BookingSteps.SEATS_SELECTION, Booking.BookingSteps.EXTRAS];
+                        _c = [];
+                        for (_d in _b)
+                            _c.push(_d);
+                        _i = 0;
+                        _e.label = 1;
+                    case 1:
+                        if (!(_i < _c.length)) return [3 /*break*/, 4];
+                        _d = _c[_i];
+                        if (!(_d in _b)) return [3 /*break*/, 3];
+                        step = _d;
+                        if (!!((_a = this.bookingStepsToStatus.get(step)) !== null && _a !== void 0 ? _a : [false])[0]) return [3 /*break*/, 3];
+                        return [4 /*yield*/, this.markBookingStepCompleted(step)];
+                    case 2:
+                        _e.sent();
+                        _e.label = 3;
+                    case 3:
+                        _i++;
+                        return [3 /*break*/, 1];
+                    case 4:
+                        // Check again if the discounts step is accessible
+                        discountsStep = this.bookingStepsToStatus.get(Booking.BookingSteps.DISCOUNTS);
+                        if (!discountsStep || !discountsStep[0]) {
+                            throw Error("The status of the cart does not allow to call this API");
+                        }
+                        _e.label = 5;
+                    case 5:
+                        url = "".concat(this.config.API_ENDPOINT, "/booking/cart/").concat(this.cartId, "/payment/voucher");
+                        return [2 /*return*/, this.callPostApi(url, { voucherCode: voucherCode }).then(function (response) {
+                                if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
+                                    return response;
+                                }
+                                // Update the booking process status
+                                _this.bookingStepsToStatus = (0, processBookingSteps_1.processBookingSteps)(response.stepsToStatus);
+                                return true;
+                            })];
                 }
-                discountsStep = this.bookingStepsToStatus.get(Booking.BookingSteps.DISCOUNTS);
-                if (!discountsStep || !discountsStep[0]) {
-                    throw Error("The status of the cart does not allow to call this API");
-                }
-                url = "".concat(this.config.API_ENDPOINT, "/booking/cart/").concat(this.cartId, "/payment/voucher");
-                return [2 /*return*/, this.callPostApi(url, { voucherCode: voucherCode }).then(function (response) {
-                        return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response) ? response : response;
-                    })];
             });
         });
     };
@@ -218,21 +371,52 @@ var Booking = /** @class */ (function () {
      * @returns An {@link ErrorResponse} object in case of error, a {@link GetSellerGatewaysResponse} object otherwise.
      */
     Booking.prototype.getSellerGateways = function () {
+        var _a;
         return __awaiter(this, void 0, void 0, function () {
-            var issueStep, url;
-            return __generator(this, function (_a) {
-                // First check that it is possible to call this API
-                if (!this.cartId || this.cartId === 0) {
-                    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");
+            var issueStep, _b, _c, _d, _i, step, url;
+            return __generator(this, function (_e) {
+                switch (_e.label) {
+                    case 0:
+                        // First check that it is possible to call this API
+                        if (!this.cartId || this.cartId === 0) {
+                            throw Error("Cart is not initialized yet");
+                        }
+                        issueStep = this.bookingStepsToStatus.get(Booking.BookingSteps.ISSUE);
+                        if (!issueStep)
+                            throw Error("Booking step not found!");
+                        if (!!issueStep[0]) return [3 /*break*/, 5];
+                        _b = [Booking.BookingSteps.SEATS_SELECTION, Booking.BookingSteps.EXTRAS, Booking.BookingSteps.DISCOUNTS];
+                        _c = [];
+                        for (_d in _b)
+                            _c.push(_d);
+                        _i = 0;
+                        _e.label = 1;
+                    case 1:
+                        if (!(_i < _c.length)) return [3 /*break*/, 4];
+                        _d = _c[_i];
+                        if (!(_d in _b)) return [3 /*break*/, 3];
+                        step = _d;
+                        if (!!((_a = this.bookingStepsToStatus.get(step)) !== null && _a !== void 0 ? _a : [false])[0]) return [3 /*break*/, 3];
+                        return [4 /*yield*/, this.markBookingStepCompleted(step)];
+                    case 2:
+                        _e.sent();
+                        _e.label = 3;
+                    case 3:
+                        _i++;
+                        return [3 /*break*/, 1];
+                    case 4:
+                        // Check again if the issue step is accessible
+                        issueStep = this.bookingStepsToStatus.get(Booking.BookingSteps.DISCOUNTS);
+                        if (!issueStep || !issueStep[0]) {
+                            throw Error("The status of the cart does not allow to call this API");
+                        }
+                        _e.label = 5;
+                    case 5:
+                        url = "".concat(this.config.API_ENDPOINT, "/sellers/").concat(this.sellerId, "/gateways");
+                        return [2 /*return*/, this.callGetApi(url).then(function (response) {
+                                return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response) ? response : response;
+                            })];
                 }
-                url = "".concat(this.config.API_ENDPOINT, "/sellers/").concat(this.sellerId, "/gateways");
-                return [2 /*return*/, this.callGetApi(url).then(function (response) {
-                        return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response) ? response : response;
-                    })];
             });
         });
     };
@@ -265,28 +449,76 @@ var Booking = /** @class */ (function () {
     };
     /**
      * @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},
+     * first the {@link Booking.addReduction} API is called with a 100% discount, then tickets are issued with the {@link PaymentMethods.CASH} method.
      * @returns An {@link ErrorResponse} object in case of error, nothing otherwise.
      */
     Booking.prototype.issueTickets = function (paymentMethod) {
+        var _a;
         return __awaiter(this, void 0, void 0, function () {
-            var issueStep, url, body;
-            return __generator(this, function (_a) {
-                // First check that it is possible to call this API
-                if (!this.cartId || this.cartId === 0) {
-                    throw Error("Cart is not initialized yet");
+            var paymentMethodToSet, issueStep, _b, _c, _d, _i, step, url, body;
+            return __generator(this, function (_e) {
+                switch (_e.label) {
+                    case 0:
+                        // First check that it is possible to call this API
+                        if (!this.cartId || this.cartId === 0) {
+                            throw Error("Cart is not initialized yet");
+                        }
+                        paymentMethodToSet = paymentMethod;
+                        if (!(paymentMethod === Payment_1.PaymentMethods.ZERO_COST)) return [3 /*break*/, 2];
+                        return [4 /*yield*/, this.addReduction({ tripId: 0, reduction: 1, isPercentage: true }).then(function (response) {
+                                if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
+                                    return response;
+                                }
+                                else {
+                                    // Request was successful. Set payment method to CASH
+                                    paymentMethodToSet = Payment_1.PaymentMethods.CASH;
+                                }
+                            })];
+                    case 1:
+                        _e.sent();
+                        _e.label = 2;
+                    case 2:
+                        issueStep = this.bookingStepsToStatus.get(Booking.BookingSteps.ISSUE);
+                        if (!issueStep)
+                            throw Error("Booking step not found!");
+                        if (!!issueStep[0]) return [3 /*break*/, 7];
+                        _b = [Booking.BookingSteps.SEATS_SELECTION, Booking.BookingSteps.EXTRAS, Booking.BookingSteps.DISCOUNTS];
+                        _c = [];
+                        for (_d in _b)
+                            _c.push(_d);
+                        _i = 0;
+                        _e.label = 3;
+                    case 3:
+                        if (!(_i < _c.length)) return [3 /*break*/, 6];
+                        _d = _c[_i];
+                        if (!(_d in _b)) return [3 /*break*/, 5];
+                        step = _d;
+                        if (!!((_a = this.bookingStepsToStatus.get(step)) !== null && _a !== void 0 ? _a : [false])[0]) return [3 /*break*/, 5];
+                        return [4 /*yield*/, this.markBookingStepCompleted(step)];
+                    case 4:
+                        _e.sent();
+                        _e.label = 5;
+                    case 5:
+                        _i++;
+                        return [3 /*break*/, 3];
+                    case 6:
+                        // Check again if the issue step is accessible
+                        issueStep = this.bookingStepsToStatus.get(Booking.BookingSteps.DISCOUNTS);
+                        if (!issueStep || !issueStep[0]) {
+                            throw Error("The status of the cart does not allow to call this API");
+                        }
+                        _e.label = 7;
+                    case 7:
+                        url = "".concat(this.config.API_ENDPOINT, "/issueTickets");
+                        body = {
+                            cartId: this.cartId,
+                            paymentMethod: paymentMethodToSet === Payment_1.PaymentMethods.PAY_LATER ? null : paymentMethodToSet,
+                        };
+                        return [2 /*return*/, this.callPostApi(url, body).then(function (response) {
+                                return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response) ? response : true;
+                            })];
                 }
-                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");
-                }
-                url = "".concat(this.config.API_ENDPOINT, "/issueTickets");
-                body = {
-                    cartId: this.cartId,
-                    paymentMethod: paymentMethod === Payment_1.PaymentMethods.PAY_LATER ? null : paymentMethod,
-                };
-                return [2 /*return*/, this.callPostApi(url, body).then(function (response) {
-                        return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response) ? response : response;
-                    })];
             });
         });
     };

package/lib/booking/journeyBooking.d.ts

@@ -4,6 +4,7 @@ import { EditPassengersDetailsRequest, GetBuyerPassengersDetailsResponse, Person
 import { BusMatrix } from "../types/journeys/BusMatrix";
 import { CreateJourneyCartRequest, JourneyCart } from "../types/journeys/JourneyCart";
 import { JourneySearchRequest, JourneySearchResult } from "../types/journeys/JourneySearch";
+import { ReductionTrip } from "../types/journeys/Trip";
 import { Booking } from "./booking";
 export declare class JourneyBooking extends Booking {
     private cart?;
@@ -68,9 +69,9 @@ export declare class JourneyBooking extends Booking {
     /**
      * @description This methosd shall be called when the user wants to update the buyer and the passengers information.
      * @param {EditPassengersDetailsRequest} passengersDetails The object containing the buyer and the passengers information.
-     * @returns An {@link ErrorResponse} object in case of error, nothing otherwise.
+     * @returns An {@link ErrorResponse} object in case of error, true otherwise.
      */
-    updateBuyerPassengersDetails(passengersDetails: EditPassengersDetailsRequest): Promise<ErrorResponse | any>;
+    updateBuyerPassengersDetails(passengersDetails: EditPassengersDetailsRequest): Promise<ErrorResponse | boolean>;
     /**
      * @description This method shall be used when the user wants to retrieve the bus matrix for a trip. The bus matrix shows
      * the seats that are available and the ones that are already taken, as well as how the bus is made.
@@ -90,9 +91,16 @@ export declare class JourneyBooking extends Booking {
      * @description This method shall be called when the user wants to change the assigned seats of a trip.
      * @param {number} tripId The id of the trip for which the seats should be changed
      * @param {number[]} newSeatsIds The ids of the new seats, as found the {@link BusMatrix}
-     * @returns An {@link ErrorResponse} object in case of error, nothing otherwise.
+     * @returns An {@link ErrorResponse} object in case of error, true otherwise.
      */
-    changeSeatsOfTrip(tripId: number, newSeatsIds: number[]): Promise<ErrorResponse | any>;
+    changeSeatsOfTrip(tripId: number, newSeatsIds: number[]): Promise<ErrorResponse | boolean>;
+    /**
+     * @description This method shall be called when the user wants to retrieve the trips in the cart, for adding a available reduction
+     * to a specific trip (rather than to the whole cart).
+     * @see {@link Booking.addReduction} for detailed info on how to add a reduction.
+     * @returns An {@link ErrorResponse} object in case of error, a list of {@link ReductionTrip} otherwise, representing the trips in the cart.
+     */
+    getCartTrips(): Promise<ErrorResponse | ReductionTrip[]>;
 }
 export declare namespace JourneyBooking {
     const createBooking: (env: MTSEnvs, sub_key: string, onCartExpiration: () => void, debug: boolean, language: string, access_token?: string, sellerId?: number, resellerId?: number) => Promise<JourneyBooking>;

package/lib/booking/journeyBooking.js

@@ -64,6 +64,7 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.JourneyBooking = void 0;
 var ErrorResponse_1 = require("../types/ErrorResponse");
+var processBookingSteps_1 = require("../utils/processBookingSteps");
 var booking_1 = require("./booking");
 var JourneyBooking = /** @class */ (function (_super) {
     __extends(JourneyBooking, _super);
@@ -106,13 +107,7 @@ var JourneyBooking = /** @class */ (function (_super) {
                                 _this.cartId = cart.id;
                                 _this.bookingDueDate = cartDate; // See Booking class
                                 // Fill the booking process status
-                                _this.bookingStepsToStatus = new Map(Object.entries(cart.stepsToStatus).map(function (_a) {
-                                    var bookingStep = _a[0], values = _a[1];
-                                    return [
-                                        bookingStep,
-                                        values
-                                    ];
-                                }));
+                                _this.bookingStepsToStatus = (0, processBookingSteps_1.processBookingSteps)(cart.stepsToStatus);
                                 _this.createCartTimer(cartDate);
                             }
                         })];
@@ -260,13 +255,7 @@ var JourneyBooking = /** @class */ (function (_super) {
                         // Save the cartId in the localStorage
                         localStorage.setItem("cartId", response.cart.id.toString());
                         // Fill the booking process status
-                        _this.bookingStepsToStatus = new Map(Object.entries(response.cart.stepsToStatus).map(function (_a) {
-                            var bookingStep = _a[0], values = _a[1];
-                            return [
-                                bookingStep,
-                                values
-                            ];
-                        }));
+                        _this.bookingStepsToStatus = (0, processBookingSteps_1.processBookingSteps)(response.cart.stepsToStatus);
                         _this.bookingDueDate = new Date(response.cart.bookingDueDate);
                         _this.createCartTimer(new Date(response.cart.bookingDueDate));
                         return response.cart;
@@ -367,11 +356,12 @@ var JourneyBooking = /** @class */ (function (_super) {
     /**
      * @description This methosd shall be called when the user wants to update the buyer and the passengers information.
      * @param {EditPassengersDetailsRequest} passengersDetails The object containing the buyer and the passengers information.
-     * @returns An {@link ErrorResponse} object in case of error, nothing otherwise.
+     * @returns An {@link ErrorResponse} object in case of error, true otherwise.
      */
     JourneyBooking.prototype.updateBuyerPassengersDetails = function (passengersDetails) {
         return __awaiter(this, void 0, void 0, function () {
             var buyerPassengersDetails, request, url;
+            var _this = this;
             return __generator(this, function (_a) {
                 // First check that it is possible to call this API
                 if (!this.cart) {
@@ -391,7 +381,12 @@ var JourneyBooking = /** @class */ (function (_super) {
                 });
                 url = "".concat(this.config.API_ENDPOINT, "/booking/cart/").concat(this.cart.id, "/details");
                 return [2 /*return*/, this.callPostApi(url, request).then(function (response) {
-                        return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response) ? response : response;
+                        if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
+                            return response;
+                        }
+                        // Update the booking process status
+                        _this.bookingStepsToStatus = (0, processBookingSteps_1.processBookingSteps)(response.stepsToStatus);
+                        return true;
                     })];
             });
         });
@@ -456,11 +451,12 @@ var JourneyBooking = /** @class */ (function (_super) {
      * @description This method shall be called when the user wants to change the assigned seats of a trip.
      * @param {number} tripId The id of the trip for which the seats should be changed
      * @param {number[]} newSeatsIds The ids of the new seats, as found the {@link BusMatrix}
-     * @returns An {@link ErrorResponse} object in case of error, nothing otherwise.
+     * @returns An {@link ErrorResponse} object in case of error, true otherwise.
      */
     JourneyBooking.prototype.changeSeatsOfTrip = function (tripId, newSeatsIds) {
         return __awaiter(this, void 0, void 0, function () {
             var seatSelectionStatus, url;
+            var _this = this;
             return __generator(this, function (_a) {
                 // First check that it is possible to call this API
                 if (!this.cart) {
@@ -472,7 +468,33 @@ var JourneyBooking = /** @class */ (function (_super) {
                 }
                 url = "".concat(this.config.API_ENDPOINT, "/booking/cart/").concat(this.cart.id, "/seats");
                 return [2 /*return*/, this.callPostApi(url, { tripId: tripId, seatsIds: newSeatsIds }).then(function (response) {
-                        return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response) ? response : response;
+                        if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
+                            return response;
+                        }
+                        // Update the booking process status
+                        _this.bookingStepsToStatus = (0, processBookingSteps_1.processBookingSteps)(response.stepsToStatus);
+                        return true;
+                    })];
+            });
+        });
+    };
+    /**
+     * @description This method shall be called when the user wants to retrieve the trips in the cart, for adding a available reduction
+     * to a specific trip (rather than to the whole cart).
+     * @see {@link Booking.addReduction} for detailed info on how to add a reduction.
+     * @returns An {@link ErrorResponse} object in case of error, a list of {@link ReductionTrip} otherwise, representing the trips in the cart.
+     */
+    JourneyBooking.prototype.getCartTrips = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var url;
+            return __generator(this, function (_a) {
+                // First check that it is possible to call this API
+                if (!this.cart) {
+                    throw Error("Cart is not initialized yet");
+                }
+                url = "".concat(this.config.API_ENDPOINT, "/booking/cart/").concat(this.cart.id, "/payment/reduction/trips");
+                return [2 /*return*/, this.callGetApi(url).then(function (response) {
+                        return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response) ? response : response.trips;
                     })];
             });
         });

package/lib/booking/serviceBooking.d.ts

@@ -71,9 +71,9 @@ export declare class ServiceBooking extends Booking {
     /**
      * @description This method shall be called when the user wants to update the buyer information.
      * @param {Person} buyerDetails The object containing the buyer information.
-     * @returns An {@link ErrorResponse} object in case of error, nothing otherwise.
+     * @returns An {@link ErrorResponse} object in case of error, true otherwise.
      */
-    updateBuyerPassengersDetails(buyerDetails: Person): Promise<ErrorResponse | any>;
+    updateBuyerPassengersDetails(buyerDetails: Person): Promise<ErrorResponse | boolean>;
 }
 export declare namespace ServiceBooking {
     const createBooking: (env: MTSEnvs, sub_key: string, onCartExpiration: () => void, debug: boolean, language: string, access_token?: string, sellerId?: number, resellerId?: number) => Promise<ServiceBooking>;

package/lib/booking/serviceBooking.js

@@ -64,6 +64,7 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ServiceBooking = void 0;
 var ErrorResponse_1 = require("../types/ErrorResponse");
+var processBookingSteps_1 = require("../utils/processBookingSteps");
 var booking_1 = require("./booking");
 var ServiceBooking = /** @class */ (function (_super) {
     __extends(ServiceBooking, _super);
@@ -106,13 +107,7 @@ var ServiceBooking = /** @class */ (function (_super) {
                                 _this.cartId = cart.id;
                                 _this.bookingDueDate = cartDate; // See Booking class
                                 // Fill the booking process status
-                                _this.bookingStepsToStatus = new Map(Object.entries(cart.stepsToStatus).map(function (_a) {
-                                    var bookingStep = _a[0], values = _a[1];
-                                    return [
-                                        bookingStep,
-                                        values
-                                    ];
-                                }));
+                                _this.bookingStepsToStatus = (0, processBookingSteps_1.processBookingSteps)(cart.stepsToStatus);
                                 _this.createCartTimer(cartDate);
                             }
                         })];
@@ -253,13 +248,7 @@ var ServiceBooking = /** @class */ (function (_super) {
                         // Save the cartId in the localStorage
                         localStorage.setItem("cartId", response.cart.id.toString());
                         // Fill the booking process status
-                        _this.bookingStepsToStatus = new Map(Object.entries(response.cart.stepsToStatus).map(function (_a) {
-                            var bookingStep = _a[0], values = _a[1];
-                            return [
-                                bookingStep,
-                                values
-                            ];
-                        }));
+                        _this.bookingStepsToStatus = (0, processBookingSteps_1.processBookingSteps)(response.cart.stepsToStatus);
                         _this.bookingDueDate = new Date(response.cart.bookingDueDate);
                         _this.createCartTimer(new Date(response.cart.bookingDueDate));
                         return response.cart;
@@ -341,11 +330,12 @@ var ServiceBooking = /** @class */ (function (_super) {
     /**
      * @description This method shall be called when the user wants to update the buyer information.
      * @param {Person} buyerDetails The object containing the buyer information.
-     * @returns An {@link ErrorResponse} object in case of error, nothing otherwise.
+     * @returns An {@link ErrorResponse} object in case of error, true otherwise.
      */
     ServiceBooking.prototype.updateBuyerPassengersDetails = function (buyerDetails) {
         return __awaiter(this, void 0, void 0, function () {
             var buyerPassengersDetails, request, url;
+            var _this = this;
             return __generator(this, function (_a) {
                 // First check that it is possible to call this API
                 if (!this.cart) {
@@ -361,7 +351,12 @@ var ServiceBooking = /** @class */ (function (_super) {
                 };
                 url = "".concat(this.config.API_ENDPOINT, "/booking/cart/").concat(this.cart.id, "/details");
                 return [2 /*return*/, this.callPostApi(url, request).then(function (response) {
-                        return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response) ? response : response;
+                        if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
+                            return response;
+                        }
+                        // Update the booking process status
+                        _this.bookingStepsToStatus = (0, processBookingSteps_1.processBookingSteps)(response.stepsToStatus);
+                        return true;
                     })];
             });
         });

package/lib/booking/subscriptionBooking.d.ts

@@ -90,9 +90,9 @@ export declare class SubscriptionBooking extends Booking {
     /**
      * @description This methosd shall be called when the user wants to update the buyer and the passengers information.
      * @param {EditPassengersDetailsRequest} passengersDetails The object containing the buyer and the passengers information.
-     * @returns An {@link ErrorResponse} object in case of error, nothing otherwise.
+     * @returns An {@link ErrorResponse} object in case of error, true otherwise.
      */
-    updateBuyerPassengersDetails(passengersDetails: EditPassengersDetailsRequest): Promise<ErrorResponse | any>;
+    updateBuyerPassengersDetails(passengersDetails: EditPassengersDetailsRequest): Promise<ErrorResponse | boolean>;
 }
 export declare namespace SubscriptionBooking {
     const createBooking: (env: MTSEnvs, sub_key: string, onCartExpiration: () => void, debug: boolean, language: string, access_token?: string, sellerId?: number, resellerId?: number) => Promise<SubscriptionBooking>;

package/lib/booking/subscriptionBooking.js

@@ -64,6 +64,7 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SubscriptionBooking = void 0;
 var ErrorResponse_1 = require("../types/ErrorResponse");
+var processBookingSteps_1 = require("../utils/processBookingSteps");
 var booking_1 = require("./booking");
 var SubscriptionBooking = /** @class */ (function (_super) {
     __extends(SubscriptionBooking, _super);
@@ -309,13 +310,7 @@ var SubscriptionBooking = /** @class */ (function (_super) {
                         // Save the cartId in the localStorage
                         localStorage.setItem("cartId", response.cart.id.toString());
                         // Fill the booking process status
-                        _this.bookingStepsToStatus = new Map(Object.entries(response.cart.stepsToStatus).map(function (_a) {
-                            var bookingStep = _a[0], values = _a[1];
-                            return [
-                                bookingStep,
-                                values
-                            ];
-                        }));
+                        _this.bookingStepsToStatus = (0, processBookingSteps_1.processBookingSteps)(response.cart.stepsToStatus);
                         _this.bookingDueDate = new Date(response.cart.bookingDueDate);
                         _this.createCartTimer(new Date(response.cart.bookingDueDate));
                         return response.cart;
@@ -416,11 +411,12 @@ var SubscriptionBooking = /** @class */ (function (_super) {
     /**
      * @description This methosd shall be called when the user wants to update the buyer and the passengers information.
      * @param {EditPassengersDetailsRequest} passengersDetails The object containing the buyer and the passengers information.
-     * @returns An {@link ErrorResponse} object in case of error, nothing otherwise.
+     * @returns An {@link ErrorResponse} object in case of error, true otherwise.
      */
     SubscriptionBooking.prototype.updateBuyerPassengersDetails = function (passengersDetails) {
         return __awaiter(this, void 0, void 0, function () {
             var buyerPassengersDetails, request, url;
+            var _this = this;
             return __generator(this, function (_a) {
                 // First check that it is possible to call this API
                 if (!this.cart) {
@@ -440,7 +436,12 @@ var SubscriptionBooking = /** @class */ (function (_super) {
                 });
                 url = "".concat(this.config.API_ENDPOINT, "/booking/cart/").concat(this.cart.id, "/details");
                 return [2 /*return*/, this.callPostApi(url, request).then(function (response) {
-                        return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response) ? response : response;
+                        if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
+                            return response;
+                        }
+                        // Update the booking process status
+                        _this.bookingStepsToStatus = (0, processBookingSteps_1.processBookingSteps)(response.stepsToStatus);
+                        return true;
                     })];
             });
         });

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

@@ -51,7 +51,14 @@ export declare enum GatewayTypes {
     PAYPAL = "PAYPAL"
 }
 /**
- * @description This enum contains the possible values for the `paymentMethod` parameter of the {@link Booking.issueTickets} function.
+ * @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: Pay online using payment gateways
  */
 export declare enum PaymentMethods {
     CARD = "CARD",
@@ -59,5 +66,6 @@ export declare enum PaymentMethods {
     CREDIT_FROM_CHANGE = "CREDIT_FROM_CHANGE",
     PAY_LATER = "PAY_LATER",
     ONLINE_CARD = "ONLINE CARD",
-    WALLET = "WALLET"
+    WALLET = "WALLET",
+    ZERO_COST = "ZERO_COST"
 }

package/lib/types/common/Payment.js

@@ -11,7 +11,14 @@ var GatewayTypes;
     GatewayTypes["PAYPAL"] = "PAYPAL";
 })(GatewayTypes || (exports.GatewayTypes = GatewayTypes = {}));
 /**
- * @description This enum contains the possible values for the `paymentMethod` parameter of the {@link Booking.issueTickets} function.
+ * @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: Pay online using payment gateways
  */
 var PaymentMethods;
 (function (PaymentMethods) {
@@ -21,4 +28,5 @@ var PaymentMethods;
     PaymentMethods["PAY_LATER"] = "PAY_LATER";
     PaymentMethods["ONLINE_CARD"] = "ONLINE CARD";
     PaymentMethods["WALLET"] = "WALLET";
+    PaymentMethods["ZERO_COST"] = "ZERO_COST";
 })(PaymentMethods || (exports.PaymentMethods = PaymentMethods = {}));

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

@@ -8,3 +8,13 @@ export type Trip = {
     tariffTypes: TariffType[];
     termsTypes: TermsType[];
 };
+/**
+ * This type is used to represent a trip for the reduction page. This only makes sense for a JourneyBooking,
+ * and it allows to add a reduction to a specific trip (rather than to the whole cart).
+ * @property { number } id - The id of the trip
+ * @property { string } name - The name of the trip
+ */
+export type ReductionTrip = {
+    id: number;
+    name: string;
+};

package/lib/utils/processBookingSteps.d.ts

@@ -0,0 +1,7 @@
+/**
+ * This function process the stepsToStatus object returned by the BE in several APIs and returns the processed Map.
+ * This is necessary because Typescript does not treat the jsonized map as an actual Map making it impossible to use.
+ * @param stepsToStatus the stepsToStatus object returned by the BE
+ * @returns The processed Map
+ */
+export declare const processBookingSteps: (stepsToStatus: any) => Map<string, boolean[]>;

package/lib/utils/processBookingSteps.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.processBookingSteps = void 0;
+/**
+ * This function process the stepsToStatus object returned by the BE in several APIs and returns the processed Map.
+ * This is necessary because Typescript does not treat the jsonized map as an actual Map making it impossible to use.
+ * @param stepsToStatus the stepsToStatus object returned by the BE
+ * @returns The processed Map
+ */
+var processBookingSteps = function (stepsToStatus) {
+    try {
+        return new Map(Object.entries(stepsToStatus).map(function (_a) {
+            var bookingStep = _a[0], values = _a[1];
+            return [
+                bookingStep,
+                values
+            ];
+        }));
+    }
+    catch (error) {
+        throw new Error("Error while processing booking steps");
+    }
+};
+exports.processBookingSteps = processBookingSteps;

package/package.json

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