btrz-api-client 8.30.0 → 8.31.0

package/src/endpoints/notifications/orders-rules-validations.js

@@ -2,11 +2,6 @@ const {
   authorizationHeaders
 } = require("../endpoints_helpers.js");
 
-/**
- * Query params for POST /orders-rules-validations (btrz-api-notifications). Forwarded to API as-is.
- * @typedef {Object} OrdersRulesValidationsPostQuery
- */
-
 /**
  * Factory for orders-rules-validations API (btrz-api-notifications).
  * @param {Object} deps
@@ -19,12 +14,11 @@ function ordersRulesValidations({
   internalAuthTokenProvider
 }) {
   /**
-   * POST /orders-rules-validations - create an order rules validation (notification).
+   * POST /orders-rules-validations - validate a rule using the data (body only). API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {OrdersRulesValidationsPostQuery} [opts.query] - Optional query params (forwarded to API)
-   * @param {Object} opts.orderRulesValidation - Validation payload
+   * @param {Object} opts.orderRulesValidation - Validation payload (rule and facts)
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */

package/src/endpoints/notifications/pdf-data.js

@@ -4,8 +4,9 @@ const {
 } = require("./../endpoints_helpers.js");
 
 /**
+ * Query params for GET pdf-templates-processing routes (btrz-api-notifications). Client uses type/family to resolve path.
  * @typedef {Object} PdfDataGetQuery
- * @property {string} type - Document type; determines path. E.g. "product", "giftCertificate", "voucher", "transaction", "ssr", "manifest", "passengersManifest", "order", "order_confirmation", "cancellation", "change", "shift", "invoice", "parcelManifest", "parcel_confirmation", "redeemable_items_confirmation", "sold_item_confirmation", "customer_card_membership", "user_password_reset", "new_account", "operator_manifest_capacity", "reaccomodation", "ticket_movement", "manifest_notification", "startingBalance", "partialShiftDeposits", "shiftLocationClosure", "bankDepositSlip", "terminalVoucher", "manualTickets", etc.
+ * @property {string} type - Document type; determines path (e.g. product, giftCertificate, voucher, transaction, ssr, manifest, passengersManifest, order, order_confirmation, cancellation, change, shift, invoice, parcelManifest, startingBalance, partialShiftDeposits, bankDepositSlip, terminalVoucher, manualTickets, etc.)
  * @property {string} [family] - When type is "product": "ticket" | "reservation" | "paid in" | "paid out" | "parcel" | "flexpass" | "bundle"
  */
 

package/src/endpoints/notifications/pdfs.js

@@ -4,8 +4,9 @@ const {
 } = require("./../endpoints_helpers.js");
 
 /**
+ * Query params for GET pdf-templates-processing binary routes (btrz-api-notifications). Client uses type/family to resolve path.
  * @typedef {Object} PdfGetQuery
- * @property {string} type - Document type: "product" | "giftCertificate" | "voucher" | "transaction" | "ssr" | "manifest" | "passengersManifest" | "order" | "shift" | "remainderSlip" | "exchange" | "invoice" | "locationClosure" | "parcelManifest" | "startingBalance" | "partialShiftDeposits" | "shiftLocationClosure" | "bankDepositSlip" | "terminalVoucher" | "manualTickets"
+ * @property {string} type - Document type (e.g. product, giftCertificate, voucher, transaction, ssr, manifest, passengersManifest, order, shift, remainderSlip, exchange, invoice, locationClosure, parcelManifest, startingBalance, partialShiftDeposits, shiftLocationClosure, bankDepositSlip, terminalVoucher, manualTickets)
  * @property {string} [family] - When type is "product": "ticket" | "reservation" | "paid in" | "paid out" | "parcel" | "flexpass" | "bundle"
  */
 

package/src/endpoints/notifications/printed-tickets.js

@@ -2,6 +2,15 @@ const {
   authorizationHeaders
 } = require("../endpoints_helpers.js");
 
