mts-booking-library 1.2.25 → 1.2.27

package/lib/booking/booking.d.ts

@@ -21,12 +21,10 @@ export declare abstract class Booking {
     bookingStepsToStatus: Map<string, boolean[]>;
     cartId: number | undefined;
     bookingDueDate: Date | undefined;
-    onCartExpiration: () => void;
     /**
     * This is the constructor of the Booking class.
     * @param {string} env The environment in which the app is running. Can be "DEV", "STAGING" or "PROD"
     * @param {string} sub_key The subscription key for using the APIs
-    * @param {() => void} onCartExpiration A callback function that will be called when the cart expires
     * @param {Booking.BookingTypes} bookingType The type of booking. Can be "MLP", "SERVICE" or "MLP_SUBSCRIPTION"
     * @param {boolean} [debug=false] If true, the app will run in debug mode (meaning that will print requests and responses in the console)
     * @param {string} [language=Booking.Languages.EN] The language in which the app is running. Can be "it", "en", "fr", "de" or "es"
@@ -34,7 +32,7 @@ export declare abstract class Booking {
     * @param {number} [sellerId=undefined] The id of the seller. If not set, it will return the results for all sellers
     * @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);
+    constructor(env: MTSEnvs, sub_key: string, 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.
@@ -60,6 +58,7 @@ export declare abstract class Booking {
      */
     markBookingStepCompleted(bookingStep: Booking.BookingSteps): Promise<ErrorResponse | boolean>;
     abstract deleteCart(): Promise<ErrorResponse | any>;
+    abstract resetBooking(): void;
     abstract getBuyerPassengersDetails(): Promise<ErrorResponse | GetBuyerPassengersDetailsResponse>;
     abstract getBuyerFromLinkavelCard(linkavelCardNumber?: string, linkavelCardPhoneNumber?: string): Promise<ErrorResponse | Person>;
     abstract updateBuyerPassengersDetails(request: any): Promise<ErrorResponse | boolean>;

package/lib/booking/booking.js

@@ -58,7 +58,6 @@ var Booking = /** @class */ (function () {
     * This is the constructor of the Booking class.
     * @param {string} env The environment in which the app is running. Can be "DEV", "STAGING" or "PROD"
     * @param {string} sub_key The subscription key for using the APIs
-    * @param {() => void} onCartExpiration A callback function that will be called when the cart expires
     * @param {Booking.BookingTypes} bookingType The type of booking. Can be "MLP", "SERVICE" or "MLP_SUBSCRIPTION"
     * @param {boolean} [debug=false] If true, the app will run in debug mode (meaning that will print requests and responses in the console)
     * @param {string} [language=Booking.Languages.EN] The language in which the app is running. Can be "it", "en", "fr", "de" or "es"
@@ -66,7 +65,7 @@ var Booking = /** @class */ (function () {
     * @param {number} [sellerId=undefined] The id of the seller. If not set, it will return the results for all sellers
     * @param {number} [resellerId=undefined] The id of the reseller.
     */
-    function Booking(env, sub_key, onCartExpiration, bookingType, debug, language, access_token, sellerId, resellerId) {
+    function Booking(env, sub_key, bookingType, debug, language, access_token, sellerId, resellerId) {
         if (debug === void 0) { debug = false; }
         if (language === void 0) { language = Booking.Languages.EN; }
         this.language = Booking.Languages.EN;
@@ -84,7 +83,6 @@ var Booking = /** @class */ (function () {
         this.resellerId = resellerId || undefined;
         this.config = (0, config_1.setConfig)(env, sub_key, debug, access_token);
         this.bookingType = bookingType;
-        this.onCartExpiration = onCartExpiration;
         this.changeLanguage(language);
     }
     /**
@@ -329,7 +327,7 @@ var Booking = /** @class */ (function () {
                         return [3 /*break*/, 3];
                     case 6:
                         // Check again if the issue step is accessible
-                        issueStep = this.bookingStepsToStatus.get(Booking.BookingSteps.DISCOUNTS);
+                        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");
                         }

package/lib/booking/journeyBooking.d.ts

@@ -3,7 +3,7 @@ import { ErrorResponse } from "../types/ErrorResponse";
 import { EditPassengersDetailsRequest, GetBuyerPassengersDetailsResponse, Person } from "../types/common/Person";
 import { AddReductionRequest } from "../types/common/Reduction";
 import { BusMatrix } from "../types/journeys/BusMatrix";
-import { CreateJourneyCartRequest, JourneyCart } from "../types/journeys/JourneyCart";
+import { CreateJourneyCartRequest, GetJourneyCartResponse, JourneyCart } from "../types/journeys/JourneyCart";
 import { JourneySearchRequest, JourneySearchResult } from "../types/journeys/JourneySearch";
 import { ReductionTrip } from "../types/journeys/Trip";
 import { Booking } from "./booking";
@@ -13,19 +13,17 @@ export declare class JourneyBooking extends Booking {
     * This is the constructor of the ServiceBooking class.
     * @param {MTSEnvs} env The environment in which the app is running. Can be "DEV", "STAGING" or "PROD"
     * @param {string} sub_key The subscription key for using the APIs
-    * @param {() => void} onCartExpiration A callback function that will be called when the cart expires
-    * @param {Booking.BookingTypes} bookingType The type of booking. Can be "MLP", "SERVICE" or "MLP_SUBSCRIPTION"
     * @param {boolean} [debug=false] If true, the app will run in debug mode (meaning that will print requests and responses in the console)
     * @param {string} [language=Booking.Languages.EN] The language in which the app is running. Can be "it", "en", "fr", "de" or "es"
     * @param {string} [access_token=undefined] The access token for calling MTS APIs
     * @param {number} [sellerId=undefined] The id of the seller. If not set, it will return the results for all sellers
     * @param {number} [resellerId=undefined] The id of the reseller.
     */
-    constructor(env: MTSEnvs, sub_key: string, onCartExpiration: () => void, debug?: boolean, language?: string, access_token?: string, sellerId?: number, resellerId?: number);
+    constructor(env: MTSEnvs, sub_key: string, debug?: boolean, language?: string, access_token?: string, sellerId?: number, resellerId?: number);
     getCart(): JourneyCart | undefined;
+    resetBooking(): void;
     fetchAndSetCart(cartId: number): Promise<void>;
-    private createCartTimer;
-    fetchCart(cartId: number): Promise<JourneyCart>;
+    fetchCart(cartId: number): Promise<GetJourneyCartResponse>;
     /**
      * This method allows to delete a cart, thus allowing the user to exit from the booking process.
      * @returns An {@link ErrorResponse} object in case of error, nothing otherwise. Note that also in case of error, all
@@ -138,5 +136,5 @@ export declare class JourneyBooking extends Booking {
     useVoucher(voucherCode: string): Promise<ErrorResponse | boolean>;
 }
 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>;
+    const createBooking: (env: MTSEnvs, sub_key: string, debug: boolean, language: string, access_token?: string, sellerId?: number, resellerId?: number) => Promise<JourneyBooking>;
 }

package/lib/booking/journeyBooking.js

@@ -82,19 +82,17 @@ var JourneyBooking = /** @class */ (function (_super) {
     * This is the constructor of the ServiceBooking class.
     * @param {MTSEnvs} env The environment in which the app is running. Can be "DEV", "STAGING" or "PROD"
     * @param {string} sub_key The subscription key for using the APIs
-    * @param {() => void} onCartExpiration A callback function that will be called when the cart expires
-    * @param {Booking.BookingTypes} bookingType The type of booking. Can be "MLP", "SERVICE" or "MLP_SUBSCRIPTION"
     * @param {boolean} [debug=false] If true, the app will run in debug mode (meaning that will print requests and responses in the console)
     * @param {string} [language=Booking.Languages.EN] The language in which the app is running. Can be "it", "en", "fr", "de" or "es"
     * @param {string} [access_token=undefined] The access token for calling MTS APIs
     * @param {number} [sellerId=undefined] The id of the seller. If not set, it will return the results for all sellers
     * @param {number} [resellerId=undefined] The id of the reseller.
     */
-    function JourneyBooking(env, sub_key, onCartExpiration, debug, language, access_token, sellerId, resellerId) {
+    function JourneyBooking(env, sub_key, debug, language, access_token, sellerId, resellerId) {
         if (debug === void 0) { debug = false; }
         if (language === void 0) { language = booking_1.Booking.Languages.EN; }
         // Call Booking constructor
-        var _this = _super.call(this, env, sub_key, onCartExpiration, booking_1.Booking.BookingTypes.MLP, debug, language, access_token, sellerId, resellerId) || this;
+        var _this = _super.call(this, env, sub_key, booking_1.Booking.BookingTypes.MLP, debug, language, access_token, sellerId, resellerId) || this;
         // Set cartId
         var cartId = localStorage.getItem("cartId");
         if (cartId) {
@@ -105,20 +103,32 @@ var JourneyBooking = /** @class */ (function (_super) {
     JourneyBooking.prototype.getCart = function () {
         return this.cart;
     };
+    JourneyBooking.prototype.resetBooking = function () {
+        this.cart = undefined;
+        this.cartId = undefined;
+        this.bookingStepsToStatus = new Map();
+        this.bookingDueDate = undefined;
+        localStorage.removeItem("cartId");
+    };
     JourneyBooking.prototype.fetchAndSetCart = function (cartId) {
         return __awaiter(this, void 0, void 0, function () {
             var _this = this;
             return __generator(this, function (_a) {
                 switch (_a.label) {
-                    case 0: return [4 /*yield*/, this.fetchCart(cartId).then(function (cart) {
-                            var cartDate = new Date(cart.bookingDueDate);
-                            if (cartDate > new Date()) {
-                                _this.cart = cart;
-                                _this.cartId = cart.id;
-                                _this.bookingDueDate = cartDate; // See Booking class
-                                // Fill the booking process status
-                                _this.bookingStepsToStatus = (0, processBookingSteps_1.processBookingSteps)(cart.stepsToStatus);
-                                _this.createCartTimer(cartDate);
+                    case 0: return [4 /*yield*/, this.fetchCart(cartId).then(function (response) {
+                            if (response.cart) {
+                                var cartDate = new Date(response.cart.bookingDueDate);
+                                if (cartDate > new Date()) {
+                                    _this.cart = response.cart;
+                                    _this.cartId = response.cart.id;
+                                    _this.bookingDueDate = cartDate; // See Booking class
+                                    // Fill the booking process status
+                                    _this.bookingStepsToStatus = (0, processBookingSteps_1.processBookingSteps)(response.cart.stepsToStatus);
+                                }
+                                else {
+                                    // This should never happen, but just in case
+                                    _this.resetBooking();
+                                }
                             }
                         })];
                     case 1:
@@ -128,34 +138,22 @@ var JourneyBooking = /** @class */ (function (_super) {
             });
         });
     };
-    JourneyBooking.prototype.createCartTimer = function (expiringDate) {
-        return __awaiter(this, void 0, void 0, function () {
-            var _this = this;
-            return __generator(this, function (_a) {
-                setTimeout(function () {
-                    localStorage.removeItem("cartId");
-                    // Put actions that have to be done when timer expires here
-                    _this.bookingStepsToStatus = new Map();
-                    _this.cart = undefined;
-                    _this.cartId = undefined;
-                    _this.bookingDueDate = undefined; // See Booking class
-                    _this.onCartExpiration();
-                }, expiringDate.valueOf() - new Date().valueOf());
-                return [2 /*return*/];
-            });
-        });
-    };
     JourneyBooking.prototype.fetchCart = function (cartId) {
         return __awaiter(this, void 0, void 0, function () {
             var url;
+            var _this = this;
             return __generator(this, function (_a) {
                 url = "".concat(this.config.API_ENDPOINT, "/booking/cart?").concat(new URLSearchParams({ cartId: cartId.toString() }));
                 return [2 /*return*/, this.callGetApi(url).then(function (response) {
                         if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
-                            localStorage.removeItem("cartId");
+                            _this.resetBooking();
                             throw new Error(response);
                         }
-                        return response.cart;
+                        // Check that the cart doe not have issued tickets
+                        if (response.hasIssuedTickets) {
+                            _this.resetBooking();
+                        }
+                        return response;
                     })];
             });
         });
@@ -171,17 +169,13 @@ 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.cart) {
+                if (!this.cart || !this.cartId) {
                     throw Error("Cart is not initialized yet");
                 }
-                url = "".concat(this.config.API_ENDPOINT, "/removeBookingFromCart");
-                return [2 /*return*/, this.callPostApi(url, { cartId: this.cart.id }).then(function (response) {
+                url = "".concat(this.config.API_ENDPOINT, "/booking/carts?").concat(new URLSearchParams({ cartId: this.cartId.toString() }));
+                return [2 /*return*/, this.callDeleteApi(url).then(function (response) {
                         // Clear all data
-                        localStorage.removeItem("cartId");
-                        _this.bookingStepsToStatus = new Map();
-                        _this.cart = undefined;
-                        _this.cartId = undefined;
-                        _this.bookingDueDate = undefined; // See Booking class
+                        _this.resetBooking();
                         return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response) ? response : response;
                     })];
             });
@@ -252,8 +246,7 @@ var JourneyBooking = /** @class */ (function (_super) {
                         // Check for errors
                         if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
                             // If there was an error, reset cartId and remove it from the localStorage
-                            _this.cartId = undefined;
-                            localStorage.removeItem("cartId");
+                            _this.resetBooking();
                             return response;
                         }
                         _this.cart = response.cart;
@@ -263,7 +256,6 @@ var JourneyBooking = /** @class */ (function (_super) {
                         // Fill the booking process status
                         _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;
                     })];
             });
@@ -774,12 +766,12 @@ var JourneyBooking = /** @class */ (function (_super) {
 exports.JourneyBooking = JourneyBooking;
 (function (JourneyBooking) {
     var _this = this;
-    JourneyBooking.createBooking = function (env, sub_key, onCartExpiration, debug, language, access_token, sellerId, resellerId) { return __awaiter(_this, void 0, void 0, function () {
+    JourneyBooking.createBooking = function (env, sub_key, debug, language, access_token, sellerId, resellerId) { return __awaiter(_this, void 0, void 0, function () {
         var booking, error_1;
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0:
-                    booking = new JourneyBooking(env, sub_key, onCartExpiration, debug, language, access_token, sellerId, resellerId);
+                    booking = new JourneyBooking(env, sub_key, debug, language, access_token, sellerId, resellerId);
                     _a.label = 1;
                 case 1:
                     _a.trys.push([1, 4, , 5]);

package/lib/booking/serviceBooking.d.ts

@@ -3,7 +3,7 @@ import { ErrorResponse } from "../types/ErrorResponse";
 import { GetBuyerPassengersDetailsResponse, Person } from "../types/common/Person";
 import { AddReductionRequest } from "../types/common/Reduction";
 import { Service, ServiceTrip } from "../types/services/Service";
-import { CreateServiceCartRequest, ServiceCart } from "../types/services/ServiceCart";
+import { CreateServiceCartRequest, GetServiceCartResponse, ServiceCart } from "../types/services/ServiceCart";
 import { Booking } from "./booking";
 export declare class ServiceBooking extends Booking {
     private cart?;
@@ -11,19 +11,17 @@ export declare class ServiceBooking extends Booking {
     * This is the constructor of the ServiceBooking class.
     * @param {MTSEnvs} env The environment in which the app is running. Can be "DEV", "STAGING" or "PROD"
     * @param {string} sub_key The subscription key for using the APIs
-    * @param {() => void} onCartExpiration A callback function that will be called when the cart expires
-    * @param {Booking.BookingTypes} bookingType The type of booking. Can be "MLP", "SERVICE" or "MLP_SUBSCRIPTION"
     * @param {boolean} [debug=false] If true, the app will run in debug mode (meaning that will print requests and responses in the console)
     * @param {string} [language=Booking.Languages.EN] The language in which the app is running. Can be "it", "en", "fr", "de" or "es"
     * @param {string} [access_token=undefined] The access token for calling MTS APIs
     * @param {number} [sellerId=undefined] The id of the seller. If not set, it will return the results for all sellers
     * @param {number} [resellerId=undefined] The id of the reseller.
     */
-    constructor(env: MTSEnvs, sub_key: string, onCartExpiration: () => void, debug?: boolean, language?: string, access_token?: string, sellerId?: number, resellerId?: number);
+    constructor(env: MTSEnvs, sub_key: string, debug?: boolean, language?: string, access_token?: string, sellerId?: number, resellerId?: number);
     getCart(): ServiceCart | undefined;
+    resetBooking(): void;
     fetchAndSetCart(cartId: number): Promise<void>;
-    private createCartTimer;
-    fetchCart(cartId: number): Promise<ServiceCart>;
+    fetchCart(cartId: number): Promise<GetServiceCartResponse>;
     /**
    * This method allows to delete a cart, thus allowing the user to exit from the booking process.
    * @returns An {@link ErrorResponse} object in case of error, nothing otherwise. Note that also in case of error, all
@@ -112,5 +110,5 @@ export declare class ServiceBooking extends Booking {
     useVoucher(voucherCode: string): 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>;
+    const createBooking: (env: MTSEnvs, sub_key: string, debug: boolean, language: string, access_token?: string, sellerId?: number, resellerId?: number) => Promise<ServiceBooking>;
 }

package/lib/booking/serviceBooking.js

@@ -82,19 +82,17 @@ var ServiceBooking = /** @class */ (function (_super) {
     * This is the constructor of the ServiceBooking class.
     * @param {MTSEnvs} env The environment in which the app is running. Can be "DEV", "STAGING" or "PROD"
     * @param {string} sub_key The subscription key for using the APIs
-    * @param {() => void} onCartExpiration A callback function that will be called when the cart expires
-    * @param {Booking.BookingTypes} bookingType The type of booking. Can be "MLP", "SERVICE" or "MLP_SUBSCRIPTION"
     * @param {boolean} [debug=false] If true, the app will run in debug mode (meaning that will print requests and responses in the console)
     * @param {string} [language=Booking.Languages.EN] The language in which the app is running. Can be "it", "en", "fr", "de" or "es"
     * @param {string} [access_token=undefined] The access token for calling MTS APIs
     * @param {number} [sellerId=undefined] The id of the seller. If not set, it will return the results for all sellers
     * @param {number} [resellerId=undefined] The id of the reseller.
     */
-    function ServiceBooking(env, sub_key, onCartExpiration, debug, language, access_token, sellerId, resellerId) {
+    function ServiceBooking(env, sub_key, debug, language, access_token, sellerId, resellerId) {
         if (debug === void 0) { debug = false; }
         if (language === void 0) { language = booking_1.Booking.Languages.EN; }
         // Call Booking constructor
-        var _this = _super.call(this, env, sub_key, onCartExpiration, booking_1.Booking.BookingTypes.SERVICE, debug, language, access_token, sellerId, resellerId) || this;
+        var _this = _super.call(this, env, sub_key, booking_1.Booking.BookingTypes.SERVICE, debug, language, access_token, sellerId, resellerId) || this;
         // Set cartId
         var cartId = localStorage.getItem("cartId");
         if (cartId) {
@@ -105,20 +103,33 @@ var ServiceBooking = /** @class */ (function (_super) {
     ServiceBooking.prototype.getCart = function () {
         return this.cart;
     };
+    ServiceBooking.prototype.resetBooking = function () {
+        this.cart = undefined;
+        this.cartId = undefined;
+        this.bookingStepsToStatus = new Map();
+        this.bookingDueDate = undefined;
+        localStorage.removeItem("cartId");
+    };
     ServiceBooking.prototype.fetchAndSetCart = function (cartId) {
         return __awaiter(this, void 0, void 0, function () {
             var _this = this;
             return __generator(this, function (_a) {
                 switch (_a.label) {
-                    case 0: return [4 /*yield*/, this.fetchCart(cartId).then(function (cart) {
-                            var cartDate = new Date(cart.bookingDueDate);
-                            if (cartDate > new Date()) {
-                                _this.cart = cart;
-                                _this.cartId = cart.id;
-                                _this.bookingDueDate = cartDate; // See Booking class
-                                // Fill the booking process status
-                                _this.bookingStepsToStatus = (0, processBookingSteps_1.processBookingSteps)(cart.stepsToStatus);
-                                _this.createCartTimer(cartDate);
+                    case 0: return [4 /*yield*/, this.fetchCart(cartId).then(function (response) {
+                            console.log(response);
+                            if (response.cart) {
+                                var cartDate = new Date(response.cart.bookingDueDate);
+                                if (cartDate > new Date()) {
+                                    _this.cart = response.cart;
+                                    _this.cartId = response.cart.id;
+                                    _this.bookingDueDate = cartDate; // See Booking class
+                                    // Fill the booking process status
+                                    _this.bookingStepsToStatus = (0, processBookingSteps_1.processBookingSteps)(response.cart.stepsToStatus);
+                                }
+                                else {
+                                    // This should never happen, but just in case
+                                    _this.resetBooking();
+                                }
                             }
                         })];
                     case 1:
@@ -128,25 +139,10 @@ var ServiceBooking = /** @class */ (function (_super) {
             });
         });
     };
-    ServiceBooking.prototype.createCartTimer = function (expiringDate) {
-        return __awaiter(this, void 0, void 0, function () {
-            var _this = this;
-            return __generator(this, function (_a) {
-                setTimeout(function () {
-                    localStorage.removeItem("cartId");
-                    // Put actions that have to be done when timer expires here
-                    _this.cart = undefined;
-                    _this.cartId = undefined;
-                    _this.bookingDueDate = undefined; // See Booking class
-                    _this.onCartExpiration();
-                }, expiringDate.valueOf() - new Date().valueOf());
-                return [2 /*return*/];
-            });
-        });
-    };
     ServiceBooking.prototype.fetchCart = function (cartId) {
         return __awaiter(this, void 0, void 0, function () {
             var url;
+            var _this = this;
             return __generator(this, function (_a) {
                 url = "".concat(this.config.API_ENDPOINT, "/booking/cart?").concat(new URLSearchParams({ cartId: cartId.toString() }));
                 return [2 /*return*/, this.callGetApi(url).then(function (response) {
@@ -154,7 +150,11 @@ var ServiceBooking = /** @class */ (function (_super) {
                             localStorage.removeItem("cartId");
                             throw new Error(response);
                         }
-                        return response.cart;
+                        // Check that the cart doe not have issued tickets
+                        if (response.hasIssuedTickets) {
+                            _this.resetBooking();
+                        }
+                        return response;
                     })];
             });
         });
@@ -170,17 +170,13 @@ 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.cart) {
+                if (!this.cart || !this.cartId) {
                     throw Error("Cart is not initialized yet");
                 }
-                url = "".concat(this.config.API_ENDPOINT, "/removeBookingFromCart");
-                return [2 /*return*/, this.callPostApi(url, { cartId: this.cart.id }).then(function (response) {
+                url = "".concat(this.config.API_ENDPOINT, "/booking/carts?").concat(new URLSearchParams({ cartId: this.cartId.toString() }));
+                return [2 /*return*/, this.callDeleteApi(url).then(function (response) {
                         // Clear all data
-                        localStorage.removeItem("cartId");
-                        _this.bookingStepsToStatus = new Map();
-                        _this.cart = undefined;
-                        _this.cartId = undefined;
-                        _this.bookingDueDate = undefined; // See Booking class
+                        _this.resetBooking();
                         return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response) ? response : response;
                     })];
             });
@@ -251,8 +247,7 @@ var ServiceBooking = /** @class */ (function (_super) {
                         // Check for errors
                         if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
                             // If there was an error, reset cartId and remove it from the localStorage
-                            _this.cartId = undefined;
-                            localStorage.removeItem("cartId");
+                            _this.resetBooking();
                             return response;
                         }
                         // Save the local data
@@ -263,7 +258,6 @@ var ServiceBooking = /** @class */ (function (_super) {
                         // Fill the booking process status
                         _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;
                     })];
             });
@@ -645,12 +639,12 @@ var ServiceBooking = /** @class */ (function (_super) {
 exports.ServiceBooking = ServiceBooking;
 (function (ServiceBooking) {
     var _this = this;
-    ServiceBooking.createBooking = function (env, sub_key, onCartExpiration, debug, language, access_token, sellerId, resellerId) { return __awaiter(_this, void 0, void 0, function () {
+    ServiceBooking.createBooking = function (env, sub_key, debug, language, access_token, sellerId, resellerId) { return __awaiter(_this, void 0, void 0, function () {
         var booking, error_1;
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0:
-                    booking = new ServiceBooking(env, sub_key, onCartExpiration, debug, language, access_token, sellerId, resellerId);
+                    booking = new ServiceBooking(env, sub_key, debug, language, access_token, sellerId, resellerId);
                     _a.label = 1;
                 case 1:
                     _a.trys.push([1, 4, , 5]);

package/lib/booking/subscriptionBooking.d.ts

@@ -3,7 +3,7 @@ import { ErrorResponse } from "../types/ErrorResponse";
 import { EditPassengersDetailsRequest, GetBuyerPassengersDetailsResponse, Person } from "../types/common/Person";
 import { AddReductionRequest } from "../types/common/Reduction";
 import { GetSubscriptionAvailabilityRequest, GetSubscriptionAvailabilityResponse } from "../types/subscriptions/SubscriptionAvailabilities";
-import { CreateSubscriptionCartRequest, SubscriptionCart } from "../types/subscriptions/SubscriptionCart";
+import { CreateSubscriptionCartRequest, GetSubscriptionCartResponse, SubscriptionCart } from "../types/subscriptions/SubscriptionCart";
 import { Subscription } from "../types/subscriptions/Subscriptions";
 import { Booking } from "./booking";
 export declare class SubscriptionBooking extends Booking {
@@ -12,19 +12,17 @@ export declare class SubscriptionBooking extends Booking {
     * This is the constructor of the ServiceBooking class.
     * @param {MTSEnvs} env The environment in which the app is running. Can be "DEV", "STAGING" or "PROD"
     * @param {string} sub_key The subscription key for using the APIs
-    * @param {() => void} onCartExpiration A callback function that will be called when the cart expires
-    * @param {Booking.BookingTypes} bookingType The type of booking. Can be "MLP", "SERVICE" or "MLP_SUBSCRIPTION"
     * @param {boolean} [debug=false] If true, the app will run in debug mode (meaning that will print requests and responses in the console)
     * @param {string} [language=Booking.Languages.EN] The language in which the app is running. Can be "it", "en", "fr", "de" or "es"
     * @param {string} [access_token=undefined] The access token for calling MTS APIs
     * @param {number} [sellerId=undefined] The id of the seller. If not set, it will return the results for all sellers
     * @param {number} [resellerId=undefined] The id of the reseller.
     */
-    constructor(env: MTSEnvs, sub_key: string, onCartExpiration: () => void, debug?: boolean, language?: string, access_token?: string, sellerId?: number, resellerId?: number);
+    constructor(env: MTSEnvs, sub_key: string, debug?: boolean, language?: string, access_token?: string, sellerId?: number, resellerId?: number);
     getCart(): SubscriptionCart | undefined;
+    resetBooking(): void;
     fetchAndSetCart(cartId: number): Promise<void>;
-    private createCartTimer;
-    fetchCart(cartId: number): Promise<SubscriptionCart>;
+    fetchCart(cartId: number): Promise<GetSubscriptionCartResponse>;
     /**
    * This method allows to delete a cart, thus allowing the user to exit from the booking process.
    * @returns An {@link ErrorResponse} object in case of error, nothing otherwise. Note that also in case of error, all
@@ -130,7 +128,7 @@ export declare class SubscriptionBooking extends Booking {
     useVoucher(voucherCode: string): 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>;
+    const createBooking: (env: MTSEnvs, sub_key: string, debug: boolean, language: string, access_token?: string, sellerId?: number, resellerId?: number) => Promise<SubscriptionBooking>;
     enum ValidityTypes {
         WORKING_WEEK = "WORKING_WEEK",
         WEEKLY = "WEEKLY",

package/lib/booking/subscriptionBooking.js

@@ -82,19 +82,17 @@ var SubscriptionBooking = /** @class */ (function (_super) {
     * This is the constructor of the ServiceBooking class.
     * @param {MTSEnvs} env The environment in which the app is running. Can be "DEV", "STAGING" or "PROD"
     * @param {string} sub_key The subscription key for using the APIs
-    * @param {() => void} onCartExpiration A callback function that will be called when the cart expires
-    * @param {Booking.BookingTypes} bookingType The type of booking. Can be "MLP", "SERVICE" or "MLP_SUBSCRIPTION"
     * @param {boolean} [debug=false] If true, the app will run in debug mode (meaning that will print requests and responses in the console)
     * @param {string} [language=Booking.Languages.EN] The language in which the app is running. Can be "it", "en", "fr", "de" or "es"
     * @param {string} [access_token=undefined] The access token for calling MTS APIs
     * @param {number} [sellerId=undefined] The id of the seller. If not set, it will return the results for all sellers
     * @param {number} [resellerId=undefined] The id of the reseller.
     */
-    function SubscriptionBooking(env, sub_key, onCartExpiration, debug, language, access_token, sellerId, resellerId) {
+    function SubscriptionBooking(env, sub_key, debug, language, access_token, sellerId, resellerId) {
         if (debug === void 0) { debug = false; }
         if (language === void 0) { language = booking_1.Booking.Languages.EN; }
         // Call Booking constructor
-        var _this = _super.call(this, env, sub_key, onCartExpiration, booking_1.Booking.BookingTypes.MLP_SUBSCRIPTION, debug, language, access_token, sellerId, resellerId) || this;
+        var _this = _super.call(this, env, sub_key, booking_1.Booking.BookingTypes.MLP_SUBSCRIPTION, debug, language, access_token, sellerId, resellerId) || this;
         // Set cartId
         var cartId = localStorage.getItem("cartId");
         if (cartId) {
@@ -105,26 +103,32 @@ var SubscriptionBooking = /** @class */ (function (_super) {
     SubscriptionBooking.prototype.getCart = function () {
         return this.cart;
     };
+    SubscriptionBooking.prototype.resetBooking = function () {
+        this.cart = undefined;
+        this.cartId = undefined;
+        this.bookingStepsToStatus = new Map();
+        this.bookingDueDate = undefined;
+        localStorage.removeItem("cartId");
+    };
     SubscriptionBooking.prototype.fetchAndSetCart = function (cartId) {
         return __awaiter(this, void 0, void 0, function () {
             var _this = this;
             return __generator(this, function (_a) {
                 switch (_a.label) {
-                    case 0: return [4 /*yield*/, this.fetchCart(cartId).then(function (cart) {
-                            var cartDate = new Date(cart.bookingDueDate);
-                            if (cartDate > new Date()) {
-                                _this.cart = cart;
-                                _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.createCartTimer(cartDate);
+                    case 0: return [4 /*yield*/, this.fetchCart(cartId).then(function (response) {
+                            if (response.cart) {
+                                var cartDate = new Date(response.cart.bookingDueDate);
+                                if (cartDate > new Date()) {
+                                    _this.cart = response.cart;
+                                    _this.cartId = response.cart.id;
+                                    _this.bookingDueDate = cartDate; // See Booking class
+                                    // Fill the booking process status
+                                    _this.bookingStepsToStatus = (0, processBookingSteps_1.processBookingSteps)(response.cart.stepsToStatus);
+                                }
+                                else {
+                                    // This should never happen, but just in case
+                                    _this.resetBooking();
+                                }
                             }
                         })];
                     case 1:
@@ -134,34 +138,22 @@ var SubscriptionBooking = /** @class */ (function (_super) {
             });
         });
     };
-    SubscriptionBooking.prototype.createCartTimer = function (expiringDate) {
-        return __awaiter(this, void 0, void 0, function () {
-            var _this = this;
-            return __generator(this, function (_a) {
-                setTimeout(function () {
-                    localStorage.removeItem("cartId");
-                    // Put actions that have to be done when timer expires here
-                    _this.bookingStepsToStatus = new Map();
-                    _this.cart = undefined;
-                    _this.cartId = undefined;
-                    _this.bookingDueDate = undefined; // See Booking class
-                    _this.onCartExpiration();
-                }, expiringDate.valueOf() - new Date().valueOf());
-                return [2 /*return*/];
-            });
-        });
-    };
     SubscriptionBooking.prototype.fetchCart = function (cartId) {
         return __awaiter(this, void 0, void 0, function () {
             var url;
+            var _this = this;
             return __generator(this, function (_a) {
                 url = "".concat(this.config.API_ENDPOINT, "/booking/cart?").concat(new URLSearchParams({ cartId: cartId.toString() }));
                 return [2 /*return*/, this.callGetApi(url).then(function (response) {
                         if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
-                            localStorage.removeItem("cartId");
+                            _this.resetBooking();
                             throw new Error(response);
                         }
-                        return response.cart;
+                        // Check that the cart doe not have issued tickets
+                        if (response.hasIssuedTickets) {
+                            _this.resetBooking();
+                        }
+                        return response;
                     })];
             });
         });
@@ -177,17 +169,12 @@ 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.cart) {
+                if (!this.cart || !this.cartId) {
                     throw Error("Cart is not initialized yet");
                 }
-                url = "".concat(this.config.API_ENDPOINT, "/removeBookingFromCart");
-                return [2 /*return*/, this.callPostApi(url, { cartId: this.cart.id }).then(function (response) {
-                        // Clear all data
-                        localStorage.removeItem("cartId");
-                        _this.bookingStepsToStatus = new Map();
-                        _this.cart = undefined;
-                        _this.cartId = undefined;
-                        _this.bookingDueDate = undefined; // See Booking class
+                url = "".concat(this.config.API_ENDPOINT, "/booking/carts?").concat(new URLSearchParams({ cartId: this.cartId.toString() }));
+                return [2 /*return*/, this.callDeleteApi(url).then(function (response) {
+                        _this.resetBooking();
                         return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response) ? response : response;
                     })];
             });
@@ -314,8 +301,7 @@ var SubscriptionBooking = /** @class */ (function (_super) {
                         // Check for errors
                         if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
                             // If there was an error, reset cartId and remove it from the localStorage
-                            _this.cartId = undefined;
-                            localStorage.removeItem("cartId");
+                            _this.resetBooking();
                             return response;
                         }
                         _this.cart = response.cart;
@@ -325,7 +311,6 @@ var SubscriptionBooking = /** @class */ (function (_super) {
                         // Fill the booking process status
                         _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;
                     })];
             });
@@ -728,12 +713,12 @@ var SubscriptionBooking = /** @class */ (function (_super) {
 exports.SubscriptionBooking = SubscriptionBooking;
 (function (SubscriptionBooking) {
     var _this = this;
-    SubscriptionBooking.createBooking = function (env, sub_key, onCartExpiration, debug, language, access_token, sellerId, resellerId) { return __awaiter(_this, void 0, void 0, function () {
+    SubscriptionBooking.createBooking = function (env, sub_key, debug, language, access_token, sellerId, resellerId) { return __awaiter(_this, void 0, void 0, function () {
         var booking, error_1;
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0:
-                    booking = new SubscriptionBooking(env, sub_key, onCartExpiration, debug, language, access_token, sellerId, resellerId);
+                    booking = new SubscriptionBooking(env, sub_key, debug, language, access_token, sellerId, resellerId);
                     _a.label = 1;
                 case 1:
                     _a.trys.push([1, 4, , 5]);

package/lib/index.d.ts

@@ -10,15 +10,15 @@ export { Reduction, AddReductionRequest } from "./types/common/Reduction";
 export { Gateway, GetSellerGatewaysResponse, GetPaymentInformationFromGatewayResponse, IssueTicketsResponse, GatewayTypes, PaymentMethods } from "./types/common/Payment";
 export { ErrorResponse, objectIsMTSErrorResponse } from "./types/ErrorResponse";
 export { BusLayoutCell, BusMatrix, BusCellTypes, SeatStatus } from "./types/journeys/BusMatrix";
-export { JourneyCart, JourneyBookingType, CreateJourneyCartRequest, TripBookingInfo, DEFAULT_CREATE_JOURNEY_CART } from "./types/journeys/JourneyCart";
+export { JourneyCart, GetJourneyCartResponse, JourneyBookingType, CreateJourneyCartRequest, TripBookingInfo, DEFAULT_CREATE_JOURNEY_CART } from "./types/journeys/JourneyCart";
 export { JourneyInfo } from "./types/journeys/JourneyInfo";
 export { JourneySearchRequest, JourneySearchResult, DEFAULT_JOURNEY_SEARCH } from "./types/journeys/JourneySearch";
 export { Stop } from "./types/journeys/Stop";
 export { Trip, CartTrip, ReductionTrip } from "./types/journeys/Trip";
 export { Line } from "./types/services/Line";
 export { Service, ServiceTrip } from "./types/services/Service";
-export { ServiceCart, ServiceBookingType, CreateServiceCartRequest } from "./types/services/ServiceCart";
+export { ServiceCart, GetServiceCartResponse, ServiceBookingType, CreateServiceCartRequest } from "./types/services/ServiceCart";
 export { ServiceInfo } from "./types/services/ServiceInfo";
 export { Subscription } from "./types/subscriptions/Subscriptions";
 export { GetSubscriptionAvailabilityRequest, GetSubscriptionAvailabilityResponse, SubscriptionCalendarDayPeriodInfo } from "./types/subscriptions/SubscriptionAvailabilities";
-export { SubscriptionCart, SubscriptionBookingType, CreateSubscriptionCartRequest, SubscriptionPeriod } from "./types/subscriptions/SubscriptionCart";
+export { SubscriptionCart, GetSubscriptionCartResponse, SubscriptionBookingType, CreateSubscriptionCartRequest, SubscriptionPeriod } from "./types/subscriptions/SubscriptionCart";

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

@@ -9,6 +9,7 @@ import { Extra } from "./Extra";
  * - SubscriptionCart: {@link SubscriptionCart}
  * @property {number} id The id of the cart
  * @property {string} cartCode The code of the cart
+ * @property {number} sellerId The id of the seller of the tickets in the cart
  * @property {Map<string, boolean[]>} stepsToStatus This data structure describes the steps of the booking process.
  * The keys of this dictionary represent the booking steps. See ... for the list of possible steps. If the
  * key is present, then the booking step shall be displayed. The value is a list of 3 booleans:
@@ -17,10 +18,10 @@ import { Extra } from "./Extra";
  * - The third tells whether the section is required.
  * @property {Booking.Currencies} currency The currency of the cart. See {@link Booking.Currencies}
  * @property {string} bookingDueDate The date and time when the cart expires
- * @property {number} buyerId The id of the buyer
  */
 export type Cart = {
     id: number;
+    sellerId: number;
     cartCode: string;
     stepsToStatus: Map<string, boolean[]>;
     currency: Booking.Currencies;

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

@@ -23,13 +23,17 @@ export declare const initializePerson: (person?: Person | undefined | null) => P
  * @description Represents a passenger in the response of the {@link getPassengersDetails} method. This type extends the {@link Person} type
  * with the `outboundTariffs` and `returnTariffs` properties.
  *
+ * @property {string} outboundNotes - The notes for the outbound trip.
  * @property { Map<number, PassengerTariff>} outboundTariffs - A map containing the outbound tariffs for this passenger. The key is the trip id.
  * For every trip, the first element the value is the suggested tariff. The other elements are the other tariffs, so that the user can adjust
  * the tariff for the passenger.
+ * @property {string} returnNotes - The notes for the return trip.
  * @property { Map<number, PassengerTariff>} returnTariffs - Same of `outboundTariffs`, but for the return trip.
 */
 export type GetPassenger = Person & {
+    outboundNotes: string | null;
     outboundTariffs: Map<number, PassengerTariff[]>;
+    returnNotes: string | null;
     returnTariffs: Map<number, PassengerTariff[]> | null;
 };
 export declare enum BuyerDataStatus {
@@ -54,9 +58,12 @@ export type GetBuyerPassengersDetailsResponse = {
 };
 /**
  * @description Represents the type of the passengers array in {@link EditPassengersDetailsRequest}.
+ * @property {Map<number, number>} tripsToTariffs A dictionary containg the selected tariff for each trip (both outbound and return).
  * Note that in the `tripsToTariffs` map, the key is the trip id and the value is the chosen tariff id.
  */
 export type EditPassengerRequestType = Person & {
+    outboundNotes?: string | undefined;
+    returnNotes?: string | undefined;
     tripsToTariffs: Map<number, number>;
 };
 /**

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

@@ -35,6 +35,16 @@ export type CreateJourneyCartRequest = {
     returnJourney: TripBookingInfo[] | null;
 };
 export declare const DEFAULT_CREATE_JOURNEY_CART: CreateJourneyCartRequest;
+/**
+ * This type represents the response of the {@link JourneyBooking.fetchCart} API.
+ * @property {JourneyCart} cart - The {@link JourneyCart} object representing the cart.
+ * @property {boolean} hasIssuedTickets - A boolean telling whether the cart has issued tickets. Note that if this is the case,
+ * the cart will be null because it is not possible to add tickets to an issued cart. Thus, all data should be reset.
+ */
+export type GetJourneyCartResponse = {
+    cart: JourneyCart | null;
+    hasIssuedTickets: boolean;
+};
 /**
  * @description Represents a `JourneyCart`, which extends the {@link Cart} type by including additional
  * information about the bookings

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

@@ -31,6 +31,16 @@ export type CreateServiceCartRequest = {
 export type ServiceCart = Cart & {
     bookings: ServiceBookingType[];
 };
+/**
+ * This type represents the response of the {@link ServiceBooking.fetchCart} API.
+ * @property {JourneyCart} cart - The {@link ServiceCart} object representing the cart.
+ * @property {boolean} hasIssuedTickets - A boolean telling whether the cart has issued tickets. Note that if this is the case,
+ * the cart will be null because it is not possible to add tickets to an issued cart. Thus, all data should be reset.
+ */
+export type GetServiceCartResponse = {
+    cart: ServiceCart | null;
+    hasIssuedTickets: boolean;
+};
 /**
  * @description Represents a `ServiceBooking`, which contains information about a service booking.
  *

package/lib/types/subscriptions/SubscriptionCart.d.ts

@@ -48,6 +48,16 @@ export type SubscriptionPeriod = {
 export type SubscriptionCart = Cart & {
     bookings: SubscriptionBookingType[];
 };
+/**
+ * This type represents the response of the {@link SubscriptionBooking.fetchCart} API.
+ * @property {JourneyCart} cart - The {@link SubscriptionCart} object representing the cart.
+ * @property {boolean} hasIssuedTickets - A boolean telling whether the cart has issued tickets. Note that if this is the case,
+ * the cart will be null because it is not possible to add tickets to an issued cart. Thus, all data should be reset.
+ */
+export type GetSubscriptionCartResponse = {
+    cart: SubscriptionCart | null;
+    hasIssuedTickets: boolean;
+};
 /**
  * @description Represents a `SubscriptionBooking`, which contains information about a subscription booking.
  *

package/package.json

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