mts-booking-library 3.6.0 → 3.8.0

package/lib/booking/booking.d.ts

@@ -28,7 +28,7 @@ export declare abstract class Booking {
     /**
      * This is the constructor of the Booking class. See {@link Booking.BookingConfig} for more information.
      */
-    constructor({ env, subKey, bookingType, debug, language, sessionId, accessToken, sellerId, resellerId, appVersion, os, dbType }: Omit<Booking.BookingConfig, "restoreState">);
+    constructor({ env, subKey, bookingType, debug, language, sessionId, accessToken, sellerId, resellerId, appVersion, os, dbType, useLegacyPermissions }: Omit<Booking.BookingConfig, "restoreState">);
     /**
      * This method allows to update the sellerId. It is mostly important for Linkavel, as we start with sellerId = 0
      * but then it changes to the actual sellerId once the cart is created.
@@ -174,5 +174,11 @@ export declare namespace Booking {
         appVersion?: string;
         /** If this library is used from the MTS App, this is the operating system (android or ios) */
         os?: string;
+        /**
+         * Opt into the BE legacy authorization resolver. When provided the value is
+         * forwarded on every request (`useLegacyPermissions` body field for POST/PUT,
+         * query parameter for GET/DELETE). Leave undefined to defer to the BE default.
+         */
+        useLegacyPermissions?: boolean;
     };
 }

package/lib/booking/booking.js

