mts-booking-library 1.1.9 → 1.2.0

package/lib/booking/journeyBooking.js

@@ -52,6 +52,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 booking_1 = require("./booking");
 var JourneyBooking = /** @class */ (function (_super) {
     __extends(JourneyBooking, _super);
@@ -90,7 +91,14 @@ var JourneyBooking = /** @class */ (function (_super) {
                     if (cartDate > new Date()) {
                         _this.cart = cart;
                         _this.bookingDueDate = cartDate; // See Booking class
-                        _this.cartStatus = cart.status;
+                        // 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);
                     }
                 });
@@ -105,7 +113,7 @@ var JourneyBooking = /** @class */ (function (_super) {
                 setTimeout(function () {
                     localStorage.removeItem("cartId");
                     // Put actions that have to be done when timer expires here
-                    _this.cartStatus = booking_1.Booking.CartStatus.EMPTY;
+                    _this.bookingStepsToStatus = new Map();
                     _this.cart = undefined;
                     _this.bookingDueDate = undefined; // See Booking class
                     _this.onCartExpiration();
@@ -119,7 +127,13 @@ var JourneyBooking = /** @class */ (function (_super) {
             var url;
             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)];
+                return [2 /*return*/, this.callGetApi(url).then(function (response) {
+                        if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
+                            localStorage.removeItem("cartId");
+                            throw new Error("Error ".concat(response.httpStatus, " ").concat(response.message));
+                        }
+                        return response.cart;
+                    })];
             });
         });
     };
@@ -132,7 +146,9 @@ var JourneyBooking = /** @class */ (function (_super) {
             var url;
             return __generator(this, function (_a) {
                 url = "".concat(this.config.API_ENDPOINT, "/booking/journeys/departures?");
-                return [2 /*return*/, this.callGetApi(url)];
+                return [2 /*return*/, this.callGetApi(url).then(function (response) {
+                        return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response) ? response : response.stops;
+                    })];
             });
         });
     };
@@ -147,7 +163,9 @@ var JourneyBooking = /** @class */ (function (_super) {
             return __generator(this, function (_a) {
                 searchParams = new URLSearchParams({ departureStopName: departureStopName });
                 url = "".concat(this.config.API_ENDPOINT, "/booking/journeys/destinations?").concat(searchParams);
-                return [2 /*return*/, this.callGetApi(url)];
+                return [2 /*return*/, this.callGetApi(url).then(function (response) {
+                        return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response) ? response : response.stops;
+                    })];
             });
         });
     };
