btrz-api-client 8.31.0 → 8.33.0

package/src/endpoints/accounts/people-lookups.js

@@ -4,11 +4,11 @@ const {
 } = require("./../endpoints_helpers.js");
 
 /**
- * Query params for GET /people-lookups (btrz-api-accounts). See get-handler getSpec().
+ * Query params for GET /people-lookups (btrz-api-accounts). Optional filters; when provided only matching people are returned.
  * @typedef {Object} PeopleLookupsListQuery
  * @property {string} [dynamicFormId] - If provided, only include this dynamic form's data in response
  * @property {string} [documentNumber] - Document number to search for
- * @property {string} [documentTypeId] - Document type id to search for
+ * @property {string} [documentTypeId] - Document type id (ObjectId) to search for
  * @property {string} [email] - Email to search for
  * @property {string} [customerNumber] - Customer number to search for
  * @property {string} [phone] - Phone to search for
@@ -29,14 +29,14 @@ const {
  */
 function peopleLookupsFactory({client, internalAuthTokenProvider}) {
   /**
-   * GET /people-lookups - list people lookups.
+   * GET /people-lookups – list people lookups (paginated). Requires BETTEREZ_APP audience.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {PeopleLookupsListQuery} [opts.query] - Query params (dynamicFormId, documentNumber, documentTypeId, email, customerNumber, phone)
    * @param {string} [opts.providerId] - Provider id (ObjectId); merged into query for provider context
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ people: object[], totalRecords: number, page?: number, pageSize?: number }>>}
    */
   function all({token, jwtToken, query, headers, providerId}) {
     const query_ = providerId ? {...query, providerId} : query;
@@ -48,15 +48,15 @@ function peopleLookupsFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * GET /people-lookups/:personId - get a person lookup.
+   * GET /people-lookups/:personId – get a single person lookup by id. Returns 404 if not found. Requires BETTEREZ_APP audience.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.personId - Person id (ObjectId)
+   * @param {string} opts.personId - Person id (24 hex ObjectId)
    * @param {PeopleLookupGetByIdQuery} [opts.query] - Query params: dynamicFormId
    * @param {string} [opts.providerId] - Provider id (ObjectId); merged into query for provider context
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ person: object }>>}
    */
   function getById({token, jwtToken, query, headers, personId, providerId}) {
     const query_ = providerId ? {...query, providerId} : query;
@@ -69,15 +69,15 @@ function peopleLookupsFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * PUT /people-lookups/:personId - update a person lookup. API getSpec() does not define query params.
+   * PUT /people-lookups/:personId – update a person lookup. Emits peopleLookups.updated webhook. Requires BETTEREZ_APP audience.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.personId - Person id (ObjectId)
-   * @param {Object} opts.person - Person payload
+   * @param {string} opts.personId - Person id (24 hex ObjectId)
+   * @param {Object} opts.person - Person payload (PeopleLookupPutData: documentTypeId, documentNumber, firstName, lastName, email, phone, dynamicForms, etc.)
    * @param {string} [opts.providerId] - Provider id (ObjectId); sent as query for provider context
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ person: object }>>}
    */
   function update({jwtToken, token, personId, person, headers, providerId}) {
     const query = providerId ? {providerId} : {};
@@ -96,14 +96,14 @@ function peopleLookupsFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * POST /people-lookups - create a person lookup. API getSpec() does not define query params.
+   * POST /people-lookups – create a person lookup. Emits peopleLookups.created webhook. Requires BETTEREZ_APP audience. Body requires documentTypeId and documentNumber.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {Object} opts.person - Person payload
+   * @param {Object} opts.person - Person payload (PeopleLookupPostData: documentTypeId, documentNumber required; firstName, lastName, email, phone, dynamicForms, etc.)
    * @param {string} [opts.providerId] - Provider id (ObjectId); sent as query for provider context
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ person: object }>>}
    */
   function create({jwtToken, token, person, headers, providerId}) {
     const query = providerId ? {providerId} : {};
@@ -122,13 +122,13 @@ function peopleLookupsFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * DELETE /people-lookups/:personId - remove a person lookup. API does not accept query params.
+   * DELETE /people-lookups/:personId – remove a person lookup. Emits peoplelookups.deleted webhook. Returns 404 if person not found. Requires BETTEREZ_APP audience.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.personId - Person id (ObjectId)
+   * @param {string} opts.personId - Person id (24 hex ObjectId)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ personId: string }>>}
    */
   function remove({personId, token, jwtToken, headers}) {
     return client({

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({