mts-booking-library 1.0.5 → 1.1.1

package/lib/booking/booking.d.ts

@@ -0,0 +1,44 @@
+import { MTSConfig, MTSEnvs } from "../config";
+export declare abstract class Booking {
+    readonly sellerId?: number | undefined;
+    readonly config: MTSConfig;
+    cartStatus: Booking.CartStatus;
+    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", "stag" 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 {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
+    */
+    constructor(env: MTSEnvs, sub_key: string, onCartExpiration: () => void, debug?: boolean, access_token?: string, sellerId?: number);
+    /**
+     * This method allows to renew the access token for calling MTS APIs
+     * @param {string} access_token The new access token
+     */
+    renewAccessToken(access_token: string): void;
+    getCartStatus(): Booking.CartStatus;
+    getCartExpirationTimeInMs(): Promise<number>;
+}
+export declare namespace Booking {
+    enum Currencies {
+        EUR = "EUR",
+        USD = "USD",
+        CHF = "CHF"
+    }
+    enum CartStatus {
+        EMPTY = "EMPTY",
+        CREATION = "CREATION",
+        PASSENGERS = "PASSENGERS",
+        SEATS = "SEATS",
+        EXTRAS = "EXTRAS",
+        PAYMENT = "PAYMENT"
+    }
+    enum BookingTypes {
+        MLP = "MLP",
+        SERVICE = "SERVICE",
+        MLP_SUBSCRIPTIONS = "MLP_SUBSCRIPTIONS"
+    }
+}

package/lib/booking/booking.js

@@ -0,0 +1,105 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Booking = void 0;
+var config_1 = require("../config");
+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", "stag" 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 {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
+    */
+    function Booking(env, sub_key, onCartExpiration, debug, access_token, sellerId) {
+        if (debug === void 0) { debug = false; }
+        this.cartStatus = Booking.CartStatus.EMPTY;
+        this.sellerId = sellerId || undefined;
+        this.config = (0, config_1.setConfig)(env, sub_key, debug, access_token);
+        this.onCartExpiration = onCartExpiration;
+    }
+    /**
+     * This method allows to renew the access token for calling MTS APIs
+     * @param {string} access_token The new access token
+     */
+    Booking.prototype.renewAccessToken = function (access_token) {
+        (0, config_1.setConfig)(this.config.ENV, this.config.OCP_SUBSCRIPTION_KEY, this.config.DEBUG, access_token);
+    };
+    Booking.prototype.getCartStatus = function () {
+        return this.cartStatus;
+    };
+    Booking.prototype.getCartExpirationTimeInMs = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                // If cart is initialized, return the time in ms until the cart expires.
+                // Note that bookingDueDate is initialized only when the cart is created.
+                if (this.bookingDueDate) {
+                    return [2 /*return*/, (new Date(this.bookingDueDate).valueOf() - new Date().valueOf())];
+                }
+                // Cart is not initialized
+                throw Error("Cart is not initialized yet");
+            });
+        });
+    };
+    return Booking;
+}());
+exports.Booking = Booking;
+(function (Booking) {
+    var Currencies;
+    (function (Currencies) {
+        Currencies["EUR"] = "EUR";
+        Currencies["USD"] = "USD";
+        Currencies["CHF"] = "CHF";
+    })(Currencies = Booking.Currencies || (Booking.Currencies = {}));
+    var CartStatus;
+    (function (CartStatus) {
+        CartStatus["EMPTY"] = "EMPTY";
+        CartStatus["CREATION"] = "CREATION";
+        CartStatus["PASSENGERS"] = "PASSENGERS";
+        CartStatus["SEATS"] = "SEATS";
+        CartStatus["EXTRAS"] = "EXTRAS";
+        CartStatus["PAYMENT"] = "PAYMENT";
+    })(CartStatus = Booking.CartStatus || (Booking.CartStatus = {}));
+    var BookingTypes;
+    (function (BookingTypes) {
+        BookingTypes["MLP"] = "MLP";
+        BookingTypes["SERVICE"] = "SERVICE";
+        BookingTypes["MLP_SUBSCRIPTIONS"] = "MLP_SUBSCRIPTIONS";
+    })(BookingTypes = Booking.BookingTypes || (Booking.BookingTypes = {}));
+})(Booking || (exports.Booking = Booking = {}));

package/lib/booking/journeyBooking.d.ts

@@ -0,0 +1,49 @@
+import { MTSEnvs } from "../config";
+import { PassengersDetails } from "../types/common/Person";
+import { CreateJourneyCartRequest, JourneyCart } from "../types/journeys/JourneyCart";
+import { JourneySearchRequest, JourneySearchResult } from "../types/journeys/JourneySearch";
+import { Booking } from "./booking";
+export declare class JourneyBooking extends Booking {
+    private cart?;
+    constructor(env: MTSEnvs, sub_key: string, onCartExpiration: () => void, debug?: boolean, access_token?: string, sellerId?: number);
+    getCart(): JourneyCart | undefined;
+    private fetchAndSetCart;
+    private createCartTimer;
+    fetchCart(cartId: number): Promise<JourneyCart>;
+    /**
+    * This method returns the possible departures for all journeys (MLP) sold by this seller.
+    * @returns {string[]} The list of possible departures
+    */
+    getJourneysDepartures(): Promise<string[]>;
+    /**
+    * This method returns the possible destination for the journeys sold by this seller that start at the selected departure.
+    * @param {string} departureStopName The departure stop name (as returned by {@link getJourneysDepartures})
+    * @returns {string[]} The list of possible destinations
+    */
+    getJourneysDestinations(departureStopName: string): Promise<string[]>;
+    /**
+    * 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
+    * @returns {JourneySearchResult[]} The returned journeys that match the given parameters
+    */
+    getJourneys(params: JourneySearchRequest): Promise<JourneySearchResult[]>;
+    createJourneyCart(tripCart: CreateJourneyCartRequest): Promise<JourneyCart>;
+    getBusMatrix(params: {
+        tripId: number;
+        departureStopId: number;
+        destinationStopId: number;
+    }): Promise<any>;
+    getSeatsStatus(params: {
+        tripId: number;
+        departureStopId: number;
+        destinationStopId: number;
+    }): Promise<any>;
+    movePassengers(params: {
+        tripId: number;
+        seatsIds: number[];
+    }): Promise<any>;
+    getPassengersDetails(): Promise<any>;
+    updatePassengersDetails(passengersDetails: PassengersDetails): Promise<any>;
+}

package/lib/booking/journeyBooking.js

