mts-booking-library 1.3.25 → 2.0.0

package/lib/booking/tplBooking.js

@@ -35,8 +35,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 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;
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["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.");
@@ -99,11 +99,8 @@ var TplBooking = /** @class */ (function (_super) {
             resellerId: resellerId,
             dbType: dbType
         }) || this;
-        // Set cartId & cartGuid
-        var _b = _this.getStorage().getState(), cartId = _b.cartId, cartGuid = _b.cartGuid;
-        if (cartId && restoreState) {
-            _this.cartId = cartId;
-        }
+        // Set cartGuid
+        var cartGuid = _this.getStorage().getState().cartGuid;
         if (cartGuid && restoreState) {
             _this.cartGuid = cartGuid;
         }
@@ -120,16 +117,15 @@ var TplBooking = /** @class */ (function (_super) {
     };
     TplBooking.prototype.resetBooking = function () {
         this.cart = undefined;
-        this.cartId = undefined;
         this.cartGuid = undefined;
         this.bookingStepsToStatus = new Map();
         this.bookingDueDate = undefined;
         try {
-            this.getStorage().getState().updateCartId(undefined, undefined);
+            this.getStorage().getState().updateCartGuid(undefined);
         }
         catch (e) {
             if (this.config.ENV !== config_1.MTSEnvs.TEST) {
-                throw new Error("Error while deleting cartId from storage");
+                throw new Error("Error while deleting cartGuid from storage");
             }
             console.log(e);
         }
@@ -145,7 +141,6 @@ var TplBooking = /** @class */ (function (_super) {
                                 cartDueDate.setSeconds(cartDueDate.getSeconds() + cart.bookingDueDateRemainingSeconds);
                                 if (cartDueDate > new Date() && !cart.hasIssuedTickets) {
                                     _this.cart = cart;
-                                    _this.cartId = cart.id;
                                     _this.cartGuid = cart.guid;
                                     _this.bookingDueDate = cartDueDate; // See Booking class
                                     // Update the sellerId. This is particularly important in Linkavel
@@ -227,18 +222,17 @@ var TplBooking = /** @class */ (function (_super) {
             });
         });
     };
-    // TODO: use v3_resources/superAreas
     /**
      * This method fetches the list of super areas for a given city. A super area is a region of the city in which
      * the TPL service is available at a certain price.
      * @returns An array of {@link SuperArea} objects representing the SuperAreas if the call is successful, an {@link ErrorResponse} object otherwise.
      */
-    TplBooking.prototype.getSuperAreas = function (cityId) {
+    TplBooking.prototype.getSuperAreas = function (request) {
         return __awaiter(this, void 0, void 0, function () {
             var searchParams, url;
             return __generator(this, function (_a) {
-                searchParams = new URLSearchParams({ cityId: cityId.toString() });
-                url = "".concat(this.config.API_ENDPOINT, "/v3_booking/tpl/superAreasByCity?").concat(searchParams);
+                searchParams = new URLSearchParams(__assign(__assign({ includeBasicInfo: "true", includeAreaIds: "false", includeTariffIds: "false", includeRouteIds: "false" }, (request.cityId && { cityId: request.cityId.toString() })), (request.tripId && { tripId: request.tripId.toString() })));
+                url = "".concat(this.config.API_ENDPOINT, "/v3_resources/superAreas?").concat(searchParams);
                 return [2 /*return*/, this.callGetApi(url).then(function (response) {
                         return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response)
                             ? response
@@ -320,36 +314,32 @@ var TplBooking = /** @class */ (function (_super) {
     };
     /**
      * This method allows to create a TPL cart.
-     * @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, isCurrentPeriod, renewSubscriptionTicketPNR) {
+    TplBooking.prototype.createTplCart = function (tplCart) {
         return __awaiter(this, void 0, void 0, function () {
             var url, processedTariffIdToQuantity, request;
             var _this = this;
             return __generator(this, function (_a) {
                 url = "".concat(this.config.API_ENDPOINT, "/v3_booking/tpl/carts");
                 processedTariffIdToQuantity = {};
-                tariffIdToQuantity.forEach(function (value, key) {
+                tplCart.tariffIdToQuantity.forEach(function (value, key) {
                     processedTariffIdToQuantity[key] = value;
                 });
-                request = __assign(__assign(__assign({ tariffIdToQuantity: processedTariffIdToQuantity, currency: currency }, (startDate !== undefined && { startDate: startDate })), (isCurrentPeriod !== undefined && { isCurrentPeriod: isCurrentPeriod })), (renewSubscriptionTicketPNR !== undefined && { renewSubscriptionTicketPNR: renewSubscriptionTicketPNR }));
+                request = __assign(__assign(__assign(__assign(__assign({ tariffIdToQuantity: processedTariffIdToQuantity, currency: tplCart.currency }, (tplCart.startDate !== undefined && { startDate: tplCart.startDate })), (tplCart.isCurrentPeriod !== undefined && { isCurrentPeriod: tplCart.isCurrentPeriod })), (tplCart.renewSubscriptionTicketPNR !== undefined && {
+                    renewSubscriptionTicketPNR: tplCart.renewSubscriptionTicketPNR
+                })), (tplCart.otaResellerId !== undefined && { otaResellerId: tplCart.otaResellerId })), (tplCart.otaTicketPicture !== undefined && { otaTicketPicture: tplCart.otaTicketPicture }));
                 // Call the API
                 return [2 /*return*/, this.callPostApi(url, request).then(function (response) {
                         // Check for errors
                         if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
-                            // If there was an error, reset cartId and remove it from the mts-storage
+                            // If there was an error, reset cartGuid and remove it from the mts-storage
                             _this.resetBooking();
                             return response;
                         }
                         _this.cart = response.cart;
-                        _this.cartId = response.cart.id;
                         _this.cartGuid = response.cart.guid;
-                        // Save the cartId in the mts-storage
-                        _this.getStorage().getState().updateCartId(response.cart.id, response.cart.guid);
+                        // Save the cartGuid in the mts-storage
+                        _this.getStorage().getState().updateCartGuid(response.cart.guid);
                         // Fill the booking process status
                         _this.bookingStepsToStatus = (0, processBookingSteps_1.processBookingSteps)(response.cart.stepsToStatus);
                         var cartDueDate = new Date();
@@ -362,7 +352,7 @@ var TplBooking = /** @class */ (function (_super) {
             });
         });
     };
-    //#region Buyer data API
+    //#region PersonDetails data API
     /**
      * @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,
@@ -396,39 +386,6 @@ var TplBooking = /** @class */ (function (_super) {
             });
         });
     };
-    /**
-     * @description This method shall be called when the user wants to retrieve information about an esisting buyer.
-     * @param {GetBuyerRequest} request The object containing the parameters to search the buyer.
-     * @returns An object of type {@link Buyer} containing the buyer information, or an {@link ErrorResponse} object in case of error.
-     */
-    TplBooking.prototype.getBuyer = function (request) {
-        return __awaiter(this, void 0, void 0, function () {
-            var buyerPassengersDetails, searchParams, url;
-            var _a;
-            return __generator(this, function (_b) {
-                // First check that it is possible to call this API
-                if (!this.cart) {
-                    throw Error("Cart is not initialized yet");
-                }
-                buyerPassengersDetails = this.bookingStepsToStatus.get(booking_1.Booking.BookingSteps.BUYER_PASSENGERS);
-                if (!buyerPassengersDetails || !buyerPassengersDetails[0]) {
-                    throw Error("The status of the cart does not allow to call this API");
-                }
-                if (!request.personId && !request.personCode && !request.phoneNumber) {
-                    throw Error("At least one of the parameters personId, personCode or phoneNumber must be set");
-                }
-                searchParams = new URLSearchParams(__assign(__assign(__assign({}, (request.personId && { personId: (_a = request.personId) === null || _a === void 0 ? void 0 : _a.toString() })), (request.personCode && { personCode: request.personCode })), (request.phoneNumber && { phoneNumber: request.phoneNumber })));
-                url = "".concat(this.config.API_ENDPOINT, "/v3_customers/persons?").concat(searchParams);
-                return [2 /*return*/, this.callGetApi(url).then(function (response) {
-                        // Check for errors
-                        if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
-                            return response;
-                        }
-                        return response.persons[0];
-                    })];
-            });
-        });
-    };
     /**
      * @description This method shall be called when the user wants to update the buyer information.
      * @param buyerDetails The object containing the buyer information.
@@ -522,7 +479,7 @@ var TplBooking = /** @class */ (function (_super) {
                         _c.label = 5;
                     case 5:
                         url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/payment/reduction");
-                        return [2 /*return*/, this.callPostApi(url, __assign(__assign({}, request), { cartId: this.cartId, cartGuid: this.cartGuid })).then(function (response) {
+                        return [2 /*return*/, this.callPostApi(url, __assign(__assign({}, request), { cartGuid: this.cartGuid })).then(function (response) {
                                 var _a, _b;
                                 if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
                                     return response;
@@ -557,7 +514,10 @@ var TplBooking = /** @class */ (function (_super) {
                 if (!discountsStep || !discountsStep[0]) {
                     throw Error("The status of the cart does not allow to call this API");
                 }
-                queryParams = new URLSearchParams({ tripId: tripId.toString(), cartId: this.cartId.toString(), cartGuid: this.cartGuid });
+                queryParams = new URLSearchParams({
+                    tripId: tripId.toString(),
+                    cartGuid: this.cartGuid
+                });
                 url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/payment/reduction?").concat(queryParams);
                 return [2 /*return*/, this.callDeleteApi(url).then(function (response) {
                         var _a, _b, _c;
@@ -626,7 +586,7 @@ var TplBooking = /** @class */ (function (_super) {
                         _c.label = 5;
                     case 5:
                         url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/payment/wallet");
-                        return [2 /*return*/, this.callPostApi(url, { cartId: this.cartId, cartGuid: this.cartGuid }).then(function (response) {
+                        return [2 /*return*/, this.callPostApi(url, { cartGuid: this.cartGuid }).then(function (response) {
                                 var _a, _b;
                                 if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
                                     return response;
@@ -656,7 +616,9 @@ var TplBooking = /** @class */ (function (_super) {
                 if ((0, utils_1.isNullOrWhiteSpace)(this.cartGuid)) {
                     throw Error("Cart is not initialized yet");
                 }
-                queryParams = new URLSearchParams({ cartId: this.cartId.toString(), cartGuid: this.cartGuid });
+                queryParams = new URLSearchParams({
+                    cartGuid: this.cartGuid
+                });
                 url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/payment/wallet?").concat(queryParams);
                 return [2 /*return*/, this.callDeleteApi(url).then(function (response) {
                         var _a, _b, _c;
@@ -768,11 +730,10 @@ exports.TplBooking = TplBooking;
                 case 3: return [2 /*return*/, booking];
                 case 4:
                     error_1 = _c.sent();
-                    // Check if the error is due to an expired cart. In this case, delete the cartId from the mts-storage
+                    // Check if the error is due to an expired cart. In this case, delete the cartGuid from the mts-storage
                     // This error can occur when the user refreshes the page and the cart has expired
                     if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(error_1) && error_1.mtsCode === 40053) {
-                        booking.getStorage().getState().updateCartId(undefined, undefined);
-                        booking.cartId = undefined;
+                        booking.getStorage().getState().updateCartGuid(undefined);
                         booking.cartGuid = undefined;
                         return [2 /*return*/, booking];
                     }

package/lib/index.d.ts

@@ -4,13 +4,14 @@ export { ServiceBooking } from "./booking/serviceBooking";
 export { SubscriptionBooking } from "./booking/subscriptionBooking";
 export { TplBooking } from "./booking/tplBooking";
 export { useMtsBookingState } from "./mtsStorage";
-export { Person, Buyer, DEFAULT_PERSON, initializePerson } from "./types/common/Person";
-export { GetBuyerPassengersDetailsResponse, GetBuyerRequest, GetPassenger, BuyerDataStatus, EditPassengerRequestType, EditPassengersDetailsRequest } from "./types/common/Person";
+export { Person, PersonDetails, DEFAULT_PERSON, initializePerson } from "./types/common/Person";
+export { GetBuyerPassengersDetailsResponse, GetPersonRequest, GetPassenger, BuyerDataStatus, EditPassengerRequestType, EditPassengersDetailsRequest } from "./types/common/Person";
 export { Tariff, TariffsMatrix, TariffSummary, TariffType, TermsType, PassengerTariff, ExtraTariff } from "./types/common/Tariffs";
-export { Reduction, AddReductionRequest } from "./types/common/Reduction";
-export { Gateway, GetSellerGatewaysResponse, GetPaymentInformationFromGatewayResponse, IssueTicketsResponse, GatewayTypes, PaymentMethods } from "./types/common/Payment";
-export { ReductionType } from "./types/common/Reduction";
+export { ReductionType, Reduction, AddReductionRequest } from "./types/common/Reduction";
+export { Gateway, GetSellerGatewaysResponse, GetPaymentInformationFromGatewayResponse, IssueCartResponse, GatewayTypes, PaymentMethods } from "./types/common/Payment";
 export { ErrorResponse, objectIsMTSErrorResponse } from "./types/ErrorResponse";
+export { City } from "./types/common/City";
+export { Extra, GetExtrasResponse, GetExtrasForBookingResponse } from "./types/common/Extra";
 export { BusLayoutCell, BusMatrix, BusCellTypes, SeatStatus } from "./types/journeys/BusMatrix";
 export { JourneyCart, JourneyBookingType, CreateJourneyCartRequest, TripBookingInfo, DEFAULT_CREATE_JOURNEY_CART } from "./types/journeys/JourneyCart";
 export { JourneyInfo } from "./types/journeys/JourneyInfo";
@@ -22,8 +23,8 @@ export { Service, ServiceTrip } from "./types/services/Service";
 export { ServiceCart, ServiceBookingType, CreateServiceCartRequest } from "./types/services/ServiceCart";
 export { ServiceInfo } from "./types/services/ServiceInfo";
 export { GetTariffsResponse } from "./types/tpl/GetTariffsResponse";
-export { SuperArea } from "./types/tpl/SuperArea";
-export { TplCart, TplBookingType, TplBookingInfo } from "./types/tpl/TplCart";
+export { SuperArea, GetSuperAreasRequest } from "./types/tpl/SuperArea";
+export { CreateTplCartRequest, TplCart, TplBookingType, TplBookingInfo } from "./types/tpl/TplCart";
 export { Subscription } from "./types/subscriptions/Subscriptions";
 export { GetSubscriptionAvailabilityRequest, GetSubscriptionAvailabilityResponse, SubscriptionCalendarDayPeriodInfo } from "./types/subscriptions/SubscriptionAvailabilities";
 export { SubscriptionCart, SubscriptionBookingType, CreateSubscriptionCartRequest, SubscriptionPeriod } from "./types/subscriptions/SubscriptionCart";

package/lib/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_JOURNEY_SEARCH = exports.DEFAULT_CREATE_JOURNEY_CART = exports.SeatStatus = exports.BusCellTypes = exports.objectIsMTSErrorResponse = exports.ReductionType = exports.PaymentMethods = exports.GatewayTypes = exports.BuyerDataStatus = exports.initializePerson = exports.DEFAULT_PERSON = exports.useMtsBookingState = exports.TplBooking = exports.SubscriptionBooking = exports.ServiceBooking = exports.JourneyBooking = exports.Booking = void 0;
+exports.DEFAULT_JOURNEY_SEARCH = exports.DEFAULT_CREATE_JOURNEY_CART = exports.SeatStatus = exports.BusCellTypes = exports.objectIsMTSErrorResponse = exports.PaymentMethods = exports.GatewayTypes = exports.ReductionType = exports.BuyerDataStatus = exports.initializePerson = exports.DEFAULT_PERSON = exports.useMtsBookingState = exports.TplBooking = exports.SubscriptionBooking = exports.ServiceBooking = exports.JourneyBooking = exports.Booking = void 0;
 //#region Export Booking classes
 var booking_1 = require("./booking/booking");
 Object.defineProperty(exports, "Booking", { enumerable: true, get: function () { return booking_1.Booking; } });
@@ -24,11 +24,11 @@ Object.defineProperty(exports, "DEFAULT_PERSON", { enumerable: true, get: functi
 Object.defineProperty(exports, "initializePerson", { enumerable: true, get: function () { return Person_1.initializePerson; } });
 var Person_2 = require("./types/common/Person");
 Object.defineProperty(exports, "BuyerDataStatus", { enumerable: true, get: function () { return Person_2.BuyerDataStatus; } });
+var Reduction_1 = require("./types/common/Reduction");
+Object.defineProperty(exports, "ReductionType", { enumerable: true, get: function () { return Reduction_1.ReductionType; } });
 var Payment_1 = require("./types/common/Payment");
 Object.defineProperty(exports, "GatewayTypes", { enumerable: true, get: function () { return Payment_1.GatewayTypes; } });
 Object.defineProperty(exports, "PaymentMethods", { enumerable: true, get: function () { return Payment_1.PaymentMethods; } });
-var Reduction_1 = require("./types/common/Reduction");
-Object.defineProperty(exports, "ReductionType", { enumerable: true, get: function () { return Reduction_1.ReductionType; } });
 var ErrorResponse_1 = require("./types/ErrorResponse");
 Object.defineProperty(exports, "objectIsMTSErrorResponse", { enumerable: true, get: function () { return ErrorResponse_1.objectIsMTSErrorResponse; } });
 //#endregion

package/lib/mtsStorage.d.ts

@@ -1,10 +1,8 @@
 type MtsBookingState = {
-    /** @deprecated Please use {@link MtsBookingState.cartGuid} instead, where possible */
-    cartId: number | undefined;
     cartGuid: string | undefined;
 };
 type MtsBookingAction = {
-    updateCartId: (cartId: MtsBookingState["cartId"], cartGuid: MtsBookingState["cartGuid"]) => void;
+    updateCartGuid: (cartGuid: MtsBookingState["cartGuid"]) => void;
     resetState: () => void;
 };
 export declare const useMtsBookingLocalState: import("zustand").UseBoundStore<Omit<import("zustand").StoreApi<MtsBookingState & MtsBookingAction>, "persist"> & {

package/lib/mtsStorage.js

@@ -16,17 +16,16 @@ var async_storage_1 = require("@react-native-async-storage/async-storage");
 var zustand_1 = require("zustand");
 var middleware_1 = require("zustand/middleware");
 var INITIAL_STATE = {
-    cartId: 0,
     cartGuid: undefined
 };
-var useMtsBookingAsyncState = (0, zustand_1.create)((0, middleware_1.persist)(function (set) { return (__assign(__assign({}, INITIAL_STATE), { updateCartId: function (cartId, cartGuid) {
-        return set(function () { return ({ cartId: cartId, cartGuid: cartGuid }); });
+var useMtsBookingAsyncState = (0, zustand_1.create)((0, middleware_1.persist)(function (set) { return (__assign(__assign({}, INITIAL_STATE), { updateCartGuid: function (cartGuid) {
+        return set(function () { return ({ cartGuid: cartGuid }); });
     }, resetState: function () { return set(function () { return INITIAL_STATE; }); } })); }, {
     name: "mts-booking-storage",
     storage: (0, middleware_1.createJSONStorage)(function () { return async_storage_1.default; })
 }));
-exports.useMtsBookingLocalState = (0, zustand_1.create)((0, middleware_1.persist)(function (set) { return (__assign(__assign({}, INITIAL_STATE), { updateCartId: function (cartId, cartGuid) {
-        return set(function () { return ({ cartId: cartId, cartGuid: cartGuid }); });
+exports.useMtsBookingLocalState = (0, zustand_1.create)((0, middleware_1.persist)(function (set) { return (__assign(__assign({}, INITIAL_STATE), { updateCartGuid: function (cartGuid) {
+        return set(function () { return ({ cartGuid: cartGuid }); });
     }, resetState: function () { return set(function () { return INITIAL_STATE; }); } })); }, {
     name: "mts-booking-storage",
     storage: (0, middleware_1.createJSONStorage)(function () { return localStorage; })

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

@@ -16,11 +16,6 @@ export declare enum SellingMethod {
  * - TplCart: {@link TplCart}
  */
 export type Cart = {
-    /**
-     * The id of the cart
-     * @deprecated Please use {@link Cart.guid} instead
-     */
-    id: number;
     /** The guid of the cart */
     guid: string;
     /** The id of the seller of the tickets in the cart */

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

@@ -1,4 +1,4 @@
-import { ExtraTariff } from "./Tariffs";
+import { ExtraTariff, TariffsMatrix } from "./Tariffs";
 /**
  * @description this type represents an extra, which is an additional service that can be added to a cart. Extras are selected in the booking step `EXTRAS`.
  *
@@ -18,3 +18,15 @@ export type Extra = {
     notes: string;
     tariff: ExtraTariff;
 };
+export type GetExtrasResponse = {
+    extras: {
+        id: number;
+        name: string;
+        description: string;
+        requiresNotes: boolean;
+        notes: string | null;
+    }[];
+};
+export type GetExtrasForBookingResponse = {
+    extraIdToTariffsMatrix: Record<number, TariffsMatrix>;
+};

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

@@ -55,7 +55,7 @@ export declare enum GatewayTypes {
 }
 /**
  * This enum contains the possible values for the `paymentMethod` parameter of the
- * {@link Booking.issueTickets} function.
+ * {@link Booking.issueCart} function.
  */
 export declare enum PaymentMethods {
     /** Pay with card at the Seller/Reseller counter */
@@ -83,7 +83,7 @@ export type Wallet = {
     walletTransactions: any[];
 };
 /**
- * @description This type represents the response of the {@link Booking.issueTickets} API.
+ * @description This type represents the response of the {@link Booking.issueCart} API.
  * @param {Wallet} wallet If the booking was performed by a reseller, this field contains the wallet with the updated balance.
  * @param {string} ticketsSentToEmail This field contains the email address to which the tickets were sent.
  * If the buyer email was specified, this field will contain the buyer email. Otherwise, if the reseller performed the booking, this
@@ -91,7 +91,7 @@ export type Wallet = {
  * the MTS email.
  * @param {string[]} PNRs An array of PNRs associated with the booking.
  */
-export type IssueTicketsResponse = {
+export type IssueCartResponse = {
     wallet: Wallet | null;
     ticketsSentToEmail: string;
     pnrs: string[];

package/lib/types/common/Payment.js

@@ -13,7 +13,7 @@ var GatewayTypes;
 })(GatewayTypes || (exports.GatewayTypes = GatewayTypes = {}));
 /**
  * This enum contains the possible values for the `paymentMethod` parameter of the
- * {@link Booking.issueTickets} function.
+ * {@link Booking.issueCart} function.
  */
 var PaymentMethods;
 (function (PaymentMethods) {

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

@@ -18,19 +18,19 @@ export type Person = {
     /** The notes for this person. */
     notes?: string;
 };
-export type Buyer = Person & {
+export type PersonDetails = 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;
 /**
- * @description Represents the request for the {@link Booking.getBuyerFromLinkavelCard} method.
+ * @description Represents the request for the {@link Booking.getPerson} method.
  * @property {number} personId - The unique identifier of the buyer.
  * @property {string} personCode - The person code of the person (the old linkAvelCardNumber)
  * @property {string} phoneNumber - The phone number of the person.
  */
-export type GetBuyerRequest = {
+export type GetPersonRequest = {
     personId?: number;
     personCode?: string;
     phoneNumber?: string;
@@ -53,11 +53,11 @@ 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. */
+    /** The buyer data are optional. PersonDetails 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. */
+    /** The buyer data are required. PersonDetails form shall be displayed and the user cannot skip it. */
     REQUIRED = 1,
-    /** The buyer data cannot be specified. Buyer form shall not be displayed. */
+    /** The buyer data cannot be specified. PersonDetails form shall not be displayed. */
     CANNOT_BE_SPECIFIED = 2
 }
 /**
@@ -67,7 +67,7 @@ export type GetBuyerPassengersDetailsResponse = {
     /** Whether the form for the buyer data is required, optional or cannot be specified. */
     buyerDataStatus: BuyerDataStatus;
     /** The {@link Person} object representing the buyer. */
-    buyer: Buyer | null;
+    buyer: PersonDetails | null;
     /** An array of {@link GetPassenger} objects representing the passengers. */
     passengers: GetPassenger[] | null;
 };
@@ -92,5 +92,5 @@ export type EditPassengersDetailsRequest = {
      * 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;
+    buyer: PersonDetails | null;
 };

package/lib/types/common/Person.js

@@ -18,10 +18,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. */
+    /** The buyer data are optional. PersonDetails 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. */
+    /** The buyer data are required. PersonDetails 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. */
+    /** The buyer data cannot be specified. PersonDetails 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

@@ -30,6 +30,8 @@ export type Tariff = {
         chf: number | null;
         id: number;
     };
+    /** The user-friendly label of the tariff */
+    label: string;
     /** The number of passengers to which this tariff applies */
     quantity: number;
     /** The custom code for one-way tickets */

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

@@ -17,21 +17,26 @@ export type TripBookingInfo = {
     destinationStopId: number;
     /** A record containing tariff ids as keys and their respective quantities as values. */
     tariffIdToQuantity: Record<number, number>;
+    /** The id of the OTA Reseller that sold the ticket */
+    otaResellerId?: number;
+    /** A string in base64 representing the picture of the ticket that was sold */
+    otaTicketPicture?: string;
 };
 /**
- * @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 {TripBookingInfo[]} outboundJourney - Information about outbound journeys. This is an array of {@link TripBookingInfo} objects.
- * Note that when searching for journeys, the `trips` property of the {@link JourneySearchResult} object contains an array of {@link Trip} objects.
- * Each trip should be mapped into a {@link TripBookingInfo} object.
- * @property {TripBookingInfo[] | null} returnJourney - Information about return journeys (optional, can be null). See outboundJourney.
+ * @description This is the object to be passed to {@link JourneyBooking.createJourneyCart}, containing information about the selected service.
  */
 export type CreateJourneyCartRequest = {
-    cartId?: number;
+    /** The unique identifier for the cart. This should be passed during the change process to link the new ticket to the already existing change cart */
+    cartGuid?: string;
+    /** The currency in which the journey is priced */
     currency: Booking.Currencies;
+    /**
+     * Information about outbound journeys. This is an array of {@link TripBookingInfo} objects.
+     * Note that when searching for journeys, the `trips` property of the {@link JourneySearchResult} object contains an array of {@link Trip} objects.
+     * Each trip should be mapped into a {@link TripBookingInfo} object.
+     */
     outboundJourney: TripBookingInfo[];
+    /** Information about return journeys (optional, can be null). See outboundJourney. */
     returnJourney: TripBookingInfo[] | null;
 };
 export declare const DEFAULT_CREATE_JOURNEY_CART: CreateJourneyCartRequest;

package/lib/types/journeys/JourneyCart.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DEFAULT_CREATE_JOURNEY_CART = void 0;
 var booking_1 = require("../../booking/booking");
 exports.DEFAULT_CREATE_JOURNEY_CART = {
-    cartId: 0,
+    cartGuid: undefined,
     currency: booking_1.Booking.Currencies.EUR,
     outboundJourney: [],
     returnJourney: null

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

@@ -19,6 +19,10 @@ export type CreateServiceCartRequest = {
         date?: string;
         /** The unique identifier for the trip (optional). */
         tripId?: number;
+        /** The id of the OTA Reseller that sold the ticket */
+        otaResellerId?: number;
+        /** A string in base64 representing the picture of the ticket that was sold */
+        otaTicketPicture?: string;
     };
 };
 /**

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

@@ -11,3 +11,9 @@ export type SuperArea = {
     shortName: string;
     description: string;
 };
+export type GetSuperAreasRequest = {
+    /** The id of the city (as returned by the {@link TplBooking.getCities} method). If present, only the super areas associated with this city will be returned. */
+    cityId?: number;
+    /** The id of the trip. If present, only the super areas associated with this trip will be returned. This is used by the app. */
+    tripId?: number;
+};

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

@@ -1,6 +1,25 @@
 import { Booking } from "../../booking/booking";
 import { Cart } from "../common/Cart";
 import { TariffSummary } from "../common/Tariffs";
+/**
+ * @description This is the object to be passed to {@link TplBooking.createTplCart}, containing information about the selected tpl service.
+ */
+export type CreateTplCartRequest = {
+    /** The currency in which the ticket is priced. */
+    currency: Booking.Currencies;
+    /** A map that associates a tariff id (the one chosen by the user) to the number of tickets to buy for that tariff. */
+    tariffIdToQuantity: Map<number, number>;
+    /** The start date of the ticket. This is optional and should be used only for subscriptions */
+    startDate?: string;
+    /** Whether the subscription is for the current period. This is optional and should be used only for subscriptions. */
+    isCurrentPeriod?: boolean;
+    /** The PNR of the subscription ticket to renew. This is optional and should be used only for subscriptions. */
+    renewSubscriptionTicketPNR?: string;
+    /** The id of the OTA Reseller that sold the ticket */
+    otaResellerId?: number;
+    /** A string in base64 representing the picture of the ticket that was sold */
+    otaTicketPicture?: string;
+};
 /**
  * @description Represents a `TplCart`, which extends the {@link Cart} type by including additional
  * information about the bookings

package/lib/utils/apiCall.d.ts

@@ -8,4 +8,5 @@
 import { ErrorResponse } from "../types/ErrorResponse";
 export declare const makeGet: (url: string) => Promise<ErrorResponse | any>;
 export declare const makePost: (url: string, data: any) => Promise<ErrorResponse | any>;
+export declare const makePut: (url: string, data: any) => Promise<ErrorResponse | any>;
 export declare const makeDelete: (url: string) => Promise<ErrorResponse | any>;