mts-booking-library 1.3.14 → 1.3.16

package/lib/booking/journeyBooking.d.ts

@@ -1,5 +1,5 @@
 import { ErrorResponse } from "../types/ErrorResponse";
-import { EditPassengersDetailsRequest, GetBuyerPassengersDetailsResponse, Person } from "../types/common/Person";
+import { Buyer, EditPassengersDetailsRequest, GetBuyerPassengersDetailsResponse } from "../types/common/Person";
 import { AddReductionRequest } from "../types/common/Reduction";
 import { BusMatrix } from "../types/journeys/BusMatrix";
 import { CreateJourneyCartRequest, JourneyCart } from "../types/journeys/JourneyCart";
@@ -96,13 +96,12 @@ export declare class JourneyBooking extends Booking {
     getBuyerPassengersDetails(): Promise<ErrorResponse | GetBuyerPassengersDetailsResponse>;
     /**
      * @description This method shall be called when the user wants to retrieve information about an esisting buyer.
-     * @param {string} [linkavelCard=undefined] The linkavel card number of the buyer. This parameter is required if phoneNumber is not set.
-     * A linkavelCard number is a string of 9 digits.
-     * @param {string} [phoneNumber=undefined] The phone number of the buyer. This parameter is required if linkavelCard is not set.
+     * @param linkavelCard The linkavel card number of the buyer. This parameter is required if phoneNumber is not set.
+     * @param phoneNumber The phone number of the buyer. This parameter is required if linkavelCard is not set.
      * @returns An object of type {@link GetBuyerPassengersDetailsResponse} containing the buyer and the passengers information,
      * as well as a list of the available tariffs for each trip.
      */
-    getBuyerFromLinkavelCard(linkavelCard?: string, phoneNumber?: string): Promise<ErrorResponse | Person>;
+    getBuyerFromLinkavelCard(linkavelCard?: string, phoneNumber?: string): Promise<ErrorResponse | Buyer>;
     /**
      * @description This methosd shall be called when the user wants to update the buyer and the passengers information.
      * @param {EditPassengersDetailsRequest} passengersDetails The object containing the buyer and the passengers information.

package/lib/booking/journeyBooking.js

@@ -349,9 +349,8 @@ var JourneyBooking = /** @class */ (function (_super) {
     };
     /**
      * @description This method shall be called when the user wants to retrieve information about an esisting buyer.
-     * @param {string} [linkavelCard=undefined] The linkavel card number of the buyer. This parameter is required if phoneNumber is not set.
-     * A linkavelCard number is a string of 9 digits.
-     * @param {string} [phoneNumber=undefined] The phone number of the buyer. This parameter is required if linkavelCard is not set.
+     * @param linkavelCard The linkavel card number of the buyer. This parameter is required if phoneNumber is not set.
+     * @param phoneNumber The phone number of the buyer. This parameter is required if linkavelCard is not set.
      * @returns An object of type {@link GetBuyerPassengersDetailsResponse} containing the buyer and the passengers information,
      * as well as a list of the available tariffs for each trip.
      */

package/lib/booking/serviceBooking.d.ts

@@ -1,5 +1,5 @@
 import { ErrorResponse } from "../types/ErrorResponse";
-import { GetBuyerPassengersDetailsResponse, Person } from "../types/common/Person";
+import { Buyer, GetBuyerPassengersDetailsResponse } from "../types/common/Person";
 import { AddReductionRequest } from "../types/common/Reduction";
 import { Service, ServiceTripsResponse } from "../types/services/Service";
 import { CreateServiceCartRequest, ServiceCart } from "../types/services/ServiceCart";
@@ -98,20 +98,19 @@ export declare class ServiceBooking extends Booking {
     getBuyerPassengersDetails(): Promise<ErrorResponse | GetBuyerPassengersDetailsResponse>;
     /**
      * @description This method shall be called when the user wants to retrieve information about an esisting buyer.
-     * @param {string} [linkavelCardNumber=undefined] The linkavel card number of the buyer. This parameter is required if linkavelCardPhoneNumber is not set.
-     * A linkavelCardNumber is a string of 9 digits.
-     * @param {string} [linkavelCardPhoneNumber=undefined] The linkavel card phone number of the buyer. This parameter is required if linkavelCardNumber is not set.
+     * @param linkavelCard The linkavel card number of the buyer. This parameter is required if linkavelCardPhoneNumber is not set.
+     * @param phoneNumber The phone number of the buyer. This parameter is required if linkavelCard is not set.
      * @returns An object of type {@link GetBuyerPassengersDetailsResponse} containing the buyer and the passengers information,
      * as well as a list of the available tariffs for each trip.
      */
-    getBuyerFromLinkavelCard(linkavelCardNumber?: string, linkavelCardPhoneNumber?: string): Promise<ErrorResponse | Person>;
+    getBuyerFromLinkavelCard(linkavelCard?: string, phoneNumber?: string): Promise<ErrorResponse | Buyer>;
     /**
      * @description This method shall be called when the user wants to update the buyer information.
-     * @param {Person | null} buyerDetails The object containing the buyer information.
+     * @param buyerDetails The object containing the buyer information.
      * It should be null if the buyer data cannot be specified (see {@link GetBuyerPassengersDetailsResponse.buyerDataStatus}).
      * @returns An {@link ErrorResponse} object in case of error, true otherwise.
      */
-    updateBuyerPassengersDetails(buyerDetails: Person | null): Promise<ErrorResponse | boolean>;
+    updateBuyerPassengersDetails(buyerDetails: Buyer | null): Promise<ErrorResponse | boolean>;
     /**
      * @description This method allows to add a reduction to the whole cart or to a single trip in the cart.
      * @param {AddReductionRequest} request The information about the reduction to add

package/lib/booking/serviceBooking.js

@@ -329,13 +329,12 @@ var ServiceBooking = /** @class */ (function (_super) {
     };
     /**
      * @description This method shall be called when the user wants to retrieve information about an esisting buyer.
-     * @param {string} [linkavelCardNumber=undefined] The linkavel card number of the buyer. This parameter is required if linkavelCardPhoneNumber is not set.
-     * A linkavelCardNumber is a string of 9 digits.
-     * @param {string} [linkavelCardPhoneNumber=undefined] The linkavel card phone number of the buyer. This parameter is required if linkavelCardNumber is not set.
+     * @param linkavelCard The linkavel card number of the buyer. This parameter is required if linkavelCardPhoneNumber is not set.
+     * @param phoneNumber The phone number of the buyer. This parameter is required if linkavelCard is not set.
      * @returns An object of type {@link GetBuyerPassengersDetailsResponse} containing the buyer and the passengers information,
      * as well as a list of the available tariffs for each trip.
      */
-    ServiceBooking.prototype.getBuyerFromLinkavelCard = function (linkavelCardNumber, linkavelCardPhoneNumber) {
+    ServiceBooking.prototype.getBuyerFromLinkavelCard = function (linkavelCard, phoneNumber) {
         return __awaiter(this, void 0, void 0, function () {
             var buyerPassengersDetails, searchParams, url;
             return __generator(this, function (_a) {
@@ -347,10 +346,10 @@ var ServiceBooking = /** @class */ (function (_super) {
                 if (!buyerPassengersDetails || !buyerPassengersDetails[0]) {
                     throw Error("The status of the cart does not allow to call this API");
                 }
-                if (!linkavelCardNumber && !linkavelCardPhoneNumber) {
+                if (!linkavelCard && !phoneNumber) {
                     throw Error("At least one of the parameters linkavelCardNumber and linkavelCardPhoneNumber must be set");
                 }
-                searchParams = new URLSearchParams(__assign(__assign({}, (linkavelCardNumber && { linkavelCardNumber: linkavelCardNumber })), (linkavelCardPhoneNumber && { linkavelCardPhoneNumber: linkavelCardPhoneNumber })));
+                searchParams = new URLSearchParams(__assign(__assign({}, (linkavelCard && { linkavelCard: linkavelCard })), (phoneNumber && { phoneNumber: phoneNumber })));
                 url = "".concat(this.config.API_ENDPOINT, "/v3_resources/buyers?").concat(searchParams);
                 return [2 /*return*/, this.callGetApi(url).then(function (response) {
                         // Check for errors
@@ -364,7 +363,7 @@ var ServiceBooking = /** @class */ (function (_super) {
     };
     /**
      * @description This method shall be called when the user wants to update the buyer information.
-     * @param {Person | null} buyerDetails The object containing the buyer information.
+     * @param buyerDetails The object containing the buyer information.
      * It should be null if the buyer data cannot be specified (see {@link GetBuyerPassengersDetailsResponse.buyerDataStatus}).
      * @returns An {@link ErrorResponse} object in case of error, true otherwise.
      */

package/lib/booking/subscriptionBooking.d.ts

@@ -1,5 +1,5 @@
 import { ErrorResponse } from "../types/ErrorResponse";
-import { EditPassengersDetailsRequest, GetBuyerPassengersDetailsResponse, Person } from "../types/common/Person";
+import { Buyer, EditPassengersDetailsRequest, GetBuyerPassengersDetailsResponse } from "../types/common/Person";
 import { AddReductionRequest } from "../types/common/Reduction";
 import { GetSubscriptionAvailabilityRequest, GetSubscriptionAvailabilityResponse } from "../types/subscriptions/SubscriptionAvailabilities";
 import { CreateSubscriptionCartRequest, SubscriptionCart } from "../types/subscriptions/SubscriptionCart";
@@ -117,13 +117,12 @@ export declare class SubscriptionBooking extends Booking {
     getBuyerPassengersDetails(): Promise<ErrorResponse | GetBuyerPassengersDetailsResponse>;
     /**
      * @description This method shall be called when the user wants to retrieve information about an esisting buyer.
-     * @param {string} [linkavelCardNumber=undefined] The linkavel card number of the buyer. This parameter is required if linkavelCardPhoneNumber is not set.
-     * A linkavelCardNumber is a string of 9 digits.
-     * @param {string} [linkavelCardPhoneNumber=undefined] The linkavel card phone number of the buyer. This parameter is required if linkavelCardNumber is not set.
+     * @param linkavelCard The linkavel card number of the buyer. This parameter is required if linkavelCardPhoneNumber is not set.
+     * @param phoneNumber The phone number of the buyer. This parameter is required if linkavelCard is not set.
      * @returns An object of type {@link GetBuyerPassengersDetailsResponse} containing the buyer and the passengers information,
      * as well as a list of the available tariffs for each trip.
      */
-    getBuyerFromLinkavelCard(linkavelCardNumber?: string, linkavelCardPhoneNumber?: string): Promise<ErrorResponse | Person>;
+    getBuyerFromLinkavelCard(linkavelCard?: string, phoneNumber?: string): Promise<ErrorResponse | Buyer>;
     /**
      * @description This methosd shall be called when the user wants to update the buyer and the passengers information.
      * @param {EditPassengersDetailsRequest} passengersDetails The object containing the buyer and the passengers information.

package/lib/booking/subscriptionBooking.js

@@ -408,13 +408,12 @@ var SubscriptionBooking = /** @class */ (function (_super) {
     };
     /**
      * @description This method shall be called when the user wants to retrieve information about an esisting buyer.
-     * @param {string} [linkavelCardNumber=undefined] The linkavel card number of the buyer. This parameter is required if linkavelCardPhoneNumber is not set.
-     * A linkavelCardNumber is a string of 9 digits.
-     * @param {string} [linkavelCardPhoneNumber=undefined] The linkavel card phone number of the buyer. This parameter is required if linkavelCardNumber is not set.
+     * @param linkavelCard The linkavel card number of the buyer. This parameter is required if linkavelCardPhoneNumber is not set.
+     * @param phoneNumber The phone number of the buyer. This parameter is required if linkavelCard is not set.
      * @returns An object of type {@link GetBuyerPassengersDetailsResponse} containing the buyer and the passengers information,
      * as well as a list of the available tariffs for each trip.
      */
-    SubscriptionBooking.prototype.getBuyerFromLinkavelCard = function (linkavelCardNumber, linkavelCardPhoneNumber) {
+    SubscriptionBooking.prototype.getBuyerFromLinkavelCard = function (linkavelCard, phoneNumber) {
         return __awaiter(this, void 0, void 0, function () {
             var buyerPassengersDetails, searchParams, url;
             return __generator(this, function (_a) {
@@ -426,10 +425,10 @@ var SubscriptionBooking = /** @class */ (function (_super) {
                 if (!buyerPassengersDetails || !buyerPassengersDetails[0]) {
                     throw Error("The status of the cart does not allow to call this API");
                 }
-                if (!linkavelCardNumber && !linkavelCardPhoneNumber) {
+                if (!linkavelCard && !phoneNumber) {
                     throw Error("At least one of the parameters linkavelCardNumber and linkavelCardPhoneNumber must be set");
                 }
-                searchParams = new URLSearchParams(__assign(__assign({}, (linkavelCardNumber && { linkavelCardNumber: linkavelCardNumber })), (linkavelCardPhoneNumber && { linkavelCardPhoneNumber: linkavelCardPhoneNumber })));
+                searchParams = new URLSearchParams(__assign(__assign({}, (linkavelCard && { linkavelCard: linkavelCard })), (phoneNumber && { phoneNumber: phoneNumber })));
                 url = "".concat(this.config.API_ENDPOINT, "/v3_resources/buyers?").concat(searchParams);
                 return [2 /*return*/, this.callGetApi(url).then(function (response) {
                         // Check for errors

package/lib/booking/tplBooking.d.ts

@@ -1,6 +1,6 @@
 import { ErrorResponse } from "../types/ErrorResponse";
 import { City } from "../types/common/City";
-import { GetBuyerPassengersDetailsResponse, Person } from "../types/common/Person";
+import { Buyer, GetBuyerPassengersDetailsResponse } from "../types/common/Person";
 import { AddReductionRequest } from "../types/common/Reduction";
 import { TariffType, TermsType } from "../types/common/Tariffs";
 import { GetTariffsResponse } from "../types/tpl/GetTariffsResponse";
@@ -103,11 +103,13 @@ export declare class TplBooking extends Booking {
     getTariffs(superAreaId: number, termsTypeId: number | null, onlyTickets: boolean, onlySubscriptions: boolean): Promise<ErrorResponse | GetTariffsResponse>;
     /**
      * This method allows to create a TPL cart.
-     * @param {Map<number, number>} tariffIdToQuantity A map that associates a tariff id (the one chosen by the user) to the number of tickets to buy for that tariff.
-     * @param {Booking.Currencies} currency The currency in which the ticket is priced.
-     * @param {string} [startDate] The start date of the ticket. This is optional and should be used only for subscriptions.
+     * @param tariffIdToQuantity A map that associates a tariff id (the one chosen by the user) to the number of tickets to buy for that tariff.
+     * @param currency The currency in which the ticket is priced.
+     * @param startDate The start date of the ticket. This is optional and should be used only for subscriptions.
+     * @param isCurrentPeriod Whether the subscription is for the current period. This is optional and should be used only for subscriptions.
+     * @param renewSubscriptionTicketPNR The PNR of the subscription ticket to renew. This is optional and should be used only for subscriptions.
      */
-    createTplCart(tariffIdToQuantity: Map<number, number>, currency: Booking.Currencies, startDate?: string): Promise<ErrorResponse | TplCart>;
+    createTplCart(tariffIdToQuantity: Map<number, number>, currency: Booking.Currencies, startDate?: string, isCurrentPeriod?: boolean, renewSubscriptionTicketPNR?: string): Promise<ErrorResponse | TplCart>;
     /**
      * @description This method shall be called when the user wants to retrieve information about the buyer and the passengers.
      * @returns An object of type {@link GetBuyerPassengersDetailsResponse} containing the buyer and the passengers information,
@@ -116,20 +118,19 @@ export declare class TplBooking extends Booking {
     getBuyerPassengersDetails(): Promise<ErrorResponse | GetBuyerPassengersDetailsResponse>;
     /**
      * @description This method shall be called when the user wants to retrieve information about an esisting buyer.
-     * @param {string} [linkavelCardNumber=undefined] The linkavel card number of the buyer. This parameter is required if linkavelCardPhoneNumber is not set.
-     * A linkavelCardNumber is a string of 9 digits.
-     * @param {string} [linkavelCardPhoneNumber=undefined] The linkavel card phone number of the buyer. This parameter is required if linkavelCardNumber is not set.
+     * @param linkavelCard The linkavel card number of the buyer. This parameter is required if linkavelCardPhoneNumber is not set.
+     * @param phoneNumber The phone number of the buyer. This parameter is required if linkavelCard is not set.
      * @returns An object of type {@link GetBuyerPassengersDetailsResponse} containing the buyer and the passengers information,
      * as well as a list of the available tariffs for each trip.
      */
-    getBuyerFromLinkavelCard(linkavelCardNumber?: string, linkavelCardPhoneNumber?: string): Promise<ErrorResponse | Person>;
+    getBuyerFromLinkavelCard(linkavelCard?: string, phoneNumber?: string): Promise<ErrorResponse | Buyer>;
     /**
      * @description This method shall be called when the user wants to update the buyer information.
-     * @param {Person | null} buyerDetails The object containing the buyer information.
+     * @param buyerDetails The object containing the buyer information.
      * It should be null if the buyer data cannot be specified (see {@link GetBuyerPassengersDetailsResponse.buyerDataStatus}).
      * @returns An {@link ErrorResponse} object in case of error, true otherwise.
      */
-    updateBuyerPassengersDetails(buyerDetails: Person | null): Promise<ErrorResponse | boolean>;
+    updateBuyerPassengersDetails(buyerDetails: Buyer | null): Promise<ErrorResponse | boolean>;
     /**
      * @description This method allows to add a reduction to the whole cart or to a single trip in the cart.
      * @param {AddReductionRequest} request The information about the reduction to add

package/lib/booking/tplBooking.js

@@ -313,11 +313,13 @@ var TplBooking = /** @class */ (function (_super) {
     };
     /**
      * This method allows to create a TPL cart.
-     * @param {Map<number, number>} tariffIdToQuantity A map that associates a tariff id (the one chosen by the user) to the number of tickets to buy for that tariff.
-     * @param {Booking.Currencies} currency The currency in which the ticket is priced.
-     * @param {string} [startDate] The start date of the ticket. This is optional and should be used only for subscriptions.
+     * @param tariffIdToQuantity A map that associates a tariff id (the one chosen by the user) to the number of tickets to buy for that tariff.
+     * @param currency The currency in which the ticket is priced.
+     * @param startDate The start date of the ticket. This is optional and should be used only for subscriptions.
+     * @param isCurrentPeriod Whether the subscription is for the current period. This is optional and should be used only for subscriptions.
+     * @param renewSubscriptionTicketPNR The PNR of the subscription ticket to renew. This is optional and should be used only for subscriptions.
      */
-    TplBooking.prototype.createTplCart = function (tariffIdToQuantity, currency, startDate) {
+    TplBooking.prototype.createTplCart = function (tariffIdToQuantity, currency, startDate, isCurrentPeriod, renewSubscriptionTicketPNR) {
         return __awaiter(this, void 0, void 0, function () {
             var url, processedTariffIdToQuantity, request;
             var _this = this;
@@ -327,7 +329,7 @@ var TplBooking = /** @class */ (function (_super) {
                 tariffIdToQuantity.forEach(function (value, key) {
                     processedTariffIdToQuantity[key] = value;
                 });
-                request = __assign({ tariffIdToQuantity: processedTariffIdToQuantity, currency: currency }, (startDate && { startDate: startDate }));
+                request = __assign(__assign(__assign({ tariffIdToQuantity: processedTariffIdToQuantity, currency: currency }, (startDate !== undefined && { startDate: startDate })), (isCurrentPeriod !== undefined && { isCurrentPeriod: isCurrentPeriod })), (renewSubscriptionTicketPNR !== undefined && { renewSubscriptionTicketPNR: renewSubscriptionTicketPNR }));
                 // Call the API
                 return [2 /*return*/, this.callPostApi(url, request).then(function (response) {
                         // Check for errors
@@ -379,7 +381,7 @@ var TplBooking = /** @class */ (function (_super) {
                         return {
                             buyerDataStatus: response.buyerDataStatus,
                             buyer: response.buyer,
-                            passengers: []
+                            passengers: null
                         };
                     })];
             });
@@ -387,13 +389,12 @@ var TplBooking = /** @class */ (function (_super) {
     };
     /**
      * @description This method shall be called when the user wants to retrieve information about an esisting buyer.
-     * @param {string} [linkavelCardNumber=undefined] The linkavel card number of the buyer. This parameter is required if linkavelCardPhoneNumber is not set.
-     * A linkavelCardNumber is a string of 9 digits.
-     * @param {string} [linkavelCardPhoneNumber=undefined] The linkavel card phone number of the buyer. This parameter is required if linkavelCardNumber is not set.
+     * @param linkavelCard The linkavel card number of the buyer. This parameter is required if linkavelCardPhoneNumber is not set.
+     * @param phoneNumber The phone number of the buyer. This parameter is required if linkavelCard is not set.
      * @returns An object of type {@link GetBuyerPassengersDetailsResponse} containing the buyer and the passengers information,
      * as well as a list of the available tariffs for each trip.
      */
-    TplBooking.prototype.getBuyerFromLinkavelCard = function (linkavelCardNumber, linkavelCardPhoneNumber) {
+    TplBooking.prototype.getBuyerFromLinkavelCard = function (linkavelCard, phoneNumber) {
         return __awaiter(this, void 0, void 0, function () {
             var buyerPassengersDetails, searchParams, url;
             return __generator(this, function (_a) {
@@ -405,10 +406,10 @@ var TplBooking = /** @class */ (function (_super) {
                 if (!buyerPassengersDetails || !buyerPassengersDetails[0]) {
                     throw Error("The status of the cart does not allow to call this API");
                 }
-                if (!linkavelCardNumber && !linkavelCardPhoneNumber) {
+                if (!linkavelCard && !phoneNumber) {
                     throw Error("At least one of the parameters linkavelCardNumber and linkavelCardPhoneNumber must be set");
                 }
-                searchParams = new URLSearchParams(__assign(__assign({}, (linkavelCardNumber && { linkavelCardNumber: linkavelCardNumber })), (linkavelCardPhoneNumber && { linkavelCardPhoneNumber: linkavelCardPhoneNumber })));
+                searchParams = new URLSearchParams(__assign(__assign({}, (linkavelCard && { linkavelCard: linkavelCard })), (phoneNumber && { phoneNumber: phoneNumber })));
                 url = "".concat(this.config.API_ENDPOINT, "/v3_resources/buyers?").concat(searchParams);
                 return [2 /*return*/, this.callGetApi(url).then(function (response) {
                         // Check for errors
@@ -422,7 +423,7 @@ var TplBooking = /** @class */ (function (_super) {
     };
     /**
      * @description This method shall be called when the user wants to update the buyer information.
-     * @param {Person | null} buyerDetails The object containing the buyer information.
+     * @param buyerDetails The object containing the buyer information.
      * It should be null if the buyer data cannot be specified (see {@link GetBuyerPassengersDetailsResponse.buyerDataStatus}).
      * @returns An {@link ErrorResponse} object in case of error, true otherwise.
      */

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

@@ -1,22 +1,25 @@
 import { PassengerTariff } from "./Tariffs";
 /**
  * @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.
- * @property {string} [notes=undefined] - The notes for this person.
  */
 export type Person = {
+    /** The unique identifier for the person. */
     id: number;
+    /** The name of the person. */
     name: string;
+    /** The last name of the person. */
     lastName: string;
+    /** The email of the person. */
     email: string;
+    /** The phone number of the person. */
     phoneNumber: string;
+    /** The notes for this person. */
     notes?: string;
 };
+export type Buyer = Person & {
+    /** The social security number of the buyer, if provided. */
+    socialSecurityNumber: string | null;
+};
 export declare const DEFAULT_PERSON: Person;
 export declare const initializePerson: (person?: Person | undefined | null) => Person;
 /**
@@ -37,24 +40,23 @@ export type GetPassenger = Person & {
     returnTariffs: Map<number, PassengerTariff[]> | null;
 };
 export declare enum BuyerDataStatus {
+    /** The buyer data are optional. Buyer form shall be displayed, but the user can skip it. */
     OPTIONAL = 0,
+    /** The buyer data are required. Buyer form shall be displayed and the user cannot skip it. */
     REQUIRED = 1,
+    /** The buyer data cannot be specified. Buyer form shall not be displayed. */
     CANNOT_BE_SPECIFIED = 2
 }
 /**
- * @description Represents the response of the {@link getBuyerPassengersDetails} method.
- *
- * @property {BuyerDataStatus} buyerDataStatus - Whether the for for the buyer data are required, optional or cannot be specified.
- * - `OPTIONAL`: The buyer data are optional. Buyer form shall be displayed, but the user can skip it.
- * - `REQUIRED`: The buyer data are required. Buyer form shall be displayed and the user cannot skip it.
- * - `CANNOT_BE_SPECIFIED`: The buyer data cannot be specified. Buyer form shall not be displayed.
- * @property {Person} buyer - The {@link Person} object representing the buyer.
- * @property {GetPassenger[]} passengers - An array of {@link GetPassenger} objects representing the passengers.
+ * Represents the response of the {@link getBuyerPassengersDetails} method.
  */
 export type GetBuyerPassengersDetailsResponse = {
+    /** Whether the form for the buyer data is required, optional or cannot be specified. */
     buyerDataStatus: BuyerDataStatus;
-    buyer: Person;
-    passengers: GetPassenger[];
+    /** The {@link Person} object representing the buyer. */
+    buyer: Buyer | null;
+    /** An array of {@link GetPassenger} objects representing the passengers. */
+    passengers: GetPassenger[] | null;
 };
 /**
  * @description Represents the type of the passengers array in {@link EditPassengersDetailsRequest}.
@@ -68,13 +70,14 @@ export type EditPassengerRequestType = Person & {
 };
 /**
  * @description Represents the passengers details.
- * This type shall be used as request for the {@link updatePassengersDetails} method.
- *
- * @property {EditPassengerRequestType[]} passengers - An array of {@link Person} extended by the map `tripsToTariffs` objects representing the passengers.
- * @property {Person | null} buyer - The {@link Person} object representing the buyer.
- * It should be null if the buyer data cannot be specified (see {@link GetBuyerPassengersDetailsResponse.buyerDataStatus}).
+ * This type shall be used as request for the {@link Booking.updateBuyerPassengersDetails} method.
  */
 export type EditPassengersDetailsRequest = {
+    /** An array of {@link Person} extended by the map `tripsToTariffs` objects representing the passengers. */
     passengers: EditPassengerRequestType[];
-    buyer: Person | null;
+    /**
+     * The {@link Person} object representing the buyer.
+     * It should be null if the buyer data cannot be specified (see {@link GetBuyerPassengersDetailsResponse.buyerDataStatus}).
+     */
+    buyer: Buyer | null;
 };

package/lib/types/common/Person.js

@@ -1,5 +1,4 @@
 "use strict";
-// This module contains the types to manage the passengers information
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BuyerDataStatus = exports.initializePerson = exports.DEFAULT_PERSON = void 0;
 exports.DEFAULT_PERSON = {
@@ -18,7 +17,10 @@ var initializePerson = function (person) {
 exports.initializePerson = initializePerson;
 var BuyerDataStatus;
 (function (BuyerDataStatus) {
+    /** The buyer data are optional. Buyer form shall be displayed, but the user can skip it. */
     BuyerDataStatus[BuyerDataStatus["OPTIONAL"] = 0] = "OPTIONAL";
+    /** The buyer data are required. Buyer form shall be displayed and the user cannot skip it. */
     BuyerDataStatus[BuyerDataStatus["REQUIRED"] = 1] = "REQUIRED";
+    /** The buyer data cannot be specified. Buyer form shall not be displayed. */
     BuyerDataStatus[BuyerDataStatus["CANNOT_BE_SPECIFIED"] = 2] = "CANNOT_BE_SPECIFIED";
 })(BuyerDataStatus || (exports.BuyerDataStatus = BuyerDataStatus = {}));

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

@@ -1,17 +1,43 @@
 /**
  * This represents a tariff, which defined the price to pay for a certain ticket.
- * @param {number} id - The id of the tariff.
- * @param {number} tariffTypeId - The id of the tariff type.
- * @param {number} termsTypeId - The id of the terms type.
- * @param {number} value - The value of the tariff (in the currency specified in the {@link Booking} object).
- * @param {number} quantity - The number of passengers to which this tariff applies.
  */
 export type Tariff = {
+    /** The id of the tariff */
     id: number;
+    /** The id of the tariff type */
     tariffTypeId: number;
+    /** The id of the terms type */
     termsTypeId: number;
+    /** The id of the tariff plan */
+    tariffPlanId: number;
+    /** The id of the seller */
+    sellerId: number;
+    /** The id of the associated segment, if any */
+    segmentId: number | null;
+    /** The id of the associated super area, if any */
+    superAreaId: number | null;
+    /** The id of the associated extra, if any */
+    extraId: number | null;
+    /** The value of the tariff (in the currency specified in the {@link Booking} object) */
     value: number;
+    /** @deprecated Use {@link Tariff.valueCurrencies} instead */
+    currency: null;
+    /** The value of the tariff in the different currencies */
+    valueCurrencies: {
+        percentage: number | null;
+        eur: number | null;
+        usd: number | null;
+        chf: number | null;
+        id: number;
+    };
+    /** The number of passengers to which this tariff applies */
     quantity: number;
+    /** The custom code for one-way tickets */
+    oneWayCode: string | null;
+    /** The custom code for round trip tickets */
+    roundTripCode: string | null;
+    /** Whether the tariff is active */
+    isActive: boolean;
 };
 /**
  * This represents a tariff matrix, returned when searching Journeys or Services.
@@ -22,41 +48,57 @@ export type Tariff = {
 export type TariffsMatrix = (Tariff | undefined)[][];
 /**
  * This represents a tariff type (e.g. "Adult", "Child", "Over65", ...).
- * @param {number} id - The id of the tariff type in the db.
- * @param {string} name - The name of the tariff type.
- * @param {string} description - The description of the tariff type.
- * @param {boolean} requiredPassengersName - Whether the passengers' names are required for this tariff type.
- * @param {number} numberOfOccupiedSeats - The number of seats occupied by this tariff type.
- * @param {string} bookingProcessDescription - A message to be shown to the user during the booking process that describes the tariff type,
- * including info on the rules that apply to it.
  */
 export type TariffType = {
+    /** The id of the tariff type in the db */
     id: number;
+    /** The name of the tariff type */
     name: string;
+    /** The description of the tariff type */
     description: string;
+    /** Whether the passengers' names are required for this tariff type */
     requiredPassengersName: boolean;
+    /** The number of seats occupied by this tariff type */
     numberOfOccupiedSeats: number;
+    /**
+     * A message to be shown to the user during the booking process that describes the tariff type,
+     * including info on the rules that apply to it
+     */
     bookingProcessDescription: string;
 };
 /**
  * This represents a terms type (e.g. "Standard", "Business", ...).
- * @param {number} id - The id of the terms type in the db.
- * @param {string} name - The name of the terms type.
- * @param {string} description - The description of the terms type.
- * @param {boolean} isRefundAllowed - Whether tickets refunds are allowed for this terms type.
- * @param {boolean} isChangeAllowed - Whether changing the ticket is allowed for this terms type.
- * @param {string} validationRulesString - A string containing the validation rules that apply to this terms type.
- * @param {string} bookingProcessDescription - A message to be shown to the user during the booking process that describes the terms type,
- * including info on the rules that apply to it.
  */
 export type TermsType = {
+    /** The id of the terms type in the db */
     id: number;
+    /** The name of the terms type */
     name: string;
+    /** The description of the terms type */
     description: string;
+    /** Whether tickets refunds are allowed for this terms type */
     isRefundAllowed: boolean;
+    /** Whether changing the ticket is allowed for this terms type */
     isChangeAllowed: boolean;
+    /** A string containing the validation rules that apply to this terms type */
     validationRulesString: string;
+    /**
+     * A message to be shown to the user during the booking process that describes the terms type,
+     * including info on the rules that apply to it
+     */
     bookingProcessDescription: string;
+    /** Whether these terms are the default ones */
+    isDefault: boolean;
+    /** Whether the terms are for a subscription */
+    isSubscription: boolean;
+    /** Whether a start date can be selected for this ticket */
+    canSelectStartDate: boolean;
+    /** Whether a start date is mandatory for this ticket */
+    isStartDateMandatory: boolean;
+    /** The validation rule for these terms */
+    validationRule: any | null;
+    /** The rules associated with these terms */
+    rules: any | null;
 };
 export type TariffSummary = {
     quantity: number;

package/lib/types/tpl/TplCart.d.ts

@@ -26,16 +26,16 @@ export type TplBookingType = {
 };
 /**
  * @description Represents a `TplBookingInfo`, which contains general information about a tpl booking.
- * @property {boolean} isSubscription - Whether the booking is a subscription or a single ticket.
- * @property {number} superAreaId - The id of the super area.
- * @property {number} validity - The validity of the ticket (or of the subscription).
- * @property {string} startDate - The start date of the ticket (or of the subscription).
- * @property {string} endDate - The end date of the ticket (or of the subscription).
  */
 export type TplBookingInfo = {
+    /** Whether the booking is a subscription or a single ticket. */
     isSubscription: boolean;
+    /** The id of the super area. */
     superAreaId: number;
-    validity: number;
+    /** The validity of the ticket (or of the subscription). */
+    validity: string;
+    /** The start date of the ticket (or of the subscription). */
     startDate: string;
+    /** The end date of the ticket (or of the subscription). */
     endDate: string;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mts-booking-library",
-  "version": "1.3.14",
+  "version": "1.3.16",
   "description": "Library for using MyTicketSolution Booking API",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -20,7 +20,7 @@
     "jest": "^29.7.0",
     "prettier": "^3.3.3",
     "ts-jest": "^29.2.3",
-    "typescript": "^5.5.3"
+    "typescript": "^5.5.4"
   },
   "files": [
     "lib/**/*"