btrz-api-client 8.33.0 → 8.35.0

package/lib/endpoints/inventory/products.js

@@ -48,7 +48,9 @@ function productsFactory(_ref) {
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {ProductsListQuery} [opts.query] - Query params
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ products: Array<object> }>>}
+   *   Resolves with list of products; response.data has Products shape.
+   * @throws When the request fails (400 invalid channels, 401 unauthorized, 500). ErrorResponse body.
    */
   function all(_ref2) {
     var token = _ref2.token,
@@ -71,7 +73,9 @@ function productsFactory(_ref) {
    * @param {string} opts.productId - Product id
    * @param {ProductGetQuery} [opts.query] - Query params (providerIds, channels, enabled)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ product: object }>>}
+   *   Resolves with single product; response.data.product is the Product.
+   * @throws When the request fails (400/401/404/500). Body: INVALID_PRODUCTID, WRONG_DATA, PRODUCT_NOTFOUND.
    */
   function get(_ref3) {
     var productId = _ref3.productId,
@@ -89,13 +93,16 @@ function productsFactory(_ref) {
   }
 
   /**
-   * POST /products - create product. API does not accept query params.
+   * POST /products - create product. No query params. Requires BETTEREZ_APP JWT or API key.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {Object} opts.data - Product payload
+   * @param {Object} opts.data - Product payload (PostedProduct); must not include _id.
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ product: object }>>}
+   *   Resolves with the created product.
+   * @throws When the request fails (400/401/500). Body: DUPLICATE_PRODUCT, CANNOT_CREATE_PRODUCT_WITH_ID,
+   *   INVALID_PAYMENT_METHODS, INVALID_PARENT_PRODUCT_ID, INVALID_JOURNEY_RESTRICTIONS, INVALID_PRODUCT_NAME, etc.
    */
   function create(_ref4) {
     var data = _ref4.data,
@@ -112,14 +119,17 @@ function productsFactory(_ref) {
   }
 
   /**
-   * PUT /products/:productId - update product. API does not accept query params.
+   * PUT /products/:productId - update product. No query params. Requires BETTEREZ_APP JWT or API key.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.productId - Product id
-   * @param {Object} opts.data - Product payload
+   * @param {Object} opts.data - Product payload (PostedProduct).
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ product: object }>>}
+   *   Resolves with the updated product. Emits product.updated webhook.
+   * @throws When the request fails (400/401/404/500). Body: NOT_FOUND, INVALID_PAYMENT_METHODS,
+   *   CANNOT_SET_PARENT_AS_CHILD, INVALID_JOURNEY_RESTRICTIONS, INVALID_PRODUCT_NAME, etc.
    */
   function update(_ref5) {
     var productId = _ref5.productId,
@@ -145,7 +155,8 @@ function productsFactory(_ref) {
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
      * @param {string} opts.domain - Domain
      * @param {Object} [opts.headers] - Optional headers
-     * @returns {Promise<import("axios").AxiosResponse>}
+     * @returns {Promise<import("axios").AxiosResponse>} Resolves on success. May emit product.updated.
+     * @throws When the request fails (401, 404, 500).
      */
     remove: function remove(_ref6) {
       var token = _ref6.token,
@@ -169,7 +180,8 @@ function productsFactory(_ref) {
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
      * @param {Object} [opts.headers] - Optional headers
-     * @returns {Promise<import("axios").AxiosResponse>}
+     * @returns {Promise<import("axios").AxiosResponse>} Resolves with list of product families.
+     * @throws When the request fails (401, 500).
      */
     all: function all(_ref7) {
       var token = _ref7.token,

package/lib/endpoints/inventory/promos.js

@@ -48,7 +48,9 @@ function promosFactory(_ref) {
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {PromosListQuery} [opts.query] - Query params
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ promos: Array<object>, total: number }>>}
+   *   Resolves with paginated promos; response.data has Promos shape.
+   * @throws When the request fails (400/401/404/500). Body: WRONG_DATA, PROMO_NOT_FOUND.
    */
   function all(_ref2) {
     var token = _ref2.token,
@@ -85,13 +87,15 @@ function promosFactory(_ref) {
   }
 
   /**
-   * POST /promos - create promo. API does not accept query params.
+   * POST /promos - create promo. No query params. Requires BETTEREZ_APP JWT or API key. Emits promo.created.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {Object} opts.promo - Promo payload
+   * @param {Object} opts.promo - Promo payload (PromoUpdateRequest); must not include _id.
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<object>>} Resolves with created Promo.
+   * @throws When the request fails (400/401/500). Body: WRONG_DATA, INTERNALID_USED,
+   *   CANNOT_CREATE_PROMO_WITH_ID, INVALID_PAYMENT_METHOD_TYPE, etc.
    */
   function create(_ref4) {
     var jwtToken = _ref4.jwtToken,
@@ -108,13 +112,14 @@ function promosFactory(_ref) {
   }
 
   /**
-   * DELETE /promos/:promoId - remove promo. API does not accept query params.
+   * DELETE /promos/:promoId - disable promo (soft delete). No query params. Requires BETTEREZ_APP. Emits promo.deleted.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.promoId - Promo id
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse>} Resolves with disabled promo.
+   * @throws When the request fails (400/401/404/500). Body: WRONG_DATA, INVALID_PROMO_ID, PROMO_NOT_FOUND.
    */
   function remove(_ref5) {
     var jwtToken = _ref5.jwtToken,
@@ -130,14 +135,15 @@ function promosFactory(_ref) {
   }
 
   /**
-   * PATCH /promos/:promoId - update promo. API does not accept query params.
+   * PATCH /promos/:promoId - update promo (partial). No query params. Requires BETTEREZ_APP. Emits promo.updated.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.promoId - Promo id
-   * @param {Object} opts.update - Update payload
+   * @param {Object} opts.update - Partial update (PromoUpdateRequest).
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<object>>} Resolves with updated Promo.
+   * @throws When the request fails (400/401/404/500). Body: WRONG_DATA, INTERNALID_USED, PROMO_NOT_FOUND, etc.
    */
   // eslint-disable-next-line no-shadow
   function update(_ref6) {
@@ -156,14 +162,15 @@ function promosFactory(_ref) {
   }
 
   /**
-   * PATCH /promo/:promoId - patch promo with operations. API does not accept query params.
+   * PATCH /promo/:promoId - update rule availability (add/subtract). No query params. Emits promo.updated.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.promoId - Promo id
-   * @param {Object} opts.operations - Patch operations
+   * @param {Object} opts.operations - Array of PromoUpdateOperation (op, path, value).
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<object>>} Resolves with PatchedPromos.
+   * @throws When the request fails (400/401/404/500).
    */
   function patch(_ref7) {
     var jwtToken = _ref7.jwtToken,
@@ -181,14 +188,15 @@ function promosFactory(_ref) {
   }
 
   /**
-   * POST /promos/:promoId/rules - add promo rule. API does not accept query params.
+   * POST /promos/:promoId/rules - add promo rule. No query params. Requires BETTEREZ_APP. May emit promo.updated.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.promoId - Promo id
-   * @param {Object} opts.rule - Rule payload
+   * @param {Object} opts.rule - Rule payload (PromoRule).
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<object>>} Resolves with Promo including new rule.
+   * @throws When the request fails (400/401/404/500). Body: WRONG_DATA, INVALID_PRODUCT_ID, INVALID_FARE_ID, etc.
    */
   function addRule(_ref8) {
     var jwtToken = _ref8.jwtToken,
@@ -206,15 +214,16 @@ function promosFactory(_ref) {
   }
 
   /**
-   * PUT /promos/:promoId/rules/:ruleId - update promo rule. API does not accept query params.
+   * PUT /promos/:promoId/rules/:ruleId - update promo rule. No query params. Requires BETTEREZ_APP. Emits promo.updated.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.promoId - Promo id
    * @param {string} opts.ruleId - Rule id
-   * @param {Object} opts.rule - Rule payload
+   * @param {Object} opts.rule - Full rule payload (PromoRule).
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<object>>} Resolves with updated Promo.
+   * @throws When the request fails (400/401/404/500). Body: WRONG_DATA, INVALID_PRODUCT_ID, INVALID_FARE_ID, etc.
    */
   function updateRule(_ref9) {
     var jwtToken = _ref9.jwtToken,

package/lib/endpoints/inventory/segments-information-tables.js

@@ -1,12 +1,13 @@
 "use strict";
 
+/* eslint-disable max-len */
 var _require = require("./../endpoints_helpers.js"),
     authorizationHeaders = _require.authorizationHeaders;
 
 /**
  * Query params for GET /segments-information-tables/:routeId (btrz-api-inventory-trips). See get-by-id-handler getSpec().
  * @typedef {Object} SegmentsInformationTablesQuery
- * @property {string} [providerId] - Provider id of the route if not the same as the user making the request (ObjectId format)
+ * @property {string} [providerId] - Provider/account id of the route when different from the authenticated user (24-char hex ObjectId)
  */
 
 /**
@@ -23,14 +24,18 @@ function segmentInformationTableFactory(_ref) {
       internalAuthTokenProvider = _ref.internalAuthTokenProvider;
 
   /**
-   * GET /segments-information-tables/:routeId - get segments information table by route id.
+   * GET /segments-information-tables/:routeId — Returns segment information tables for the route (distances, durations, durationsHHMM between stops). Requires BETTEREZ_APP audience.
    * @param {Object} opts
-   * @param {string} [opts.token] - API key
-   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.routeId - Route id (ObjectId format)
-   * @param {SegmentsInformationTablesQuery} [opts.query] - Query params (providerId)
+   * @param {string} [opts.token] - API key (X-API-KEY)
+   * @param {string} [opts.jwtToken] - JWT or internal auth (Authorization: Bearer)
+   * @param {string} opts.routeId - Route id (24-char hex ObjectId)
+   * @param {SegmentsInformationTablesQuery} [opts.query] - Optional providerId
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ segmentInformationTables: { distances: Object, durations: Object, durationsHHMM: Object } }>>}
+   * @throws 400 INVALID_ROUTE_ID — routeId not 24 hex characters
+   * @throws 401 Unauthorized
+   * @throws 404 ROUTE_NOT_FOUND
+   * @throws 500 Internal server error
    */
   function get(_ref2) {
     var token = _ref2.token,
@@ -42,6 +47,7 @@ function segmentInformationTableFactory(_ref) {
 
     return client({
       url: "/segments-information-tables/" + routeId,
+      method: "get",
       params: query,
       headers: authorizationHeaders({ token: token, jwtToken: jwtToken, internalAuthTokenProvider: internalAuthTokenProvider, headers: headers })
     });

package/lib/endpoints/inventory/station-groups.js

@@ -26,8 +26,7 @@ function stationGroupsFactory(_ref) {
    * GET /station-groups - list station groups.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
-   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {StationGroupsListQuery} [opts.query] - Query params
+   * @param {StationGroupsListQuery} [opts.query] - Query params (e.g. providerIds)
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -37,8 +36,7 @@ function stationGroupsFactory(_ref) {
         query = _ref2$query === undefined ? {} : _ref2$query,
         headers = _ref2.headers;
 
-    return client({
-      url: "/station-groups",
+    return client.get("/station-groups", {
       params: query,
       headers: authorizationHeaders({ token: token, internalAuthTokenProvider: internalAuthTokenProvider, headers: headers })
     });

package/lib/endpoints/inventory/taxes.js

@@ -9,6 +9,15 @@ var _require = require("../endpoints_helpers.js"),
  * @property {string} [providerIds] - The id of the providers to get taxes for
  */
 
+/**
+ * Query params for GET /taxes/exceptions (btrz-api-inventory). See get-tax-exceptions-handler getSpec().
+ * @typedef {Object} TaxExceptionsListQuery
+ * @property {string} [originId] - Origin station id (24 hex characters)
+ * @property {string} [destinationId] - Destination station id (24 hex characters)
+ * @property {number} [page] - Page to return
+ * @property {number} [recordsPerPage] - Records per page
+ */
+
 /**
  * Factory for taxes API (btrz-api-inventory).
  * @param {Object} deps
@@ -134,7 +143,7 @@ function taxesFactory(_ref) {
         url: "/taxes/exceptions",
         method: "post",
         headers: authorizationHeaders({ token: token, jwtToken: jwtToken, internalAuthTokenProvider: internalAuthTokenProvider, headers: headers }),
-        data: taxException
+        data: { taxException: taxException }
       });
     },
 
@@ -159,7 +168,7 @@ function taxesFactory(_ref) {
         url: "/taxes/exceptions/" + taxExceptionId,
         method: "put",
         headers: authorizationHeaders({ token: token, jwtToken: jwtToken, internalAuthTokenProvider: internalAuthTokenProvider, headers: headers }),
-        data: taxException
+        data: { taxException: taxException }
       });
     },
 

package/lib/endpoints/inventory/traveller-card-providers-types.js

@@ -5,6 +5,7 @@ var _require = require("./../endpoints_helpers.js"),
 
 /**
  * Factory for traveller-card-providers types API (btrz-api-inventory).
+ * Returns the list of supported traveller card provider types (e.g. "custom", "caa").
  * @param {Object} deps
  * @param {import("axios").AxiosInstance} deps.client
  * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
@@ -17,21 +18,20 @@ function travellerCardProvidersTypesFactory(_ref) {
       internalAuthTokenProvider = _ref.internalAuthTokenProvider;
 
   /**
-   * GET /traveller-card-providers/types - list traveller card provider types. API does not accept query params.
+   * GET /traveller-card-providers/types - list traveller card provider types (e.g. "custom", "caa"). No query or path params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ travellerCardProviderTypes: Array<{ type: string, properties: Object }> }>>}
    */
   function all(_ref2) {
     var token = _ref2.token,
-        _ref2$query = _ref2.query,
-        query = _ref2$query === undefined ? {} : _ref2$query,
+        jwtToken = _ref2.jwtToken,
         headers = _ref2.headers;
 
     return client.get("/traveller-card-providers/types", {
-      params: query,
-      headers: authorizationHeaders({ token: token, internalAuthTokenProvider: internalAuthTokenProvider, headers: headers })
+      headers: authorizationHeaders({ token: token, jwtToken: jwtToken, internalAuthTokenProvider: internalAuthTokenProvider, headers: headers })
     });
   }
 

package/lib/endpoints/inventory/trip-ids.js

@@ -0,0 +1,67 @@
+"use strict";
+
+/* eslint-disable max-len */
+var _require = require("./../endpoints_helpers.js"),
+    authorizationHeaders = _require.authorizationHeaders;
+
+/**
+ * Body for POST /direct-trip-ids (btrz-api-inventory-trips). See TripIdPostData in post-handler getSpec().
+ * @typedef {Object} TripIdPostData
+ * @property {string} providerId - Provider id (24-char hex ObjectId)
+ * @property {string} routeId - Route id (24-char hex ObjectId)
+ * @property {string} scheduleId - Schedule id
+ * @property {string} departureDate - Departure date (yyyy-mm-dd)
+ * @property {string} fareIds - Fare ids and quantities (e.g. fareId:qty)
+ * @property {string} channel - One of: backoffice, agency-backoffice, websales, agency-websales
+ * @property {string} productId - Product id (24-char hex ObjectId)
+ * @property {string} originId - Origin station id (24-char hex ObjectId)
+ * @property {string} destinationId - Destination station id (24-char hex ObjectId)
+ * @property {string} [currency] - ISO currency code (optional, for multicurrency)
+ */
+
+/**
+ * Factory for trip-ids API (btrz-api-inventory-trips).
+ * @param {Object} deps
+ * @param {import("axios").AxiosInstance} deps.client
+ * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
+ * @returns {{ create: function }}
+ */
+
+
+function tripIdsFactory(_ref) {
+  var client = _ref.client,
+      internalAuthTokenProvider = _ref.internalAuthTokenProvider;
+
+  /**
+   * POST /direct-trip-ids — Resolve trip parameters to a trip id. Runs trip search internally and returns the matching trip's base64 id (or null). Body can be TripIdPostData or { tripId: TripIdPostData }.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key (X-API-KEY)
+   * @param {string} [opts.jwtToken] - JWT or internal auth (Authorization: Bearer)
+   * @param {TripIdPostData|{ tripId: TripIdPostData }} opts.data - Trip parameters (or wrapped in tripId key)
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse<{ tripId: { tripId: string|null } }>>}
+   * @throws 400 WRONG_DATA — tripId required or required fields missing
+   * @throws 401 Unauthorized
+   * @throws 404 TRIP_IDS_NOT_FOUND
+   * @throws 500 Internal server error
+   */
+  function create(_ref2) {
+    var token = _ref2.token,
+        jwtToken = _ref2.jwtToken,
+        data = _ref2.data,
+        headers = _ref2.headers;
+
+    return client({
+      url: "/direct-trip-ids",
+      method: "post",
+      data: data,
+      headers: authorizationHeaders({ token: token, jwtToken: jwtToken, internalAuthTokenProvider: internalAuthTokenProvider, headers: headers })
+    });
+  }
+
+  return {
+    create: create
+  };
+}
+
+module.exports = tripIdsFactory;

package/lib/endpoints/inventory/trips.js

@@ -1,14 +1,15 @@
 "use strict";
 
+/* eslint-disable max-len */
 var _require = require("./../endpoints_helpers.js"),
     authorizationHeaders = _require.authorizationHeaders;
 
 /**
- * Factory for trips API (btrz-api-inventory).
+ * Factory for trips API (btrz-api-inventory-trips).
  * @param {Object} deps
  * @param {import("axios").AxiosInstance} deps.client
  * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
- * @returns {{ all: function, get: function }}
+ * @returns {{ all: function, get: function, getPricingSimulation: function }}
  */
 
 
@@ -17,12 +18,17 @@ function tripsFactory(_ref) {
       internalAuthTokenProvider = _ref.internalAuthTokenProvider;
 
   /**
-   * GET /trips - list trips. API source of truth in btrz-api-inventory-trips; query not documented here.
+   * GET /trips — Search for available trips by date, origin, destination, fare, product, channel, and price. Rate limited (e.g. 8000 req/10 min). See get-trips getSpec() for full query params (productId, originId, destinationId, fareIds, departureDate, returnDate, channel, currency, etc.).
    * @param {Object} opts
-   * @param {string} [opts.token] - API key
-   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {string} [opts.token] - API key (X-API-KEY)
+   * @param {string} [opts.jwtToken] - JWT or internal auth (Authorization: Bearer)
+   * @param {Object} [opts.query] - Query params (productId, originId, destinationId, fareIds, departureDate, returnDate, etc.)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ trips: { departures: Object[], returns: Object[] } }>>}
+   * @throws 400 INVALID_DATE, INVALID_DATE_FORMAT, INVALID_PRODUCTID, INVALID_ORIGIN, INVALID_DESTINATION, INVALID_CHANNEL, INVALID_FARE, INVALID_FAREID, INVALID_MANIFEST_STATUS, WRONG_DATA
+   * @throws 401 Unauthorized
+   * @throws 409 NO_HIGHER_OR_EQL_PRICE
+   * @throws 500 Internal server error
    */
   function all(_ref2) {
     var token = _ref2.token,
@@ -33,32 +39,73 @@ function tripsFactory(_ref) {
 
     return client({
       url: "/trips",
+      method: "get",
       params: query,
       headers: authorizationHeaders({ token: token, jwtToken: jwtToken, internalAuthTokenProvider: internalAuthTokenProvider, headers: headers })
     });
   }
 
   /**
-   * GET /trip/:id - get trip by id. API does not accept query params.
+   * GET /trip/:id — Get up-to-date information for a trip by its ID (base64-encoded trip summary from a search). Optional query: extraCapacityImpact, ignoreCutoffs, currency, ignoreOmitByAvailability, includeMoveToTrips.
    * @param {Object} opts
-   * @param {string} [opts.token] - API key
-   * @param {string} opts.id - Trip id
+   * @param {string} [opts.token] - API key (X-API-KEY)
+   * @param {string} [opts.jwtToken] - JWT or internal auth (Authorization: Bearer)
+   * @param {string} opts.id - Trip id (base64-encoded)
+   * @param {Object} [opts.query] - Optional: extraCapacityImpact, ignoreCutoffs, currency, ignoreOmitByAvailability, includeMoveToTrips
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ trip: Object }>>}
+   * @throws 400 INVALID_TRIP — tripId is invalid
+   * @throws 401 Unauthorized
+   * @throws 500 Internal server error
    */
   function get(_ref3) {
     var token = _ref3.token,
+        jwtToken = _ref3.jwtToken,
         id = _ref3.id,
+        _ref3$query = _ref3.query,
+        query = _ref3$query === undefined ? {} : _ref3$query,
         headers = _ref3.headers;
 
-    return client.get("/trip/" + id, {
-      headers: authorizationHeaders({ token: token, internalAuthTokenProvider: internalAuthTokenProvider, headers: headers })
+    return client({
+      url: "/trip/" + id,
+      method: "get",
+      params: query,
+      headers: authorizationHeaders({ token: token, jwtToken: jwtToken, internalAuthTokenProvider: internalAuthTokenProvider, headers: headers })
+    });
+  }
+
+  /**
+   * GET /trips/pricing-simulation — Get pricing simulation for all purchase combinations for a schedule. Query: scheduleId, productId (required); purchaseDate, travelDate, includeReadable, includeMetadata, minimize (optional).
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key (X-API-KEY)
+   * @param {string} [opts.jwtToken] - JWT or internal auth (Authorization: Bearer)
+   * @param {Object} [opts.query] - scheduleId, productId (required); purchaseDate, travelDate, includeReadable, includeMetadata, minimize
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse<Object>>} Response shape per PricingSimulationResult definition
+   * @throws 400 INVALID_SCHEDULE_ID, INVALID_PRODUCT_ID, INVALID_PRODUCT, ROUTE_NOT_FOUND, ONLY_JP_SUPPORTED, INVALID_DATE
+   * @throws 401 Unauthorized, PRICING_SIMULATOR_DISABLED, PROVIDER_UNAUTHORIZED
+   * @throws 404 SCHEDULE_NOT_FOUND, NO_MANIFEST
+   * @throws 500 Internal server error
+   */
+  function getPricingSimulation(_ref4) {
+    var token = _ref4.token,
+        jwtToken = _ref4.jwtToken,
+        _ref4$query = _ref4.query,
+        query = _ref4$query === undefined ? {} : _ref4$query,
+        headers = _ref4.headers;
+
+    return client({
+      url: "/trips/pricing-simulation",
+      method: "get",
+      params: query,
+      headers: authorizationHeaders({ token: token, jwtToken: jwtToken, internalAuthTokenProvider: internalAuthTokenProvider, headers: headers })
     });
   }
 
   return {
     all: all,
-    get: get
+    get: get,
+    getPricingSimulation: getPricingSimulation
   };
 }
 

package/lib/endpoints/inventory/vehicle-types.js

@@ -17,22 +17,19 @@ function vehicleTypesFactory(_ref) {
       internalAuthTokenProvider = _ref.internalAuthTokenProvider;
 
   /**
-   * GET /vehicle-types - list vehicle types (e.g. Bus, Shuttle, Van, Train, Ferry, Tram).
+   * GET /vehicle-types - list vehicle types (e.g. Bus, Shuttle, Van, Train, Ferry, Tram). No query or path params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ vehicleTypes: Array<{ _id: string, name: string }> }>>}
    */
   function all(_ref2) {
     var token = _ref2.token,
         jwtToken = _ref2.jwtToken,
-        _ref2$query = _ref2.query,
-        query = _ref2$query === undefined ? {} : _ref2$query,
         headers = _ref2.headers;
 
     return client.get("/vehicle-types", {
-      params: query,
       headers: authorizationHeaders({ token: token, jwtToken: jwtToken, internalAuthTokenProvider: internalAuthTokenProvider, headers: headers })
     });
   }

package/lib/endpoints/inventory/vehicles.js

@@ -47,13 +47,14 @@ function vehiclesFactory(_ref) {
    */
   function all(_ref2) {
     var token = _ref2.token,
+        jwtToken = _ref2.jwtToken,
         _ref2$query = _ref2.query,
         query = _ref2$query === undefined ? {} : _ref2$query,
         headers = _ref2.headers;
 
     return client.get("/vehicles", {
       params: query,
-      headers: authorizationHeaders({ token: token, internalAuthTokenProvider: internalAuthTokenProvider, headers: headers })
+      headers: authorizationHeaders({ token: token, jwtToken: jwtToken, internalAuthTokenProvider: internalAuthTokenProvider, headers: headers })
     });
   }
 
@@ -69,10 +70,11 @@ function vehiclesFactory(_ref) {
   function get(_ref3) {
     var vehicleId = _ref3.vehicleId,
         token = _ref3.token,
+        jwtToken = _ref3.jwtToken,
         headers = _ref3.headers;
 
     return client.get("/vehicles/" + vehicleId, {
-      headers: authorizationHeaders({ token: token, internalAuthTokenProvider: internalAuthTokenProvider, headers: headers })
+      headers: authorizationHeaders({ token: token, jwtToken: jwtToken, internalAuthTokenProvider: internalAuthTokenProvider, headers: headers })
     });
   }
 

package/lib/endpoints/invoices/emails.js

@@ -18,13 +18,23 @@ function emailsFactory(_ref) {
       internalAuthTokenProvider = _ref.internalAuthTokenProvider;
 
   /**
-   * POST /emails - create/send invoice email. API does not accept query params.
+   * POST /emails — Send invoice by email to the given addresses.
+   * Request body may be sent as root object or under key "email". On success the API emits webhook invoiceemail.created.
+   *
    * @param {Object} opts
-   * @param {string} [opts.token] - API key
-   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {Object} opts.data - Request body
+   * @param {string} [opts.token] - API key (X-API-KEY)
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol (Authorization: Bearer)
+   * @param {Object} opts.data - Request body (EmailPostData)
+   * @param {string} opts.data.invoiceId - Invoice ID (required, 24-char hex ObjectId)
+   * @param {string[]} opts.data.emails - Recipient email addresses (required)
+   * @param {string} [opts.data.language] - Language code for template (e.g. "en-us")
+   * @param {Object} [opts.query] - Query params (none used by this endpoint)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ status: "OK" }>>} Resolves with { status: "OK" } on success
+   * @throws 400 WRONG_DATA, ACCOUNT_CANT_SEND_EMAILS, NO_VERIFIED_OR_ACTIVE_EMAIL, INVALID_EMAIL_TO_SEND
+   * @throws 401 Unauthorized (missing/invalid X-API-KEY or Authorization)
+   * @throws 404 INVOICE_NOT_FOUND
+   * @throws 500 Internal server error
    */
   function create(_ref2) {
     var token = _ref2.token,