@@ -155,107 +173,203 @@ var JourneyBooking = /** @class */ (function (_super) {
     * This method returns the journeys that match the given parameters.
     * Note that it will always return the journeys for the one-way trip.
     * If you want to get the journeys for the round trip, you have to call this method twice (make sure to swap departureStopName and destinationStopName)
-    * @param {JourneySearch} params an object of type {@link JourneySearch} containing the parameters of the search
+    * @param {JourneySearch} request an object of type {@link JourneySearch} containing the parameters of the search
     * @returns {JourneySearchResult[]} The returned journeys that match the given parameters
     */
-    JourneyBooking.prototype.getJourneys = function (params) {
+    JourneyBooking.prototype.getJourneys = function (request) {
         return __awaiter(this, void 0, void 0, function () {
             var searchParams, url;
             return __generator(this, function (_a) {
-                if (params.departureStopName === undefined || params.destinationStopName === undefined) {
+                if (request.departureStopName === undefined || request.destinationStopName === undefined) {
                     throw Error("Fields departureStopName and destinationStopName are required");
                 }
                 searchParams = new URLSearchParams({
-                    departureStopName: params.departureStopName,
-                    destinationStopName: params.destinationStopName,
-                    passengersNumber: params.passengersNumber.toString(),
-                    date: params.date,
-                    roundTripDate: params.roundTripDate ? params.roundTripDate : "null",
-                    currency: params.currency,
-                    isRoundtrip: params.isRoundtrip.toString()
+                    departureStopName: request.departureStopName,
+                    destinationStopName: request.destinationStopName,
+                    passengersNumber: request.passengersNumber.toString(),
+                    date: request.date,
+                    roundTripDate: request.roundTripDate ? request.roundTripDate : "null",
+                    currency: request.currency,
+                    isRoundtrip: request.isRoundtrip.toString()
                 });
                 url = "".concat(this.config.API_ENDPOINT, "/booking/journeys?").concat(searchParams);
-                return [2 /*return*/, this.callGetApi(url)];
+                return [2 /*return*/, this.callGetApi(url).then(function (response) {
+                        return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response) ? response : response.journeys;
+                    })];
             });
         });
     };
-    JourneyBooking.prototype.createJourneyCart = function (tripCart) {
+    JourneyBooking.prototype.createJourneyCart = function (journeyCart) {
         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/journeys/cart");
-                return [2 /*return*/, this.callPostApi(url, tripCart).then(function (cart) {
-                        _this.cart = cart.cart;
-                        _this.cartStatus = cart.cart.status;
-                        _this.bookingDueDate = new Date(cart.cart.bookingDueDate);
-                        _this.createCartTimer(new Date(cart.cart.bookingDueDate));
-                        return cart.cart;
+                return [2 /*return*/, this.callPostApi(url, journeyCart).then(function (response) {
+                        // Check for errors
+                        if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
+                            return response;
+                        }
+                        _this.cart = response.cart;
+                        // 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.bookingDueDate = new Date(response.cart.bookingDueDate);
+                        _this.createCartTimer(new Date(response.cart.bookingDueDate));
+                        return response.cart;
                     })];
             });
         });
     };
-    JourneyBooking.prototype.getBusMatrix = function (tripId, departureStopId, destinationStopId) {
+    /**
+     * @description This method shall be called when the user wants to retrieve information about the buyer and the passengers.
+     * @returns An object of type {@link GetBuyerPassengersDetailsResponse} containing the buyer and the passengers information,
+     * as well as a list of the available tariffs for each trip.
+     */
+    JourneyBooking.prototype.getBuyerPassengersDetails = function () {
         return __awaiter(this, void 0, void 0, function () {
-            var searchParams, url;
+            var buyerPassengersDetails, url;
             return __generator(this, function (_a) {
-                searchParams = new URLSearchParams({
-                    departureStopId: departureStopId.toString(),
-                    destinationStopId: destinationStopId.toString()
-                });
-                url = "".concat(this.config.API_ENDPOINT, "/booking/journeys/trips/").concat(tripId, "/seats?").concat(searchParams);
-                return [2 /*return*/, this.callGetApi(url)];
+                // First check that it is possible to call this API
+                if (!this.cart) {
+                    throw Error("Cart is not initialized yet");
+                }
+                buyerPassengersDetails = this.bookingStepsToStatus.get(booking_1.Booking.BookingSteps.BUYER_PASSENGERS);
+                if (!buyerPassengersDetails || !buyerPassengersDetails[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.cart.id, "/details?");
+                return [2 /*return*/, this.callGetApi(url).then(function (response) {
+                        // Check for errors
+                        if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
+                            return response;
+                        }
+                        // Parse the map for the tariffs
+                        var tripsToTariffs = new Map(Object.entries(response.tariffs).map(function (_a) {
+                            var tripId = _a[0], tariff = _a[1];
+                            return [
+                                +tripId,
+                                tariff
+                            ];
+                        }));
+                        return {
+                            buyer: response.buyer,
+                            passengers: response.passengers,
+                            tariffs: tripsToTariffs
+                        };
+                    })];
             });
         });
     };
-    // TODO: Fix this
-    JourneyBooking.prototype.getSeatsStatus = function (params) {
+    /**
+     * @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.
+     */
+    JourneyBooking.prototype.updateBuyerPassengersDetails = function (passengersDetails) {
         return __awaiter(this, void 0, void 0, function () {
-            var searchParams, url;
+            var buyerPassengersDetails, 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");
                 }
-                searchParams = new URLSearchParams({ tripId: params.tripId.toString() });
-                url = "".concat(this.config.API_ENDPOINT, "/booking/cart/").concat(this.cart.id, "/seats?").concat(searchParams);
-                return [2 /*return*/, this.callGetApi(url)];
+                buyerPassengersDetails = this.bookingStepsToStatus.get(booking_1.Booking.BookingSteps.BUYER_PASSENGERS);
+                if (!buyerPassengersDetails || !buyerPassengersDetails[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.cart.id, "/details");
+                return [2 /*return*/, this.callPostApi(url, passengersDetails).then(function (response) {
+                        return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response) ? response : response;
+                    })];
             });
         });
     };
-    // TODO: Fix this
-    JourneyBooking.prototype.movePassengers = function (params) {
+    /**
+     * @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.
+     * @param {number} tripId The id of the trip for which the bus matrix should be retrieved
+     * @param {number} departureStopId The id of the departure stop
+     * @param {number} destinationStopId The id of the destination stop
+     * @returns An {@link ErrorResponse} object in case of error, a {@link BusMatrix} otherwise.
+     */
+    JourneyBooking.prototype.getBusMatrix = function (tripId, departureStopId, destinationStopId) {
         return __awaiter(this, void 0, void 0, function () {
-            var url;
+            var seatSelectionStatus, searchParams, 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, "/seats");
-                return [2 /*return*/, this.callGetApi(url)];
+                seatSelectionStatus = this.bookingStepsToStatus.get(booking_1.Booking.BookingSteps.SEATS_SELECTION);
+                if (!seatSelectionStatus || !seatSelectionStatus[0]) {
+                    throw Error("The status of the cart does not allow to call this API");
+                }
+                searchParams = new URLSearchParams({
+                    departureStopId: departureStopId.toString(),
+                    destinationStopId: destinationStopId.toString()
+                });
+                url = "".concat(this.config.API_ENDPOINT, "/booking/journeys/trips/").concat(tripId, "/seats?").concat(searchParams);
+                return [2 /*return*/, this.callGetApi(url).then(function (response) {
+                        return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response) ? response : response.busMatrix;
+                    })];
             });
         });
     };
