mts-booking-library 1.0.5 → 1.1.1

package/lib/index.js

@@ -1,417 +1,18 @@
 "use strict";
-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.Booking = void 0;
-var config_1 = require("./config");
-var apiCall_1 = require("./utils/apiCall");
-if (typeof localStorage === "undefined" || localStorage === null) {
-    var LocalStorage = require("node-localstorage").LocalStorage;
-    global.localStorage = new LocalStorage("./scratch");
-}
-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, access_token, sellerId) {
-        this.cartStatus = Booking.CartStatus.EMPTY;
-        this.sellerId = sellerId || undefined;
-        this.config = (0, config_1.setConfig)(env, sub_key, access_token);
-        this.onCartExpiration = onCartExpiration;
-        var cartId = localStorage.getItem("cartId");
-        if (cartId) {
-            this.fetchAndSetCart(parseInt(cartId));
-        }
-    }
-    /**
-     * 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, access_token);
-    };
-    Booking.prototype.getCartStatus = function () {
-        return this.cartStatus;
-    };
-    Booking.prototype.getCart = function () {
-        return this.cart;
-    };
-    Booking.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.cartStatus = cart.status;
-                        _this.createCartTimer(cartDate);
-                    }
-                });
-                return [2 /*return*/];
-            });
-        });
-    };
-    Booking.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.CartStatus.EMPTY;
-                    _this.cart = undefined;
-                    _this.onCartExpiration();
-                }, expiringDate.valueOf() - new Date().valueOf());
-                return [2 /*return*/];
-            });
-        });
-    };
-    Booking.prototype.getCartExpirationTimeInMs = function () {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                if (this.cart) {
-                    return [2 /*return*/, (new Date(this.cart.bookingDueDate).valueOf() - new Date().valueOf())];
-                }
-                else {
-                    throw Error("Cart is not initialized yet");
-                }
-                return [2 /*return*/];
-            });
-        });
-    };
-    // #region Tours config
-    /**
-    * 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
-    */
-    Booking.prototype.getTourCities = function () {
-        return __awaiter(this, void 0, void 0, function () {
-            var url;
-            return __generator(this, function (_a) {
-                url = "".concat(this.config.API_ENDPOINT, "/booking/tours/cities?").concat(new URLSearchParams(__assign({}, (this.sellerId && { sellerId: this.sellerId.toString() }))));
-                return [2 /*return*/, (0, apiCall_1.makeGet)(url)];
-            });
-        });
-    };
-    /**
-    * 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
-    */
-    Booking.prototype.getTours = function (currency, cityName) {
-        return __awaiter(this, void 0, void 0, function () {
-            var url;
-            return __generator(this, function (_a) {
-                url = "".concat(this.config.API_ENDPOINT, "/booking/tours?").concat(new URLSearchParams(__assign(__assign(__assign({}, (this.sellerId && { sellerId: this.sellerId.toString() })), (cityName && { cityName: cityName })), { currency: currency })));
-                return [2 /*return*/, (0, apiCall_1.makeGet)(url)];
-            });
-        });
-    };
-    /**
-    * 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 Tour.isDateOptional} or {@link Tour.isDateRequired} is true for the selected tour.
-    * @param {number} tourId The id of the selected tour (can be retrieved in the object {@link Tour} returned by {@link getTours})
-    * @param {Date} date The date on which to get the tours
-    * @returns {TourTrip[]} The returned information about the tour (tripId and hour)
-    */
-    Booking.prototype.getToursTrips = function (tourId, date) {
-        return __awaiter(this, void 0, void 0, function () {
-            var url;
-            return __generator(this, function (_a) {
-                url = "".concat(this.config.API_ENDPOINT, "/booking/tours/").concat(tourId, "/trips?").concat(new URLSearchParams(__assign(__assign({}, (this.sellerId && { sellerId: this.sellerId.toString() })), { date: date.toDateString() })));
-                return [2 /*return*/, (0, apiCall_1.makeGet)(url)];
-            });
-        });
-    };
-    Booking.prototype.createTourCart = function (tourCart) {
-        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/tours/cart");
-                return [2 /*return*/, (0, apiCall_1.makePost)(url, tourCart).then(function (cart) {
-                        _this.cart = cart.cart;
-                        _this.cartStatus = cart.cart.status;
-                        _this.createCartTimer(new Date(cart.cart.bookingDueDate));
-                        return cart.cart;
-                    })];
-            });
-        });
-    };
-    //#endregion
-    Booking.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/tours/cart/").concat(cartId);
-                return [2 /*return*/, (0, apiCall_1.makeGet)(url)];
-            });
-        });
-    };
-    //#region Journeys config
-    /**
-    * This method returns the possible departures for all journeys (MLP) sold by this seller.
-    * @returns {string[]} The list of possible departures
-    */
-    Booking.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
-    */
-    Booking.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 {Journey[]} The returned journeys that match the given parameters
-    */
-    Booking.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.toDateString(), roundTripDate: params.roundTripDate ? params.roundTripDate.toDateString() : "null", currency: params.currency, isRoundtrip: params.isRoundtrip.toString() })));
-                return [2 /*return*/, (0, apiCall_1.makeGet)(url)];
-            });
-        });
-    };
-    Booking.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;
-                    })];
-            });
-        });
-    };
-    Booking.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)];
-            });
-        });
-    };
-    Booking.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)];
-            });
-        });
-    };
-    Booking.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)];
-            });
-        });
-    };
-    //#endregion
-    //#region Subscriptions config
-    /**
-    * This method returns the possible departures for all subscriptions sold by this seller.
-    * @returns {string[]} The list of possible departures
-    */
-    Booking.prototype.getSubscriptionsDepartures = function () {
-        return __awaiter(this, void 0, void 0, function () {
-            var url;
-            return __generator(this, function (_a) {
-                url = "".concat(this.config.API_ENDPOINT, "/booking/subscriptions/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 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
-    */
-    Booking.prototype.getSubscrptionsDestinations = function (departureStopName) {
-        return __awaiter(this, void 0, void 0, function () {
-            var url;
-            return __generator(this, function (_a) {
-                url = "".concat(this.config.API_ENDPOINT, "/booking/subscriptions/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 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.
-    * @param {string} departureStopName The departure stop name (as returned by {@link getSubscriptionsDepartures})
-    * @param {string} destinationStopName The destination stop name (as returned by {@link getSubscriptionsDstinations})
-    * @returns {ValidityTypes[]} The list of possible validity types
-    */
-    Booking.prototype.getSubscrptionsValidityTypes = function (departureStopName, destinationStopName) {
-        return __awaiter(this, void 0, void 0, function () {
-            var url;
-            return __generator(this, function (_a) {
-                url = "".concat(this.config.API_ENDPOINT, "/booking/subscriptions/validityTypes?").concat(new URLSearchParams(__assign(__assign({}, (this.sellerId && { sellerId: this.sellerId.toString() })), { departureStopName: departureStopName, destinationStopName: destinationStopName })));
-                return [2 /*return*/, (0, apiCall_1.makeGet)(url)];
-            });
-        });
-    };
-    /**
-    * This method returns the subscriptions that match the given parameters.
-    * Note that it will always return the subscription for the one-way trip.
-    * If you want to get the subscription for the round trip, you have to call this method twice (make sure to swap departureStopName and destinationStopName)
-    * @param {string} departureStopName The departure stop name (as returned by {@link getSubscriptionsDepartures})
-    * @param {string} destinationStopName The destination stop name (as returned by {@link getSubscriptionsDstinations})
-    * @param {string} validityType The validity type (as returned by {@link getSubscriptionsValidityTypes})
-    * @returns {Array<Subscription>} The subscriptions that match the given parameters
-    */
-    Booking.prototype.getSubscrptions = function (departureStopName, destinationStopName, validityType) {
-        return __awaiter(this, void 0, void 0, function () {
-            var url;
-            return __generator(this, function (_a) {
-                url = "".concat(this.config.API_ENDPOINT, "/booking/subscriptions/search?").concat(new URLSearchParams(__assign(__assign({}, (this.sellerId && { sellerId: this.sellerId.toString() })), { departureStopName: departureStopName, destinationStopName: destinationStopName, validityType: validityType })));
-                return [2 /*return*/, (0, apiCall_1.makeGet)(url)];
-            });
-        });
-    };
-    Booking.prototype.getSubscrptionAvailabilities = function (departureStopName, destinationStopName, validityType) {
-        return __awaiter(this, void 0, void 0, function () {
-            var url;
-            return __generator(this, function (_a) {
-                url = "".concat(this.config.API_ENDPOINT, "/booking/subscriptions/search?").concat(new URLSearchParams(__assign(__assign({}, (this.sellerId && { sellerId: this.sellerId.toString() })), { departureStopName: departureStopName, destinationStopName: destinationStopName, validityType: validityType })));
-                return [2 /*return*/, (0, apiCall_1.makeGet)(url)];
-            });
-        });
-    };
-    //#endregion
-    Booking.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)];
-            });
-        });
-    };
-    Booking.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 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 = {}));
-})(Booking || (exports.Booking = Booking = {}));
+exports.DEFAULT_JOURNEY_SEARCH = exports.DEFAULT_PERSON = exports.SubscriptionBooking = exports.ServiceBooking = exports.JourneyBooking = void 0;
+//#region Export Booking classes
+var journeyBooking_1 = require("./booking/journeyBooking");
+Object.defineProperty(exports, "JourneyBooking", { enumerable: true, get: function () { return journeyBooking_1.JourneyBooking; } });
+var serviceBooking_1 = require("./booking/serviceBooking");
+Object.defineProperty(exports, "ServiceBooking", { enumerable: true, get: function () { return serviceBooking_1.ServiceBooking; } });
+var subscriptionBooking_1 = require("./booking/subscriptionBooking");
+Object.defineProperty(exports, "SubscriptionBooking", { enumerable: true, get: function () { return subscriptionBooking_1.SubscriptionBooking; } });
+//#endregion
+//#region Export common types
+// @note: Cart is not exported because it is extended by other types
+var Person_1 = require("./types/common/Person");
+Object.defineProperty(exports, "DEFAULT_PERSON", { enumerable: true, get: function () { return Person_1.DEFAULT_PERSON; } });
+var JourneySearch_1 = require("./types/journeys/JourneySearch");
+Object.defineProperty(exports, "DEFAULT_JOURNEY_SEARCH", { enumerable: true, get: function () { return JourneySearch_1.DEFAULT_JOURNEY_SEARCH; } });
+//#endregion

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

@@ -0,0 +1,47 @@
+import { Booking } from "../../booking/booking";
+import { Person } from "./Person";
+/**
+ * @description Cart is the object returned by the API when a cart is created.
+ * Note that depending on the type of booking, this type will be extended with different fields:
+ * - TourCart: {@link TourCart.ts}
+ * - JourneyCart: {@link JourneyCart.ts}
+ * - SubscriptionCart: {@link SubscriptionCart.ts}
+ * @property {number} id The id of the cart
+ * @property {string} cartCode The code of the cart
+ * @property {Booking.CartStatus} status The status of the cart. See {@link Booking.CartStatus}
+ * @property {Booking.CartStatus} nextStatus The next status of the cart. See {@link Booking.CartStatus}
+ * @property {Booking.Currencies} currency The currency of the cart. See {@link Booking.Currencies}
+ */
+export type Cart = {
+    id: number;
+    cartCode: string;
+    status: Booking.CartStatus;
+    nextStatus: Booking.CartStatus;
+    currency: Booking.Currencies;
+    bookingDueDate: string;
+    buyer: Person;
+    reductions: {
+        tripId: number;
+        tripName: string;
+        value: number;
+        isPercentage: boolean;
+        voucherCode?: string;
+    }[];
+    isSeatsSelectionAllowed: boolean;
+    sellingMethod: string;
+    totalValue: number;
+    totalResellerFee?: number;
+    totalCreditFromChange: number;
+    totalAmountToPay: number;
+    extas: {
+        id: number;
+        resourceId: number;
+        name: string;
+        description: string;
+        notes: string;
+        tariff: {
+            tariffId: number;
+            tariffName: string;
+        };
+    }[];
+};

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

@@ -0,0 +1,31 @@
+/**
+ * @description Represents a person, that can be a passenger or the buyer.
+ *
+ * @property {number} id - The unique identifier for the person.
+ * @property {string} name - The name of the person.
+ * @property {string} lastName - The last name of the person.
+ * @property {string} email - The email of the person.
+ * @property {string} phoneNumber - The phone number of the person.
+ */
+export type Person = {
+    id: number;
+    name: string;
+    lastName: string;
+    email: string;
+    phoneNumber: string;
+};
+export declare const DEFAULT_PERSON: Person;
+/**
+ * @description Represents the passengers details.
+ *
+ * @property {Person[]} passengers - An array of {@link Person} extended by the map `tripsToTariffs` objects representing the passengers.
+ * @property {Person} buyer - The {@link Person} object representing the buyer.
+ */
+export type PassengersDetails = {
+    passengers: Person[] & {
+        tripsToTariffs: {
+            [tripId: number]: number;
+        };
+    };
+    buyer: Person;
+};

package/lib/types/common/Person.js

@@ -0,0 +1,11 @@
+"use strict";
+// This module contains the types to manage the passengers information
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_PERSON = void 0;
+exports.DEFAULT_PERSON = {
+    id: 0,
+    name: '',
+    lastName: '',
+    email: '',
+    phoneNumber: ''
+};

package/lib/types/{TermsAndTariffs.d.ts → common/Tariffs.d.ts}

@@ -19,3 +19,8 @@ export type TermsType = {
     validationRulesString: string;
     bookingProcessDescription: string;
 };
+export type TariffSummary = {
+    quantity: number;
+    label: string;
+    value: number;
+};

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

@@ -0,0 +1,55 @@
+import { Booking } from "../../booking/booking";
+import { Cart } from "../common/Cart";
+import { TariffMatrix, TariffSummary } from "../common/Tariffs";
+import { Stop } from "./Stop";
+/**
+ * @description Object containing information about the selected journey, to be used when booking the journey.
+ *
+ * @property {number} tripId - The unique identifier for the trip.
+ * @property {number} departureStopId - The unique identifier for the departure stop.
+ * @property {number} destinationStopId - The unique identifier for the destination stop.
+ * @property {TariffMatrix} tariffsMatrix - The tariff matrix for pricing the outbound journey.
+ */
+export type JourneyBookingInfo = {
+    tripId: number;
+    departureStopId: number;
+    destinationStopId: number;
+    tariffsMatrix: TariffMatrix;
+};
+/**
+ * @description This is the object to be passed to `JourneyBooking.createJourneyCart`, containing information about the selected service.
+ *
+ * @property {number|undefined} [cartId=0] - The unique identifier for the cart (optional).
+ * @property {Booking.Currencies} currency - The currency in which the journey is priced.
+ * @property {JourneyBookingInfo[]} outboundJourney - Information about outbound journeys.
+ * @property {JourneyBookingInfo[]|null} returnJourney - Information about return journeys (optional, can be null).
+ */
+export type CreateJourneyCartRequest = {
+    cartId?: number;
+    currency: Booking.Currencies;
+    outboundJourney: JourneyBookingInfo[];
+    returnJourney: JourneyBookingInfo[] | null;
+};
+/**
+ * @description Represents a `JourneyCart`, which extends the {@link Cart} type by including additional
+ * information about the bookings
+ *
+ * @property {JourneyBookingType[]} bookings - An array of {@link JourneyBookingType} objects representing the bookings associated
+ * with this journey cart.
+ */
+export type JourneyCart = Cart & {
+    bookings: JourneyBookingType[];
+};
+/**
+ * @description Represents a `JourneyBooking`, which contains information about a journey booking.
+ *
+ * @property {Booking.BookingTypes} type - The type of booking.
+ * @property {TariffSummary[]} summary - An array of {@link TariffSummary} objects representing the tariff summary
+ * associated with this journey booking.
+ * @property {Stop[]} info - An array of {@link Stop} objects representing the stops associated with this journey booking.
+ */
+export type JourneyBookingType = {
+    type: Booking.BookingTypes;
+    summary: TariffSummary[];
+    info: Stop[];
+};

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

@@ -0,0 +1,18 @@
+/**
+ * @description Represents information about a journey.
+ *
+ * @property {string} sellerName - The name of the seller offering the journey.
+ * @property {string} minimumTotalPrice - The minimum total price for booking the journey, meaning the price if all passenger choose the cheapest tariff.
+ * @property {number} remainingSeats - The number of remaining seats for the journey.
+ * @property {number} totalNumberOfSeats - The total number of seats for the journey (including booked seats).
+ * @property {string} bookingProcessMessage - Optional message to be displayed to the user when booking this journey.
+ * @property {boolean} isBookable - Indicates whether the journey is bookable (true) or not (false).
+ */
+export type JourneyInfo = {
+    sellerName: string;
+    minimumTotalPrice: string;
+    remainingSeats: number;
+    totalNumberOfSeats: number;
+    bookingProcessMessage: string;
+    isBookable: boolean;
+};

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

@@ -0,0 +1,19 @@
+import { Booking } from "../../booking/booking";
+import { JourneyInfo } from "./JourneyInfo";
+import { Stop } from "./Stop";
+import { Trip } from "./Trip";
+export type JourneySearchRequest = {
+    departureStopName: string | undefined;
+    destinationStopName: string | undefined;
+    passengersNumber: number;
+    date: string;
+    roundTripDate: string | null;
+    currency: Booking.Currencies;
+    isRoundtrip: boolean;
+};
+export declare const DEFAULT_JOURNEY_SEARCH: JourneySearchRequest;
+export type JourneySearchResult = {
+    stops: Stop[];
+    info: JourneyInfo;
+    trips: Trip[];
+};

package/lib/types/{Journeys → journeys}/JourneySearch.js

@@ -1,13 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DefaultJourneySearch = void 0;
-var __1 = require("../..");
-exports.DefaultJourneySearch = {
+exports.DEFAULT_JOURNEY_SEARCH = void 0;
+var booking_1 = require("../../booking/booking");
+exports.DEFAULT_JOURNEY_SEARCH = {
     departureStopName: "",
     destinationStopName: "",
     passengersNumber: 1,
-    date: new Date(Date.UTC(new Date().getFullYear(), new Date().getMonth(), new Date().getDate(), 0, 1)),
+    date: new Date(Date.UTC(new Date().getFullYear(), new Date().getMonth(), new Date().getDate(), 0, 1))
+        .toISOString()
+        .slice(0, -1),
     roundTripDate: null,
-    currency: __1.Booking.Currencies.EUR,
+    currency: booking_1.Booking.Currencies.EUR,
     isRoundtrip: false,
 };