@@ -0,0 +1,246 @@
+"use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JourneyBooking = void 0;
+var apiCall_1 = require("../utils/apiCall");
+var booking_1 = require("./booking");
+var JourneyBooking = /** @class */ (function (_super) {
+    __extends(JourneyBooking, _super);
+    function JourneyBooking(env, sub_key, onCartExpiration, debug, access_token, sellerId) {
+        if (debug === void 0) { debug = false; }
+        var _this = 
+        // Call Booking constructor
+        _super.call(this, env, sub_key, onCartExpiration, debug, access_token, sellerId) || this;
+        var cartId = localStorage.getItem("cartId");
+        if (cartId) {
+            _this.fetchAndSetCart(parseInt(cartId));
+        }
+        return _this;
+    }
+    JourneyBooking.prototype.getCart = function () {
+        return this.cart;
+    };
+    JourneyBooking.prototype.fetchAndSetCart = function (cartId) {
+        return __awaiter(this, void 0, void 0, function () {
+            var _this = this;
+            return __generator(this, function (_a) {
+                this.fetchCart(cartId).then(function (cart) {
+                    var cartDate = new Date(cart.bookingDueDate);
+                    if (cartDate > new Date()) {
+                        _this.cart = cart;
+                        _this.bookingDueDate = cartDate; // See Booking class
+                        _this.cartStatus = cart.status;
+                        _this.createCartTimer(cartDate);
+                    }
+                });
+                return [2 /*return*/];
+            });
+        });
+    };
+    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.cartStatus = booking_1.Booking.CartStatus.EMPTY;
+                    _this.cart = 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;
+            return __generator(this, function (_a) {
+                url = "".concat(this.config.API_ENDPOINT, "/booking/cart/\n      ").concat(new URLSearchParams({ cartId: cartId.toString() }));
+                return [2 /*return*/, (0, apiCall_1.makeGet)(url)];
+            });
+        });
+    };
+    /**
+    * This method returns the possible departures for all journeys (MLP) sold by this seller.
+    * @returns {string[]} The list of possible departures
+    */
+    JourneyBooking.prototype.getJourneysDepartures = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var url;
+            return __generator(this, function (_a) {
+                url = "".concat(this.config.API_ENDPOINT, "/booking/journeys/departures?").concat(new URLSearchParams(__assign({}, (this.sellerId && { sellerId: this.sellerId.toString() }))));
+                return [2 /*return*/, (0, apiCall_1.makeGet)(url)];
+            });
+        });
+    };
+    /**
+    * This method returns the possible destination for the journeys sold by this seller that start at the selected departure.
+    * @param {string} departureStopName The departure stop name (as returned by {@link getJourneysDepartures})
+    * @returns {string[]} The list of possible destinations
+    */
+    JourneyBooking.prototype.getJourneysDestinations = function (departureStopName) {
+        return __awaiter(this, void 0, void 0, function () {
+            var url;
+            return __generator(this, function (_a) {
+                url = "".concat(this.config.API_ENDPOINT, "/booking/journeys/destinations?").concat(new URLSearchParams(__assign(__assign({}, (this.sellerId && { sellerId: this.sellerId.toString() })), { departureStopName: departureStopName })));
+                return [2 /*return*/, (0, apiCall_1.makeGet)(url)];
+            });
+        });
+    };
+    /**
+    * 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
+    * @returns {JourneySearchResult[]} The returned journeys that match the given parameters
+    */
+    JourneyBooking.prototype.getJourneys = function (params) {
+        return __awaiter(this, void 0, void 0, function () {
+            var url;
+            return __generator(this, function (_a) {
+                if (params.departureStopName === undefined || params.destinationStopName === undefined) {
+                    throw Error("Fields departureStopName and destinationStopName are required");
+                }
+                url = "".concat(this.config.API_ENDPOINT, "/booking/journeys?").concat(new URLSearchParams(__assign(__assign({}, (this.sellerId && { sellerId: this.sellerId.toString() })), { 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() })));
+                return [2 /*return*/, (0, apiCall_1.makeGet)(url)];
+            });
+        });
+    };
+    JourneyBooking.prototype.createJourneyCart = function (tripCart) {
+        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*/, (0, apiCall_1.makePost)(url, tripCart).then(function (cart) {
+                        _this.cart = cart.cart;
+                        _this.cartStatus = cart.cart.status;
+                        _this.createCartTimer(new Date(cart.cart.bookingDueDate));
+                        return cart.cart;
+                    })];
+            });
+        });
+    };
+    JourneyBooking.prototype.getBusMatrix = function (params) {
+        return __awaiter(this, void 0, void 0, function () {
+            var url;
+            return __generator(this, function (_a) {
+                url = "".concat(this.config.API_ENDPOINT, "/booking/journeys/trips/").concat(params.tripId, "/seats?").concat(new URLSearchParams(__assign(__assign({}, (this.sellerId && { sellerId: this.sellerId.toString() })), { departureStopId: params.departureStopId.toString(), destinationStopId: params.destinationStopId.toString() })));
+                return [2 /*return*/, (0, apiCall_1.makeGet)(url)];
+            });
+        });
+    };
+    JourneyBooking.prototype.getSeatsStatus = function (params) {
+        return __awaiter(this, void 0, void 0, function () {
+            var url;
+            return __generator(this, function (_a) {
+                if (!this.cart) {
+                    throw Error("Cart is not initialized yet");
+                }
+                url = "".concat(this.config.API_ENDPOINT, "/booking/cart/").concat(this.cart.id, "/seats?").concat(new URLSearchParams(__assign(__assign({}, (this.sellerId && { sellerId: this.sellerId.toString() })), { tripId: params.tripId.toString() })));
+                return [2 /*return*/, (0, apiCall_1.makeGet)(url)];
+            });
+        });
+    };
+    JourneyBooking.prototype.movePassengers = function (params) {
+        return __awaiter(this, void 0, void 0, function () {
+            var url;
+            return __generator(this, function (_a) {
+                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*/, (0, apiCall_1.makePost)(url, params)];
+            });
+        });
+    };
+    JourneyBooking.prototype.getPassengersDetails = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var url;
+            return __generator(this, function (_a) {
+                if (!this.cart) {
+                    throw Error("Cart is not initialized yet");
+                }
+                url = "".concat(this.config.API_ENDPOINT, "/booking/cart/").concat(this.cart.id, "/details?").concat(new URLSearchParams(__assign({}, (this.sellerId && { sellerId: this.sellerId.toString() }))));
+                return [2 /*return*/, (0, apiCall_1.makeGet)(url)];
+            });
+        });
+    };
+    JourneyBooking.prototype.updatePassengersDetails = function (passengersDetails) {
+        return __awaiter(this, void 0, void 0, function () {
+            var url;
+            return __generator(this, function (_a) {
+                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*/, (0, apiCall_1.makePost)(url, passengersDetails)];
+            });
+        });
+    };
+    return JourneyBooking;
+}(booking_1.Booking));
+exports.JourneyBooking = JourneyBooking;

package/lib/booking/serviceBooking.d.ts

@@ -0,0 +1,36 @@
+import { MTSEnvs } from "../config";
+import { Service, ServiceTrip } from "../types/services/Service";
+import { CreateServiceCartRequest, ServiceCart } from "../types/services/ServiceCart";
+import { Booking } from "./booking";
+export declare class ServiceBooking extends Booking {
+    private cart?;
+    constructor(env: MTSEnvs, sub_key: string, onCartExpiration: () => void, debug?: boolean, access_token?: string, sellerId?: number);
+    getCart(): ServiceCart | undefined;
+    private fetchAndSetCart;
+    private createCartTimer;
+    fetchCart(cartId: number): Promise<ServiceCart>;
+    /**
+    * This method returns the list of cities in which the seller offers tours.
+    * 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[]>;
+    /**
+    * 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.
+    * @param {string} [cityName=undefined] The name of the selected city (as returned by {@link getTourCities})
+    * @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[]>;
+    /**
+    * 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.
+    * You should call this method only if {@link Service.isDateOptional} or {@link Service.isDateRequired} is true for the selected tour.
+    * @param {number} serviceId The id of the selected tour (can be retrieved in the object {@link Service} returned by {@link getTours})
+    * @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>;
+}