-    JourneyBooking.prototype.getPassengersDetails = function () {
+    /**
+     * @description This method shall be called when the user wants to retrieve which seats were assigned for this booking.
+     * @param {number} tripId The id of the trip for which the seats should be retrieved.
+     * @returns An {@link ErrorResponse} object in case of error, a list of {@link BusLayoutCell} ids otherwise, representing the assigned seats.
+     */
+    JourneyBooking.prototype.getAssignedSeats = function (tripId) {
         return __awaiter(this, void 0, void 0, function () {
-            var url;
+            var seatSelectionStatus, searchParams, 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, "/details?");
-                return [2 /*return*/, this.callGetApi(url)];
+                seatSelectionStatus = this.bookingStepsToStatus.get(booking_1.Booking.BookingSteps.SEATS_SELECTION);
+                if (!seatSelectionStatus || !seatSelectionStatus[0]) {
+                    throw Error("The status of the cart does not allow to call this API");
+                }
+                searchParams = new URLSearchParams({ tripId: tripId.toString() });
+                url = "".concat(this.config.API_ENDPOINT, "/booking/cart/").concat(this.cart.id, "/seats?").concat(searchParams);
+                return [2 /*return*/, this.callGetApi(url).then(function (response) {
+                        return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response) ? response : response.assignedSeats;
+                    })];
             });
         });
     };
