btrz-api-client 8.30.0 → 8.32.0

package/lib/endpoints/inventory/routes.js

@@ -4,6 +4,27 @@
 var _require = require("./../endpoints_helpers.js"),
     authorizationHeaders = _require.authorizationHeaders;
 
+/**
+ * Query params for GET /routes (btrz-api-inventory). See get-routes getSpec().
+ * @typedef {Object} RoutesListQuery
+ * @property {string} [disabled] - Get enabled or disabled routes [true, false]
+ * @property {string} [productId] - Filter by product id (object id)
+ * @property {string} [routeGTFSID] - Filter by route external ID (GTFS)
+ * @property {string} [providerId] - Filter by provider
+ * @property {string} [name] - Filter by exact name (case sensitive)
+ * @property {string} [partialName] - Filter by partial name (case insensitive)
+ * @property {number} [page] - Page for pagination
+ * @property {boolean} [minimalPayload] - If true, schedules not included in response
+ */
+
+/**
+ * Query params for GET /routes/proration-tables (btrz-api-inventory). See get-proration-tables getSpec().
+ * @typedef {Object} RoutesProrationTablesListQuery
+ * @property {string} [routeId] - Route id
+ * @property {string} [providerId] - Provider id
+ * @property {string} [productId] - Product id (journey pricing)
+ */
+
 /**
  * Factory for routes API (btrz-api-inventory).
  * @param {Object} deps
@@ -18,12 +39,11 @@ function routesFactory(_ref) {
       internalAuthTokenProvider = _ref.internalAuthTokenProvider;
 
   /**
-   * GET /routes/:routeId - get route by id.
+   * GET /routes/:routeId - get route 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.routeId - Route id
-   * @param {Object} [opts.query] - Query params
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -42,15 +62,15 @@ function routesFactory(_ref) {
   }
 
   /**
-   * GET /routes/prices - get route prices.
+   * GET /routes/prices - get route prices. Client merges productId, originId, destinationId, channel into query.
    * @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 {string} opts.originId - Origin id
-   * @param {string} opts.destinationId - Destination id
-   * @param {string} opts.channel - Channel
-   * @param {Object} [opts.query] - Query params
+   * @param {string} opts.productId - Product id (merged into query)
+   * @param {string} opts.originId - Origin id (merged into query)
+   * @param {string} opts.destinationId - Destination id (merged into query)
+   * @param {string} opts.channel - Channel (merged into query)
+   * @param {Object} [opts.query] - Additional query params
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -77,7 +97,7 @@ function routesFactory(_ref) {
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {Object} [opts.query] - Query params
+   * @param {RoutesListQuery} [opts.query] - Query params
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -94,7 +114,7 @@ function routesFactory(_ref) {
   }
 
   /**
-   * GET /routes/:routeId/stations - get route stations.
+   * GET /routes/:routeId/stations - get route stations. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -114,7 +134,7 @@ function routesFactory(_ref) {
   }
 
   /**
-   * POST /routes - create route.
+   * POST /routes - create route. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -139,7 +159,7 @@ function routesFactory(_ref) {
   }
 
   /**
-   * PUT /routes/:routeId - update route.
+   * PUT /routes/:routeId - update route. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -166,7 +186,7 @@ function routesFactory(_ref) {
   }
 
   /**
-   * DELETE /routes/:routeId - remove route.
+   * DELETE /routes/:routeId - remove route. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -192,11 +212,10 @@ function routesFactory(_ref) {
   /** @type {{ all: function, create: function, update: function }} */
   var fareTables = {
     /**
-     * GET /routes/fare-tables - list fare tables.
+     * GET /routes/fare-tables - list fare tables. 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.query] - Query params
      * @param {Object} [opts.headers] - Optional headers
      * @returns {Promise<import("axios").AxiosResponse>}
      */
@@ -216,7 +235,7 @@ function routesFactory(_ref) {
     },
 
     /**
-     * POST /routes/:routeId/fare-tables - create fare table.
+     * POST /routes/:routeId/fare-tables - create fare table. API does not accept query params.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -245,7 +264,7 @@ function routesFactory(_ref) {
     },
 
     /**
-     * PUT /routes/:routeId/fare-tables/:fareTableId - update fare table.
+     * PUT /routes/:routeId/fare-tables/:fareTableId - update fare table. API does not accept query params.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -278,7 +297,7 @@ function routesFactory(_ref) {
   /** @type {{ create: function }} */
   var stops = {
     /**
-     * POST /routes/:routeId/stops - create stop.
+     * POST /routes/:routeId/stops - create stop. API does not accept query params.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -308,7 +327,7 @@ function routesFactory(_ref) {
   /** @type {{ get: function, create: function, update: function, remove: function }} */
   var fareRules = {
     /**
-     * GET /routes/:routeId/fare-rules - get fare rules.
+     * GET /routes/:routeId/fare-rules - get fare rules. API does not accept query params.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -331,7 +350,7 @@ function routesFactory(_ref) {
     },
 
     /**
-     * POST /routes/:routeId/fare-rules - create fare rule.
+     * POST /routes/:routeId/fare-rules - create fare rule. API does not accept query params.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -360,7 +379,7 @@ function routesFactory(_ref) {
     },
 
     /**
-     * PUT /routes/:routeId/fare-rules/:fareRuleId - update fare rule.
+     * PUT /routes/:routeId/fare-rules/:fareRuleId - update fare rule. API does not accept query params.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -391,7 +410,7 @@ function routesFactory(_ref) {
     },
 
     /**
-     * DELETE /routes/:routeId/fare-rules/:fareRuleId - remove fare rule.
+     * DELETE /routes/:routeId/fare-rules/:fareRuleId - remove fare rule. API does not accept query params.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -420,7 +439,7 @@ function routesFactory(_ref) {
   /** @type {{ get: function, create: function, update: function, remove: function }} */
   var priceBuckets = {
     /**
-     * GET /routes/:routeId/price-buckets - get price buckets.
+     * GET /routes/:routeId/price-buckets - get price buckets. API does not accept query params.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -443,7 +462,7 @@ function routesFactory(_ref) {
     },
 
     /**
-     * POST /routes/:routeId/price-buckets - create price bucket.
+     * POST /routes/:routeId/price-buckets - create price bucket. API does not accept query params.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -472,7 +491,7 @@ function routesFactory(_ref) {
     },
 
     /**
-     * PUT /routes/:routeId/price-buckets/:bucketId - update price bucket.
+     * PUT /routes/:routeId/price-buckets/:bucketId - update price bucket. API does not accept query params.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -503,7 +522,7 @@ function routesFactory(_ref) {
     },
 
     /**
-     * DELETE /routes/:routeId/price-buckets/:bucketId - remove price bucket.
+     * DELETE /routes/:routeId/price-buckets/:bucketId - remove price bucket. API does not accept query params.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -532,7 +551,7 @@ function routesFactory(_ref) {
   /** @type {{ get: function, update: function }} */
   var crossBorderDistances = {
     /**
-     * GET /routes/:routeId/cross-border-distances - get cross border distances.
+     * GET /routes/:routeId/cross-border-distances - get cross border distances. API does not accept query params.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -555,7 +574,7 @@ function routesFactory(_ref) {
     },
 
     /**
-     * PUT /routes/:routeId/cross-border-distances - update cross border distances.
+     * PUT /routes/:routeId/cross-border-distances - update cross border distances. API does not accept query params.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -592,7 +611,7 @@ function routesFactory(_ref) {
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-     * @param {Object} [opts.query] - Query params
+     * @param {RoutesProrationTablesListQuery} [opts.query] - Query params (routeId, providerId, productId)
      * @param {Object} [opts.headers] - Optional headers
      * @returns {Promise<import("axios").AxiosResponse>}
      */
@@ -618,7 +637,7 @@ function routesFactory(_ref) {
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
      * @param {string} opts.routeId - Route id
-     * @param {string} [opts.productId] - Product id (optional query)
+     * @param {string} [opts.productId] - Product id (optional query; filters by product)
      * @param {Object} [opts.headers] - Optional headers
      * @returns {Promise<import("axios").AxiosResponse>}
      */
@@ -640,7 +659,7 @@ function routesFactory(_ref) {
     },
 
     /**
-     * PUT /routes/:routeId/proration-tables - update proration table by route id.
+     * PUT /routes/:routeId/proration-tables - update proration table by route 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/lib/endpoints/inventory/schedule-groups.js

@@ -4,8 +4,9 @@ var _require = require("./../endpoints_helpers.js"),
     authorizationHeaders = _require.authorizationHeaders;
 
 /**
- * @typedef {Object} ScheduleGroupsQuery
- * @property {string} [providerId] - Provider account ID
+ * Query params for GET /schedule-groups (btrz-api-inventory). See get-handler getSpec().
+ * @typedef {Object} ScheduleGroupsListQuery
+ * @property {number} [page] - Page number to retrieve
  */
 
 /**
@@ -26,7 +27,7 @@ function scheduleGroupsFactory(_ref) {
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {ScheduleGroupsQuery} [opts.query] - Query params
+   * @param {ScheduleGroupsListQuery} [opts.query] - Query params
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -44,12 +45,11 @@ function scheduleGroupsFactory(_ref) {
   }
 
   /**
-   * GET /schedule-groups/:scheduleGroupId - get schedule group by id.
+   * GET /schedule-groups/:scheduleGroupId - get schedule group 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.scheduleGroupId - Schedule group id
-   * @param {ScheduleGroupsQuery} [opts.query] - Query params
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -68,7 +68,7 @@ function scheduleGroupsFactory(_ref) {
   }
 
   /**
-   * POST /schedule-groups - create schedule group.
+   * POST /schedule-groups - create schedule group. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -91,7 +91,7 @@ function scheduleGroupsFactory(_ref) {
   }
 
   /**
-   * PUT /schedule-groups/:scheduleGroupId - update schedule group.
+   * PUT /schedule-groups/:scheduleGroupId - update schedule group. 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/lib/endpoints/inventory/schedules.js

@@ -4,6 +4,20 @@
 var _require = require("./../endpoints_helpers.js"),
     authorizationHeaders = _require.authorizationHeaders;
 
+/**
+ * Query params for GET /routes/schedules (btrz-api-inventory). See get-schedules getSpec().
+ * @typedef {Object} SchedulesListQuery
+ * @property {string} [displayName] - Exact schedule name (case sensitive)
+ * @property {string} [stationId] - Schedules that contain this station on legs
+ * @property {string} [routeId] - Filter by route id
+ * @property {string} [labelId] - Filter by label id
+ * @property {string} [onlyActive] - Get active schedules (mutually exclusive with onlyInactive)
+ * @property {string} [onlyInactive] - Get inactive schedules (mutually exclusive with onlyActive)
+ * @property {string} [date] - Schedules active on this date (MM/DD/YYYY)
+ * @property {number} [page] - Page for pagination
+ * @property {string} [providerId] - Filter by provider
+ */
+
 /**
  * Factory for schedules API (btrz-api-inventory).
  * @param {Object} deps
@@ -22,7 +36,7 @@ function schedulesFactory(_ref) {
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {Object} [opts.query] - Query params
+   * @param {SchedulesListQuery} [opts.query] - Query params
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -39,13 +53,12 @@ function schedulesFactory(_ref) {
   }
 
   /**
-   * GET /routes/:routeId/schedules/:scheduleId - get schedule by id.
+   * GET /routes/:routeId/schedules/:scheduleId - get schedule 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.routeId - Route id
    * @param {string} opts.scheduleId - Schedule id
-   * @param {Object} [opts.query] - Query params
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -64,7 +77,7 @@ function schedulesFactory(_ref) {
   }
 
   /**
-   * POST /routes/:routeId/schedules - create schedule.
+   * POST /routes/:routeId/schedules - create schedule. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -91,7 +104,7 @@ function schedulesFactory(_ref) {
   }
 
   /**
-   * PUT /routes/:routeId/schedules/:scheduleId - update schedule.
+   * PUT /routes/:routeId/schedules/:scheduleId - update schedule. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -120,7 +133,7 @@ function schedulesFactory(_ref) {
   }
 
   /**
-   * DELETE /routes/:routeId/schedules/:scheduleId - delete schedule.
+   * DELETE /routes/:routeId/schedules/:scheduleId - delete schedule. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -148,7 +161,7 @@ function schedulesFactory(_ref) {
   /** @type {{ create: function, delete: function }} */
   var autoBouncing = {
     /**
-     * POST /routes/schedules/auto-bouncing - create auto bouncing.
+     * POST /routes/schedules/auto-bouncing - create auto bouncing. API does not accept query params.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -172,7 +185,7 @@ function schedulesFactory(_ref) {
       });
     },
     /**
-     * DELETE /routes/:routeId/schedules/:parentScheduleId/auto-bouncing - delete auto bouncing.
+     * DELETE /routes/:routeId/schedules/:parentScheduleId/auto-bouncing - delete auto bouncing. API does not accept query params.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -201,7 +214,7 @@ function schedulesFactory(_ref) {
   /** @type {{ create: function, delete: function, update: function }} */
   var exceptions = {
     /**
-     * POST /schedules/:scheduleId/schedule-exceptions - create schedule exception.
+     * POST /schedules/:scheduleId/schedule-exceptions - create schedule exception. API does not accept query params.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -227,7 +240,7 @@ function schedulesFactory(_ref) {
       });
     },
     /**
-     * DELETE /schedules/:scheduleId/schedule-exceptions/:exceptionId - delete schedule exception.
+     * DELETE /schedules/:scheduleId/schedule-exceptions/:exceptionId - delete schedule exception. API does not accept query params.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -252,7 +265,7 @@ function schedulesFactory(_ref) {
       });
     },
     /**
-     * PUT /schedules/:scheduleId/schedule-exceptions/:exceptionId - update schedule exception.
+     * PUT /schedules/:scheduleId/schedule-exceptions/:exceptionId - update schedule exception. 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/lib/endpoints/inventory/seatclasses.js

@@ -4,11 +4,6 @@
 var _require = require("./../endpoints_helpers"),
     authorizationHeaders = _require.authorizationHeaders;
 
-/**
- * Query params for seat-classes endpoints (btrz-api-inventory). Forwarded to API as-is.
- * @typedef {Object} InventorySeatclassesQuery
- */
-
 /**
  * Factory for seat-classes API (btrz-api-inventory).
  * @param {Object} deps
@@ -23,11 +18,10 @@ function seatClassesFactory(_ref) {
       internalAuthTokenProvider = _ref.internalAuthTokenProvider;
 
   /**
-   * GET /seat-classes - list seat classes.
+   * GET /seat-classes - list seat classes. 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 {InventorySeatclassesQuery} [opts.query] - Optional query params (forwarded to API)
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -47,12 +41,11 @@ function seatClassesFactory(_ref) {
   }
 
   /**
-   * GET /seat-classes/:id - get seat class by id.
+   * GET /seat-classes/:id - get seat class 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.id - Seat class id
-   * @param {InventorySeatclassesQuery} [opts.query] - Optional query params (forwarded to API)
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -73,13 +66,12 @@ function seatClassesFactory(_ref) {
   }
 
   /**
-   * PUT /seat-classes/:id - update seat class.
+   * PUT /seat-classes/:id - update seat class. 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.id - Seat class id
    * @param {Object} opts.data - Request body
-   * @param {InventorySeatclassesQuery} [opts.query] - Optional query params (forwarded to API)
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -102,12 +94,11 @@ function seatClassesFactory(_ref) {
   }
 
   /**
-   * DELETE /seat-classes/:id - remove seat class.
+   * DELETE /seat-classes/:id - remove seat class. 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.id - Seat class id
-   * @param {InventorySeatclassesQuery} [opts.query] - Optional query params (forwarded to API)
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -128,12 +119,11 @@ function seatClassesFactory(_ref) {
   }
 
   /**
-   * POST /seat-classes - create seat class.
+   * POST /seat-classes - create seat class. 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.data - Request body
-   * @param {InventorySeatclassesQuery} [opts.query] - Optional query params (forwarded to API)
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */

package/lib/endpoints/inventory/seatfees.js

@@ -4,8 +4,11 @@ var _require = require("./../endpoints_helpers.js"),
     authorizationHeaders = _require.authorizationHeaders;
 
 /**
- * Query params for seatfees endpoints (btrz-api-inventory). Forwarded to API as-is.
- * @typedef {Object} InventorySeatfeesQuery
+ * Query params for GET /seat-fees (btrz-api-inventory). See get-handler getSpec().
+ * @typedef {Object} SeatFeesListQuery
+ * @property {string} [disabled] - Filter disabled/enabled [true, false]
+ * @property {string} [providerId] - Provider account id to get seat fees for
+ * @property {string} [currency] - ISO 4217 currency code; defaults to account currency
  */
 
 /**
@@ -25,7 +28,7 @@ function seatfeesFactory(_ref) {
    * GET /seat-fees - list seat fees.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
-   * @param {InventorySeatfeesQuery} [opts.query] - Optional query params (forwarded to API)
+   * @param {SeatFeesListQuery} [opts.query] - Query params
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -42,7 +45,7 @@ function seatfeesFactory(_ref) {
   }
 
   /**
-   * GET /seat-fees/:seatfeeId - get seat fee by id.
+   * GET /seat-fees/:seatfeeId - get seat fee by id. API does not accept query params.
    * @param {Object} opts
    * @param {string} opts.seatfeeId - Seat fee id
    * @param {string} [opts.token] - API key
@@ -60,7 +63,7 @@ function seatfeesFactory(_ref) {
   }
 
   /**
-   * POST /seat-fees - create seat fee.
+   * POST /seat-fees - create seat fee. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} [opts.token] - API key
@@ -85,7 +88,7 @@ function seatfeesFactory(_ref) {
   }
 
   /**
-   * PUT /seat-fees/:seatfeeId - update seat fee.
+   * PUT /seat-fees/:seatfeeId - update seat fee. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} [opts.token] - API key

package/lib/endpoints/inventory/seatmaps.js

@@ -5,8 +5,35 @@ var _require = require("./../endpoints_helpers.js"),
     authorizationHeaders = _require.authorizationHeaders;
 
 /**
- * @typedef {Object} SeatmapsQuery
- * @property {string} [providerId] - Provider account ID
+ * Query params for GET /seatmaps (btrz-api-inventory). See get-handler getSpec().
+ * @typedef {Object} SeatmapsListQuery
+ * @property {string} [vehicleId] - Return only seatmaps assigned to this vehicle; disables pagination
+ * @property {string} [name] - Filter by name (case-insensitive partial match)
+ * @property {string} [amenityGroupId] - Filter by amenity group id
+ * @property {string} [brandId] - Filter by brand id
+ * @property {number} [capacity] - Filter by exact capacity
+ * @property {boolean} [standard] - Filter by standard seatmap flag
+ * @property {boolean} [originalOnly] - When true, only original seatmaps (no manifest copies)
+ * @property {boolean} [newdesign] - When true, query new design collection; otherwise legacy
+ * @property {number} [page] - Page number (1-based, 20 per page); ignored when vehicleId provided
+ */
+
+/**
+ * Query params for GET /seatmaps/:seatmapId/available-seats/... (btrz-api-inventory). See get-seatmaps-id-available-seats getSpec().
+ * @typedef {Object} SeatmapsAvailableSeatsQuery
+ * @property {boolean} [newdesign] - If true and account uses new design, return new structure
+ * @property {string} [originId] - Origin station for segment (required for API)
+ * @property {string} [destinationId] - Destination station for segment (required for API)
+ * @property {string} [providerId] - Provider id; defaults to account
+ * @property {string} [legFromIndex] - Departure station index in schedule (0-based)
+ * @property {string} [legToIndex] - Arrival station index in schedule (0-based)
+ * @property {string} [channel] - Channel: agency, agency-backoffice, backoffice, websales, agency-websales
+ */
+
+/**
+ * Query for GET /seatmaps/:seatmapId/occupied-seats (btrz-api-inventory). See get-occupied-seats getSpec().
+ * @typedef {Object} SeatmapsOccupiedSeatsQuery
+ * @property {boolean} newdesign - Must be true; required for new-design seatmaps
  */
 
 /**
@@ -27,7 +54,7 @@ function seatmapsFactory(_ref) {
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {SeatmapsQuery} [opts.query] - Query params
+   * @param {SeatmapsListQuery} [opts.query] - Query params
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -51,7 +78,7 @@ function seatmapsFactory(_ref) {
    * @param {string} opts.routeId - Route id
    * @param {string} opts.scheduleId - Schedule id
    * @param {string} opts.manifestDate - Manifest date
-   * @param {SeatmapsQuery} [opts.query] - Query params
+   * @param {SeatmapsAvailableSeatsQuery} [opts.query] - Query params (originId, destinationId, etc.)
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -77,7 +104,7 @@ function seatmapsFactory(_ref) {
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.seatmapId - Seatmap id
-   * @param {SeatmapsQuery} [opts.query] - Query params
+   * @param {string} [opts.providerId] - Optional account id to scope lookup (query)
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -96,7 +123,7 @@ function seatmapsFactory(_ref) {
   }
 
   /**
-   * POST /seatmaps - create seatmap.
+   * POST /seatmaps - create seatmap. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -121,7 +148,7 @@ function seatmapsFactory(_ref) {
   }
 
   /**
-   * PUT /seatmaps/:seatmapId - update seatmap.
+   * PUT /seatmaps/:seatmapId - update seatmap. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -148,7 +175,7 @@ function seatmapsFactory(_ref) {
   }
 
   /**
-   * DELETE /seatmaps/:seatmapId - remove seatmap.
+   * DELETE /seatmaps/:seatmapId - remove seatmap. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -170,12 +197,12 @@ function seatmapsFactory(_ref) {
   }
 
   /**
-   * GET /seatmaps/:seatmapId/occupied-seats - get occupied seats.
+   * GET /seatmaps/:seatmapId/occupied-seats - get occupied seats. Requires newdesign=true in query.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.seatmapId - Seatmap id
-   * @param {SeatmapsQuery} [opts.query] - Query params
+   * @param {SeatmapsOccupiedSeatsQuery} [opts.query] - Query (newdesign required)
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */