mts-booking-library 1.2.21 → 1.2.23

package/lib/booking/booking.d.ts

@@ -1,6 +1,6 @@
 import { MTSConfig, MTSEnvs } from "../config";
 import { ErrorResponse } from "../types/ErrorResponse";
-import { GetPaymentInformationFromGatewayResponse, GetSellerGatewaysResponse, PaymentMethods, Wallet } from "../types/common/Payment";
+import { GetPaymentInformationFromGatewayResponse, GetSellerGatewaysResponse, PaymentMethods, IssueTicketsResponse } from "../types/common/Payment";
 import { GetBuyerPassengersDetailsResponse, Person } from "../types/common/Person";
 import { AddReductionRequest } from "../types/common/Reduction";
 export declare abstract class Booking {
@@ -85,12 +85,9 @@ export declare abstract class Booking {
      * @description This method shall be used to issue the tickets. It must be called after the payment was successful.
      * @param {PaymentMethods} paymentMethod The payment method used to pay the cart. If the chosen method is {@link PaymentMethods.ZERO_COST},
      * first the {@link Booking.addReduction} API is called with a 100% discount, then tickets are issued with the {@link PaymentMethods.CASH} method.
-     * @returns An {@link ErrorResponse} object in case of error, nothing otherwise.
+     * @returns An {@link IssueTicketsResponse} object.
      */
-    issueTickets(paymentMethod: PaymentMethods): Promise<ErrorResponse | {
-        wallet: Wallet;
-        result: boolean;
-    }>;
+    issueTickets(paymentMethod: PaymentMethods): Promise<ErrorResponse | IssueTicketsResponse>;
 }
 export declare namespace Booking {
     enum Currencies {

package/lib/booking/booking.js

@@ -271,7 +271,7 @@ var Booking = /** @class */ (function () {
      * @description This method shall be used to issue the tickets. It must be called after the payment was successful.
      * @param {PaymentMethods} paymentMethod The payment method used to pay the cart. If the chosen method is {@link PaymentMethods.ZERO_COST},
      * first the {@link Booking.addReduction} API is called with a 100% discount, then tickets are issued with the {@link PaymentMethods.CASH} method.
-     * @returns An {@link ErrorResponse} object in case of error, nothing otherwise.
+     * @returns An {@link IssueTicketsResponse} object.
      */
     Booking.prototype.issueTickets = function (paymentMethod) {
         var _a;
@@ -337,7 +337,7 @@ var Booking = /** @class */ (function () {
                             paymentMethod: paymentMethodToSet === Payment_1.PaymentMethods.PAY_LATER ? null : paymentMethodToSet,
                         };
                         return [2 /*return*/, this.callPostApi(url, body).then(function (response) {
-                                return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response) ? response : { wallet: response.wallet, result: true };
+                                return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response) ? response : response;
                             })];
                 }
             });

package/lib/booking/serviceBooking.d.ts

@@ -71,10 +71,11 @@ export declare class ServiceBooking extends Booking {
     getBuyerFromLinkavelCard(linkavelCardNumber?: string, linkavelCardPhoneNumber?: string): Promise<ErrorResponse | Person>;
     /**
      * @description This method shall be called when the user wants to update the buyer information.
-     * @param {Person} buyerDetails The object containing the buyer information.
+     * @param {Person | null} 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): Promise<ErrorResponse | boolean>;
+    updateBuyerPassengersDetails(buyerDetails: Person | 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

@@ -336,7 +336,8 @@ var ServiceBooking = /** @class */ (function (_super) {
     };
     /**
      * @description This method shall be called when the user wants to update the buyer information.
-     * @param {Person} buyerDetails The object containing the buyer information.
+     * @param {Person | null} 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.
      */
     ServiceBooking.prototype.updateBuyerPassengersDetails = function (buyerDetails) {

package/lib/index.d.ts

@@ -7,7 +7,7 @@ export { GetBuyerPassengersDetailsResponse, GetPassenger, BuyerDataStatus } from
 export { 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, GatewayTypes, PaymentMethods } from "./types/common/Payment";
+export { Gateway, GetSellerGatewaysResponse, GetPaymentInformationFromGatewayResponse, IssueTicketsResponse, GatewayTypes, PaymentMethods } from "./types/common/Payment";
 export { ErrorResponse, objectIsMTSErrorResponse } from "./types/ErrorResponse";
 export { BusLayoutCell, BusMatrix, BusCellTypes, SeatStatus } from "./types/journeys/BusMatrix";
 export { JourneyCart, JourneyBookingType, CreateJourneyCartRequest, TripBookingInfo, DEFAULT_CREATE_JOURNEY_CART } from "./types/journeys/JourneyCart";

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

@@ -10,7 +10,7 @@ export type Gateway = {
     name: string;
 };
 /**
- * @description This type represents the response of the {@link Booking.getSellerGateways} API. Note that at least
+ * @description This type represents the response of the {@link Booking.getSellerGateways()} API. Note that at least
  * one of the two fields will be null, depending on the seller configuration.
  * @param {Gateway | null} cardGatewayDTO The card gateway, if available. Currecntly this can only be {@link GatewayTypes.AXEPTA_BNL}
  * or {@link GatewayTypes.AXERVE_BANCASELLA}
@@ -77,3 +77,17 @@ export type Wallet = {
     balance: any;
     walletTransactions: any[];
 };
+/**
+ * @description This type represents the response of the {@link Booking.issueTickets} 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
+ * field will contain the reseller email. Otherwise, it will be the seller's email. If this is also not available, this field will contain
+ * the MTS email.
+ * @param {string[]} PNRs An array of PNRs associated with the booking.
+ */
+export type IssueTicketsResponse = {
+    wallet: Wallet | null;
+    ticketsSentToEmail: string;
+    pnrs: string[];
+};

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

@@ -64,9 +64,10 @@ export type EditPassengerRequestType = Person & {
  * 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} buyer - The {@link Person} object representing the buyer.
+ * @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}).
  */
 export type EditPassengersDetailsRequest = {
     passengers: EditPassengerRequestType[];
-    buyer: Person;
+    buyer: Person | null;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mts-booking-library",
-  "version": "1.2.21",
+  "version": "1.2.23",
   "description": "Library for use MyTicketSolution Booking API",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -28,7 +28,7 @@
   ],
   "author": "M",
   "dependencies": {
-    "axios": "^1.6.2",
+    "axios": "^1.6.5",
     "node-localstorage": "^3.0.5"
   }
 }