-    JourneyBooking.prototype.updatePassengersDetails = function (passengersDetails) {
+    /**
+     * @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.
+     */
+    JourneyBooking.prototype.changeSeatsOfTrip = function (tripId, newSeatsIds) {
         return __awaiter(this, void 0, void 0, function () {
-            var url;
+            var seatSelectionStatus, 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, "/details");
-                return [2 /*return*/, this.callPostApi(url, passengersDetails)];
+                seatSelectionStatus = this.bookingStepsToStatus.get(booking_1.Booking.BookingSteps.SEATS_SELECTION);
+                if (!seatSelectionStatus || !seatSelectionStatus[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.cart.id, "/seats");
+                return [2 /*return*/, this.callPostApi(url, { tripId: tripId, seatsIds: newSeatsIds }).then(function (response) {
+                        return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response) ? response : response;
+                    })];
             });
         });
     };

package/lib/booking/serviceBooking.d.ts

@@ -1,4 +1,5 @@
 import { MTSEnvs } from "../config";
+import { ErrorResponse } from "../types/ErrorResponse";
 import { Service, ServiceTrip } from "../types/services/Service";
 import { CreateServiceCartRequest, ServiceCart } from "../types/services/ServiceCart";
 import { Booking } from "./booking";
@@ -25,7 +26,7 @@ export declare class ServiceBooking extends Booking {
     * If the sellerId is not set or it is 0, it will return the list of cities for all sellers.
     * @returns {string[]} The list of possible cities
     */
-    getServiceCities(): Promise<string[]>;
+    getServiceCities(): Promise<ErrorResponse | string[]>;
     /**
     * This method returns the tours sold by this seller in the given city.
     * If the sellerId is not set or it is 0, it will return the tours in the given city for all sellers.
@@ -33,7 +34,7 @@ export declare class ServiceBooking extends Booking {
     * @param {Booking.Currencies} currency The currency in which the prices should be returned
     * @returns {Tour[]} The returned tours
     */
-    getServices(currency: Booking.Currencies, cityName?: string): Promise<Service[]>;
+    getServices(currency: Booking.Currencies, cityName?: string): Promise<ErrorResponse | Service[]>;
     /**
     * This method returns the tours available for the given date. This method can be used if the seller wants the user to book a specific date
     * and/or a specific hour for the tour.
@@ -42,6 +43,6 @@ export declare class ServiceBooking extends Booking {
     * @param {Date} date The date on which to get the tours
     * @returns {ServiceTrip[]} The returned information about the tour (tripId and hour)
     */
-    getServiceTrips(serviceId: number, date: Date): Promise<ServiceTrip[]>;
-    createServiceCart(serviceCart: CreateServiceCartRequest): Promise<ServiceCart>;
+    getServiceTrips(serviceId: number, date: Date): Promise<ErrorResponse | ServiceTrip[]>;
+    createServiceCart(serviceCart: CreateServiceCartRequest): Promise<ErrorResponse | ServiceCart>;
 }

package/lib/booking/serviceBooking.js

@@ -63,6 +63,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 booking_1 = require("./booking");
 var ServiceBooking = /** @class */ (function (_super) {
     __extends(ServiceBooking, _super);
@@ -101,7 +102,14 @@ var ServiceBooking = /** @class */ (function (_super) {
                     if (cartDate > new Date()) {
                         _this.cart = cart;
                         _this.bookingDueDate = cartDate; // See Booking class
-                        _this.cartStatus = cart.status;
+                        // 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);
                     }
                 });
@@ -116,7 +124,6 @@ var ServiceBooking = /** @class */ (function (_super) {
                 setTimeout(function () {
                     localStorage.removeItem("cartId");
                     // Put actions that have to be done when timer expires here
-                    _this.cartStatus = booking_1.Booking.CartStatus.EMPTY;
                     _this.cart = undefined;
                     _this.bookingDueDate = undefined; // See Booking class
                     _this.onCartExpiration();
@@ -130,7 +137,13 @@ var ServiceBooking = /** @class */ (function (_super) {
             var url;
             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)];
+                return [2 /*return*/, this.callGetApi(url).then(function (response) {
+                        if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
+                            localStorage.removeItem("cartId");
+                            throw new Error("Error ".concat(response.httpStatus, " ").concat(response.message));
+                        }
+                        return response.cart;
+                    })];
             });
         });
     };