+/**
+ * Query params for GET /printed-tickets (btrz-api-notifications). See get-printed-tickets getSpec().
+ * @typedef {Object} PrintedTicketsGetQuery
+ * @property {string} trxId - Transaction id to print its tickets (required)
+ * @property {string} [channel] - Optional channel of the transaction
+ * @property {string} [lang] - Language (handler uses for PDF URL)
+ * @property {string} [date] - Date (handler uses for PDF URL)
+ */
+
 /**
  * Factory for printed-tickets API (btrz-api-notifications).
  * @param {Object} deps
@@ -13,23 +22,24 @@ function printedTicketsFactory({
   client, internalAuthTokenProvider
 }) {
   /**
-   * GET /printed-tickets - get printed tickets (by trxId, lang, date); responseType json or blob.
+   * GET /printed-tickets - get printed tickets PDF (trxId required; lang, date optional).
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} [opts.responseType] - Response type (e.g. "json" or "blob")
-   * @param {string} opts.trxId - Transaction id
-   * @param {string} opts.lang - Language code
-   * @param {string} opts.date - Date
+   * @param {string} [opts.responseType] - Response type ("json" or "blob")
+   * @param {string} opts.trxId - Transaction id (required)
+   * @param {string} [opts.lang] - Language code
+   * @param {string} [opts.date] - Date
+   * @param {string} [opts.channel] - Optional channel of the transaction
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
   function get({
-    token, jwtToken, responseType = "json", trxId, lang, date, headers
+    token, jwtToken, responseType = "json", trxId, lang, date, channel, headers
   }) {
     return client({
       url: "/printed-tickets",
-      params: {trxId, lang, date},
+      params: {trxId, lang, date, channel},
       responseType,
       headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers})
     });

package/src/endpoints/notifications/twilio.js

@@ -2,11 +2,6 @@ const {
   authorizationHeaders
 } = require("../endpoints_helpers.js");
 
-/**
- * Query params for GET /twilio/phone-numbers/:isocode (btrz-api-notifications). Forwarded to API as-is.
- * @typedef {Object} TwilioPhoneNumbersListQuery
- */
-
 /**
  * Factory for twilio API (btrz-api-notifications).
  * @param {Object} deps
@@ -20,12 +15,11 @@ function twilioFactory({
   return {
     phoneNumbers: {
       /**
-       * GET /twilio/phone-numbers/:isocode - list Twilio phone numbers for country isocode.
+       * GET /twilio/phone-numbers/:isocode - list Twilio phone numbers for country isocode. API does not accept query params.
        * @param {Object} opts
        * @param {string} opts.isocode - Country ISO code
        * @param {string} [opts.token] - API key
        * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-       * @param {TwilioPhoneNumbersListQuery} [opts.query] - Optional query params (forwarded to API)
        * @param {Object} [opts.headers] - Optional headers
        * @returns {Promise<import("axios").AxiosResponse>}
        */

package/src/endpoints/operations/accounting_items.js

@@ -3,8 +3,13 @@ const {
 } = require("../endpoints_helpers.js");
 
 /**
- * @typedef {Object} AccountingItemsQuery
- * @property {string} [providerId] - Provider account ID
+ * Query params for GET /accounting-items (btrz-api-operations). See accounting-items get-handler getSpec().
+ * @typedef {Object} AccountingItemsListQuery
+ * @property {number} [page] - Page number (20 records per page)
+ * @property {string} [shiftId] - Shift id (ObjectId format)
+ * @property {string} [type] - "account_payable" | "account_receivable"
+ * @property {string} [trxId] - Transaction id (ObjectId format)
+ * @property {string} [status] - Comma-separated statuses: created, paid, waiting for payment
  */
 
 /**
@@ -21,7 +26,7 @@ function accountingItemsFactory({
    * GET /accounting-items - list accounting items.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
-   * @param {AccountingItemsQuery} [opts.query] - Query params
+   * @param {AccountingItemsListQuery} [opts.query] - Query params (all optional)
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -41,7 +46,7 @@ function accountingItemsFactory({
   }
 
   /**
-   * GET /accounting-items/:accountingItemId - get accounting item by id.
+   * GET /accounting-items/:accountingItemId - get accounting item by id. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} opts.accountingItemId - Accounting item id

package/src/endpoints/operations/applied_insurance.js

@@ -7,13 +7,20 @@ const {authorizationHeaders} = require("./../endpoints_helpers.js");
  * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
  * @returns {Object} applied-insurance API methods
  */
