mts-booking-library 3.3.0 → 3.5.0

package/lib/booking/journeyBooking.d.ts

@@ -2,12 +2,16 @@ import { ErrorResponse } from "../types/ErrorResponse";
 import { CreateUpdateCartRequest } from "../types/common/Cart";
 import { EditPassengersDetailsRequest, GetBuyerPassengersDetailsResponse } from "../types/common/Person";
 import { AddReductionRequest } from "../types/common/Reduction";
-import { BusMatrix } from "../types/journeys/BusMatrix";
+import { BusMatrix, SeatChange } from "../types/journeys/BusMatrix";
 import { JourneyCart } from "../types/journeys/JourneyCart";
 import { JourneySearchRequest, JourneySearchResult } from "../types/journeys/JourneySearch";
 import { ReductionTrip } from "../types/journeys/Trip";
 import { ApiCallOptions } from "../utils/apiCall";
 import { Booking } from "./booking";
+type JourneyLineRouteFilters = {
+    lineId?: number | null;
+    routeId?: number | null;
+};
 export declare class JourneyBooking extends Booking {
     private cart?;
     /**
@@ -116,13 +120,13 @@ export declare class JourneyBooking extends Booking {
      * This method returns the possible departures for all journeys (MLP) sold by this seller.
      * @returns The list of possible departures
      */
-    getJourneysDepartures(options?: ApiCallOptions): Promise<ErrorResponse | string[]>;
+    getJourneysDepartures(filtersOrOptions?: JourneyLineRouteFilters | ApiCallOptions, options?: ApiCallOptions): Promise<ErrorResponse | string[]>;
     /**
      * This method returns the possible destination for the journeys sold by this seller that start at the selected departure.
      * @param departureStopName The departure stop name (as returned by {@link getJourneysDepartures})
      * @returns The list of possible destinations
      */
-    getJourneysDestinations(departureStopName: string, options?: ApiCallOptions): Promise<ErrorResponse | string[]>;
+    getJourneysDestinations(departureStopName: string, filtersOrOptions?: JourneyLineRouteFilters | ApiCallOptions, options?: ApiCallOptions): Promise<ErrorResponse | string[]>;
     /**
      * This method returns the journeys that match the given parameters.
      * Note that it will always return the journeys for the one-way trip.
@@ -165,11 +169,24 @@ export declare class JourneyBooking extends Booking {
     getAssignedSeats(tripId: number, options?: ApiCallOptions): Promise<ErrorResponse | number[]>;
     /**
      * @description This method shall be called when the user wants to change the assigned seats of a trip.
+     *
+     * Two shapes are supported. Callers should prefer `seatChanges` when
+     * the cart has more than one passenger on the trip — the BE pairs by
+     * {@link SeatChange.oldSeatId}, which uniquely identifies the cart's
+     * underlying TripBusLayoutCell. The legacy `newSeatsIds` form is a
+     * full positional snapshot of every passenger's new seat; the BE
+     * zips it against EF-ordered TripBusLayoutCells, which can reassign
+     * the wrong passenger when the two orderings disagree.
+     *
+     * Send only one of the two arguments per call. If both are present
+     * the BE prefers `seatChanges`.
      * @param tripId The id of the trip for which the seats should be changed
-     * @param newSeatsIds The ids of the new seats, as found the {@link BusMatrix}
+     * @param seatsOrChanges Either the legacy `newSeatsIds` array (every
+     *   passenger's new seat, in order) or an explicit list of
+     *   {@link SeatChange} pairs (only the seats that change).
      * @returns An {@link ErrorResponse} object in case of error, true otherwise.
      */
-    changeSeatsOfTrip(tripId: number, newSeatsIds: number[], options?: ApiCallOptions): Promise<ErrorResponse | boolean>;
+    changeSeatsOfTrip(tripId: number, seatsOrChanges: number[] | SeatChange[], options?: ApiCallOptions): Promise<ErrorResponse | boolean>;
     /**
      * @description This method shall be called when the user wants to retrieve the trips in the cart, for adding a available reduction
      * to a specific trip (rather than to the whole cart).
@@ -215,3 +232,4 @@ export declare class JourneyBooking extends Booking {
 export declare namespace JourneyBooking {
     const createBooking: ({ env, subKey, debug, language, sessionId, restoreState, accessToken, sellerId, resellerId, appVersion, os, dbType }: Omit<Booking.BookingConfig, "bookingType">) => Promise<JourneyBooking>;
 }
+export {};

package/lib/booking/journeyBooking.js

@@ -79,6 +79,8 @@ var Reduction_1 = require("../types/common/Reduction");
 var processBookingSteps_1 = require("../utils/processBookingSteps");
 var utils_1 = require("../utils/utils");
 var booking_1 = require("./booking");
+var isJourneyLineRouteFilters = function (value) { return !!value && ("lineId" in value || "routeId" in value); };
+var getJourneyLineRouteParams = function (filters) { return (__assign(__assign({}, ((filters === null || filters === void 0 ? void 0 : filters.lineId) && { lineId: filters.lineId.toString() })), ((filters === null || filters === void 0 ? void 0 : filters.routeId) && { routeId: filters.routeId.toString() }))); };
 var JourneyBooking = /** @class */ (function (_super) {
     __extends(JourneyBooking, _super);
     /**
@@ -219,12 +221,15 @@ var JourneyBooking = /** @class */ (function (_super) {
      * This method returns the possible departures for all journeys (MLP) sold by this seller.
      * @returns The list of possible departures
      */
-    JourneyBooking.prototype.getJourneysDepartures = function (options) {
+    JourneyBooking.prototype.getJourneysDepartures = function (filtersOrOptions, options) {
         return __awaiter(this, void 0, void 0, function () {
-            var url;
+            var filters, requestOptions, searchParams, url;
             return __generator(this, function (_a) {
-                url = "".concat(this.config.API_ENDPOINT, "/v3_booking/journeys/departures?");
-                return [2 /*return*/, this.callGetApi(url, options).then(function (response) {
+                filters = isJourneyLineRouteFilters(filtersOrOptions) ? filtersOrOptions : undefined;
+                requestOptions = isJourneyLineRouteFilters(filtersOrOptions) ? options : filtersOrOptions;
+                searchParams = new URLSearchParams(getJourneyLineRouteParams(filters));
+                url = "".concat(this.config.API_ENDPOINT, "/v3_booking/journeys/departures?").concat(searchParams);
+                return [2 /*return*/, this.callGetApi(url, requestOptions).then(function (response) {
                         return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response) ? response : response.stops;
                     })];
             });
@@ -235,13 +240,15 @@ var JourneyBooking = /** @class */ (function (_super) {
      * @param departureStopName The departure stop name (as returned by {@link getJourneysDepartures})
      * @returns The list of possible destinations
      */
-    JourneyBooking.prototype.getJourneysDestinations = function (departureStopName, options) {
+    JourneyBooking.prototype.getJourneysDestinations = function (departureStopName, filtersOrOptions, options) {
         return __awaiter(this, void 0, void 0, function () {
-            var searchParams, url;
+            var filters, requestOptions, searchParams, url;
             return __generator(this, function (_a) {
-                searchParams = new URLSearchParams({ departureStopName: departureStopName });
+                filters = isJourneyLineRouteFilters(filtersOrOptions) ? filtersOrOptions : undefined;
+                requestOptions = isJourneyLineRouteFilters(filtersOrOptions) ? options : filtersOrOptions;
+                searchParams = new URLSearchParams(__assign({ departureStopName: departureStopName }, getJourneyLineRouteParams(filters)));
                 url = "".concat(this.config.API_ENDPOINT, "/v3_booking/journeys/destinations?").concat(searchParams);
-                return [2 /*return*/, this.callGetApi(url, options).then(function (response) {
+                return [2 /*return*/, this.callGetApi(url, requestOptions).then(function (response) {
                         return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response) ? response : response.stops;
                     })];
             });
@@ -262,7 +269,7 @@ var JourneyBooking = /** @class */ (function (_super) {
                 if (request.departureStopName === undefined || request.destinationStopName === undefined) {
                     throw Error("Fields departureStopName and destinationStopName are required");
                 }
-                searchParams = new URLSearchParams(__assign(__assign(__assign({ departureStopName: request.departureStopName, destinationStopName: request.destinationStopName, passengersNumber: request.passengersNumber.toString(), outboundDate: request.outboundDate.dateTime }, (request.returnDate && { returnDate: request.returnDate.dateTime })), { currency: request.currency, outboundTripId: (_b = (_a = request.outboundTripId) === null || _a === void 0 ? void 0 : _a.toString()) !== null && _b !== void 0 ? _b : "null" }), (this.cartGuid && { cartGuid: this.cartGuid })));
+                searchParams = new URLSearchParams(__assign(__assign(__assign(__assign(__assign({ departureStopName: request.departureStopName, destinationStopName: request.destinationStopName, passengersNumber: request.passengersNumber.toString(), outboundDate: request.outboundDate.dateTime }, (request.returnDate && { returnDate: request.returnDate.dateTime })), { currency: request.currency, outboundTripId: (_b = (_a = request.outboundTripId) === null || _a === void 0 ? void 0 : _a.toString()) !== null && _b !== void 0 ? _b : "null" }), (request.lineId && { lineId: request.lineId.toString() })), (request.routeId && { routeId: request.routeId.toString() })), (this.cartGuid && { cartGuid: this.cartGuid })));
                 url = "".concat(this.config.API_ENDPOINT, "/v3_booking/journeys_v4?").concat(searchParams);
                 return [2 /*return*/, this.callGetApi(url, options).then(function (response) {
                         return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response)
@@ -462,13 +469,26 @@ var JourneyBooking = /** @class */ (function (_super) {
     };
     /**
      * @description This method shall be called when the user wants to change the assigned seats of a trip.
+     *
+     * Two shapes are supported. Callers should prefer `seatChanges` when
+     * the cart has more than one passenger on the trip — the BE pairs by
+     * {@link SeatChange.oldSeatId}, which uniquely identifies the cart's
+     * underlying TripBusLayoutCell. The legacy `newSeatsIds` form is a
+     * full positional snapshot of every passenger's new seat; the BE
+     * zips it against EF-ordered TripBusLayoutCells, which can reassign
+     * the wrong passenger when the two orderings disagree.
+     *
+     * Send only one of the two arguments per call. If both are present
+     * the BE prefers `seatChanges`.
      * @param tripId The id of the trip for which the seats should be changed
-     * @param newSeatsIds The ids of the new seats, as found the {@link BusMatrix}
+     * @param seatsOrChanges Either the legacy `newSeatsIds` array (every
+     *   passenger's new seat, in order) or an explicit list of
+     *   {@link SeatChange} pairs (only the seats that change).
      * @returns An {@link ErrorResponse} object in case of error, true otherwise.
      */
-    JourneyBooking.prototype.changeSeatsOfTrip = function (tripId, newSeatsIds, options) {
+    JourneyBooking.prototype.changeSeatsOfTrip = function (tripId, seatsOrChanges, options) {
         return __awaiter(this, void 0, void 0, function () {
-            var seatSelectionStatus, url;
+            var seatSelectionStatus, usesExplicitShape, body, url;
             var _this = this;
             return __generator(this, function (_a) {
                 // First check that it is possible to call this API
@@ -479,12 +499,19 @@ var JourneyBooking = /** @class */ (function (_super) {
                 if (!seatSelectionStatus || !seatSelectionStatus[0]) {
                     throw Error("The status of the cart does not allow to call this API");
                 }
+                usesExplicitShape = seatsOrChanges.length > 0 && typeof seatsOrChanges[0] === "object";
+                body = {
+                    tripId: tripId,
+                    cartGuid: this.cart.guid
+                };
+                if (usesExplicitShape) {
+                    body.seatChanges = seatsOrChanges;
+                }
+                else {
+                    body.newSeatsIds = seatsOrChanges;
+                }
                 url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/seats");
-                return [2 /*return*/, this.callPostApi(url, {
-                        tripId: tripId,
-                        newSeatsIds: newSeatsIds,
-                        cartGuid: this.cart.guid
-                    }, options).then(function (response) {
+                return [2 /*return*/, this.callPostApi(url, body, options).then(function (response) {
                         if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response))
                             return response;
                         // Update the booking process status

package/lib/index.d.ts

@@ -16,7 +16,7 @@ export { ErrorResponse, objectIsMTSErrorResponse } from "./types/ErrorResponse";
 export { City } from "./types/common/City";
 export { Extra, GetExtrasResponse, GetExtrasForBookingResponse } from "./types/common/Extra";
 export * from "./types/common/dates";
-export { BusLayoutCell, BusMatrix, BusCellTypes, SeatStatus } from "./types/journeys/BusMatrix";
+export { BusLayoutCell, BusMatrix, BusCellTypes, SeatChange, SeatStatus } from "./types/journeys/BusMatrix";
 export { JourneyCart, JourneyBookingType, TripBookingInfo } from "./types/journeys/JourneyCart";
 export { JourneyInfo } from "./types/journeys/JourneyInfo";
 export { JourneySearchRequest, JourneySearchResult, DEFAULT_JOURNEY_SEARCH } from "./types/journeys/JourneySearch";

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

@@ -18,6 +18,17 @@ export type BusLayoutCell = {
  * - On the third dimension, the are the columns.
  */
 export type BusMatrix = BusLayoutCell[][][];
+/**
+ * Explicit (oldSeatId, newSeatId) pair for a single seat change in a
+ * cart. Used by `JourneyBooking.changeSeatsOfTrip` instead of the
+ * legacy positional `newSeatsIds` snapshot — the BE pairs by
+ * `oldSeatId`, so multi-passenger swaps no longer depend on array
+ * order and can never reassign the wrong passenger.
+ */
+export type SeatChange = {
+    oldSeatId: number;
+    newSeatId: number;
+};
 export declare enum BusCellTypes {
     SEAT = "SEAT",
     SELECTED_SEAT = "SELECTED_SEAT",

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

@@ -12,6 +12,8 @@ export type JourneySearchRequest = {
     currency: Booking.Currencies;
     isRoundTrip: boolean;
     outboundTripId?: number | null;
+    lineId?: number | null;
+    routeId?: number | null;
 };
 export declare const DEFAULT_JOURNEY_SEARCH: JourneySearchRequest;
 export type JourneySearchResult = {

package/package.json

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