@@ -144,7 +157,9 @@ var ServiceBooking = /** @class */ (function (_super) {
             var url;
             return __generator(this, function (_a) {
                 url = "".concat(this.config.API_ENDPOINT, "/booking/services/cities?");
-                return [2 /*return*/, this.callGetApi(url)];
+                return [2 /*return*/, this.callGetApi(url).then(function (response) {
+                        return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response) ? response : response.cities;
+                    })];
             });
         });
     };
@@ -161,7 +176,9 @@ var ServiceBooking = /** @class */ (function (_super) {
             return __generator(this, function (_a) {
                 searchParams = new URLSearchParams(__assign(__assign({}, (cityName && { cityName: cityName })), { currency: currency }));
                 url = "".concat(this.config.API_ENDPOINT, "/booking/services?").concat(searchParams);
-                return [2 /*return*/, this.callGetApi(url)];
+                return [2 /*return*/, this.callGetApi(url).then(function (response) {
+                        return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response) ? response : response.services;
+                    })];
             });
         });
     };
@@ -179,7 +196,9 @@ var ServiceBooking = /** @class */ (function (_super) {
             return __generator(this, function (_a) {
                 searchParams = new URLSearchParams({ date: date.toDateString() });
                 url = "".concat(this.config.API_ENDPOINT, "/booking/services/").concat(serviceId, "/trips?").concat(searchParams);
-                return [2 /*return*/, this.callGetApi(url)];
+                return [2 /*return*/, this.callGetApi(url).then(function (response) {
+                        return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response) ? response : response.trips;
+                    })];
             });
         });
     };
