btrz-api-client 8.65.0 → 8.68.1

package/lib/endpoints/notifications/notify.js

@@ -128,6 +128,7 @@ function notifyTicketFactory(_ref) {
             jwtToken = _ref4.jwtToken,
             email = _ref4.email,
             lang = _ref4.lang,
+            accountId = _ref4.accountId,
             headers = _ref4.headers;
 
         return client({
@@ -135,6 +136,41 @@ function notifyTicketFactory(_ref) {
           method: "post",
           data: {
             email: email,
+            lang: lang,
+            accountId: accountId
+          },
+          headers: authorizationHeaders({ token: token, jwtToken: jwtToken, internalAuthTokenProvider: internalAuthTokenProvider, headers: headers })
+        });
+      }
+    },
+    newSeller: {
+      /**
+       * POST /notify-new-seller - welcome email for a new agency (seller).
+       * @param {Object} opts
+       * @param {string} [opts.token] - API key (provider)
+       * @param {string} [opts.jwtToken] - Internal service JWT
+       * @param {string} opts.sellerEmail - Agency admin email
+       * @param {string} opts.sellerDomain - Agency subdomain
+       * @param {string} [opts.providerAdminEmail] - Support contact in the email
+       * @param {string} [opts.lang] - Template lexicon language (e.g. en-us)
+       * @param {Object} [opts.headers] - Optional headers
+       */
+      create: function create(_ref5) {
+        var token = _ref5.token,
+            jwtToken = _ref5.jwtToken,
+            sellerEmail = _ref5.sellerEmail,
+            sellerDomain = _ref5.sellerDomain,
+            providerAdminEmail = _ref5.providerAdminEmail,
+            lang = _ref5.lang,
+            headers = _ref5.headers;
+
+        return client({
+          url: "/notify-new-seller",
+          method: "post",
+          data: {
+            sellerEmail: sellerEmail,
+            sellerDomain: sellerDomain,
+            providerAdminEmail: providerAdminEmail,
             lang: lang
           },
           headers: authorizationHeaders({ token: token, jwtToken: jwtToken, internalAuthTokenProvider: internalAuthTokenProvider, headers: headers })
@@ -154,14 +190,14 @@ function notifyTicketFactory(_ref) {
        * @param {Object} [opts.headers] - Optional headers
        * @returns {Promise<import("axios").AxiosResponse>}
        */
-      create: function create(_ref5) {
-        var token = _ref5.token,
-            jwtToken = _ref5.jwtToken,
-            query = _ref5.query,
-            operation = _ref5.operation,
-            to = _ref5.to,
-            ticketId = _ref5.ticketId,
-            headers = _ref5.headers;
+      create: function create(_ref6) {
+        var token = _ref6.token,
+            jwtToken = _ref6.jwtToken,
+            query = _ref6.query,
+            operation = _ref6.operation,
+            to = _ref6.to,
+            ticketId = _ref6.ticketId,
+            headers = _ref6.headers;
 
         return client({
           url: "/notify-tickets/" + ticketId,
@@ -186,12 +222,12 @@ function notifyTicketFactory(_ref) {
        * @param {Object} [opts.headers] - Optional headers
        * @returns {Promise<import("axios").AxiosResponse>}
        */
-      create: function create(_ref6) {
-        var token = _ref6.token,
-            jwtToken = _ref6.jwtToken,
-            query = _ref6.query,
-            data = _ref6.data,
-            headers = _ref6.headers;
+      create: function create(_ref7) {
+        var token = _ref7.token,
+            jwtToken = _ref7.jwtToken,
+            query = _ref7.query,
+            data = _ref7.data,
+            headers = _ref7.headers;
 
         return client({
           url: "/notify-vouchers",
@@ -212,11 +248,11 @@ function notifyTicketFactory(_ref) {
        * @param {Object} [opts.headers] - Optional headers
        * @returns {Promise<import("axios").AxiosResponse>}
        */
-      create: function create(_ref7) {
-        var token = _ref7.token,
-            jwtToken = _ref7.jwtToken,
-            data = _ref7.data,
-            headers = _ref7.headers;
+      create: function create(_ref8) {
+        var token = _ref8.token,
+            jwtToken = _ref8.jwtToken,
+            data = _ref8.data,
+            headers = _ref8.headers;
 
         return client({
           url: "/notify-manifest",

package/lib/endpoints/operations/movements.js

@@ -6,8 +6,13 @@ var _require = require("./../endpoints_helpers.js"),
 /**
  * Request body for POST /movements (btrz-api-operations). See MovementPostData in movements models.
  * @typedef {Object} MovementPostData
- * @property {Array<{ _id: string, section?: string, sectionName?: string, seat?: string, row?: string, seatId?: string }>} tickets - Tickets to move (same transaction if more than one). Each must have _id; optional seat fields for destination seatmap.
- * @property {{ routeId: string, scheduleId: string, date: string }} newManifest - Destination manifest: routeId (ObjectId), scheduleId (UUID), date (YYYY-MM-DD).
+ * @property {Array<{ _id: string, section?: string, sectionName?: string,
+ * seat?: string, row?: string, seatId?: string }>} tickets - Tickets to move
+ * (same transaction if more than one). Each must have _id; optional seat fields
+ * for destination seatmap.
+ * @property {{ routeId: string, scheduleId: string, date: string }} newManifest
+ * - Destination manifest: routeId (ObjectId), scheduleId (UUID), date
+ * (YYYY-MM-DD).
  * @property {string} channel - Channel of the movement (e.g. backoffice). Must be a valid backoffice channel.
  * @property {boolean} [allowsDifferentTrx] - If true, allows moving tickets from different transactions.
  * @property {boolean} [newdesign] - If true, uses new seatmap design for accommodation.

package/lib/endpoints/operations/pago-express.js

@@ -22,9 +22,13 @@ function pagoExpressFactory(_ref) {
    * @param {Object} opts
    * @param {string} [opts.token] - API key (x-api-key)
    * @param {string} [opts.jwtToken] - JWT or internal auth
-   * @param {Object} opts.payment - Request body: folio (20-digit string), id_terminal (number), local_date (string DD/MM/YYYY HH:mm:ss), trx_no (number)
+   * @param {Object} opts.payment - Request body: folio (20-digit string),
+   * id_terminal (number), local_date (string DD/MM/YYYY HH:mm:ss),
+   * trx_no (number)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>} 200 PostInfoResponse (code, message, result with folio, id_terminal, local_date, saldo, trx_no, responsecode, descriptioncode)
+   * @returns {Promise<import("axios").AxiosResponse>} 200 PostInfoResponse
+   * (code, message, result with folio, id_terminal, local_date, saldo,
+   * trx_no, responsecode, descriptioncode)
    */
   function info(_ref2) {
     var token = _ref2.token,
@@ -47,7 +51,9 @@ function pagoExpressFactory(_ref) {
    * @param {string} [opts.jwtToken] - JWT or internal auth
    * @param {Object} opts.payment - Request body: folio, id_terminal, local_date, trx_no, amount (string)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>} 200 PostPayResponse (code, message, result with folio, id_terminal, local_date, trx_no, noauto, amount, responsecode, descriptioncode)
+   * @returns {Promise<import("axios").AxiosResponse>} 200 PostPayResponse
+   * (code, message, result with folio, id_terminal, local_date, trx_no,
+   * noauto, amount, responsecode, descriptioncode)
    */
   function pay(_ref3) {
     var token = _ref3.token,

package/lib/endpoints/operations/parcels.js

@@ -144,7 +144,9 @@ function parcelFactory(_ref) {
    * @param {string} opts.id - Parcel id (path parcelId)
    * @param {string} opts.commentId - Comment id (path)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>} 200 deleted ParcelUserComment; 400 MISSING_*; 401; 403; 404 PARCEL_NOT_FOUND, COMMENT_NOT_FOUND; 409
+   * @returns {Promise<import("axios").AxiosResponse>} 200 deleted
+   * ParcelUserComment; 400 MISSING_*; 401; 403;
+   * 404 PARCEL_NOT_FOUND, COMMENT_NOT_FOUND; 409
    */
   function deleteComment(_ref6) {
     var token = _ref6.token,

package/lib/endpoints/sales/cancellations.js

@@ -4,7 +4,8 @@ var _require = require("./../endpoints_helpers.js"),
     authorizationHeaders = _require.authorizationHeaders;
 
 /**
- * Request body for POST /cancellations (btrz-api-sales). CancelPostData. Item IDs grouped by family; trxId required.
+ * Request body for POST /cancellations (btrz-api-sales).
+ * CancelPostData. Item IDs grouped by family; trxId required.
  * @typedef {{
  *   trxId: string,
  *   fees: number[],
@@ -26,7 +27,9 @@ var _require = require("./../endpoints_helpers.js"),
  */
 
 /**
- * Request body for PUT /cancellations (btrz-api-sales). CancelPutData. Unmodified cancel set from POST response (must include _id and signature).
+ * Request body for PUT /cancellations (btrz-api-sales). CancelPutData.
+ * Unmodified cancel set from POST response
+ * (must include _id and signature).
  * @typedef {{ _id: string, cancellation: Object, signature: string }} CancelPutData
  */
 
@@ -50,13 +53,20 @@ function cancellationEndpointsFactory(_ref) {
       internalAuthTokenProvider = _ref.internalAuthTokenProvider;
 
   /**
-   * POST /cancellations - creates a cancel set (preview) with calculated refunds and signature. Does not execute refunds. API does not accept query params.
+   * POST /cancellations - creates a cancel set (preview) with calculated
+   * refunds and signature. Does not execute refunds.
+   * 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 {CancelPostData} opts.cancelData - Refundable item IDs by family, trxId, channel, penalty (optional), etc.
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse<{ _id: string, cancellation: Object, signature: string }>>} Cancel set (signed). Rejects with 400 (e.g. MISSING_CANCELLABLE_IDS, INVALID_CANCEL_SET, [itemType]_NOT_REFUNDABLE), 401, 403 (NOT_ALLOWED_FOR_ONLINE, FEE_OVERRIDE_NOT_ALLOWED), 404 ([itemType]_NOT_FOUND), 409 (CURRENCY_EXCHANGE_MISMATCH, AGENCY_CURRENCY_MISMATCH), 500.
+   * @returns {Promise<import("axios").AxiosResponse<{ _id: string,
+   * cancellation: Object, signature: string }>>} Cancel set (signed).
+   * Rejects with 400 (e.g. MISSING_CANCELLABLE_IDS, INVALID_CANCEL_SET,
+   * [itemType]_NOT_REFUNDABLE), 401, 403 (NOT_ALLOWED_FOR_ONLINE,
+   * FEE_OVERRIDE_NOT_ALLOWED), 404 ([itemType]_NOT_FOUND),
+   * 409 (CURRENCY_EXCHANGE_MISMATCH, AGENCY_CURRENCY_MISMATCH), 500.
    */
   function createCancelSet(_ref2) {
     var token = _ref2.token,
@@ -75,13 +85,20 @@ function cancellationEndpointsFactory(_ref) {
   }
 
   /**
-   * PUT /cancellations - executes the refund using the signed cancel set from POST. Body is cancelSet (or object with cancelSet key). API does not accept query params. Duplicate submission (same dupKey within 30s) returns 409.
+   * PUT /cancellations - executes the refund using the signed cancel set from
+   * POST. Body is cancelSet (or object with cancelSet key).
+   * API does not accept query params. Duplicate submission
+   * (same dupKey within 30s) returns 409.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {CancelPutData} opts.cancelSet - Unmodified cancel set from createCancelSet response
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse<{ transaction: Object }>>} RefundResponse. Rejects with 400 (e.g. INVALID_SIGNATURE, MISSING_TERMINAL_PAYLOAD, REFUNDED_ITEM), 401, 409 (NOT_FOUND_FOR_REFUND, REFUND_EXECUTION_ERROR, PAYMENT_ROLLBACK_FAILED, CONFLICT duplicate), 500.
+   * @returns {Promise<import("axios").AxiosResponse<{ transaction: Object }>>}
+   * RefundResponse. Rejects with 400 (e.g. INVALID_SIGNATURE,
+   * MISSING_TERMINAL_PAYLOAD, REFUNDED_ITEM), 401,
+   * 409 (NOT_FOUND_FOR_REFUND, REFUND_EXECUTION_ERROR,
+   * PAYMENT_ROLLBACK_FAILED, CONFLICT duplicate), 500.
    */
   function createRefund(_ref3) {
     var token = _ref3.token,
@@ -98,14 +115,20 @@ function cancellationEndpointsFactory(_ref) {
   }
 
   /**
-   * PUT /cancellations/:pendingTransactionId - completes a pending payment for a cancellation transaction (e.g. terminal refund). API does not accept query params.
+   * PUT /cancellations/:pendingTransactionId - completes a pending payment
+   * for a cancellation transaction (e.g. terminal refund).
+   * 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.pendingTransactionId - Negative (pending) transaction ID (ObjectId)
    * @param {CompletePaymentCancellationData} opts.paymentResult - Payment result from terminal/provider
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse<{ transaction?: Object, paymentResult?: Object }>>} GetCompletePaymentCancellationResponse. Rejects with 400 (INVALID_PENDING_TRANSACTION_ID, INVALID_TRANSACTION_STATUS, PAYMENT_NOT_PENDING, etc.), 401, 404 (TRANSACTION_NOT_FOUND, PAYMENT_NOT_FOUND, etc.), 500.
+   * @returns {Promise<import("axios").AxiosResponse<{ transaction?: Object,
+   * paymentResult?: Object }>>} GetCompletePaymentCancellationResponse.
+   * Rejects with 400 (INVALID_PENDING_TRANSACTION_ID,
+   * INVALID_TRANSACTION_STATUS, PAYMENT_NOT_PENDING, etc.), 401,
+   * 404 (TRANSACTION_NOT_FOUND, PAYMENT_NOT_FOUND, etc.), 500.
    */
   function updateCompletePayment(_ref4) {
     var token = _ref4.token,

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "btrz-api-client",
-  "version": "8.65.0",
+  "version": "8.68.1",
   "description": "Api client for Betterez endpoints",
   "main": "index.js",
   "scripts": {
-    "tdd": "mocha --recursive test/ -w",
-    "test": "mocha --recursive  test/",
-    "test:integration": "mocha --recursive -r test-integration/ports.js  test-integration/",
+    "tdd": "node --watch --require ./test/node-test-globals.js --test test/all.test.js",
+    "test": "node --require ./test/node-test-globals.js --test test/all.test.js",
+    "test:only": "node --require ./test/node-test-globals.js --test test/all.test.js --test-only",
+    "test:integration": "node --require ./test/node-test-globals.js --require ./test-integration/ports.js --test test-integration/all.test.js",
     "browserify": "browserify lib/client.js --standalone BtrzApiClient -p tinyify -o lib/client-standalone-min.js",
     "commit-transpile": "git add lib/ && (git diff-index --quiet HEAD || git commit -m \"transpiled src\")",
     "pretranspile": "rm -rf lib/",
@@ -31,21 +32,18 @@
     "babel-plugin-transform-object-rest-spread": "^6.26.0",
     "babel-preset-es2015": "^6.24.1",
     "browserify": "^17.0.1",
-    "chai": "^4.3.8",
     "confusing-browser-globals": "^1.0.11",
     "eslint": "7.32.0",
     "eslint-config-btrz-base": "^1.0.0",
     "eslint-plugin-chai-friendly": "^0.4.1",
     "eslint-plugin-import": "^2.20.1",
-    "eslint-plugin-mocha": "^5.3.0",
     "form-data": "^3.0.0",
-    "mocha": "11.7.5",
     "tinyify": "4.0.0",
     "uuid": "14.0.0"
   },
   "dependencies": {
     "axios": "^0.27.2",
     "base-64": "^1.0.0",
-    "undici": "^8.1.0"
+    "undici": "8.2.0"
   }
 }

package/src/client.js

@@ -74,6 +74,7 @@ function createInventory({baseURL, headers, timeout, overrideFn, internalAuthTok
     documentTypes: require("./endpoints/inventory/document-types.js")({client, internalAuthTokenProvider}),
     externalPasses: require("./endpoints/inventory/external-passes.js")({client, internalAuthTokenProvider}),
     externalWallets: require("./endpoints/inventory/external-wallets.js")({client, internalAuthTokenProvider}),
+    fareTypeModifiers: require("./endpoints/inventory/fare-type-modifiers.js")({client, internalAuthTokenProvider}),
     fallbackCodes: require("./endpoints/inventory/fallback-codes.js")({client, internalAuthTokenProvider}),
     fareClasses: require("./endpoints/inventory/fare-classes.js")({client, internalAuthTokenProvider}),
     fares: require("./endpoints/inventory/fares.js")({client, internalAuthTokenProvider}),
@@ -455,7 +456,6 @@ function createBtrzPay({baseURL, headers, timeout, overrideFn, internalAuthToken
     adyen: require("./endpoints/btrzpay/adyen.js")({client, internalAuthTokenProvider}),
     cybersource3ds: require("./endpoints/btrzpay/cybersource3ds.js")({client, internalAuthTokenProvider}),
     docs: require("./endpoints/btrzpay/docs.js")({client}),
-    adyen: require("./endpoints/btrzpay/adyen.js")({client, internalAuthTokenProvider}),
     cardpointeTerminals: require("./endpoints/btrzpay/cardpointe.js").cardpointeTerminalsFactory({client, internalAuthTokenProvider}),
     paymentMethods: require("./endpoints/btrzpay/payment-methods.js")({client, internalAuthTokenProvider}),
     referenceNumbers: require("./endpoints/btrzpay/reference-numbers.js")({client, internalAuthTokenProvider}),

package/src/endpoints/accounts/agencies.js

@@ -8,9 +8,30 @@ const {
  * @param {Object} deps
  * @param {import("axios").AxiosInstance} deps.client
  * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
- * @returns {{ putCreditLimit: function }}
+ * @returns {{ create: function, putCreditLimit: function }}
  */
 function agenciesFactory({client, internalAuthTokenProvider}) {
+  /**
+   * POST /agencies - create an agency (seller account) and link it to the provider network.
+   * Requires X-API-KEY and Authorization (JWT).
+   * @param {Object} opts
+   * @param {string} opts.token - API key
+   * @param {string} opts.jwtToken - JWT
+   * @param {Object} opts.agency - agencyData payload ({ seller, network })
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
+  function create({token, jwtToken, agency, headers}) {
+    return client({
+      url: "/agencies",
+      method: "post",
+      headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers}),
+      data: {
+        agency
+      }
+    });
+  }
+
   /**
    * PUT /agencies/:agencyId/credit-limit - update credit limit for an agency (seller) in the provider's network.
    * Requires BETTEREZ_APP audience. Request body can be { limitAmount, unlimited } or { creditLimit: { limitAmount, unlimited } }.
@@ -33,6 +54,7 @@ function agenciesFactory({client, internalAuthTokenProvider}) {
   }
 
   return {
+    create,
     putCreditLimit
   };
 }

package/src/endpoints/accounts/journey-prices-settings.js

@@ -28,11 +28,11 @@ function journeyPricesSettingsFactory({client, internalAuthTokenProvider}) {
 
   /**
    * PUT /journey-prices-settings – Update journey prices settings. Body: JourneyPricesSettings at root.
-   * Required: recordProtectionRules. Optional: pricingParameters, allowEachTripSegmentToBePricedIndividually.
+   * Required: recordProtectionRules. Optional: pricingParameters, allowEachTripSegmentToBePricedIndividually, displayExpiredSchedulesInUI.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {Object} opts.journeyPricesSettings - { recordProtectionRules, pricingParameters?, allowEachTripSegmentToBePricedIndividually? }
+   * @param {Object} opts.journeyPricesSettings - { recordProtectionRules, pricingParameters?, allowEachTripSegmentToBePricedIndividually?, displayExpiredSchedulesInUI? }
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse<{ journeyPricesSettings: object }>>}
    */

package/src/endpoints/accounts/market-pricing-settings.js

@@ -17,7 +17,7 @@ function marketPricingSettingsFactory({client, internalAuthTokenProvider}) {
    * @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<{ marketPricingSettings: { useOnlySpecificFareTable: boolean } }>>}
+   * @returns {Promise<import("axios").AxiosResponse<{ marketPricingSettings: { useOnlySpecificFareTable: boolean, displayExpiredSchedulesInUI: boolean } }>>}
    */
   function get({token, jwtToken, headers}) {
     return client({
@@ -27,11 +27,11 @@ function marketPricingSettingsFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * PUT /market-pricing-settings – Update market pricing settings. Body: MarketPricingSettings at root (useOnlySpecificFareTable required).
+   * PUT /market-pricing-settings – Update market pricing settings. Body: MarketPricingSettings at root (useOnlySpecificFareTable and displayExpiredSchedulesInUI required).
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {Object} opts.marketPricingSettings - { useOnlySpecificFareTable: boolean }
+   * @param {Object} opts.marketPricingSettings - { useOnlySpecificFareTable: boolean, displayExpiredSchedulesInUI: boolean }
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse<{ marketPricingSettings: object }>>}
    */

package/src/endpoints/accounts/multiproduct-sales-settings.js

@@ -27,11 +27,15 @@ function multiproductSalesSettingsFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * PUT /multiproduct-sales-settings – Create or update multi-product sales settings (upsert). Body: MultiProductSettingsPayload (productsMapping, stationsMapping, faresMapping, fareClassesMapping). Emits networks.created or networks.updated.
+   * PUT /multiproduct-sales-settings – Create or update multi-product sales settings
+   * (upsert). Body: MultiProductSettingsPayload (productsMapping, stationsMapping,
+   * faresMapping, fareClassesMapping). Emits networks.created or networks.updated.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {Object} opts.data - multiProductSettings payload (productsMapping, stationsMapping, faresMapping, fareClassesMapping; each key ObjectId, each value array of ObjectIds)
+   * @param {Object} opts.data - multiProductSettings payload. Includes
+   * productsMapping, stationsMapping, faresMapping, and fareClassesMapping; each
+   * key is an ObjectId and each value is an array of ObjectIds.
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse<{ multiProductSettings: object }>>}
    */

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

@@ -29,7 +29,9 @@ function operationSettingsFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * PUT /operation-settings – Update operation settings. Body: { operationSettings } (OperationSettingsPutData). Emits operationsettings.updated.
+   * PUT /operation-settings – Update operation settings. Body:
+   * { operationSettings } (OperationSettingsPutData). Emits
+   * operationsettings.updated.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol

package/src/endpoints/btrzpay/referenced-payments.js

@@ -15,14 +15,18 @@ const {authorizationHeaders} = require("./../endpoints_helpers.js");
  */
 function referencedPaymentsFactory({client, internalAuthTokenProvider}) {
   /**
-   * GET /referenced-payments/:transactionId/:referenceNumber/status - get referenced payment status. Requires backoffice auth. Response body: { paymentResult: { status, result } | null }.
+   * GET /referenced-payments/:transactionId/:referenceNumber/status - get
+   * referenced payment status. Requires backoffice auth. Response body:
+   * { paymentResult: { status, result } | null }.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.transactionId - Transaction ID
    * @param {string} opts.referenceNumber - Reference number of the payment
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse<{ paymentResult: { status: "error"|"pending"|"success"|"review", result: object } | null }>>}
+   * @returns {Promise<import("axios").AxiosResponse<{
+   *   paymentResult: { status: "error"|"pending"|"success"|"review", result: object } | null
+   * }>>}
    */
   function getStatus({token, jwtToken, transactionId, referenceNumber, headers}) {
     return client.get(`/referenced-payments/${transactionId}/${referenceNumber}/status`, {

package/src/endpoints/btrzpay/square.js

@@ -11,7 +11,9 @@ const {
  */
 function squareWebhooksFactory({client, internalAuthTokenProvider}) {
   /**
-   * POST /square-webhooks/:providerId - send Square webhook payload to the Payments API. API verifies x-square-signature when present. Body must include type and data (Square webhook format).
+   * POST /square-webhooks/:providerId - send Square webhook payload to the
+   * Payments API. API verifies x-square-signature when present. Body must
+   * include type and data (Square webhook format).
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -43,12 +45,19 @@ function squareWebhooksFactory({client, internalAuthTokenProvider}) {
  */
 function squareTerminalsFactory({client, internalAuthTokenProvider}) {
   /**
-   * GET /square-terminals - list Square terminals for the account. Requires JWT (BETTEREZ_APP or MOBILE_SCANNER). Response body: { terminals } with terminal objects (id, name, code, deviceId, productType, locationId, status, pairBy, createdAt, statusChangedAt).
+   * GET /square-terminals - list Square terminals for the account. Requires
+   * JWT (BETTEREZ_APP or MOBILE_SCANNER). Response body: { terminals } with
+   * terminal objects (id, name, code, deviceId, productType, locationId,
+   * status, pairBy, createdAt, statusChangedAt).
    * @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<{ terminals: Array<{ id: string, name: string, code: string, deviceId?: string, productType?: string, locationId: string, status?: string, pairBy?: string, createdAt?: string, statusChangedAt?: string }> }>>}
+   * @returns {Promise<import("axios").AxiosResponse<{ terminals: Array<{
+   *   id: string, name: string, code: string, deviceId?: string, productType?: string,
+   *   locationId: string, status?: string, pairBy?: string,
+   *   createdAt?: string, statusChangedAt?: string
+   * }> }>>}
    */
   function get({token, jwtToken, headers}) {
     return client.get("/square-terminals", {

package/src/endpoints/btrzpay/stripe-terminals.js

@@ -5,7 +5,8 @@ const {
 /**
  * Query params for GET /stripe-terminals (btrz-api-payments). See get-handler getSpec().
  * @typedef {Object} StripeTerminalsListQuery
- * @property {string} [providerId] - Account provider (operator) ID; used by agencies/sellers; when omitted, authenticated account ID is used
+ * @property {string} [providerId] - Account provider (operator) ID used by
+ * agencies/sellers; when omitted, authenticated account ID is used
  */
 
 /**
@@ -31,7 +32,9 @@ function stripeTerminalsFactory({client, internalAuthTokenProvider}) {
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {StripeTerminalsListQuery} [opts.query] - Optional providerId
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse<GetStripeTerminalsResponse>>} Rejects with 400 (STRIPE_SECRET_KEY_INVALID), 401, 404 (PAYMENT_METHOD_NOT_FOUND), 500.
+   * @returns {Promise<import("axios").AxiosResponse<GetStripeTerminalsResponse>>}
+   * Rejects with 400 (STRIPE_SECRET_KEY_INVALID), 401,
+   * 404 (PAYMENT_METHOD_NOT_FOUND), 500.
    */
   function all({token, jwtToken, headers, query = {}}) {
     return client.get("/stripe-terminals", {
@@ -50,7 +53,10 @@ function stripeTerminalsFactory({client, internalAuthTokenProvider}) {
    * @param {string} opts.id - Terminal ID (Stripe reader id, e.g. tmr_xxx)
    * @param {{ ccNumber: string }} opts.stripePayment - Payment to simulate; ccNumber required
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse<{ stripeTerminalPayment: Object }>>} Rejects with 400 (WRONG_DATA), 401, 404 (PAYMENT_METHOD_NOT_FOUND, TRANSACTION_NOT_FOUND), 409 (errorCode/errorMessage), 500.
+   * @returns {Promise<import("axios").AxiosResponse<{ stripeTerminalPayment: Object }>>}
+   * Rejects with 400 (WRONG_DATA), 401,
+   * 404 (PAYMENT_METHOD_NOT_FOUND, TRANSACTION_NOT_FOUND),
+   * 409 (errorCode/errorMessage), 500.
    */
   function simulate({token, jwtToken, id, stripePayment, headers}) {
     return client({

package/src/endpoints/btrzpay/terminalPayments.js

@@ -32,10 +32,14 @@ function terminalPaymentsFactory({client, internalAuthTokenProvider}) {
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
      * @param {string} opts.id - Terminal payment ID (UUID)
-     * @param {{ result?: Object, paymentRequest: Object, orderId: string }} opts.terminalPayment - Terminal payment data (result, paymentRequest, orderId)
+     * @param {{ result?: Object, paymentRequest: Object, orderId: string }} opts.terminalPayment
+     * - Terminal payment data (result, paymentRequest, orderId)
      * @param {TerminalPaymentsMitPutQuery} [opts.query] - Optional providerId
      * @param {Object} [opts.headers] - Optional headers
-     * @returns {Promise<import("axios").AxiosResponse<{ terminalPayment: Object }>>} Rejects with 400 (WRONG_DATA, INVALID_TERMINALPAYMENT_ID, INVALID_RESULT_OBJECT, MIT_*), 401, 404 (TERMINALPAYMENT_NOT_FOUND, MIT_PAYMENT_NOT_FOUND), 409 (CANT_UPDATE_ORDER), 500.
+     * @returns {Promise<import("axios").AxiosResponse<{ terminalPayment: Object }>>}
+     * Rejects with 400 (WRONG_DATA, INVALID_TERMINALPAYMENT_ID,
+     * INVALID_RESULT_OBJECT, MIT_*), 401, 404 (TERMINALPAYMENT_NOT_FOUND,
+     * MIT_PAYMENT_NOT_FOUND), 409 (CANT_UPDATE_ORDER), 500.
      */
     update({token, jwtToken, id, terminalPayment, query = {}, headers}) {
       return client({
@@ -54,7 +58,10 @@ function terminalPaymentsFactory({client, internalAuthTokenProvider}) {
      * @param {string} opts.id - Terminal payment ID (UUID)
      * @param {TerminalPaymentsMitGetQuery} opts.query - branchId, companyId, date (required); optional providerId
      * @param {Object} [opts.headers] - Optional headers
-     * @returns {Promise<import("axios").AxiosResponse<{ terminalPayment: Object }>>} Rejects with 400 (WRONG_DATA, INVALID_TERMINALPAYMENT_ID, INVALID_DATE, MIT_*), 401, 404 (TERMINALPAYMENT_NOT_FOUND, MIT_PAYMENT_NOT_FOUND), 500.
+     * @returns {Promise<import("axios").AxiosResponse<{ terminalPayment: Object }>>}
+     * Rejects with 400 (WRONG_DATA, INVALID_TERMINALPAYMENT_ID,
+     * INVALID_DATE, MIT_*), 401, 404 (TERMINALPAYMENT_NOT_FOUND,
+     * MIT_PAYMENT_NOT_FOUND), 500.
      */
     get({token, jwtToken, id, query = {}, headers}) {
       return client.get(`/terminal-payments/mit/${id}`, {
@@ -73,7 +80,10 @@ function terminalPaymentsFactory({client, internalAuthTokenProvider}) {
      * @param {Object} [opts.headers] - Optional headers
      * @param {string} [opts.token] - API key (optional when no userId in payload)
      * @param {string} [opts.jwtToken] - JWT or internal auth (required when userId is in payload)
-     * @returns {Promise<import("axios").AxiosResponse<{ status: string }>>} Rejects with 400 (INVALID_WEBHOOK_PAYLOAD), 401 (when userId present but not authenticated), 404 (PAYMENT_NOT_FOUND_FOR_WEBHOOK_EVENT, PAYMENT_METHOD_NOT_FOUND, USER_NOT_FOUND), 409 (CANT_UPDATE_ORDER), 500.
+     * @returns {Promise<import("axios").AxiosResponse<{ status: string }>>}
+     * Rejects with 400 (INVALID_WEBHOOK_PAYLOAD), 401 (when userId present but
+     * not authenticated), 404 (PAYMENT_NOT_FOUND_FOR_WEBHOOK_EVENT,
+     * PAYMENT_METHOD_NOT_FOUND, USER_NOT_FOUND), 409 (CANT_UPDATE_ORDER), 500.
      */
     getnet({data, providerId, headers = {}, token, jwtToken}) {
       const _headers = token && jwtToken ?

package/src/endpoints/inventory/document-types.js

@@ -46,7 +46,8 @@ function documentTypesFactory({client, internalAuthTokenProvider}) {
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.id - Document type id (24 hex characters)
    * @param {DocumentTypeGetByIdQuery} [opts.query] - Optional query params (merged with providerId when opts.providerId is set)
-   * @param {string} [opts.providerId] - Provider id (ObjectId); merged into query for provider context (same as peopleLookups.getById / dynamicForms.get)
+   * @param {string} [opts.providerId] - Provider id (ObjectId); merged into
+   * query for provider context (same as peopleLookups.getById / dynamicForms.get)
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse<{ documenttype: Object }>>}
    * @throws When response is 4xx/5xx (400, 401, 404 DOCUMENTTYPE_NOT_FOUND, 500)