btrz-api-client 8.31.0 → 8.32.0

package/src/endpoints/accounts/point-to-point-settings.js

@@ -3,7 +3,7 @@ const {
 } = require("../endpoints_helpers.js");
 
 /**
- * Factory for point-to-point-settings API (btrz-api-accounts).
+ * Factory for point-to-point-settings API (btrz-api-accounts). Requires user logged in to backoffice app.
  * @param {Object} deps
  * @param {import("axios").AxiosInstance} deps.client
  * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
@@ -11,12 +11,12 @@ const {
  */
 function pointToPointSettingsFactory({client, internalAuthTokenProvider}) {
   /**
-   * GET /point-to-point-settings - get point-to-point settings. API does not accept query params.
+   * GET /point-to-point-settings – get point-to-point settings for the current account. No 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>}
+   * @returns {Promise<import("axios").AxiosResponse<{ pointToPointSettings: object }>>}
    */
   function get({token, jwtToken, headers}) {
     return client({
@@ -26,13 +26,13 @@ function pointToPointSettingsFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * PUT /point-to-point-settings - update point-to-point settings. API does not accept query params.
+   * PUT /point-to-point-settings – update settings. Body: useOnlySpecificFareTable (boolean) required.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {Object} opts.pointToPointSettings - Settings payload
+   * @param {{ useOnlySpecificFareTable: boolean }} opts.pointToPointSettings - Settings payload (useOnlySpecificFareTable required)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ pointToPointSettings: object }>>}
    */
   function update({token, jwtToken, pointToPointSettings, headers}) {
     return client({

package/src/endpoints/accounts/print-settings.js

@@ -11,28 +11,30 @@ const {
  */
 function printSettingsFactory({client, internalAuthTokenProvider}) {
   /**
-   * GET /print-settings - list/get print settings. API does not accept query params.
+   * GET /print-settings – get print settings for the current account. No query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {Object} [opts.query] - Optional query params
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ printSettings: object }>>}
    */
-  function all({token, query, headers}) {
+  function all({token, jwtToken, query, headers}) {
     return client({
       url: "/print-settings",
       params: query,
-      headers: authorizationHeaders({token, internalAuthTokenProvider, headers})
+      headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers})
     });
   }
 
   /**
-   * PUT /print-settings - update print settings. API does not accept query params.
+   * PUT /print-settings – update print settings. Emits printsettings.updated webhook. Requires BETTEREZ_APP.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {Object} opts.printSettings - Print settings payload
+   * @param {Object} opts.printSettings - Print settings payload (PrintSettingsPutData)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ printSettings: object }>>}
    */
   function update({jwtToken, token, printSettings, headers}) {
     return client({

package/src/endpoints/accounts/print-templates.js

@@ -1,3 +1,4 @@
+/* eslint-disable max-len */
 const {
   authorizationHeaders
 } = require("./../endpoints_helpers.js");
@@ -15,6 +16,7 @@ const {
  * @property {string} [sort] - relevance | natural | createdAsc | createdDesc | updatedAsc | updatedDesc
  * @property {string} [templateCollectionId] - default | epsontmt88v | zebralp2844 | zebragx420t
  * @property {string} [status] - draft | published
+ * @property {string} [agencyId] - Filter sub-templates for this agency (ObjectId)
  * @property {string} [mainTemplateAccountId] - Filter by source provider (ObjectId)
  * @property {number} [page] - 1-based page for pagination
  */
@@ -43,47 +45,54 @@ const {
  */
 function printSettingsFactory({client, internalAuthTokenProvider}) {
   /**
-   * GET /print-templates - list print templates.
+   * GET /print-templates - list print templates (paginated when page is provided).
    * @param {Object} opts
    * @param {string} [opts.token] - API key
-   * @param {PrintTemplatesListQuery} [opts.query] - Query params (providerId, type, channel, consumer, format, etc.)
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {PrintTemplatesListQuery} [opts.query] - Query params (providerId, type, channel, agencyId, etc.)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ printTemplates: object[], next?: string, previous?: string, totalRecords?: number, page?: number }>>}
+   *   When page is used, response includes next, previous, totalRecords, page.
+   * @throws {import("axios").AxiosError} 400 WRONG_DATA, INVALID_PRODUCT_ID; 401; 500
    */
-  function all({token, query, headers}) {
+  function all({token, jwtToken, query = {}, headers}) {
     return client({
       url: "/print-templates",
       params: query,
-      headers: authorizationHeaders({token, internalAuthTokenProvider, headers})
+      headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers})
     });
   }
 
   /**
-   * GET /print-templates/:printTemplateId - get a print template.
+   * GET /print-templates/:printTemplateId - get a single print template.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.printTemplateId - Print template id (ObjectId)
    * @param {PrintTemplateGetByIdQuery} [opts.query] - Query params (providerId, superUserId, superUserHash)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ printTemplate: object }>>}
+   * @throws {import("axios").AxiosError} 400 INVALID_PRINT_TEMPLATE_ID / INVALID_PROVIDER_ID, 401, 404 PRINT_TEMPLATE_NOT_FOUND, 500
    */
-  function get({token, query, headers, printTemplateId}) {
+  function get({token, jwtToken, printTemplateId, query = {}, headers}) {
     return client({
       url: `/print-templates/${printTemplateId}`,
       params: query,
-      headers: authorizationHeaders({token, internalAuthTokenProvider, headers})
+      headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers})
     });
   }
 
   /**
-   * PUT /print-templates/:printTemplateId - update a print template. API getSpec() does not define query params.
+   * PUT /print-templates/:printTemplateId - update a print template.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.printTemplateId - Print template id (ObjectId)
-   * @param {Object} opts.printTemplate - Print template payload
+   * @param {Object} opts.printTemplate - Print template payload (name, type; type-specific fields)
+   * @param {Object} [opts.query] - Optional (superUserId, superUserHash)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ printTemplate: object }>>}
+   * @throws {import("axios").AxiosError} 400 WRONG_DATA, type-specific; 401 NOT_SUPER_USER; 404; 500
    */
   function update({jwtToken, token, printTemplateId, printTemplate, headers, query}) {
     return client({
@@ -100,13 +109,14 @@ function printSettingsFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * POST /print-templates - create a print template. API does not accept query params.
+   * POST /print-templates - create a print template. Body: printTemplate (name, type required; type-specific fields).
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {Object} opts.printTemplate - Print template payload
+   * @param {Object} opts.printTemplate - Print template payload (see PrintTemplatePostData)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ printTemplate: object }>>}
+   * @throws {import("axios").AxiosError} 400 WRONG_DATA / PRODUCT_* / INVOICE_* / META_* / TEMPLATE_*, 401 NOT_SUPER_USER, 500
    */
   function create({jwtToken, token, printTemplate, headers}) {
     return client({
@@ -122,13 +132,14 @@ function printSettingsFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * DELETE /print-templates/:printTemplateId - remove a print template. API does not accept query params.
+   * DELETE /print-templates/:printTemplateId - delete a print template.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.printTemplateId - Print template id (ObjectId)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ printTemplateId: string }>>}
+   * @throws {import("axios").AxiosError} 400 PRINT_TEMPLATE_ID, 401, 404 PRINT_TEMPLATE_NOT_FOUND, 500
    */
   function remove({printTemplateId, token, jwtToken, headers}) {
     return client({
@@ -142,7 +153,7 @@ function printSettingsFactory({client, internalAuthTokenProvider}) {
 
   const versions = {
     /**
-     * PUT /print-templates/:printTemplateId/versions/:versionId - roll back print template to a version.
+     * PUT /print-templates/:printTemplateId/versions/:versionId - roll back to a saved version (versionId = zero-based index).
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -150,7 +161,8 @@ function printSettingsFactory({client, internalAuthTokenProvider}) {
      * @param {string} opts.versionId - Zero-based version index (e.g. "0", "1")
      * @param {PrintTemplateVersionUpdateQuery} [opts.query] - Query params (superUserId, superUserHash)
      * @param {Object} [opts.headers] - Optional headers
-     * @returns {Promise<import("axios").AxiosResponse>}
+     * @returns {Promise<import("axios").AxiosResponse<{ printTemplate: object }>>}
+     * @throws {import("axios").AxiosError} 400 WRONG_DATA; 401 NOT_SUPER_USER; 404; 500
      */
     update({printTemplateId, token, jwtToken, headers, query, versionId}) {
       return client({

package/src/endpoints/accounts/printers.js

@@ -1,3 +1,4 @@
+/* eslint-disable max-len */
 const {
   authorizationHeaders
 } = require("./../endpoints_helpers.js");
@@ -11,17 +12,21 @@ const {
  */
 function printersFactory({client, internalAuthTokenProvider}) {
   /**
-   * GET /printers - list printers. API does not accept query params.
+   * GET /printers - list supported printers and their print templates. No query parameters accepted.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {Object} [opts.query] - Unused; API accepts no query params
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ printers: Array<object> }>>}
+   *   Response printers array: each has id, name, itemTypes, templates (see GET /printers).
+   * @throws {import("axios").AxiosError} 401 Unauthorized, 500 Internal server error
    */
-  function all({token, query, headers}) {
+  function all({token, jwtToken, query, headers}) {
     return client({
       url: "/printers",
-      params: query,
-      headers: authorizationHeaders({token, internalAuthTokenProvider, headers})
+      params: query || {},
+      headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers})
     });
   }
 

package/src/endpoints/accounts/rms-settings.js

@@ -1,3 +1,4 @@
+/* eslint-disable max-len */
 const {
   authorizationHeaders
 } = require("./../endpoints_helpers.js");
@@ -11,12 +12,14 @@ const {
  */
 function revenueManagementSettingsFactory({client, internalAuthTokenProvider}) {
   /**
-   * GET /rms-settings - get revenue management settings. API does not accept query params.
+   * GET /rms-settings — get revenue management settings for the account. No query parameters.
    * @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>}
+   * @param {string} [opts.token] - API key (X-API-KEY)
+   * @param {string} [opts.jwtToken] - JWT or internal auth token
+   * @param {Object} [opts.headers] - Optional request headers
+   * @returns {Promise<import("axios").AxiosResponse<{ data: { revenueManagementSettings: { enabled: boolean, applicationId?: string, subscriptionId?: string, ratalityClientId?: string, userId?: string } } }>>}
+   * @throws {import("axios").AxiosError} 401 Unauthorized (missing or invalid API key/Authorization)
+   * @throws {import("axios").AxiosError} 500 Internal server error
    */
   function get({token, jwtToken, headers}) {
     return client({
@@ -26,13 +29,18 @@ function revenueManagementSettingsFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * PUT /rms-settings - update revenue management settings. API does not accept query params.
+   * PUT /rms-settings — update revenue management settings. Body is the settings object (e.g. { enabled: true }).
+   * When enabling, Ratality credentials must already exist on the account. Emits rms.enabled / rms.disabled webhooks.
    * @param {Object} opts
-   * @param {string} [opts.token] - API key
-   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {Object} opts.revenueManagementSettings - Settings payload
-   * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @param {string} [opts.token] - API key (X-API-KEY)
+   * @param {string} [opts.jwtToken] - JWT or internal auth token
+   * @param {{ enabled: boolean, ratalityUsername?: string, ratalityPassword?: string }} opts.revenueManagementSettings - Settings payload (at least enabled; credentials required when enabling)
+   * @param {Object} [opts.headers] - Optional request headers
+   * @returns {Promise<import("axios").AxiosResponse<{ data: { revenueManagementSettings: { enabled: boolean, applicationId?: string, subscriptionId?: string, ratalityClientId?: string, userId?: string } } }>>}
+   * @throws {import("axios").AxiosError} 400 ACCOUNT_ALREADY_HAS_RMS_SETTINGS_ENABLED, RATALITY_CREDENTIALS_REQUIRED, CREATE_CLIENT_*
+   * @throws {import("axios").AxiosError} 401 Unauthorized
+   * @throws {import("axios").AxiosError} 404 ACCOUNT_NOT_FOUND
+   * @throws {import("axios").AxiosError} 500 CREATE_USER_ERROR or internal server error
    */
   function update({token, jwtToken, revenueManagementSettings, headers}) {
     return client({

package/src/endpoints/accounts/salesforce-settings.js

@@ -3,7 +3,7 @@ const {
 } = require("./../endpoints_helpers.js");
 
 /**
- * Factory for salesforce-settings API (btrz-api-accounts).
+ * Factory for salesforce-settings API (btrz-api-accounts). Requires BETTEREZ_APP audience.
  * @param {Object} deps
  * @param {import("axios").AxiosInstance} deps.client
  * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
@@ -11,12 +11,13 @@ const {
  */
 function salesforceSettingsFactory({client, internalAuthTokenProvider}) {
   /**
-   * GET /salesforce-settings - get Salesforce settings. API does not accept query params.
+   * GET /salesforce-settings – get Salesforce settings for the current account. No query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {Object} [opts.query] - Optional query params
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ salesforceSettings: object }>>}
    */
   function get({jwtToken, token, query, headers}) {
     return client({
@@ -27,13 +28,14 @@ function salesforceSettingsFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * PUT /salesforce-settings - update Salesforce settings. API does not accept query params.
+   * PUT /salesforce-settings – update Salesforce settings. When enabled is true, mcInstanceId,
+   * messageId, clientId, clientSecret are required. Emits salesforcesettings.updated webhook.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {Object} opts.salesforceSettings - Settings payload
+   * @param {Object} opts.salesforceSettings - Settings payload (SalesforceSettingsPayload; enabled required)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ salesforceSettings: object }>>}
    */
   function update({jwtToken, token, salesforceSettings, headers}) {
     return client({

package/src/endpoints/accounts/shift-settings.js

@@ -3,7 +3,7 @@ const {
 } = require("./../endpoints_helpers.js");
 
 /**
- * Factory for shift-settings API (btrz-api-accounts).
+ * Factory for shift-settings API (btrz-api-accounts). Requires BETTEREZ_APP audience.
  * @param {Object} deps
  * @param {import("axios").AxiosInstance} deps.client
  * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
@@ -11,12 +11,13 @@ const {
  */
 function shiftSettingsFactory({client, internalAuthTokenProvider}) {
   /**
-   * GET /shift-settings - get shift settings. API does not accept query params.
+   * GET /shift-settings – get shift settings for the current account. No query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {Object} [opts.query] - Optional query params
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ shiftSettings: object }>>}
    */
   function get({token, jwtToken, query, headers}) {
     return client({
@@ -27,13 +28,13 @@ function shiftSettingsFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * PUT /shift-settings - update shift settings. API does not accept query params.
+   * PUT /shift-settings – update shift settings. Emits shiftsettings.updated webhook.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {Object} opts.shiftSettings - Settings payload
+   * @param {Object} opts.shiftSettings - Settings payload (ShiftSetting)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ shiftSettings: object }>>}
    */
   function update({jwtToken, token, shiftSettings, headers}) {
     return client({

package/src/endpoints/accounts/shifts.js

@@ -46,13 +46,14 @@ const {authorizationHeaders} = require("./../endpoints_helpers.js");
  */
 function shiftsFactory({client, internalAuthTokenProvider}) {
   /**
-   * GET /shifts - list shifts.
+   * GET /shifts - list shifts for the account. Returns shifts filtered by query params.
+   * See get-shifts handler getSpec() in btrz-api-accounts for full API details.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {ShiftsListQuery} [opts.query] - Query params
+   * @param {ShiftsListQuery} [opts.query] - Query params (includeActivity, status, pendingShiftClosure, locationId, providerId, sort, fromDate, toDate)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ shifts: Array }>>} Response body: { shifts }. Errors: 400 (validation), 401, 500
    */
   function all({jwtToken, token, query, headers}) {
     return client.get("/shifts", {
@@ -78,13 +79,14 @@ function shiftsFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * POST /shifts - create a shift.
+   * POST /shifts - open a shift for a user. Body: PostShiftRequest (stationId, userId, counterNumber).
+   * See post-shift handler getSpec() in btrz-api-accounts for full API details.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {Object} opts.shiftData - Shift payload
+   * @param {Object} opts.shiftData - Shift payload (stationId, userId, counterNumber)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ shift: Object }>>} Response body: { shift }. Errors: 400, 401, 404 (USER_NOT_FOUND, STATION_NOT_FOUND), 409 (SHIFT_ALREADY_OPEN_FOR_USER, USER_WITHOUT_SHIFT_ENABLED), 500
    */
   function create({jwtToken, token, shiftData, headers}) {
     return client({
@@ -98,14 +100,16 @@ function shiftsFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * PATCH /shifts/:shiftId - update a shift (operations). API getSpec() does not define query params.
+   * PATCH /shifts/:shiftId - close a shift. Body: PatchShiftRequest (operations array with comment).
+   * See patch-shift handler getSpec() in btrz-api-accounts for full API details.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.shiftId - Shift id (ObjectId)
-   * @param {Object} opts.operations - Operations payload
+   * @param {Object} opts.operations - Operations payload (e.g. [{ comment }] for close)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @param {Object} [opts.query] - Optional query params
+   * @returns {Promise<import("axios").AxiosResponse<{ shift: Object }>>} Response body: { shift }. Errors: 401, 404 (SHIFT_NOT_FOUND, USER_NOT_FOUND), 409 (SHIFT_ALREADY_CLOSED, COMMENT_IS_MANDATORY_WHEN_VARIANCE_EXISTS, TOTAL_CHANGED), 500
    */
   function update({jwtToken, token, shiftId, operations, headers, query}) {
     return client({

package/src/endpoints/accounts/sms-templates.js

@@ -12,6 +12,7 @@ const {
  * @property {string} [sort] - relevance | natural | createdAsc | createdDesc | updatedAsc | updatedDesc
  * @property {string} [templateCollectionId] - default | custom
  * @property {string} [status] - draft | published
+ * @property {string} [agencyId] - Filter sub-templates for this agency (ObjectId)
  * @property {string} [mainTemplateAccountId] - Filter by source provider (ObjectId)
  * @property {string} [lang] - ISO language code (e.g. en-us)
  * @property {number} [page] - 1-based page for pagination
@@ -41,12 +42,13 @@ const {
  */
 function smsTemplatesFactory({client, internalAuthTokenProvider}) {
   /**
-   * GET /sms-templates/types - returns available template types. API does not accept query params.
+   * GET /sms-templates/types - returns available template types.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ types: string[] }>>}
+   * @throws {import("axios").AxiosError} 401, 500
    */
   function getTypes({token, jwtToken, headers}) {
     return client({
@@ -56,13 +58,14 @@ function smsTemplatesFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * GET /sms-templates - list SMS templates.
+   * GET /sms-templates - list SMS templates (paginated when page is provided).
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {SmsTemplatesListQuery} [opts.query] - Query params (providerId, type, channel, sort, etc.)
+   * @param {SmsTemplatesListQuery} [opts.query] - Query params (providerId, type, channel, sort, agencyId, etc.)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ smsTemplates: object[], next?: string, previous?: string, totalRecords?: number, page?: number }>>}
+   * @throws {import("axios").AxiosError} 400 WRONG_DATA, 401, 500
    */
   function all({token, jwtToken, query = {}, headers}) {
     return client({
@@ -80,7 +83,8 @@ function smsTemplatesFactory({client, internalAuthTokenProvider}) {
    * @param {string} opts.smsTemplateId - Template id (ObjectId)
    * @param {SmsTemplateGetByIdQuery} [opts.query] - Query params (providerId, superUserId, superUserHash)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ smsTemplate: object }>>}
+   * @throws {import("axios").AxiosError} 400 INVALID_SMS_TEMPLATE_ID / INVALID_PROVIDER_ID, 401, 404 SMS_TEMPLATE_NOT_FOUND, 500
    */
   function get({token, jwtToken, smsTemplateId, query = {}, headers}) {
     return client({
@@ -91,13 +95,14 @@ function smsTemplatesFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * POST /sms-templates - create an SMS template. API does not accept query params.
+   * POST /sms-templates - create an SMS template. Body: smsTemplate (name, type, lang, txtTemplate required).
    * @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 {Object} opts.data - Request body (smsTemplate or root with name, type, lang, txtTemplate)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ smsTemplate: object }>>}
+   * @throws {import("axios").AxiosError} 400 WRONG_DATA / TEMPLATE_* / LANG_* / TXT_TEMPLATE_REQUIRED, 401 NOT_SUPER_USER, 500
    */
   function create({token, jwtToken, data, headers}) {
     return client({
@@ -109,14 +114,15 @@ function smsTemplatesFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * PUT /sms-templates/:smsTemplateId - update an SMS template. API does not accept query params.
+   * PUT /sms-templates/:smsTemplateId - update an SMS template. Body: smsTemplate (name, type, txtTemplate required; lang read-only).
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.smsTemplateId - Template id (ObjectId)
-   * @param {Object} opts.data - Request body
+   * @param {Object} opts.data - Request body (smsTemplate or root)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ smsTemplate: object }>>}
+   * @throws {import("axios").AxiosError} 400 WRONG_DATA / TEMPLATE_* / TXT_TEMPLATE_REQUIRED, 401 NOT_SUPER_USER, 404 SMS_TEMPLATE_NOT_FOUND, 500
    */
   function update({token, jwtToken, smsTemplateId, data, headers}) {
     return client({
@@ -128,13 +134,14 @@ function smsTemplatesFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * DELETE /sms-templates/:smsTemplateId - delete an SMS template. API does not accept query params.
+   * DELETE /sms-templates/:smsTemplateId - delete an SMS template.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.smsTemplateId - Template id (ObjectId)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ smsTemplateId: string }>>}
+   * @throws {import("axios").AxiosError} 400 SMS_TEMPLATE_ID, 401, 404 SMS_TEMPLATE_NOT_FOUND, 500
    */
   function remove({token, jwtToken, smsTemplateId, headers}) {
     return client({
@@ -145,14 +152,15 @@ function smsTemplatesFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * POST /sub-sms-templates - create a sub SMS template from a main template. API does not accept query params.
+   * POST /sub-sms-templates - create a sub SMS template from a main template.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.mainTemplateId - Main template id (ObjectId)
    * @param {string} opts.agencyId - Agency id (ObjectId)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ smsTemplate: object }>>}
+   * @throws {import("axios").AxiosError} 400 WRONG_DATA / MAIN_TEMPLATE_IS_NOT_CUSTOM, 401 MAIN_TEMPLATE_ACCOUNT_MISMATCH / MAIN_TEMPLATE_NOT_FROM_PROVIDER, 404 MAIN_TEMPLATE_NOT_FOUND, 500
    */
   function createSub({token, jwtToken, mainTemplateId, agencyId, headers}) {
     return client({
@@ -165,15 +173,16 @@ function smsTemplatesFactory({client, internalAuthTokenProvider}) {
 
   const versions = {
     /**
-     * PUT /sms-templates/:smsTemplateId/versions/:versionId - roll back sms template to a version.
+     * PUT /sms-templates/:smsTemplateId/versions/:versionId - roll back SMS template to a saved version (versionId = zero-based index).
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
      * @param {string} opts.smsTemplateId - Template id (ObjectId)
      * @param {string} opts.versionId - Zero-based version index (e.g. "0", "1")
-     * @param {SmsTemplateVersionUpdateQuery} [opts.query] - Query params (superUserId, superUserHash)
+     * @param {SmsTemplateVersionUpdateQuery} [opts.query] - Query params (superUserId, superUserHash for default templates)
      * @param {Object} [opts.headers] - Optional headers
-     * @returns {Promise<import("axios").AxiosResponse>}
+     * @returns {Promise<import("axios").AxiosResponse<{ smsTemplate: object }>>}
+     * @throws {import("axios").AxiosError} 400 WRONG_DATA, 401 NOT_SUPER_USER, 404 SMS_TEMPLATE_NOT_FOUND / SMS_TEMPLATE_VERSION_NOT_FOUND, 500
      */
     update({token, jwtToken, smsTemplateId, versionId, query = {}, headers}) {
       return client({

package/src/endpoints/accounts/sub-print-templates.js

@@ -1,3 +1,4 @@
+/* eslint-disable max-len */
 const {
   authorizationHeaders
 } = require("./../endpoints_helpers.js");
@@ -11,13 +12,14 @@ const {
  */
 function subPrintTemplatesFactory({client, internalAuthTokenProvider}) {
   /**
-   * POST /sub-print-templates - create a sub print template. API does not accept query params.
+   * POST /sub-print-templates - create a sub print template from a main template (body: agencyId, mainTemplateId).
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {Object} opts.subPrintTemplate - Sub print template payload
+   * @param {Object} opts.subPrintTemplate - Payload with agencyId and mainTemplateId (both ObjectIds)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ printTemplate: object }>>}
+   * @throws {import("axios").AxiosError} 400 WRONG_DATA / MAIN_TEMPLATE_IS_NOT_CUSTOM, 401 MAIN_TEMPLATE_ACCOUNT_MISMATCH / MAIN_TEMPLATE_NOT_FROM_PROVIDER, 404 MAIN_TEMPLATE_NOT_FOUND, 500
    */
   function create({jwtToken, token, subPrintTemplate, headers}) {
     return client({

package/src/endpoints/accounts/ticket-movement-settings.js

@@ -11,12 +11,13 @@ const {
  */
 function ticketMovementSettingsFactory({client, internalAuthTokenProvider}) {
   /**
-   * GET /ticket-movement-settings - get ticket movement settings. API does not accept query params.
+   * GET /ticket-movement-settings - get ticket movement settings for the account.
+   * No query or path parameters. See get-handler getSpec() in btrz-api-accounts for response schema.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<Object>>} Response body: ticket movement settings object. Errors: 401, 500
    */
   function get({token, jwtToken, headers}) {
     return client({
@@ -26,13 +27,15 @@ function ticketMovementSettingsFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * PUT /ticket-movement-settings - update ticket movement settings. API does not accept query params.
+   * PUT /ticket-movement-settings - update ticket movement settings for the account.
+   * Body must include all required fields (see put-handler getSpec() in btrz-api-accounts).
+   * Side effect: persists to account.preferences.ticketMovements.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {Object} opts.ticketMovementSettings - Settings payload
+   * @param {Object} opts.ticketMovementSettings - Full settings payload (see put-handler getSpec())
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<Object>>} Updated settings. Errors: 400, 401, 500
    */
   function update({token, jwtToken, ticketMovementSettings, headers}) {
     return client({