@@ -189,12 +208,26 @@ var ServiceBooking = /** @class */ (function (_super) {
             var _this = this;
             return __generator(this, function (_a) {
                 url = "".concat(this.config.API_ENDPOINT, "/booking/services/cart");
-                return [2 /*return*/, this.callPostApi(url, serviceCart).then(function (cart) {
-                        _this.cart = cart.cart;
-                        _this.cartStatus = cart.cart.status;
-                        _this.bookingDueDate = new Date(cart.cart.bookingDueDate);
-                        _this.createCartTimer(new Date(cart.cart.bookingDueDate));
-                        return cart.cart;
+                return [2 /*return*/, this.callPostApi(url, serviceCart).then(function (response) {
+                        // Check for errors
+                        if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
+                            return response;
+                        }
+                        // Save the local data
+                        _this.cart = response.cart;
+                        // 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.bookingDueDate = new Date(response.cart.bookingDueDate);
+                        _this.createCartTimer(new Date(response.cart.bookingDueDate));
+                        return response.cart;
                     })];
             });
         });

package/lib/booking/subscriptionBooking.d.ts

@@ -1,5 +1,7 @@
 import { MTSEnvs } from "../config";
+import { ErrorResponse } from "../types/ErrorResponse";
 import { Cart } from "../types/common/Cart";
+import { EditPassengersDetailsRequest, GetBuyerPassengersDetailsResponse } from "../types/common/Person";
 import { GetSubscriptionAvailabilityRequest, GetSubscriptionAvailabilityResponse } from "../types/subscriptions/SubscriptionAvailabilities";
 import { CreateSubscriptionCartRequest, SubscriptionCart } from "../types/subscriptions/SubscriptionCart";
 import { Subscription } from "../types/subscriptions/Subscriptions";
@@ -26,13 +28,13 @@ export declare class SubscriptionBooking extends Booking {
     * This method returns the possible departures for all subscriptions sold by this seller.
     * @returns {string[]} The list of possible departures
     */
-    getSubscriptionsDepartures(): Promise<string[]>;
+    getSubscriptionsDepartures(): Promise<ErrorResponse | string[]>;
     /**
     * This method returns the possible destination for the subscriptions sold by this seller that start at the selected departure.
     * @param {string} departureStopName The departure stop name (as returned by {@link getSubscriptionsDepartures})
     * @returns {string[]} The list of possible destinations
     */
-    getSubscriptionsDestinations(departureStopName: string): Promise<string[]>;
+    getSubscriptionsDestinations(departureStopName: string): Promise<ErrorResponse | string[]>;
     /**
     * This method returns the possible validity types for the subscriptions sold by this seller between the selected departure and destination.
     * The validity type is the duration of the subscription (1 week, 1 month, etc.). See {@link ValidityTypes} for more details.
@@ -40,7 +42,7 @@ export declare class SubscriptionBooking extends Booking {
     * @param {string} destinationStopName The destination stop name (as returned by {@link getSubscriptionsDstinations})
     * @returns {ValidityTypes[]} The list of possible validity types
     */
-    getSubscriptionsValidityTypes(departureStopName: string, destinationStopName: string): Promise<SubscriptionBooking.ValidityTypes[]>;
+    getSubscriptionsValidityTypes(departureStopName: string, destinationStopName: string): Promise<ErrorResponse | SubscriptionBooking.ValidityTypes[]>;
     /**
     * This method returns the subscriptions that match the given parameters.
     * Note that it will always return the subscription for the one-way trip.
@@ -50,20 +52,32 @@ export declare class SubscriptionBooking extends Booking {
     * @param {string} validityType The validity type (as returned by {@link getSubscriptionsValidityTypes})
     * @returns {Array<Subscription>} The subscriptions that match the given parameters
     */
-    getSubscriptions(departureStopName: string, destinationStopName: string, validityType: string): Promise<Subscription[]>;
+    getSubscriptions(departureStopName: string, destinationStopName: string, validityType: string): Promise<ErrorResponse | Subscription[]>;
     /**
      * This method returns the availability of the subscription for the given parameters.
      * Note that, contrary for the previous method, you should make one single request for both the outbound and return trip.
      * @param {GetSubscriptionAvailabilityRequest} request the request object containing the parameters for the availability check
      * @returns {GetSubscriptionAvailabilityResponse} The availability of the subscription for the given parameters
      */
-    getSubscriptionAvailabilities(request: GetSubscriptionAvailabilityRequest): Promise<GetSubscriptionAvailabilityResponse>;
+    getSubscriptionAvailabilities(request: GetSubscriptionAvailabilityRequest): Promise<ErrorResponse | GetSubscriptionAvailabilityResponse>;
     /**
      * This method creates a subscription cart for the given parameters.
      * @param {CreateSubscriptionCartRequest} request the request object containing the parameters for the availability check
-     * @returns
+     * @returns {SubscriptionCart} The created cart
      */
-    createSubscriptionCart(request: CreateSubscriptionCartRequest): Promise<SubscriptionCart>;
+    createSubscriptionCart(request: CreateSubscriptionCartRequest): Promise<ErrorResponse | SubscriptionCart>;
+    /**
+     * @description This method shall be called when the user wants to retrieve information about the buyer and the passengers.
+     * @returns An object of type {@link GetBuyerPassengersDetailsResponse} containing the buyer and the passengers information,
+     * as well as a list of the available tariffs for each trip.
+     */
+    getBuyerPassengersDetails(): Promise<ErrorResponse | GetBuyerPassengersDetailsResponse>;
+    /**
+     * @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.
+     */
+    updateBuyerPassengersDetails(passengersDetails: EditPassengersDetailsRequest): Promise<ErrorResponse | any>;
 }
 export declare namespace SubscriptionBooking {
     enum ValidityTypes {