@@ -59,7 +59,7 @@ var Booking = /** @class */ (function () {
      * This is the constructor of the Booking class. See {@link Booking.BookingConfig} for more information.
      */
     function Booking(_a) {
-        var env = _a.env, subKey = _a.subKey, bookingType = _a.bookingType, debug = _a.debug, language = _a.language, sessionId = _a.sessionId, accessToken = _a.accessToken, sellerId = _a.sellerId, resellerId = _a.resellerId, appVersion = _a.appVersion, os = _a.os, dbType = _a.dbType;
+        var env = _a.env, subKey = _a.subKey, bookingType = _a.bookingType, debug = _a.debug, language = _a.language, sessionId = _a.sessionId, accessToken = _a.accessToken, sellerId = _a.sellerId, resellerId = _a.resellerId, appVersion = _a.appVersion, os = _a.os, dbType = _a.dbType, useLegacyPermissions = _a.useLegacyPermissions;
         this.language = Booking.Languages.EN;
         this.selectedCurrency = Booking.Currencies.EUR;
         /**
@@ -81,7 +81,8 @@ var Booking = /** @class */ (function () {
             APP_VERSION: appVersion,
             OS: os,
             DB_TYPE: dbType,
-            SESSION_ID: sessionId
+            SESSION_ID: sessionId,
+            USE_LEGACY_PERMISSIONS: useLegacyPermissions
         });
         this.bookingType = bookingType;
         this.changeLanguage(language);
@@ -111,21 +112,27 @@ var Booking = /** @class */ (function () {
         // Add sellerId, resellerId and language to the query string.
         // If the last character of the url is a question mark (meaning that the query string is empty), don't add the "&" character.
         // Otherwise, add it (as we are adding some parameters to the query string)
-        var completeUrl = "".concat(url).concat(url.slice(-1) === "?" ? "" : "&").concat(new URLSearchParams(__assign(__assign(__assign({ sellerId: (_b = (_a = this.sellerId) === null || _a === void 0 ? void 0 : _a.toString()) !== null && _b !== void 0 ? _b : "0", resellerId: (_d = (_c = this.resellerId) === null || _c === void 0 ? void 0 : _c.toString()) !== null && _d !== void 0 ? _d : "0", language: this.language }, (config.OS && { os: config.OS })), (config.APP_VERSION && { version: config.APP_VERSION })), (config.ENV === config_1.MTSEnvs.DEV && config.DB_TYPE && { databaseType: config.DB_TYPE }))));
+        var completeUrl = "".concat(url).concat(url.slice(-1) === "?" ? "" : "&").concat(new URLSearchParams(__assign(__assign(__assign(__assign({ sellerId: (_b = (_a = this.sellerId) === null || _a === void 0 ? void 0 : _a.toString()) !== null && _b !== void 0 ? _b : "0", resellerId: (_d = (_c = this.resellerId) === null || _c === void 0 ? void 0 : _c.toString()) !== null && _d !== void 0 ? _d : "0", language: this.language }, (config.OS && { os: config.OS })), (config.APP_VERSION && { version: config.APP_VERSION })), (config.ENV === config_1.MTSEnvs.DEV && config.DB_TYPE && { databaseType: config.DB_TYPE })), (config.USE_LEGACY_PERMISSIONS !== undefined && {
+            useLegacyPermissions: String(config.USE_LEGACY_PERMISSIONS)
+        }))));
         return (0, apiCall_1.makeGet)(completeUrl, options);
     };
     Booking.prototype.callPostApi = function (url, body, options) {
         var _a, _b, _c, _d;
         var config = (0, config_1.getConfig)();
         // Add sellerId, resellerId and language to the query string
-        var completeBody = __assign(__assign(__assign(__assign(__assign({}, body), { sellerId: (_b = (_a = this.sellerId) === null || _a === void 0 ? void 0 : _a.toString()) !== null && _b !== void 0 ? _b : 0, resellerId: (_d = (_c = this.resellerId) === null || _c === void 0 ? void 0 : _c.toString()) !== null && _d !== void 0 ? _d : 0, language: this.language }), (config.OS && { os: config.OS })), (config.APP_VERSION && { version: config.APP_VERSION })), (config.ENV === config_1.MTSEnvs.DEV && config.DB_TYPE && { databaseType: config.DB_TYPE }));
+        var completeBody = __assign(__assign(__assign(__assign(__assign(__assign({}, body), { sellerId: (_b = (_a = this.sellerId) === null || _a === void 0 ? void 0 : _a.toString()) !== null && _b !== void 0 ? _b : 0, resellerId: (_d = (_c = this.resellerId) === null || _c === void 0 ? void 0 : _c.toString()) !== null && _d !== void 0 ? _d : 0, language: this.language }), (config.OS && { os: config.OS })), (config.APP_VERSION && { version: config.APP_VERSION })), (config.ENV === config_1.MTSEnvs.DEV && config.DB_TYPE && { databaseType: config.DB_TYPE })), (config.USE_LEGACY_PERMISSIONS !== undefined && {
+            useLegacyPermissions: config.USE_LEGACY_PERMISSIONS
+        }));
         return (0, apiCall_1.makePost)(url, completeBody, options);
     };
     Booking.prototype.callPutApi = function (url, body, options) {
         var _a, _b, _c, _d;
         var config = (0, config_1.getConfig)();
         // Add sellerId, resellerId and language to the query string
-        var completeBody = __assign(__assign(__assign(__assign(__assign({}, body), { sellerId: (_b = (_a = this.sellerId) === null || _a === void 0 ? void 0 : _a.toString()) !== null && _b !== void 0 ? _b : 0, resellerId: (_d = (_c = this.resellerId) === null || _c === void 0 ? void 0 : _c.toString()) !== null && _d !== void 0 ? _d : 0, language: this.language }), (config.OS && { os: config.OS })), (config.APP_VERSION && { version: config.APP_VERSION })), (config.ENV === config_1.MTSEnvs.DEV && config.DB_TYPE && { databaseType: config.DB_TYPE }));
+        var completeBody = __assign(__assign(__assign(__assign(__assign(__assign({}, body), { sellerId: (_b = (_a = this.sellerId) === null || _a === void 0 ? void 0 : _a.toString()) !== null && _b !== void 0 ? _b : 0, resellerId: (_d = (_c = this.resellerId) === null || _c === void 0 ? void 0 : _c.toString()) !== null && _d !== void 0 ? _d : 0, language: this.language }), (config.OS && { os: config.OS })), (config.APP_VERSION && { version: config.APP_VERSION })), (config.ENV === config_1.MTSEnvs.DEV && config.DB_TYPE && { databaseType: config.DB_TYPE })), (config.USE_LEGACY_PERMISSIONS !== undefined && {
+            useLegacyPermissions: config.USE_LEGACY_PERMISSIONS
+        }));
         return (0, apiCall_1.makePut)(url, completeBody, options);
     };
     Booking.prototype.callDeleteApi = function (url, options) {
@@ -134,7 +141,9 @@ var Booking = /** @class */ (function () {
         // Add sellerId, resellerId and language to the query string.
         // If the last character of the url is a question mark (meaning that the query string is empty), don't add the "&" character.
         // Otherwise, add it (as we are adding some parameters to the query string)
-        var completeUrl = "".concat(url).concat(url.slice(-1) === "?" ? "" : "&").concat(new URLSearchParams(__assign(__assign(__assign({ sellerId: (_b = (_a = this.sellerId) === null || _a === void 0 ? void 0 : _a.toString()) !== null && _b !== void 0 ? _b : "0", resellerId: (_d = (_c = this.resellerId) === null || _c === void 0 ? void 0 : _c.toString()) !== null && _d !== void 0 ? _d : "0", language: this.language }, (config.OS && { os: config.OS })), (config.APP_VERSION && { version: config.APP_VERSION })), (config.ENV === config_1.MTSEnvs.DEV && config.DB_TYPE && { databaseType: config.DB_TYPE }))));
+        var completeUrl = "".concat(url).concat(url.slice(-1) === "?" ? "" : "&").concat(new URLSearchParams(__assign(__assign(__assign(__assign({ sellerId: (_b = (_a = this.sellerId) === null || _a === void 0 ? void 0 : _a.toString()) !== null && _b !== void 0 ? _b : "0", resellerId: (_d = (_c = this.resellerId) === null || _c === void 0 ? void 0 : _c.toString()) !== null && _d !== void 0 ? _d : "0", language: this.language }, (config.OS && { os: config.OS })), (config.APP_VERSION && { version: config.APP_VERSION })), (config.ENV === config_1.MTSEnvs.DEV && config.DB_TYPE && { databaseType: config.DB_TYPE })), (config.USE_LEGACY_PERMISSIONS !== undefined && {
+            useLegacyPermissions: String(config.USE_LEGACY_PERMISSIONS)
+        }))));
         return (0, apiCall_1.makeDelete)(completeUrl, options);
     };
     Booking.prototype.getBookingStepsToStatus = function () {

package/lib/booking/journeyBooking.d.ts

@@ -28,7 +28,7 @@ export declare class JourneyBooking extends Booking {
     /**
      * This is the constructor of the JourneyBooking class. See {@link Booking.BookingConfig} for more information.
      */
-    constructor({ env, subKey, debug, language, sessionId, restoreState, accessToken, sellerId, resellerId, appVersion, os, dbType }: Omit<Booking.BookingConfig, "bookingType">);
+    constructor({ env, subKey, debug, language, sessionId, restoreState, accessToken, sellerId, resellerId, appVersion, os, dbType, useLegacyPermissions }: Omit<Booking.BookingConfig, "bookingType">);
     getCart(): JourneyCart | undefined;
     getStorage(): import("zustand").UseBoundStore<Omit<import("zustand").StoreApi<{
         cartGuid: string | undefined;

package/lib/booking/journeyBooking.js

@@ -105,7 +105,7 @@ var JourneyBooking = /** @class */ (function (_super) {
      * This is the constructor of the JourneyBooking class. See {@link Booking.BookingConfig} for more information.
      */
     function JourneyBooking(_a) {
-        var env = _a.env, subKey = _a.subKey, debug = _a.debug, language = _a.language, sessionId = _a.sessionId, restoreState = _a.restoreState, accessToken = _a.accessToken, sellerId = _a.sellerId, resellerId = _a.resellerId, appVersion = _a.appVersion, os = _a.os, dbType = _a.dbType;
+        var env = _a.env, subKey = _a.subKey, debug = _a.debug, language = _a.language, sessionId = _a.sessionId, restoreState = _a.restoreState, accessToken = _a.accessToken, sellerId = _a.sellerId, resellerId = _a.resellerId, appVersion = _a.appVersion, os = _a.os, dbType = _a.dbType, useLegacyPermissions = _a.useLegacyPermissions;
         // Call Booking constructor
         var _this = _super.call(this, {
             env: env,
@@ -119,7 +119,8 @@ var JourneyBooking = /** @class */ (function (_super) {
             resellerId: resellerId,
             appVersion: appVersion,
             os: os,
-            dbType: dbType
+            dbType: dbType,
+            useLegacyPermissions: useLegacyPermissions
         }) || this;
         // Set cartGuid
         var cartGuid = _this.getStorage().getState().cartGuid;

package/lib/booking/serviceBooking.d.ts

@@ -12,7 +12,7 @@ export declare class ServiceBooking extends Booking {
     /**
      * This is the constructor of the ServiceBooking class. See {@link Booking.BookingConfig} for more information.
      */
-    constructor({ env, subKey, debug, language, sessionId, restoreState, accessToken, sellerId, resellerId, appVersion, os, dbType }: Omit<Booking.BookingConfig, "bookingType">);
+    constructor({ env, subKey, debug, language, sessionId, restoreState, accessToken, sellerId, resellerId, appVersion, os, dbType, useLegacyPermissions }: Omit<Booking.BookingConfig, "bookingType">);
     getStorage(): import("zustand").UseBoundStore<Omit<import("zustand").StoreApi<{
         cartGuid: string | undefined;
     } & {

package/lib/booking/serviceBooking.js

@@ -85,7 +85,7 @@ var ServiceBooking = /** @class */ (function (_super) {
      * This is the constructor of the ServiceBooking class. See {@link Booking.BookingConfig} for more information.
      */
     function ServiceBooking(_a) {
-        var env = _a.env, subKey = _a.subKey, debug = _a.debug, language = _a.language, sessionId = _a.sessionId, restoreState = _a.restoreState, accessToken = _a.accessToken, sellerId = _a.sellerId, resellerId = _a.resellerId, appVersion = _a.appVersion, os = _a.os, dbType = _a.dbType;
+        var env = _a.env, subKey = _a.subKey, debug = _a.debug, language = _a.language, sessionId = _a.sessionId, restoreState = _a.restoreState, accessToken = _a.accessToken, sellerId = _a.sellerId, resellerId = _a.resellerId, appVersion = _a.appVersion, os = _a.os, dbType = _a.dbType, useLegacyPermissions = _a.useLegacyPermissions;
         // Call Booking constructor
         var _this = _super.call(this, {
             env: env,
@@ -99,7 +99,8 @@ var ServiceBooking = /** @class */ (function (_super) {
             resellerId: resellerId,
             appVersion: appVersion,
             os: os,
-            dbType: dbType
+            dbType: dbType,
+            useLegacyPermissions: useLegacyPermissions
         }) || this;
         // Set cartGuid
         var cartGuid = _this.getStorage().getState().cartGuid;

package/lib/booking/subscriptionBooking.d.ts

@@ -12,7 +12,7 @@ export declare class SubscriptionBooking extends Booking {
     /**
      * This is the constructor of the ServiceBooking class. See {@link Booking.BookingConfig} for more information.
      */
-    constructor({ env, subKey, debug, language, sessionId, restoreState, accessToken, sellerId, resellerId, appVersion, os, dbType }: Omit<Booking.BookingConfig, "bookingType">);
+    constructor({ env, subKey, debug, language, sessionId, restoreState, accessToken, sellerId, resellerId, appVersion, os, dbType, useLegacyPermissions }: Omit<Booking.BookingConfig, "bookingType">);
     getStorage(): import("zustand").UseBoundStore<Omit<import("zustand").StoreApi<{
         cartGuid: string | undefined;
     } & {

package/lib/booking/subscriptionBooking.js

@@ -85,7 +85,7 @@ var SubscriptionBooking = /** @class */ (function (_super) {
      * This is the constructor of the ServiceBooking class. See {@link Booking.BookingConfig} for more information.
      */
     function SubscriptionBooking(_a) {
-        var env = _a.env, subKey = _a.subKey, debug = _a.debug, language = _a.language, sessionId = _a.sessionId, restoreState = _a.restoreState, accessToken = _a.accessToken, sellerId = _a.sellerId, resellerId = _a.resellerId, appVersion = _a.appVersion, os = _a.os, dbType = _a.dbType;
+        var env = _a.env, subKey = _a.subKey, debug = _a.debug, language = _a.language, sessionId = _a.sessionId, restoreState = _a.restoreState, accessToken = _a.accessToken, sellerId = _a.sellerId, resellerId = _a.resellerId, appVersion = _a.appVersion, os = _a.os, dbType = _a.dbType, useLegacyPermissions = _a.useLegacyPermissions;
         // Call Booking constructor
         var _this = _super.call(this, {
             env: env,
@@ -99,7 +99,8 @@ var SubscriptionBooking = /** @class */ (function (_super) {
             resellerId: resellerId,
             appVersion: appVersion,
             os: os,
-            dbType: dbType
+            dbType: dbType,
+            useLegacyPermissions: useLegacyPermissions
         }) || this;
         // Set cartGuid
         var cartGuid = _this.getStorage().getState().cartGuid;

package/lib/booking/tplBooking.d.ts

@@ -1,7 +1,7 @@
 import { ErrorResponse } from "../types/ErrorResponse";
 import { CreateUpdateCartRequest } from "../types/common/Cart";
 import { City } from "../types/common/City";
-import { GetBuyerPassengersDetailsResponse, Person } from "../types/common/Person";
+import { EditPassengersDetailsRequest, GetBuyerPassengersDetailsResponse, Person } from "../types/common/Person";
 import { AddReductionRequest } from "../types/common/Reduction";
 import { TariffType, TermsType } from "../types/common/Tariffs";
 import { GetTariffsResponse } from "../types/tpl/GetTariffsResponse";
@@ -20,7 +20,7 @@ export declare class TplBooking extends Booking {
     /**
      * This is the constructor of the TplBooking class. See {@link Booking.BookingConfig} for more information.
      */
-    constructor({ env, subKey, debug, language, sessionId, restoreState, accessToken, sellerId, resellerId, appVersion, os, dbType }: Omit<Booking.BookingConfig, "bookingType">);
+    constructor({ env, subKey, debug, language, sessionId, restoreState, accessToken, sellerId, resellerId, appVersion, os, dbType, useLegacyPermissions }: Omit<Booking.BookingConfig, "bookingType">);
     getStorage(): import("zustand").UseBoundStore<Omit<import("zustand").StoreApi<{
         cartGuid: string | undefined;
     } & {
@@ -179,14 +179,28 @@ export declare class TplBooking extends Booking {
      */
     getBuyerPassengersDetails(options?: ApiCallOptions): Promise<ErrorResponse | GetBuyerPassengersDetailsResponse>;
     /**
-     * @description This method shall be called when the user wants to update 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}).
-     * @param subscriptionPersonCode The person code of the passenger that is associated
-     * with the subscription. This parameter is required if the cart contains a subscription.
+     * @description Update the buyer and (optionally) per-passenger data for a TPL cart.
+     *
+     * Two shapes are supported:
+     *
+     * 1. Legacy buyer-only / subscription form: pass `(buyer, subscriptionPersonCode?)`.
+     *    Used by plain TPL bookings and by TPLSubscription, where only the buyer's data
+     *    (plus optionally the subscription holder's PersonCode) is editable.
+     *
+     * 2. Full request form: pass an `EditPassengersDetailsRequest` (mirrors
+     *    {@link JourneyBooking.updateBuyerPassengersDetails}). Used by TPL_TOUR
+     *    bookings, where each ticket has its own passenger with Name/LastName/Email/
+     *    PhoneNumber/Sex. Per-passenger `tripsToTariffs` is serialized to JSON like
+     *    Journey does; pass an empty Map for TPL_TOUR (single Trip, fixed tariff).
+     *
+     * @param payload Either a {@link Person} (or null) for the legacy form, or an
+     * {@link EditPassengersDetailsRequest} for the full form.
+     * @param subscriptionPersonCode The person code of the passenger associated with the
+     * subscription. Required when the cart contains a TPLSubscription. Ignored when
+     * `payload` is an `EditPassengersDetailsRequest`.
      * @returns An {@link ErrorResponse} object in case of error, true otherwise.
      */
-    updateBuyerPassengersDetails(buyerDetails: Person | null, subscriptionPersonCode?: string, options?: ApiCallOptions): Promise<ErrorResponse | boolean>;
+    updateBuyerPassengersDetails(payload: Person | null | EditPassengersDetailsRequest, subscriptionPersonCode?: string, options?: ApiCallOptions): Promise<ErrorResponse | boolean>;
     /**
      * @description This method allows to add a reduction to the whole cart or to a single trip in the cart.
      * @param request The information about the reduction to add

package/lib/booking/tplBooking.js

@@ -86,13 +86,25 @@ var TplTariffClassificationType;
     TplTariffClassificationType["TPL_TOUR"] = "TARIFF_TYPE_TPL_TOUR";
     TplTariffClassificationType["TPL_SUBSCRIPTION"] = "TARIFF_TYPE_TPL_SUBSCRIPTION";
 })(TplTariffClassificationType || (exports.TplTariffClassificationType = TplTariffClassificationType = {}));
+/**
+ * Type guard for the full-request shape of
+ * {@link TplBooking.updateBuyerPassengersDetails}. `Person` does not declare a
+ * `passengers` field, so the presence of an array there discriminates the new
+ * TPL_TOUR contract from the legacy `(buyer, subscriptionPersonCode?)` form.
+ */
+function isEditPassengersDetailsRequest(payload) {
+    return (payload !== null &&
+        typeof payload === "object" &&
+        "passengers" in payload &&
+        Array.isArray(payload.passengers));
+}
 var TplBooking = /** @class */ (function (_super) {
     __extends(TplBooking, _super);
     /**
      * This is the constructor of the TplBooking class. See {@link Booking.BookingConfig} for more information.
      */
     function TplBooking(_a) {
-        var env = _a.env, subKey = _a.subKey, debug = _a.debug, language = _a.language, sessionId = _a.sessionId, restoreState = _a.restoreState, accessToken = _a.accessToken, sellerId = _a.sellerId, resellerId = _a.resellerId, appVersion = _a.appVersion, os = _a.os, dbType = _a.dbType;
+        var env = _a.env, subKey = _a.subKey, debug = _a.debug, language = _a.language, sessionId = _a.sessionId, restoreState = _a.restoreState, accessToken = _a.accessToken, sellerId = _a.sellerId, resellerId = _a.resellerId, appVersion = _a.appVersion, os = _a.os, dbType = _a.dbType, useLegacyPermissions = _a.useLegacyPermissions;
         // Call Booking constructor
         var _this = _super.call(this, {
             env: env,
@@ -106,7 +118,8 @@ var TplBooking = /** @class */ (function (_super) {
             resellerId: resellerId,
             appVersion: appVersion,
             os: os,
-            dbType: dbType
+            dbType: dbType,
+            useLegacyPermissions: useLegacyPermissions
         }) || this;
         // Set cartGuid
         var cartGuid = _this.getStorage().getState().cartGuid;
@@ -253,7 +266,7 @@ var TplBooking = /** @class */ (function (_super) {
         return __awaiter(this, void 0, void 0, function () {
             var searchParams, url;
             return __generator(this, function (_a) {
-                searchParams = new URLSearchParams(__assign(__assign(__assign({ includeBasicInfo: "true", includeImage: "true", includeAreaIds: "false", includeTariffIds: "false", includeRouteIds: "false", includeMultilingualDescriptions: "false" }, (request.cityId && { cityId: request.cityId.toString() })), (request.tripId && { tripId: request.tripId.toString() })), (request.type && { type: request.type })));
+                searchParams = new URLSearchParams(__assign(__assign(__assign({ includeBasicInfo: "true", includeImage: "true", includeAreaIds: "false", includeTariffIds: "false", includeRouteIds: "false", includeMultilingualDescriptions: request.includeMultilingualDescriptions ? "true" : "false" }, (request.cityId && { cityId: request.cityId.toString() })), (request.tripId && { tripId: request.tripId.toString() })), (request.type && { type: request.type })));
                 url = "".concat(this.config.API_ENDPOINT, "/v3_resources/superAreas?").concat(searchParams);
                 return [2 /*return*/, this.callGetApi(url, options).then(function (response) {
                         return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response) ? response : response.superAreas;
@@ -432,41 +445,69 @@ var TplBooking = /** @class */ (function (_super) {
         });
     };
     /**
-     * @description This method shall be called when the user wants to update 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}).
-     * @param subscriptionPersonCode The person code of the passenger that is associated
-     * with the subscription. This parameter is required if the cart contains a subscription.
+     * @description Update the buyer and (optionally) per-passenger data for a TPL cart.
+     *
+     * Two shapes are supported:
+     *
+     * 1. Legacy buyer-only / subscription form: pass `(buyer, subscriptionPersonCode?)`.
+     *    Used by plain TPL bookings and by TPLSubscription, where only the buyer's data
+     *    (plus optionally the subscription holder's PersonCode) is editable.
+     *
+     * 2. Full request form: pass an `EditPassengersDetailsRequest` (mirrors
+     *    {@link JourneyBooking.updateBuyerPassengersDetails}). Used by TPL_TOUR
+     *    bookings, where each ticket has its own passenger with Name/LastName/Email/
+     *    PhoneNumber/Sex. Per-passenger `tripsToTariffs` is serialized to JSON like
+     *    Journey does; pass an empty Map for TPL_TOUR (single Trip, fixed tariff).
+     *
+     * @param payload Either a {@link Person} (or null) for the legacy form, or an
+     * {@link EditPassengersDetailsRequest} for the full form.
+     * @param subscriptionPersonCode The person code of the passenger associated with the
+     * subscription. Required when the cart contains a TPLSubscription. Ignored when
+     * `payload` is an `EditPassengersDetailsRequest`.
      * @returns An {@link ErrorResponse} object in case of error, true otherwise.
      */
-    TplBooking.prototype.updateBuyerPassengersDetails = function (buyerDetails, subscriptionPersonCode, options) {
+    TplBooking.prototype.updateBuyerPassengersDetails = function (payload, subscriptionPersonCode, options) {
         return __awaiter(this, void 0, void 0, function () {
-            var buyerPassengersDetails, request, url;
+            var buyerPassengersDetails, request, buyerDetails, url;
             var _this = this;
             return __generator(this, function (_a) {
                 // First check that it is possible to call this API
                 if (!this.cart) {
                     throw Error("Cart is not initialized yet");
                 }
-                if (this.cart.bookings.some(function (b) { return b.info.isSubscription && b.type === TplBooking.BookingTypes.TPL; }) &&
-                    !subscriptionPersonCode) {
-                    throw Error("The subscriptionPersonCode is required when updating a subscription");
-                }
                 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");
                 }
-                request = {
-                    cartGuid: this.cart.guid,
-                    buyer: buyerDetails,
-                    passengers: subscriptionPersonCode
-                        ? [
-                            {
-                                personCode: subscriptionPersonCode
-                            }
-                        ]
-                        : []
-                };
+                if (isEditPassengersDetailsRequest(payload)) {
+                    request = __assign(__assign({}, payload), { cartGuid: this.cart.guid });
+                    // Mirror JourneyBooking: convert per-passenger tripsToTariffs Map → JSON
+                    // object. Mutates in-place; safe because `request` is a fresh shallow copy
+                    // and the payload's passengers are read immediately before the API call.
+                    payload.passengers.forEach(function (passenger, passengerIndex) {
+                        var _a;
+                        var tripsToTariffsToJson = {};
+                        (_a = passenger.tripsToTariffs) === null || _a === void 0 ? void 0 : _a.forEach(function (value, key) {
+                            tripsToTariffsToJson[String(key)] = value;
+                        });
+                        request.passengers[passengerIndex].tripsToTariffs =
+                            tripsToTariffsToJson;
+                    });
+                }
+                else {
+                    buyerDetails = payload;
+                    if (this.cart.bookings.some(function (b) { return b.info.isSubscription && b.type === TplBooking.BookingTypes.TPL; }) &&
+                        !subscriptionPersonCode) {
+                        throw Error("The subscriptionPersonCode is required when updating a subscription");
+                    }
+                    request = {
+                        cartGuid: this.cart.guid,
+                        buyer: buyerDetails,
+                        passengers: subscriptionPersonCode
+                            ? [{ personCode: subscriptionPersonCode }]
+                            : []
+                    };
+                }
                 url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/details");
                 return [2 /*return*/, this.callPostApi(url, request, options).then(function (response) {
                         if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response))

package/lib/config.d.ts

@@ -14,6 +14,13 @@ export type MTSConfig = {
     OS: string | undefined;
     DB_TYPE: string | undefined;
     SESSION_ID: number | undefined;
+    /**
+     * Per-call opt-in for the BE legacy authorization resolver. When set,
+     * `useLegacyPermissions` is added to every POST/PUT body and propagated as
+     * `useLegacyPermissions` on GET/DELETE query strings. Leave undefined to let
+     * the BE pick its own default (currently legacy at the time of writing).
+     */
+    USE_LEGACY_PERMISSIONS: boolean | undefined;
 };
-export declare const setConfig: ({ ENV, OCP_SUBSCRIPTION_KEY, DEBUG, ACCESS_TOKEN, APP_VERSION, OS, DB_TYPE, SESSION_ID }: Omit<MTSConfig, "API_ENDPOINT">) => MTSConfig;
+export declare const setConfig: ({ ENV, OCP_SUBSCRIPTION_KEY, DEBUG, ACCESS_TOKEN, APP_VERSION, OS, DB_TYPE, SESSION_ID, USE_LEGACY_PERMISSIONS }: Omit<MTSConfig, "API_ENDPOINT">) => MTSConfig;
 export declare const getConfig: () => MTSConfig;

package/lib/config.js

@@ -17,10 +17,11 @@ var config = {
     APP_VERSION: undefined,
     OS: undefined,
     DB_TYPE: undefined,
-    SESSION_ID: undefined
+    SESSION_ID: undefined,
+    USE_LEGACY_PERMISSIONS: undefined
 };
 var setConfig = function (_a) {
-    var ENV = _a.ENV, OCP_SUBSCRIPTION_KEY = _a.OCP_SUBSCRIPTION_KEY, DEBUG = _a.DEBUG, ACCESS_TOKEN = _a.ACCESS_TOKEN, APP_VERSION = _a.APP_VERSION, OS = _a.OS, DB_TYPE = _a.DB_TYPE, SESSION_ID = _a.SESSION_ID;
+    var ENV = _a.ENV, OCP_SUBSCRIPTION_KEY = _a.OCP_SUBSCRIPTION_KEY, DEBUG = _a.DEBUG, ACCESS_TOKEN = _a.ACCESS_TOKEN, APP_VERSION = _a.APP_VERSION, OS = _a.OS, DB_TYPE = _a.DB_TYPE, SESSION_ID = _a.SESSION_ID, USE_LEGACY_PERMISSIONS = _a.USE_LEGACY_PERMISSIONS;
     config.DB_TYPE = undefined;
     // First, set the environment
     config.ENV = ENV.toUpperCase();
@@ -48,6 +49,7 @@ var setConfig = function (_a) {
     // Set app variables
     config.OS = OS;
     config.APP_VERSION = APP_VERSION;
+    config.USE_LEGACY_PERMISSIONS = USE_LEGACY_PERMISSIONS;
     return config;
 };
 exports.setConfig = setConfig;

package/lib/index.d.ts

@@ -27,7 +27,7 @@ export { Service, ServiceTrip } from "./types/services/Service";
 export { ServiceCart, ServiceBookingType } from "./types/services/ServiceCart";
 export { ServiceInfo } from "./types/services/ServiceInfo";
 export { GetTariffsResponse } from "./types/tpl/GetTariffsResponse";
-export { SuperArea, GetSuperAreasRequest, GetCitiesRequest, SuperAreasTypeFilter } from "./types/tpl/SuperArea";
+export { SuperArea, MTSStringDTO, GetSuperAreasRequest, GetCitiesRequest, SuperAreasTypeFilter } from "./types/tpl/SuperArea";
 export { TplCart, TplBookingType, TplBookingInfo } from "./types/tpl/TplCart";
 export { Subscription } from "./types/subscriptions/Subscriptions";
 export { GetSubscriptionAvailabilityRequest, GetSubscriptionAvailabilityResponse, SubscriptionCalendarDayPeriodInfo } from "./types/subscriptions/SubscriptionAvailabilities";

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

@@ -1,3 +1,16 @@
+/**
+ * Multilingual string returned by the backend. Each key holds the
+ * translation for that language; consumers should fall back to `it`
+ * when the active language is missing, matching the backend's
+ * `MTSStringDTO.GetValue` resolution rules.
+ */
+export type MTSStringDTO = {
+    en: string | null;
+    it: string | null;
+    fr: string | null;
+    de: string | null;
+    es: string | null;
+};
 /** This type represents a super area. It is the return object of the {@link TplBooking.getSuperAreas} method. */
 export type SuperArea = {
     /** The id of the super area in the database */
@@ -12,6 +25,11 @@ export type SuperArea = {
     bookingProcessDescription: string;
     /** The url of the image of the super area */
     imageUrl: string;
+    /**
+     * LinkAvel-specific multilingual description. Only present when the
+     * request is made with `includeMultilingualDescriptions: true`.
+     */
+    linkAvelDescription?: MTSStringDTO;
 };
 export declare enum SuperAreasTypeFilter {
     /** No filter applied (default). */
@@ -33,6 +51,12 @@ export type GetSuperAreasRequest = {
      * A super area cannot simultaneously be a tour and a regular super area.
      */
     type?: SuperAreasTypeFilter;
+    /**
+     * When true, the response includes the multilingual `linkAvelDescription`
+     * field on each super area. Defaults to false to keep payloads minimal
+     * for callers that only need basic info.
+     */
+    includeMultilingualDescriptions?: boolean;
 };
 /** Request options for {@link TplBooking.getCities}. */
 export type GetCitiesRequest = {

package/package.json

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