btrz-api-client 8.29.0 → 8.31.0

package/src/endpoints/inventory/amenities.js

@@ -1,36 +1,88 @@
-const { authorizationHeaders } = require("./../endpoints_helpers");
+const {authorizationHeaders} = require("./../endpoints_helpers.js");
 
-function amenitiesFactory({ client, internalAuthTokenProvider }) {
+/**
+ * Query params for GET /amenities (btrz-api-inventory). See get-amenities getSpec().
+ * @typedef {Object} AmenitiesListQuery
+ * @property {string} [name] - Filter by name
+ * @property {string} [amenityId] - Filter by amenity ID
+ * @property {string} [enabled] - Filter by enabled status
+ * @property {number} [page] - Page for pagination
+ */
 
-  function all({ token, query = {}, headers }) {
+/**
+ * Factory for amenities 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 }}
+ */
+function amenitiesFactory({client, internalAuthTokenProvider}) {
+  /**
+   * GET /amenities - list amenities.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {AmenitiesListQuery} [opts.query] - Query params (name, amenityId, enabled, page)
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
+  function all({token, query = {}, headers}) {
     return client.get("/amenities", {
       params: query,
       headers: authorizationHeaders({token, internalAuthTokenProvider, headers})
     });
   }
 
-  function get({ token, amenityId, query = {}, headers }) {
+  /**
+   * GET /amenities/:amenityId - get amenity 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.amenityId - Amenity id
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
+  function get({token, amenityId, query = {}, headers}) {
     return client.get(`/amenities/${amenityId}`, {
       params: query,
       headers: authorizationHeaders({token, internalAuthTokenProvider, headers})
     });
   }
 
-  function create({ token, jwtToken, amenity, headers }) {
+  /**
+   * POST /amenities - create amenity. 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.amenity - Amenity payload
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
+  function create({token, jwtToken, amenity, headers}) {
     return client({
       url: "/amenities",
       method: "post",
       headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers}),
-      data: { amenity }
+      data: {amenity}
     });
   }
 
-  function update({ token, jwtToken, amenityId, amenity, headers }) {
+  /**
+   * PUT /amenities/:amenityId - update amenity. 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.amenityId - Amenity id
+   * @param {Object} opts.amenity - Amenity payload
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
+  function update({token, jwtToken, amenityId, amenity, headers}) {
     return client({
       url: `/amenities/${amenityId}`,
       method: "put",
       headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers}),
-      data: { amenity }
+      data: {amenity}
     });
   }
 

package/src/endpoints/inventory/amenity-groups.js

@@ -1,36 +1,89 @@
-const { authorizationHeaders } = require("./../endpoints_helpers");
+const {authorizationHeaders} = require("./../endpoints_helpers.js");
 
-function amenityGroupsFactory({ client, internalAuthTokenProvider }) {
+/**
+ * Query params for GET /amenity-groups (btrz-api-inventory). See get-amenity-groups getSpec().
+ * @typedef {Object} AmenityGroupsListQuery
+ * @property {string} [name] - Filter by name
+ * @property {string} [amenityId] - Filter by amenity ID
+ * @property {string} [enabled] - Filter by enabled status
+ * @property {number} [page] - Page for pagination
+ * @property {number} [pageSize] - Results per page
+ */
 
-  function all({ token, query = {}, headers }) {
+/**
+ * Factory for amenity-groups 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 }}
+ */
+function amenityGroupsFactory({client, internalAuthTokenProvider}) {
+  /**
+   * GET /amenity-groups - list amenity groups.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {AmenityGroupsListQuery} [opts.query] - Query params (name, amenityId, enabled, page, pageSize)
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
+  function all({token, query = {}, headers}) {
     return client.get("/amenity-groups", {
       params: query,
       headers: authorizationHeaders({token, internalAuthTokenProvider, headers})
     });
   }
 
-  function get({ token, amenityGroupId, query = {}, headers }) {
+  /**
+   * GET /amenity-groups/:amenityGroupId - get amenity 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.amenityGroupId - Amenity group id
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
+  function get({token, amenityGroupId, query = {}, headers}) {
     return client.get(`/amenity-groups/${amenityGroupId}`, {
       params: query,
       headers: authorizationHeaders({token, internalAuthTokenProvider, headers})
     });
   }
 
-  function create({ token, jwtToken, amenityGroup, headers }) {
+  /**
+   * POST /amenity-groups - create amenity 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
+   * @param {Object} opts.amenityGroup - Amenity group payload
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
+  function create({token, jwtToken, amenityGroup, headers}) {
     return client({
       url: "/amenity-groups",
       method: "post",
       headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers}),
-      data: { amenityGroup }
+      data: {amenityGroup}
     });
   }
 
-  function update({ token, jwtToken, amenityGroupId, amenityGroup, headers }) {
+  /**
+   * PUT /amenity-groups/:amenityGroupId - update amenity 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
+   * @param {string} opts.amenityGroupId - Amenity group id
+   * @param {Object} opts.amenityGroup - Amenity group payload
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
+  function update({token, jwtToken, amenityGroupId, amenityGroup, headers}) {
     return client({
       url: `/amenity-groups/${amenityGroupId}`,
       method: "put",
       headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers}),
-      data: { amenityGroup }
+      data: {amenityGroup}
     });
   }
 

package/src/endpoints/inventory/banks.js

@@ -2,7 +2,22 @@ const {
   authorizationHeaders
 } = require("./../endpoints_helpers.js");
 
+/**
+ * Factory for banks 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 banksFactory({client, internalAuthTokenProvider}) {
+  /**
+   * GET /banks - list banks. 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({
     token,
     jwtToken,
@@ -15,12 +30,30 @@ function banksFactory({client, internalAuthTokenProvider}) {
     });
   }
 
+  /**
+   * GET /banks/:bankId - get bank 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.bankId - Bank id
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function get({bankId, token, headers, jwtToken}) {
     return client.get(`/banks/${bankId}`, {
       headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers})
     });
   }
 
+  /**
+   * POST /banks - create bank. 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.bank - Bank payload
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function create({jwtToken, token, bank, headers}) {
     return client({
       url: "/banks",
@@ -32,6 +65,15 @@ function banksFactory({client, internalAuthTokenProvider}) {
     });
   }
 
+  /**
+   * DELETE /banks/:bankId - remove bank. 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.bankId - Bank id
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function remove({jwtToken, bankId, token, headers}) {
     return client({
       url: `/banks/${bankId}`,
@@ -40,6 +82,16 @@ function banksFactory({client, internalAuthTokenProvider}) {
     });
   }
 
+  /**
+   * PUT /banks/:bankId - update bank. 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.bankId - Bank id
+   * @param {Object} opts.bank - Bank payload
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function update({jwtToken, token, bankId, bank, headers}) {
     return client({
       url: `/banks/${bankId}`,

package/src/endpoints/inventory/bare-routes.js

@@ -1,6 +1,35 @@
-const {authorizationHeaders} = require("./../endpoints_helpers");
+const {authorizationHeaders} = require("./../endpoints_helpers.js");
 
+/**
+ * Query params for GET /bare-routes (btrz-api-inventory). See get-bare-routes getSpec().
+ * @typedef {Object} BareRoutesListQuery
+ * @property {string} [providerIds] - Comma-separated provider IDs
+ * @property {string} [productIds] - Comma-separated product IDs
+ */
+
+/**
+ * Query params for GET /bare-routes/:routeId (btrz-api-inventory). See get-bare-routes-id getSpec().
+ * @typedef {Object} BareRoutesGetQuery
+ * @property {string} [providerIds] - Comma-separated provider IDs
+ */
+
+/**
+ * Factory for bare-routes API (btrz-api-inventory).
+ * @param {Object} deps
+ * @param {import("axios").AxiosInstance} deps.client
+ * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
+ * @returns {{ all: function, get: function }}
+ */
 function bareRoutesFactory({client, internalAuthTokenProvider}) {
+  /**
+   * GET /bare-routes - list bare routes.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {BareRoutesListQuery} [opts.query] - Query params (providerIds, productIds)
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function all({token, query = {}, headers}) {
     return client({
       url: "/bare-routes",
@@ -9,6 +38,16 @@ function bareRoutesFactory({client, internalAuthTokenProvider}) {
     });
   }
 
+  /**
+   * GET /bare-routes/:routeId - get bare route by id.
+   * @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 {BareRoutesGetQuery} [opts.query] - Query params (providerIds)
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function get({routeId, token, query = {}, headers}) {
     return client({
       url: `/bare-routes/${routeId}`,

package/src/endpoints/inventory/brands.js

@@ -1,38 +1,90 @@
-const { authorizationHeaders } = require("./../endpoints_helpers");
+const {authorizationHeaders} = require("./../endpoints_helpers.js");
 
-function brandsFactory({ client, internalAuthTokenProvider }) {
+/**
+ * Query params for GET /brands (btrz-api-inventory). See get-brands getSpec().
+ * @typedef {Object} BrandsListQuery
+ * @property {string} [providerIds] - Comma-separated provider IDs
+ * @property {string} [enabled] - Filter by enabled status
+ * @property {number} [page] - Page for pagination
+ * @property {number} [pageSize] - Results per page
+ */
 
-  function all({ token, jwtToken, query = {}, headers }) {
+/**
+ * Factory for brands 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 brandsFactory({client, internalAuthTokenProvider}) {
+  /**
+   * GET /brands - list brands.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {BrandsListQuery} [opts.query] - Query params (providerIds, enabled, page, pageSize)
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
+  function all({token, jwtToken, query = {}, headers}) {
     return client({
       url: "/brands",
       params: query,
-      headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers}),
+      headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers})
     });
   }
 
-  function create({ token, jwtToken, brand, headers }) {
+  /**
+   * POST /brands - create brand. 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.brand - Brand payload
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
+  function create({token, jwtToken, brand, headers}) {
     return client({
       url: "/brands",
       method: "post",
       headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers}),
-      data: { brand }
+      data: {brand}
     });
   }
 
-  function update({ jwtToken, token, brandId, brand, headers }) {
-    return client({ 
+  /**
+   * PUT /brands/:brandId - update brand. 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.brandId - Brand id
+   * @param {Object} opts.brand - Brand payload
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
+  function update({jwtToken, token, brandId, brand, headers}) {
+    return client({
       url: `/brands/${brandId}`,
       method: "put",
       headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers}),
-      data: { brand }
+      data: {brand}
     });
   }
 
+  /**
+   * GET /brands/:brandId - get brand 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.brandId - Brand id
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function get({token, brandId, jwtToken, headers}) {
     return client({
       url: `/brands/${brandId}`,
       method: "get",
-      headers: authorizationHeaders({token, internalAuthTokenProvider, jwtToken, headers}),
+      headers: authorizationHeaders({token, internalAuthTokenProvider, jwtToken, headers})
     });
   }
 

package/src/endpoints/inventory/bundle-fares.js

@@ -1,8 +1,32 @@
-const { authorizationHeaders } = require("./../endpoints_helpers");
+const {authorizationHeaders} = require("./../endpoints_helpers.js");
 
-function bundleFaresFactory({client, internalAuthTokenProvider}) {
+/**
+ * Query params for GET /bundle/:bundleId/product/:productId (btrz-api-inventory). See get-bundle-fares getSpec().
+ * @typedef {Object} BundleFaresQuery
+ * @property {string} [providerIds] - Comma-separated provider IDs
+ * @property {string} [channel] - Channel filter
+ */
 
-  function all({ token, bundleId, productId, query = {}, headers }) {
+/**
+ * Factory for bundle-fares API (btrz-api-inventory).
+ * @param {Object} deps
+ * @param {import("axios").AxiosInstance} deps.client
+ * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
+ * @returns {{ all: function }}
+ */
+function bundleFaresFactory({client, internalAuthTokenProvider}) {
+  /**
+   * GET /bundle/:bundleId/product/:productId - list bundle fares.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {string} opts.bundleId - Bundle id
+   * @param {string} opts.productId - Product id
+   * @param {BundleFaresQuery} [opts.query] - Query params (providerIds, channel)
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
+  function all({token, bundleId, productId, query = {}, headers}) {
     return client.get(`/bundle/${bundleId}/product/${productId}`, {
       params: query,
       headers: authorizationHeaders({token, internalAuthTokenProvider, headers})
@@ -12,7 +36,6 @@ function bundleFaresFactory({client, internalAuthTokenProvider}) {
   return {
     all
   };
-
 }
 
 module.exports = bundleFaresFactory;

package/src/endpoints/inventory/bundles.js

@@ -1,15 +1,47 @@
-const { authorizationHeaders } = require("./../endpoints_helpers");
+const {authorizationHeaders} = require("./../endpoints_helpers.js");
 
-function bundlesFactory({ client, internalAuthTokenProvider }) {
+/**
+ * Query params for GET /bundles (btrz-api-inventory). See get-bundles getSpec().
+ * @typedef {Object} InventoryBundlesQuery
+ * @property {string} [providerId] - Provider account ID
+ * @property {string} [type] - Bundle type filter
+ * @property {string} [disabled] - Filter by disabled status
+ */
 
-  function all({ token, jwtToken, query = {}, headers }) {
+/**
+ * Factory for bundles API (btrz-api-inventory).
+ * @param {Object} deps
+ * @param {import("axios").AxiosInstance} deps.client
+ * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
+ * @returns {{ all: function, get: function }}
+ */
+function bundlesFactory({client, internalAuthTokenProvider}) {
+  /**
+   * GET /bundles - list bundles.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {InventoryBundlesQuery} [opts.query] - Query params (providerId, type, disabled)
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
+  function all({token, jwtToken, query = {}, headers}) {
     return client({
       url: "/bundles",
       params: query,
-      headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers}),
+      headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers})
     });
   }
 
+  /**
+   * GET /bundles/:bundleId - get bundle 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.bundleId - Bundle id
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function get({token, jwtToken, bundleId, headers}) {
     return client({
       url: `/bundles/${bundleId}`,
@@ -24,4 +56,4 @@ function bundlesFactory({ client, internalAuthTokenProvider }) {
   };
 }
 
-module.exports = bundlesFactory;
+module.exports = bundlesFactory;

package/src/endpoints/inventory/change-requests.js

@@ -1,6 +1,38 @@
 const {authorizationHeaders} = require("./../endpoints_helpers.js");
 
+/**
+ * Query params for GET /change-requests (btrz-api-inventory). See get-change-requests getSpec().
+ * @typedef {Object} ChangeRequestsListQuery
+ * @property {string} [type] - Filter by change request type
+ * @property {string} [status] - Filter by status
+ * @property {string} [createdBy] - Filter by user id
+ * @property {string} [from] - Filter by creation date from (YYYY-MM-DD)
+ * @property {string} [to] - Filter by creation date to (YYYY-MM-DD)
+ * @property {string} [operationId] - Filter by operation ID
+ * @property {string} [operationType] - Filter by operation type
+ * @property {number} [page] - Page number
+ * @property {string} [orderBy] - Field to order by
+ * @property {string} [orderDir] - asc (1) or desc (-1)
+ * @property {number} [pageSize] - Results per page
+ */
+
+/**
+ * Factory for change-requests 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, schedules: object }}
+ */
 function changeRequestsFactory({client, internalAuthTokenProvider}) {
+  /**
+   * GET /change-requests - list change requests.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {ChangeRequestsListQuery} [opts.query] - Query params
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function all({token, jwtToken, query = {}, headers}) {
     return client.get("/change-requests", {
       params: query,
@@ -8,6 +40,15 @@ function changeRequestsFactory({client, internalAuthTokenProvider}) {
     });
   }
 
+  /**
+   * GET /change-requests/:changerequestId/manifests - get change request manifests. 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.changerequestId - Change request id
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function get({changerequestId, token, jwtToken, query = {}, headers}) {
     return client({
       url: `/change-requests/${changerequestId}/manifests`,
@@ -16,6 +57,15 @@ function changeRequestsFactory({client, internalAuthTokenProvider}) {
     });
   }
 
+  /**
+   * POST /change-requests/manifests - create change request 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.data - Manifest payload
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function create({data, token, jwtToken, headers}) {
     return client({
       url: "/change-requests/manifests",
@@ -25,6 +75,16 @@ function changeRequestsFactory({client, internalAuthTokenProvider}) {
     });
   }
 
+  /**
+   * PUT /change-requests/:changerequestId/manifests - update change request 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 {string} opts.changerequestId - Change request id
+   * @param {Object} opts.data - Manifest payload
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function update({changerequestId, data, token, jwtToken, headers}) {
     return client({
       url: `/change-requests/${changerequestId}/manifests`,
@@ -34,7 +94,17 @@ function changeRequestsFactory({client, internalAuthTokenProvider}) {
     });
   }
 
+  /** @type {{ get: function, create: function, update: function }} */
   const schedules = {
+    /**
+     * GET /change-requests/:changeRequestId/schedules - get change request schedules. 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.changeRequestId - Change request id
+     * @param {Object} [opts.headers] - Optional headers
+     * @returns {Promise<import("axios").AxiosResponse>}
+     */
     get({changeRequestId, token, jwtToken, query = {}, headers}) {
       return client({
         url: `/change-requests/${changeRequestId}/schedules`,
@@ -43,6 +113,15 @@ function changeRequestsFactory({client, internalAuthTokenProvider}) {
       });
     },
 
+    /**
+     * POST /change-requests/schedules - create change request 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
+     * @param {Object} opts.data - Schedule payload
+     * @param {Object} [opts.headers] - Optional headers
+     * @returns {Promise<import("axios").AxiosResponse>}
+     */
     create({data, token, jwtToken, headers}) {
       return client({
         url: "/change-requests/schedules",
@@ -52,6 +131,16 @@ function changeRequestsFactory({client, internalAuthTokenProvider}) {
       });
     },
 
+    /**
+     * PUT /change-requests/:changeRequestId/schedules - update change request 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
+     * @param {string} opts.changeRequestId - Change request id
+     * @param {Object} opts.data - Schedule payload
+     * @param {Object} [opts.headers] - Optional headers
+     * @returns {Promise<import("axios").AxiosResponse>}
+     */
     update({changeRequestId, data, token, jwtToken, headers}) {
       return client({
         url: `/change-requests/${changeRequestId}/schedules`,