+/**
+ * Query params for GET /appliedInsurances (btrz-api-operations). See get-applied-insurances getSpec().
+ * Deprecated: use GET /transactions/:transactionId/applied-insurance.
+ * @typedef {Object} AppliedInsurancesListQuery
+ * @property {string} trxId - Associated transaction id (required)
+ */
+
 function appliedInsuranceFactory({client, internalAuthTokenProvider}) {
   /**
-   * GET /appliedInsurances - list applied insurances (by trxId query).
+   * GET /appliedInsurances - list applied insurances by transaction id (query: trxId).
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.trxId - Transaction id (query param)
+   * @param {string} opts.trxId - Transaction id (required, sent as query param)
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */

package/src/endpoints/operations/calendar_entries.js

@@ -1,8 +1,12 @@
 const {authorizationHeaders} = require("./../endpoints_helpers.js");
 
 /**
- * @typedef {Object} CalendarEntriesQuery
- * @property {string} [providerId] - Provider account ID
+ * Query params for GET /calendar-entries (btrz-api-operations). See get-calendar-entries getSpec().
+ * @typedef {Object} CalendarEntriesListQuery
+ * @property {string} from - Start travel date (required, format yyyy-mm-dd)
+ * @property {string} to - End travel date (required, format yyyy-mm-dd, max 31 days range)
+ * @property {string} [providerId] - Provider id when consuming from a non-main account
+ * @property {string} [channels] - Filter by channel (e.g. websales); must be one of allowed channels
  */
 
 /**
@@ -17,7 +21,7 @@ function calendarEntriesFactory({client, internalAuthTokenProvider}) {
    * GET /calendar-entries - list calendar entries.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
-   * @param {CalendarEntriesQuery} [opts.query] - Query params
+   * @param {CalendarEntriesListQuery} [opts.query] - Query params (from, to required)
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */

package/src/endpoints/operations/external-bookings.js

@@ -1,10 +1,5 @@
 const {authorizationHeaders} = require("./../endpoints_helpers.js");
 
-/**
- * @typedef {Object} ExternalBookingsQuery
- * @property {string} [providerId] - Provider account ID
- */
-
 /**
  * Factory for external-bookings API (btrz-api-operations).
  * @param {Object} deps
@@ -14,13 +9,12 @@ const {authorizationHeaders} = require("./../endpoints_helpers.js");
  */
 function externalBookingsFactory({client, internalAuthTokenProvider}) {
   /**
-   * POST /external-bookings - create external booking.
+   * POST /external-bookings - create external booking. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {Object} opts.externalBooking - External booking payload
    * @param {Object} [opts.headers] - Optional headers
-   * @param {ExternalBookingsQuery} [opts.query] - Query params
    * @returns {Promise<import("axios").AxiosResponse>}
    */
   function create({jwtToken, token, externalBooking, headers, query = {}}) {
@@ -34,7 +28,7 @@ function externalBookingsFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * DELETE /external-bookings/:ticketId - remove external booking.
+   * DELETE /external-bookings/:ticketId - remove external booking. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol

package/src/endpoints/operations/flexpasses.js

@@ -9,7 +9,7 @@ const {authorizationHeaders} = require("./../endpoints_helpers.js");
  */
 function flexpassesFactory({client, internalAuthTokenProvider}) {
   /**
-   * DELETE /flexpasses/:flexpassId/scannings/:tripId - delete scan by trip id.
+   * DELETE /flexpasses/:flexpassId/scannings/:tripId - delete scan by trip id. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol

package/src/endpoints/operations/loans.js

@@ -3,8 +3,14 @@ const {
 } = require("./../endpoints_helpers.js");
 
 /**
- * @typedef {Object} LoansQuery
- * @property {string} [providerId] - Provider account ID
+ * Query params for GET /loans (btrz-api-operations). See loans get-handler getSpec().
+ * @typedef {Object} LoansListQuery
+ * @property {number} [page] - Page number (20 records per page)
+ * @property {string} [shiftId] - Shift id (ObjectId format)
+ * @property {string} [type] - "loan" | "re-payment"
+ * @property {string} [trxId] - Transaction id (ObjectId format)
+ * @property {string} [status] - Comma-separated statuses: created, paid, waiting for payment
+ * @property {string} [providerId] - Provider id (for agencies)
  */
 
 /**
@@ -21,7 +27,7 @@ function loansFactory({
    * GET /loans - list loans.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
-   * @param {LoansQuery} [opts.query] - Query params
+   * @param {LoansListQuery} [opts.query] - Query params (all optional)
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -41,7 +47,7 @@ function loansFactory({
   }
 
   /**
-   * GET /loans/:loanId - get loan by id.
+   * GET /loans/:loanId - get loan by id. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} opts.loanId - Loan id

package/src/endpoints/operations/manifest.js

@@ -4,8 +4,75 @@ const {
 } = require("./../endpoints_helpers.js");
 
 /**
- * @typedef {Object} ManifestQuery
- * @property {string} [providerId] - Provider account ID
+ * Query params for GET /manifests (btrz-api-operations). See get-manifests getSpec().
+ * @typedef {Object} ManifestsListQuery
+ * @property {string} [providerIds] - Provider IDs of the manifests
+ * @property {string} [routeIds] - Route IDs
+ * @property {string} [scheduleIds] - Schedule IDs
+ * @property {string} [date] - Date (yyyy-mm-dd)
+ * @property {string} [dateFrom] - Start date range (yyyy-mm-dd)
+ * @property {string} [dateTo] - End date range (yyyy-mm-dd)
+ * @property {string} [seatmapId] - Seatmap ID
+ * @property {string} [vehicleId] - Vehicle ID
+ * @property {string} [assignedUserId] - Assigned user ID
+ * @property {boolean} [dispatched] - If manifest was dispatched
+ * @property {boolean} [reviewed] - If manifest was reviewed
+ * @property {string} [sendToSAP] - If manifest should be sent to SAP
+ * @property {string} [operatingCompanyId] - Operating company ID
+ * @property {number} [vehicleFrom] - First vehicle id (range)
+ * @property {number} [vehicleTo] - Last vehicle id (range)
+ * @property {string} [dispatchedStatus] - Filter by dispatched status
+ * @property {boolean} [manifestOnly] - If only manifest (no ticket info)
+ * @property {string} [status] - Comma-separated manifest statuses
+ */
+
+/**
+ * Query params for PUT /manifests (btrz-api-operations). See put-manifest getSpec().
+ * @typedef {Object} ManifestSaveQuery
+ * @property {string} providerId - Provider ID (required)
+ * @property {string} [manifestId] - Manifest ID to update (omit to create)
+ * @property {boolean} [bypassBusValidation] - Bypass bus validation
+ */
+
+/**
+ * Query params for PATCH /manifests (btrz-api-operations). See patch-manifest getSpec().
+ * @typedef {Object} ManifestPatchQuery
+ * @property {string} providerId - Provider ID (required)
+ * @property {string} [routeId] - Route ID for update_schedule
+ * @property {string} [scheduleId] - New schedule ID for update_schedule
+ * @property {string} [oldScheduleId] - Old schedule ID for update_schedule
+ * @property {string} [accommodateOnAnySeat] - "true" to assign missing seats to any available
+ * @property {string} [newdesign] - "true" when using new seatmap design
+ */
+
+/**
+ * Query params for GET /outlook-manifests (btrz-api-operations). See get-outlook-manifests getSpec().
+ * @typedef {Object} OutlookManifestsListQuery
+ * @property {string} providerId - Provider ID (required)
+ * @property {string} productId - Product ID (required)
+ * @property {string} from - Start date (required, yyyy-mm-dd)
+ * @property {string} to - End date (required, yyyy-mm-dd, max 1 month range)
+ * @property {string} [scheduleName] - Schedule name filter
+ * @property {string} [loadFactorFrom] - Min load factor
+ * @property {string} [loadFactorTo] - Max load factor
+ * @property {string} [timeFrom] - Min time filter
+ * @property {string} [timeTo] - Max time filter
+ * @property {string} [originId] - Origin station id
+ * @property {string} [destinationId] - Destination station id
+ * @property {string} [amenityGroupId] - Amenity group id
+ * @property {string} [userId] - Only manifests with this user assigned
+ * @property {string} [withAssignedUsers] - Filter by assigned users (true/false)
+ * @property {string} [status] - Comma-separated statuses (published, paused, planned, canceled)
+ * @property {boolean} [isExtraRun] - Only extra run trips
+ * @property {boolean} [minimalPayload] - Minimal data for five day outlook
+ * @property {string} [labelId] - Label id filter
+ * @property {boolean} [dispatched] - Only dispatched manifests
+ */
+
+/**
+ * Query params for PUT /manifests/:manifestKey/driver-relays (btrz-api-operations). See put-driver-relays-handler getSpec().
+ * @typedef {Object} ManifestDriverRelaysQuery
+ * @property {boolean} [bypassValidations] - If true, bypass driver validations
  */
 
 /**
@@ -56,14 +123,13 @@ function manifestFactory({
   }
 
   /**
-   * POST manifests/:manifestId/dispatches - dispatch manifest.
+   * POST manifests/:manifestId/dispatches - dispatch manifest. API does not accept query 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
    * @param {string} opts.manifestId - Manifest id
    * @param {Object} opts.data - Request body
-   * @param {ManifestQuery} [opts.query] - Query params
    * @returns {Promise<import("axios").AxiosResponse>}
    */
   function dispatch({token, jwtToken, headers, manifestId, data, query}) {
@@ -81,7 +147,7 @@ function manifestFactory({
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {ManifestQuery} [opts.query] - Query params
+   * @param {ManifestsListQuery} [opts.query] - Query params (all optional)
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -95,12 +161,11 @@ function manifestFactory({
   }
 
   /**
-   * GET /manifests/:manifestId - get manifest by id.
+   * GET /manifests/:manifestId - get manifest by id. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.manifestId - Manifest id
-   * @param {ManifestQuery} [opts.query] - Query params
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -163,7 +228,7 @@ function manifestFactory({
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {ManifestQuery} [opts.query] - Query params
+   * @param {OutlookManifestsListQuery} [opts.query] - Query params (providerId, productId, from, to required)
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -185,7 +250,7 @@ function manifestFactory({
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {ManifestQuery} [opts.query] - Query params
+   * @param {ManifestPatchQuery} [opts.query] - Query params (providerId required)
    * @param {Object} opts.operations - JSON Patch operations
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
@@ -209,10 +274,10 @@ function manifestFactory({
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} [opts.providerId] - Provider id
+   * @param {string} [opts.providerId] - Provider id (required by API as query)
    * @param {Object} opts.data - Request body
    * @param {Object} [opts.headers] - Optional headers
-   * @param {ManifestQuery} [opts.query] - Query params
+   * @param {ManifestSaveQuery} [opts.query] - Query params (providerId required; manifestId, bypassBusValidation optional)
    * @returns {Promise<import("axios").AxiosResponse>}
    */
   function save({
@@ -233,8 +298,7 @@ function manifestFactory({
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.manifestId - Manifest id
-   * @param {ManifestQuery} [opts.query] - Query params
-   * @param {Object} opts.data - Request body
+       * @param {Object} opts.data - Request body
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -280,8 +344,7 @@ function manifestFactory({
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.manifestId - Manifest id
-   * @param {ManifestQuery} [opts.query] - Query params
-   * @param {Object} opts.data - Request body
+       * @param {Object} opts.data - Request body
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -328,8 +391,7 @@ function manifestFactory({
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.manifestId - Manifest id
-   * @param {ManifestQuery} [opts.query] - Query params
-   * @param {Object} opts.data - Request body
+       * @param {Object} opts.data - Request body
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -353,8 +415,7 @@ function manifestFactory({
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.manifestId - Manifest id
-   * @param {ManifestQuery} [opts.query] - Query params
-   * @param {Object} opts.data - Request body
+       * @param {Object} opts.data - Request body
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -378,7 +439,6 @@ function manifestFactory({
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.manifestKey - Manifest key
-   * @param {ManifestQuery} [opts.query] - Query params
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -402,7 +462,6 @@ function manifestFactory({
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-     * @param {ManifestQuery} [opts.query] - Query params
      * @param {Object} [opts.headers] - Optional headers
      * @param {Object} opts.data - Request body
      * @param {string} opts.manifestId - Manifest id
@@ -425,7 +484,6 @@ function manifestFactory({
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-     * @param {ManifestQuery} [opts.query] - Query params
      * @param {Object} [opts.headers] - Optional headers
      * @param {string} opts.manifestId - Manifest id
      * @param {string} opts.legFromId - Leg from id
@@ -451,7 +509,6 @@ function manifestFactory({
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-     * @param {ManifestQuery} [opts.query] - Query params
      * @param {Object} [opts.headers] - Optional headers
      * @param {string} opts.manifestId - Manifest id
      * @param {string} opts.legFromId - Leg from id
@@ -482,7 +539,6 @@ function manifestFactory({
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
      * @param {Object} opts.data - Request body
-     * @param {ManifestQuery} [opts.query] - Query params
      * @param {Object} [opts.headers] - Optional headers
      * @param {string} opts.manifestId - Manifest id
      * @param {string} opts.legFromId - Leg from id
@@ -504,8 +560,7 @@ function manifestFactory({
        * @param {string} [opts.token] - API key
        * @param {string} [opts.jwtToken] - JWT or internal auth symbol
        * @param {Object} opts.data - Request body
-       * @param {ManifestQuery} [opts.query] - Query params
-       * @param {Object} [opts.headers] - Optional headers
+     * @param {Object} [opts.headers] - Optional headers
        * @param {string} opts.manifestId - Manifest id
        * @param {string} opts.legFromId - Leg from id
        * @param {string} opts.ticketId - Ticket id
@@ -525,8 +580,7 @@ function manifestFactory({
        * @param {Object} opts
        * @param {string} [opts.token] - API key
        * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-       * @param {ManifestQuery} [opts.query] - Query params
-       * @param {Object} [opts.headers] - Optional headers
+     * @param {Object} [opts.headers] - Optional headers
        * @param {string} opts.manifestId - Manifest id
        * @param {string} opts.legFromId - Leg from id
        * @param {string} opts.ticketId - Ticket id
@@ -549,7 +603,6 @@ function manifestFactory({
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-     * @param {ManifestQuery} [opts.query] - Query params
      * @param {string} [opts.responseType] - Response type (e.g. "json")
      * @param {string} opts.id - Manifest id
      * @param {Object} [opts.headers] - Optional headers
@@ -573,7 +626,6 @@ function manifestFactory({
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
      * @param {string} opts.manifestId - Manifest id
-     * @param {ManifestQuery} [opts.query] - Query params
      * @param {Object} [opts.headers] - Optional headers
      * @param {Object} opts.data - Request body
      * @returns {Promise<import("axios").AxiosResponse>}
@@ -613,7 +665,6 @@ function manifestFactory({
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
      * @param {string} opts.manifestId - Manifest id
-     * @param {ManifestQuery} [opts.query] - Query params
      * @param {Object} [opts.headers] - Optional headers
      * @returns {Promise<import("axios").AxiosResponse>}
      */
@@ -634,7 +685,7 @@ function manifestFactory({
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
      * @param {string} opts.manifestId - Manifest id
-     * @param {ManifestQuery} [opts.query] - Query params
+     * @param {ManifestDriverRelaysQuery} [opts.query] - Query params (bypassValidations optional)
      * @param {Object} [opts.headers] - Optional headers
      * @param {Object} opts.data - Request body
      * @returns {Promise<import("axios").AxiosResponse>}
@@ -659,7 +710,6 @@ function manifestFactory({
      * @param {string} opts.manifestKey - Manifest key
      * @param {Object} opts.manifestException - Manifest exception payload
      * @param {Object} [opts.headers] - Optional headers
-     * @param {ManifestQuery} [opts.query] - Query params
      * @returns {Promise<import("axios").AxiosResponse>}
      */
     update({token, jwtToken, manifestKey, manifestException, headers, query = {}}) {

package/src/endpoints/operations/manifest_leg_for_tickets.js

@@ -9,12 +9,11 @@ const {authorizationHeaders} = require("../endpoints_helpers.js");
  */
 function manifestLegForTicketsFactory({client, internalAuthTokenProvider}) {
   /**
-   * GET /manifest-leg-for-tickets/:ticketId - get manifest leg for ticket.
+   * GET /manifest-leg-for-tickets/:ticketId - get manifest leg for ticket. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.ticketId - Ticket id
-   * @param {Object} [opts.params] - Query params (forwarded to API)
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */

package/src/endpoints/operations/movements.js

@@ -1,10 +1,5 @@
 const {authorizationHeaders} = require("./../endpoints_helpers.js");
 
-/**
- * @typedef {Object} MovementsQuery
- * @property {string} [providerId] - Provider account ID
- */
-
 /**
  * Factory for movements API (btrz-api-operations).
  * @param {Object} deps
@@ -14,12 +9,11 @@ const {authorizationHeaders} = require("./../endpoints_helpers.js");
  */
 function movementsFactory({client, internalAuthTokenProvider}) {
   /**
-   * POST /movements - create movement.
+   * POST /movements - create movement. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {Object} opts.movement - Movement payload
-   * @param {MovementsQuery} [opts.query] - Query params
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */

package/src/endpoints/operations/outlook-trips.js

@@ -1,8 +1,18 @@
 const {authorizationHeaders} = require("./../endpoints_helpers.js");
 
 /**
- * @typedef {Object} OutlookTripsQuery
- * @property {string} [providerId] - Provider account ID
+ * Query params for GET /outlook-trips (btrz-api-operations). See get-outlook-trips getSpec().
+ * @typedef {Object} OutlookTripsListQuery
+ * @property {string} from - Travel start date (required, date format)
+ * @property {string} to - Travel end date (required, date format)
+ * @property {string} [fromTime] - Cutoff time for first date (HH:MM)
+ * @property {string} [toTime] - Cutoff time for last date (HH:MM)
+ * @property {string} productId - Product ID (required)
+ * @property {string} [originId] - Origin (departure) station ID
+ * @property {string} [destinationId] - Destination station ID
+ * @property {string} [routeId] - Route ID
+ * @property {string} [scheduleId] - Schedule ID
+ * @property {boolean} [isExtraRun] - Only trips marked as extra run
  */
 
 /**
@@ -18,7 +28,7 @@ function outlookTripsFactory({client, internalAuthTokenProvider}) {
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {OutlookTripsQuery} [opts.query] - Query params
+   * @param {OutlookTripsListQuery} [opts.query] - Query params (from, to, productId required)
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */