btrz-api-client 8.29.0 → 8.31.0

package/lib/endpoints/inventory/service-numbers.js

@@ -1,12 +1,38 @@
 "use strict";
 
-var _require = require("./../endpoints_helpers"),
+var _require = require("./../endpoints_helpers.js"),
     authorizationHeaders = _require.authorizationHeaders;
 
+/**
+ * Query params for GET /service-numbers (btrz-api-inventory). See get-handler getSpec().
+ * @typedef {Object} ServiceNumbersListQuery
+ * @property {string} [name] - Filter by service number name
+ * @property {boolean} [enabled] - Filter enabled/disabled
+ * @property {number} [page] - Page for pagination
+ */
+
+/**
+ * Factory for service-numbers API (btrz-api-inventory).
+ * @param {Object} deps
+ * @param {import("axios").AxiosInstance} deps.client
+ * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
+ * @returns {{ all: function, create: function, update: function, get: function }}
+ */
+
+
 function serviceNumbersFactory(_ref) {
   var client = _ref.client,
       internalAuthTokenProvider = _ref.internalAuthTokenProvider;
 
+  /**
+   * GET /service-numbers - list service numbers.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {ServiceNumbersListQuery} [opts.query] - Query params
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function all(_ref2) {
     var token = _ref2.token,
         jwtToken = _ref2.jwtToken,
@@ -21,6 +47,15 @@ function serviceNumbersFactory(_ref) {
     });
   }
 
+  /**
+   * POST /service-numbers - create service number. 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.serviceNumber - Service number payload
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function create(_ref3) {
     var token = _ref3.token,
         jwtToken = _ref3.jwtToken,
@@ -37,6 +72,16 @@ function serviceNumbersFactory(_ref) {
     });
   }
 
+  /**
+   * PUT /service-numbers/:serviceNumberId - update service number. API does not accept query params.
+   * @param {Object} opts
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {string} [opts.token] - API key
+   * @param {string} opts.serviceNumberId - Service number id
+   * @param {Object} opts.serviceNumber - Service number payload
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function update(_ref4) {
     var jwtToken = _ref4.jwtToken,
         token = _ref4.token,
@@ -54,6 +99,15 @@ function serviceNumbersFactory(_ref) {
     });
   }
 
+  /**
+   * GET /service-numbers/:serviceNumberId - get service number by id. API does not accept query params.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} opts.serviceNumberId - Service number id
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function get(_ref5) {
     var token = _ref5.token,
         serviceNumberId = _ref5.serviceNumberId,

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

@@ -1,13 +1,28 @@
 "use strict";
 
-var _require = require("./../endpoints_helpers"),
+var _require = require("./../endpoints_helpers.js"),
     authorizationHeaders = _require.authorizationHeaders;
 
+/**
+ * Factory for service-types API (btrz-api-inventory).
+ * @param {Object} deps
+ * @param {import("axios").AxiosInstance} deps.client
+ * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
+ * @returns {{ all: function, get: function, create: function, update: function, remove: function }}
+ */
+
+
 function serviceTypesFactory(_ref) {
   var client = _ref.client,
       internalAuthTokenProvider = _ref.internalAuthTokenProvider;
 
-
+  /**
+   * GET /service-types - list service types. API does not accept query params (getSpec has no query parameters).
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function all(_ref2) {
     var token = _ref2.token,
         _ref2$query = _ref2.query,
@@ -20,6 +35,14 @@ function serviceTypesFactory(_ref) {
     });
   }
 
+  /**
+   * GET /service-types/:serviceTypeId - get service type by id. API does not accept query params.
+   * @param {Object} opts
+   * @param {string} opts.serviceTypeId - Service type id
+   * @param {string} [opts.token] - API key
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function get(_ref3) {
     var serviceTypeId = _ref3.serviceTypeId,
         token = _ref3.token,
@@ -30,6 +53,15 @@ function serviceTypesFactory(_ref) {
     });
   }
 
+  /**
+   * POST /service-types - create service type. API does not accept query params.
+   * @param {Object} opts
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {string} [opts.token] - API key
+   * @param {Object} opts.serviceType - Service type payload
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function create(_ref4) {
     var jwtToken = _ref4.jwtToken,
         token = _ref4.token,
@@ -46,6 +78,15 @@ function serviceTypesFactory(_ref) {
     });
   }
 
+  /**
+   * DELETE /service-types/:serviceTypeId - remove service type. API does not accept query params.
+   * @param {Object} opts
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {string} opts.serviceTypeId - Service type id
+   * @param {string} [opts.token] - API key
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function remove(_ref5) {
     var jwtToken = _ref5.jwtToken,
         serviceTypeId = _ref5.serviceTypeId,
@@ -59,6 +100,16 @@ function serviceTypesFactory(_ref) {
     });
   }
 
+  /**
+   * PUT /service-types/:serviceTypeId - update service type. API does not accept query params.
+   * @param {Object} opts
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {string} [opts.token] - API key
+   * @param {string} opts.serviceTypeId - Service type id
+   * @param {Object} opts.serviceType - Service type payload
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function update(_ref6) {
     var jwtToken = _ref6.jwtToken,
         token = _ref6.token,

package/lib/endpoints/inventory/ssrs.js

@@ -1,13 +1,42 @@
 "use strict";
 
-var _require = require("./../endpoints_helpers"),
+var _require = require("./../endpoints_helpers.js"),
     authorizationHeaders = _require.authorizationHeaders;
 
+/**
+ * Query params for GET /ssrs (btrz-api-inventory). See get-ssrs getSpec().
+ * @typedef {Object} SsrsListQuery
+ * @property {string} [providerIds] - Provider ids to get SSRs for
+ * @property {string} [travelDate] - Travel date (yyyy-mm-dd)
+ * @property {string} [travelTime] - Travel time (HH:MM); required if travelDate provided
+ * @property {string} [tripId] - Trip id to get SSRs for
+ * @property {string} [productIds] - Product type ids
+ * @property {string} [enabled] - Filter enabled/disabled [true, false]
+ * @property {string} [currency] - Currency ISO code
+ * @property {string} [brandIds] - Trip brand ids
+ */
+
+/**
+ * Factory for ssrs API (btrz-api-inventory).
+ * @param {Object} deps
+ * @param {import("axios").AxiosInstance} deps.client
+ * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
+ * @returns {{ all: function }}
+ */
+
+
 function ssrsFactory(_ref) {
   var client = _ref.client,
       internalAuthTokenProvider = _ref.internalAuthTokenProvider;
 
-
+  /**
+   * GET /ssrs - list SSRs.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {SsrsListQuery} [opts.query] - Query params
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function all(_ref2) {
     var token = _ref2.token,
         _ref2$query = _ref2.query,

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

@@ -3,10 +3,35 @@
 var _require = require("../endpoints_helpers.js"),
     authorizationHeaders = _require.authorizationHeaders;
 
+/**
+ * Query params for GET /station-classes (btrz-api-inventory). See get-handler getSpec().
+ * @typedef {Object} StationClassesListQuery
+ * @property {number} [page] - Page number to retrieve
+ * @property {string} [name] - Filter by station class name
+ */
+
+/**
+ * Factory for station-classes API (btrz-api-inventory).
+ * @param {Object} deps
+ * @param {import("axios").AxiosInstance} deps.client
+ * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
+ * @returns {{ all: function, get: function, update: function, remove: function, create: function }}
+ */
+
+
 function stationClassFactory(_ref) {
   var client = _ref.client,
       internalAuthTokenProvider = _ref.internalAuthTokenProvider;
 
+  /**
+   * GET /station-classes - list station classes.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {StationClassesListQuery} [opts.query] - Query params
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function all(_ref2) {
     var token = _ref2.token,
         jwtToken = _ref2.jwtToken,
@@ -22,6 +47,15 @@ function stationClassFactory(_ref) {
     });
   }
 
+  /**
+   * GET /station-classes/:stationClassId - get station 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.stationClassId - Station class id
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function get(_ref3) {
     var token = _ref3.token,
         jwtToken = _ref3.jwtToken,
@@ -38,6 +72,16 @@ function stationClassFactory(_ref) {
     });
   }
 
+  /**
+   * PUT /station-classes/:stationClassId - update station 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.stationClassId - Station class id
+   * @param {Object} opts.data - Station class payload
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function update(_ref4) {
     var token = _ref4.token,
         jwtToken = _ref4.jwtToken,
@@ -53,6 +97,15 @@ function stationClassFactory(_ref) {
     });
   }
 
+  /**
+   * DELETE /station-classes/:stationClassId - remove station 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.stationClassId - Station class id
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function remove(_ref5) {
     var token = _ref5.token,
         jwtToken = _ref5.jwtToken,
@@ -66,6 +119,15 @@ function stationClassFactory(_ref) {
     });
   }
 
+  /**
+   * POST /station-classes - create station 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 - Station class payload
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function create(_ref6) {
     var token = _ref6.token,
         jwtToken = _ref6.jwtToken,

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

@@ -3,10 +3,34 @@
 var _require = require("./../endpoints_helpers.js"),
     authorizationHeaders = _require.authorizationHeaders;
 
+/**
+ * Query params for GET /station-groups (btrz-api-inventory). See get-handler getSpec().
+ * @typedef {Object} StationGroupsListQuery
+ * @property {string} [providerIds] - Provider ids to get station groups for
+ */
+
+/**
+ * Factory for station-groups API (btrz-api-inventory).
+ * @param {Object} deps
+ * @param {import("axios").AxiosInstance} deps.client
+ * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
+ * @returns {{ all: function }}
+ */
+
+
 function stationGroupsFactory(_ref) {
   var client = _ref.client,
       internalAuthTokenProvider = _ref.internalAuthTokenProvider;
 
+  /**
+   * 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 {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function all(_ref2) {
     var token = _ref2.token,
         _ref2$query = _ref2.query,

package/lib/endpoints/inventory/stations-provinces.js

@@ -3,10 +3,27 @@
 var _require = require("../endpoints_helpers.js"),
     authorizationHeaders = _require.authorizationHeaders;
 
+/**
+ * Factory for stations/provinces API (btrz-api-inventory).
+ * @param {Object} deps
+ * @param {import("axios").AxiosInstance} deps.client
+ * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
+ * @returns {{ all: function }}
+ */
+
+
 function stationsProvincesFactory(_ref) {
   var client = _ref.client,
       internalAuthTokenProvider = _ref.internalAuthTokenProvider;
 
+  /**
+   * GET /stations/provinces - list station provinces. 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
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function all(_ref2) {
     var token = _ref2.token,
         _ref2$query = _ref2.query,

package/lib/endpoints/inventory/stations-zones.js

@@ -3,10 +3,34 @@
 var _require = require("./../endpoints_helpers.js"),
     authorizationHeaders = _require.authorizationHeaders;
 
+/**
+ * Query params for GET /stations/zones (btrz-api-inventory). See 01-get-stations-zones getSpec().
+ * @typedef {Object} StationsZonesQuery
+ * @property {string} [accountIds] - Comma-separated account ids to get zones for (agency accounts)
+ */
+
+/**
+ * Factory for stations/zones API (btrz-api-inventory).
+ * @param {Object} deps
+ * @param {import("axios").AxiosInstance} deps.client
+ * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
+ * @returns {{ get: function }}
+ */
+
+
 function stationsZonesFactory(_ref) {
   var client = _ref.client,
       internalAuthTokenProvider = _ref.internalAuthTokenProvider;
 
+  /**
+   * GET /stations/zones - get station zones.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {StationsZonesQuery} [opts.query] - Query params (accountIds)
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function get(_ref2) {
     var token = _ref2.token,
         _ref2$query = _ref2.query,

package/lib/endpoints/inventory/stations.js

@@ -1,12 +1,53 @@
 "use strict";
 
-var _require = require("./../endpoints_helpers"),
+var _require = require("./../endpoints_helpers.js"),
     authorizationHeaders = _require.authorizationHeaders;
 
+/**
+ * Query params for GET /stations (btrz-api-inventory). See get-stations getSpec().
+ * @typedef {Object} StationsQuery
+ * @property {string} [providerId] - The id of the provider to get stations for
+ * @property {string} [providerIds] - The ids of the providers to get stations for
+ * @property {string} [productId] - The id of the product
+ * @property {string} [departure] - The id of the origin station
+ * @property {string} [province] - The province of the station
+ * @property {string} [zone] - The zone of the station
+ * @property {string} [type] - The type name of the station
+ * @property {string} [name] - The full name of the station
+ * @property {string} [partialName] - Full or partial name (case-insensitive match)
+ * @property {string} [enabled] - Filter by enabled: "true" | "false"
+ * @property {number} [page] - Page for pagination
+ * @property {string} [orderBy] - Field to order by
+ * @property {string} [orderDir] - Order direction: asc (1) or desc (-1), default 1
+ * @property {string} [stationIds] - Comma-separated station ids to return
+ * @property {string} [filterHeadStations] - Filter stations that are grouping any station
+ * @property {string} [includesStationsGroupFor] - Include stations that group/include the sent station id
+ * @property {string} [externalId] - The id of the station in the external system
+ * @property {string} [shortcode] - The shortcode of the station to filter by
+ */
+
+/**
+ * Factory for stations API (btrz-api-inventory).
+ * @param {Object} deps
+ * @param {import("axios").AxiosInstance} deps.client
+ * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
+ * @returns {{ get: function, all: function, create: function, update: function }}
+ */
+
+
 function stationsFactory(_ref) {
   var client = _ref.client,
       internalAuthTokenProvider = _ref.internalAuthTokenProvider;
 
+  /**
+   * GET /stations/:id - get station 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 - Station id
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function get(_ref2) {
     var token = _ref2.token,
         id = _ref2.id,
@@ -17,6 +58,15 @@ function stationsFactory(_ref) {
     });
   }
 
+  /**
+   * GET /stations - list stations.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {StationsQuery} [opts.query] - Query params (providerId, productId, name, page, etc.)
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function all(_ref3) {
     var token = _ref3.token,
         _ref3$query = _ref3.query,
@@ -29,6 +79,15 @@ function stationsFactory(_ref) {
     });
   }
 
+  /**
+   * POST /stations - create station. 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 - Station payload
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function create(_ref4) {
     var token = _ref4.token,
         jwtToken = _ref4.jwtToken,
@@ -45,6 +104,16 @@ function stationsFactory(_ref) {
     });
   }
 
+  /**
+   * PUT /station/:stationId - update station. 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.stationId - Station id
+   * @param {Object} opts.station - Station payload
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function update(_ref5) {
     var token = _ref5.token,
         jwtToken = _ref5.jwtToken,