mts-booking-library 1.1.0 → 1.1.2

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/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/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>;
+}

package/lib/booking/serviceBooking.js

@@ -148,7 +148,7 @@ var ServiceBooking = /** @class */ (function (_super) {
         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 })));
+                url = "".concat(this.config.API_ENDPOINT, "/booking/services?").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)];
             });
         });

package/lib/booking/subscriptionBooking.d.ts

@@ -0,0 +1,50 @@
+import { MTSEnvs } from "../config";
+import { Cart } from "../types/common/Cart";
+import { Subscription } from "../types/subscriptions/Subscrptions";
+import { Booking } from "./booking";
+export declare class SubscriptionBooking extends Booking {
+    private cart?;
+    constructor(env: MTSEnvs, sub_key: string, onCartExpiration: () => void, debug?: boolean, access_token?: string, sellerId?: number);
+    getCart(): Cart | undefined;
+    private fetchAndSetCart;
+    private createCartTimer;
+    fetchCart(cartId: number): Promise<Cart>;
+    /**
+    * This method returns the possible departures for all subscriptions sold by this seller.
+    * @returns {string[]} The list of possible departures
+    */
+    getSubscriptionsDepartures(): Promise<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
+    */
+    getSubscrptionsDestinations(departureStopName: string): Promise<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.
+    * @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
+    */
+    getSubscrptionsValidityTypes(departureStopName: string, destinationStopName: string): Promise<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.
+    * 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
+    */
+    getSubscrptions(departureStopName: string, destinationStopName: string, validityType: string): Promise<Subscription[]>;
+    getSubscrptionAvailabilities(departureStopName: string, destinationStopName: string, validityType: string): Promise<Subscription[]>;
+}
+export declare namespace SubscriptionBooking {
+    enum ValidityTypes {
+        WORKING_WEEK = "WORKING_WEEK",
+        WEEKLY = "WEEKLY",
+        MONTHLY = "MONTHLY",
+        YEARLY = "YEARLY"
+    }
+}

package/lib/config.d.ts

@@ -8,6 +8,7 @@ export type MTSConfig = {
     API_ENDPOINT: string;
     OCP_SUBSCRIPTION_KEY: string;
     ACCESS_TOKEN: string | undefined;
+    DEBUG: boolean;
 };
-export declare const setConfig: (env: MTSEnvs, sub_key: string, access_token?: string) => MTSConfig;
+export declare const setConfig: (env: MTSEnvs, sub_key: string, debug: boolean, access_token?: string) => MTSConfig;
 export declare const getConfig: () => MTSConfig;

package/lib/index.d.ts

@@ -1,140 +1,15 @@
-import { MTSEnvs } from "./config";
-import { Cart, TourCart, JourneyCart } from "./types/Cart";
-import { Details } from "./types/Details";
-import { Tour, TourTrip } from "./types/Tours/Tour";
-import { JourneySearch } from "./types/Journeys/JourneySearch";
-import { Subscription } from "./types/Subscriptions/Subscrptions";
-import { ValidityTypes } from "./types/Subscriptions/ValidityTypes";
-import { Journey } from "./types/Journeys/Journey";
-export declare class Booking {
-    readonly sellerId?: number | undefined;
-    private readonly config;
-    private cart?;
-    private cartStatus;
-    private onCartExpiration;
-    /**
-    * 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, 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;
-    getCart(): Cart | undefined;
-    private fetchAndSetCart;
-    private createCartTimer;
-    getCartExpirationTimeInMs(): Promise<number>;
-    /**
-    * 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
-    */
-    getTourCities(): 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
-    */
-    getTours(currency: Booking.Currencies, cityName?: string): Promise<Tour[]>;
-    /**
-    * 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)
-    */
-    getToursTrips(tourId: number, date: Date): Promise<TourTrip[]>;
-    createTourCart(tourCart: TourCart): Promise<Cart>;
-    fetchCart(cartId: number): Promise<Cart>;
-    /**
-    * 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 {Journey[]} The returned journeys that match the given parameters
-    */
-    getJourneys(params: JourneySearch): Promise<Journey[]>;
-    createJourneyCart(tripCart: JourneyCart): Promise<Cart>;
-    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>;
-    /**
-    * This method returns the possible departures for all subscriptions sold by this seller.
-    * @returns {string[]} The list of possible departures
-    */
-    getSubscriptionsDepartures(): Promise<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
-    */
-    getSubscrptionsDestinations(departureStopName: string): Promise<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.
-    * @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
-    */
-    getSubscrptionsValidityTypes(departureStopName: string, destinationStopName: string): Promise<ValidityTypes[]>;
-    /**
-    * 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
-    */
-    getSubscrptions(departureStopName: string, destinationStopName: string, validityType: string): Promise<Subscription[]>;
-    getSubscrptionAvailabilities(departureStopName: string, destinationStopName: string, validityType: string): Promise<Subscription[]>;
-    getPassengersDetails(): Promise<any>;
-    updatePassengersDetails(passengersDetails: Details): Promise<any>;
-}
-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"
-    }
-}
+export { JourneyBooking } from "./booking/journeyBooking";
+export { ServiceBooking } from "./booking/serviceBooking";
+export { SubscriptionBooking } from "./booking/subscriptionBooking";
+export { Person, PassengersDetails, DEFAULT_PERSON } from "./types/common/Person";
+export { TariffMatrix, TariffSummary, TariffType, TermsType } from "./types/common/Tariffs";
+export { JourneyCart, JourneyBookingType, CreateJourneyCartRequest, JourneyBookingInfo } from "./types/journeys/JourneyCart";
+export { JourneyInfo } from "./types/journeys/JourneyInfo";
+export { JourneySearchRequest, JourneySearchResult, DEFAULT_JOURNEY_SEARCH } from "./types/journeys/JourneySearch";
+export { Stop } from "./types/journeys/Stop";
+export { Trip } from "./types/journeys/Trip";
+export { Line } from "./types/services/Line";
+export { Service, ServiceTrip } from "./types/services/Service";
+export { ServiceCart, ServiceBookingType, CreateServiceCartRequest } from "./types/services/ServiceCart";
+export { ServiceInfo } from "./types/services/ServiceInfo";
+export { Subscription } from "./types/subscriptions/Subscrptions";

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/{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/Stop.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @description Represents a stop in a journey.
+ *
+ * @property {number} id - The unique identifier for the stop.
+ * @property {Date} departureTime - The time when the journey departs from this stop.
+ * @property {Date} destinationTime - The time when the journey arrives at this stop.
+ * @property {string} name - The name of the stop.
+ * @property {string} address - The address of the stop.
+ */
+export type Stop = {
+    id: number;
+    departureTime: Date;
+    destinationTime: Date;
+    name: string;
+    address: string;
+};

package/lib/types/{Journeys → journeys}/Trip.d.ts

@@ -1,4 +1,4 @@
-import { TariffMatrix, TariffType, TermsType } from "../TermsAndTariffs";
+import { TariffMatrix, TariffType, TermsType } from "../common/Tariffs";
 export type Trip = {
     id: number;
     date: Date;

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

@@ -0,0 +1,14 @@
+/**
+ * @description Represents a line on which the service is sold.
+ *
+ * @property {number} id - The unique identifier for the line.
+ * @property {string} name - The name of the line.
+ * @property {string} linkavelDescription - A description of the line, to be used in {@link https://linkavel.com/} or in other ecommerses.
+ * @property {string} backofficeNotes - Additional notes or information about the line for internal use.
+ */
+export type Line = {
+    id: number;
+    name: string;
+    linkavelDescription: string;
+    backofficeNotes: string;
+};

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

@@ -0,0 +1,33 @@
+import { TariffMatrix, TariffType, TermsType } from "../common/Tariffs";
+import { Line } from "./Line";
+import { ServiceInfo } from "./ServiceInfo";
+/**
+ * @description Represents a service offering, including information about the service, tariffs,
+ * terms, and other details.
+ *
+ * @property {number} id - The unique identifier for the service.
+ * @property {Line} line - Information about the line or route associated with the service.
+ * @property {ServiceInfo} info - Information about the service itself.
+ * @property {TariffMatrix} tariffsMatrix - The tariff matrix for pricing.
+ * @property {TariffType[]} tariffTypes - An array of tariff types available for the service.
+ * @property {TermsType[]} termsTypes - An array of terms types related to the service.
+ * @property {boolean} isDateOptional - Indicates whether a date can be optionally specified for this service.
+ * @property {boolean} isDateRequired - Indicates whether specifying a date is required for booking.
+ * @property {boolean} isTripMandatory - Indicates whether the selection of the trip in the selected date is mandatory.
+ */
+export type Service = {
+    id: number;
+    line: Line;
+    info: ServiceInfo;
+    tariffsMatrix: TariffMatrix;
+    tariffTypes: TariffType[];
+    termsTypes: TermsType[];
+    isDateOptional: boolean;
+    isDateRequired: boolean;
+    isTripMandatory: boolean;
+};
+export type ServiceTrip = {
+    tripId?: number;
+    date: Date;
+    name: string;
+};

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

@@ -0,0 +1,46 @@
+import { Booking } from "../../booking/booking";
+import { Cart } from "../common/Cart";
+import { TariffMatrix, TariffSummary } from "../common/Tariffs";
+import { ServiceTrip } from "./Service";
+/**
+ * @description This is the object to be passed to `ServiceBooking.createServiceCart`, containing information about the selected service.
+ *
+ * @property {Booking.Currencies} currency - The currency in which the service is priced.
+ * @property {Object} service - Information about the selected service.
+ * @property {number} service.serviceId - The unique identifier for the service.
+ * @property {TariffMatrix} service.tariffsMatrix - The tariff matrix for pricing the service.
+ * @property {Date|undefined} [service.date] - The date for the service (optional).
+ * @property {number|undefined} [service.tripId] - The unique identifier for the trip (optional).
+ */
+export type CreateServiceCartRequest = {
+    currency: Booking.Currencies;
+    service: {
+        serviceId: number;
+        tariffsMatrix: TariffMatrix;
+        date?: Date;
+        tripId?: number;
+    };
+};
+/**
+ * @description Represents a `JourneyCart`, which extends the {@link Cart} type by including additional
+ * information about the bookings
+ *
+ * @property {ServiceBooking[]} bookings - An array of {@link ServiceBookingType} objects representing the bookings associated
+ * with this journey cart.
+ */
+export type ServiceCart = Cart & {
+    bookings: ServiceBookingType[];
+};
+/**
+ * @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 {ServiceTrip} info - An array of {@link ServiceTrip} objects representing the stops associated with this journey booking.
+ */
+export type ServiceBookingType = {
+    type: Booking.BookingTypes;
+    summary: TariffSummary[];
+    info: ServiceTrip;
+};

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

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

package/package.json

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

package/lib/types/Booking.js

@@ -1 +0,0 @@
-"use strict";

package/lib/types/Cart.d.ts

@@ -1,79 +0,0 @@
-import { Booking } from "..";
-import { Person } from "./Person";
-import { TariffMatrix } from "./TermsAndTariffs";
-export type Cart = {
-    id: number;
-    cartCode: string;
-    status: Booking.CartStatus;
-    nextStatus: Booking.CartStatus;
-    currency: string;
-    bookingDueDate: string;
-    bookings: {
-        type: string;
-        summary: {
-            quantity: number;
-            label: string;
-            value: number;
-        }[];
-    }[];
-    info: {
-        stops: {
-            id: number;
-            departureTime: Date;
-            destinationTime: Date;
-            name: string;
-            address: 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;
-        };
-    }[];
-};
-export type TourCart = {
-    cartId?: number;
-    currency: Booking.Currencies;
-    tour: {
-        tourId: number;
-        date?: Date;
-        tripId?: number;
-        tariffsMatrix: TariffMatrix;
-    };
-};
-export type JourneyCart = {
-    cartId?: number;
-    currency: Booking.Currencies;
-    outboundJourney: {
-        departureStopId: number;
-        destinationStopId: number;
-        tripId: number;
-        tariffsMatrix: TariffMatrix;
-    }[];
-    returnJourney: {
-        tripId: number;
-        departureStopId: number;
-        destinationStopId: number;
-        tariffsMatrix: TariffMatrix;
-    }[] | null;
-};

package/lib/types/Cart.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/lib/types/Details.d.ts

@@ -1,9 +0,0 @@
-import { Person } from "./Person";
-export type Details = {
-    passengers: Person[] & {
-        tripsToTariffs: {
-            [tripId: number]: number;
-        };
-    };
-    buyer: Person;
-};

package/lib/types/Details.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/lib/types/Info.d.ts

@@ -1,8 +0,0 @@
-export type Info = {
-    sellerName: string;
-    minimumTotalPrice: string;
-    remainingSeats?: number;
-    totalNumberOfSeats?: number;
-    bookingProcessMessage: string;
-    isBookable: boolean;
-};

package/lib/types/Info.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/lib/types/Journey.d.ts

@@ -1,8 +0,0 @@
-import { Info } from "./Info";
-import { Stop } from "./Stop";
-import { Trip } from "./Trip";
-export type Journey = {
-    stops: Stop[];
-    info: Info;
-    trips: Trip[];
-};

package/lib/types/Journey.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/lib/types/JourneySearch.d.ts

@@ -1,9 +0,0 @@
-import { Booking } from "..";
-export type JourneySearch = {
-    departureStopName: string;
-    destinationStopName: string;
-    passengersNumber: number;
-    date: Date;
-    currency: Booking.Currencies;
-    isRoundtrip: boolean;
-};

package/lib/types/JourneySearch.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/lib/types/Journeys/BusMatrix.js

@@ -1 +0,0 @@
-"use strict";

package/lib/types/Journeys/Journey.d.ts

@@ -1,8 +0,0 @@
-import { Stop } from "./Stop";
-import { Info } from "../Info";
-import { Trip } from "./Trip";
-export type Journey = {
-    stops: Stop[];
-    info: Info;
-    trips: Trip[];
-};

package/lib/types/Journeys/Journey.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -1,11 +0,0 @@
-import { Booking } from "../..";
-export type JourneySearch = {
-    departureStopName: string | undefined;
-    destinationStopName: string | undefined;
-    passengersNumber: number;
-    date: Date;
-    roundTripDate: Date | null;
-    currency: Booking.Currencies;
-    isRoundtrip: boolean;
-};
-export declare const DefaultJourneySearch: JourneySearch;

package/lib/types/Journeys/Stop.d.ts

@@ -1,7 +0,0 @@
-export type Stop = {
-    id: number;
-    departureTime: Date;
-    destinationTime: Date;
-    name: string;
-    address: string;
-};

package/lib/types/Line.d.ts

@@ -1,6 +0,0 @@
-export type Line = {
-    id: number;
-    name: string;
-    linkavelDescription: string;
-    backofficeNotes: string;
-};

package/lib/types/Line.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/lib/types/Person.d.ts

@@ -1,7 +0,0 @@
-export type Person = {
-    id: number;
-    name: string;
-    lastName: string;
-    email: string;
-    phoneNumber: string;
-};

package/lib/types/Person.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/lib/types/Stop.d.ts

@@ -1,7 +0,0 @@
-export type Stop = {
-    id: number;
-    departureTime: Date;
-    destinationTime: Date;
-    name: string;
-    address: string;
-};

package/lib/types/Stop.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/lib/types/Subscriptions/ValidityTypes.d.ts

@@ -1,6 +0,0 @@
-export declare enum ValidityTypes {
-    WORKING_WEEK = "WORKING_WEEK",
-    WEEKLY = "WEEKLY",
-    MONTHLY = "MONTHLY",
-    YEARLY = "YEARLY"
-}

package/lib/types/Subscriptions/ValidityTypes.js

@@ -1,10 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ValidityTypes = void 0;
-var ValidityTypes;
-(function (ValidityTypes) {
-    ValidityTypes["WORKING_WEEK"] = "WORKING_WEEK";
-    ValidityTypes["WEEKLY"] = "WEEKLY";
-    ValidityTypes["MONTHLY"] = "MONTHLY";
-    ValidityTypes["YEARLY"] = "YEARLY";
-})(ValidityTypes || (exports.ValidityTypes = ValidityTypes = {}));

package/lib/types/TermsAndTariffs.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/lib/types/Tour.d.ts

@@ -1,18 +0,0 @@
-import { Info } from "./Info";
-import { Line } from "./Line";
-import { TariffMatrix, TariffType, TermsType } from "./TermsAndTariffs";
-export type Tour = {
-    id: number;
-    line: Line;
-    info: Info;
-    tariffsMatrix: TariffMatrix;
-    tariffTypes: TariffType[];
-    termsTypes: TermsType[];
-    isDateOptional: boolean;
-    isDateRequired: boolean;
-    isTripMandatory: boolean;
-};
-export type TourTrip = {
-    tripId: number;
-    hour: Date;
-};

package/lib/types/Tour.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/lib/types/Tours/Tour.d.ts

@@ -1,18 +0,0 @@
-import { Info } from "../Info";
-import { Line } from "../Line";
-import { TariffMatrix, TariffType, TermsType } from "../TermsAndTariffs";
-export type Tour = {
-    id: number;
-    line: Line;
-    info: Info;
-    tariffsMatrix: TariffMatrix;
-    tariffTypes: TariffType[];
-    termsTypes: TermsType[];
-    isDateOptional: boolean;
-    isDateRequired: boolean;
-    isTripMandatory: boolean;
-};
-export type TourTrip = {
-    tripId: number;
-    hour: Date;
-};

package/lib/types/Tours/Tour.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/lib/types/Tours.js

@@ -1 +0,0 @@
-"use strict";

package/lib/types/Trip.d.ts

@@ -1,9 +0,0 @@
-import { TariffMatrix, TariffType, TermsType } from "./TermsAndTariffs";
-export type Trip = {
-    id: number;
-    departureStopName: string;
-    destinationStopName: string;
-    tariffsMatrix: TariffMatrix;
-    tariffTypes: TariffType[];
-    termsTypes: TermsType[];
-};

package/lib/types/Trip.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/lib/types/TripSearch.d.ts

@@ -1,9 +0,0 @@
-import { Booking } from "..";
-export type TripSearch = {
-    departureStopName: string;
-    destinationStopName: string;
-    passengersNumber: number;
-    date: Date;
-    currency: Booking.Currencies;
-    isRoundtrip: boolean;
-};

package/lib/types/TripSearch.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });