btrz-api-client 8.29.0 → 8.31.0

package/lib/endpoints/accounts/shifts.js

@@ -1,12 +1,67 @@
 "use strict";
 
+/* eslint-disable max-len */
 var _require = require("./../endpoints_helpers.js"),
     authorizationHeaders = _require.authorizationHeaders;
 
+/**
+ * Query params for GET /shifts (btrz-api-accounts). See get-shifts handler getSpec().
+ * @typedef {Object} ShiftsListQuery
+ * @property {string} [includeActivity] - 'true'|'false'; default 'true' (include sales activity)
+ * @property {string} [status] - open | closed (ignored if pendingShiftClosure is true)
+ * @property {string} [pendingShiftClosure] - 'true'|'false'; return shifts that need shift closure
+ * @property {string} [locationId] - Filter by location (ObjectId)
+ * @property {string} [providerId] - Provider for payments (ObjectId)
+ * @property {string} [sort] - closedAsc | closedDesc | openedAsc
+ * @property {string} [fromDate] - Start date (YYYY-MM-DD); requires toDate
+ * @property {string} [toDate] - End date (YYYY-MM-DD); requires fromDate
+ */
+
+/**
+ * Query params for GET /shifts/location-closures (btrz-api-accounts). See get-location-closures handler getSpec().
+ * @typedef {Object} LocationClosuresListQuery
+ * @property {string} [sort] - createdAsc | createdDesc | updatedAsc | updatedDesc
+ * @property {number} [page] - Page number
+ * @property {string} [fromDate] - Start date (YYYY-MM-DD); requires toDate
+ * @property {string} [toDate] - End date (YYYY-MM-DD); requires fromDate
+ */
+
+/**
+ * Query params for GET /shifts/:locationId/purchase-limit-payments (btrz-api-accounts). See getSpec().
+ * @typedef {Object} PurchaseLimitPaymentsQuery
+ * @property {string} day - Date of payments (YYYY-MM-DD). Required.
+ */
+
+/**
+ * Query params for GET /shifts/:shiftId/sales-summary (btrz-api-accounts). See get-shift-sales-summary getSpec().
+ * @typedef {Object} ShiftSalesSummaryQuery
+ * @property {string} [type] - 'revenueOperatingCompany' to aggregate by revenue operating company
+ * @property {boolean} [depositable] - Get only depositable payment types
+ * @property {boolean} [paymentsAndRefundsDetails] - Include payments and refunds details per payment type and currency
+ */
+
+/**
+ * Factory for shifts API (btrz-api-accounts).
+ * @param {Object} deps
+ * @param {import("axios").AxiosInstance} deps.client
+ * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
+ * @returns {{ all: function, get: function, create: function, update: function, requiresAgencyShiftClosure: object, payments: object, transactions: object, tickets: object, fees: object, refunds: object, items: object, redeemableItems: object, giftCertificates: object, parcels: object, insurances: object, invoices: object, deposits: object, manualTickets: object, locationClosures: object, startingBalances: object, purchaseLimitPayments: object, salesSummary: object, commissions: object }}
+ */
+
+
 function shiftsFactory(_ref) {
   var client = _ref.client,
       internalAuthTokenProvider = _ref.internalAuthTokenProvider;
 
+  /**
+   * GET /shifts - list shifts.
+   * @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 {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function all(_ref2) {
     var jwtToken = _ref2.jwtToken,
         token = _ref2.token,
@@ -21,6 +76,14 @@ function shiftsFactory(_ref) {
     });
   }
 
+  /**
+   * GET /shift/user/:userId - get shift for user. API does not accept query params.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} opts.userId - User id (ObjectId)
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function get(_ref3) {
     var token = _ref3.token,
         userId = _ref3.userId,
@@ -31,6 +94,15 @@ function shiftsFactory(_ref) {
     });
   }
 
+  /**
+   * POST /shifts - create a shift.
+   * @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.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function create(_ref4) {
     var jwtToken = _ref4.jwtToken,
         token = _ref4.token,
@@ -47,6 +119,16 @@ function shiftsFactory(_ref) {
     });
   }
 
+  /**
+   * PATCH /shifts/:shiftId - update a shift (operations). API getSpec() does not define query params.
+   * @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.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function update(_ref5) {
     var jwtToken = _ref5.jwtToken,
         token = _ref5.token,
@@ -69,6 +151,16 @@ function shiftsFactory(_ref) {
   }
 
   var locationClosureComments = {
+    /**
+     * POST /shifts/location-closures/:locationClosureId/comments - add comment to location closure.
+     * @param {Object} opts
+     * @param {string} [opts.token] - API key
+     * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+     * @param {string} opts.locationClosureId - Location closure id (ObjectId)
+     * @param {Object} opts.locationClosureComment - Comment payload
+     * @param {Object} [opts.headers] - Optional headers
+     * @returns {Promise<import("axios").AxiosResponse>}
+     */
     create: function create(_ref6) {
       var jwtToken = _ref6.jwtToken,
           token = _ref6.token,
@@ -88,6 +180,16 @@ function shiftsFactory(_ref) {
   };
 
   var locationClosureStatus = {
+    /**
+     * PUT /shifts/location-closures/:locationClosureId/status - update location closure status.
+     * @param {Object} opts
+     * @param {string} [opts.token] - API key
+     * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+     * @param {string} opts.locationClosureId - Location closure id (ObjectId)
+     * @param {Object} opts.locationClosureStatusChange - Status change payload
+     * @param {Object} [opts.headers] - Optional headers
+     * @returns {Promise<import("axios").AxiosResponse>}
+     */
     update: function update(_ref7) {
       var jwtToken = _ref7.jwtToken,
           token = _ref7.token,
@@ -107,6 +209,15 @@ function shiftsFactory(_ref) {
   };
 
   var locationClosures = {
+    /**
+     * POST /shifts/location-closures - create a location closure.
+     * @param {Object} opts
+     * @param {string} [opts.token] - API key
+     * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+     * @param {Object} opts.locationClosure - Location closure payload
+     * @param {Object} [opts.headers] - Optional headers
+     * @returns {Promise<import("axios").AxiosResponse>}
+     */
     create: function create(_ref8) {
       var jwtToken = _ref8.jwtToken,
           token = _ref8.token,
@@ -122,6 +233,16 @@ function shiftsFactory(_ref) {
         data: locationClosure
       });
     },
+
+    /**
+     * GET /shifts/location-closures - list location closures.
+     * @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 {Object} [opts.headers] - Optional headers
+     * @returns {Promise<import("axios").AxiosResponse>}
+     */
     all: function all(_ref9) {
       var jwtToken = _ref9.jwtToken,
           token = _ref9.token,
@@ -135,6 +256,16 @@ function shiftsFactory(_ref) {
         params: query
       });
     },
+
+    /**
+     * GET /shifts/location-closures/:locationClosureId - get a location closure. 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.locationClosureId - Location closure id (ObjectId)
+     * @param {Object} [opts.headers] - Optional headers
+     * @returns {Promise<import("axios").AxiosResponse>}
+     */
     get: function get(_ref10) {
       var token = _ref10.token,
           jwtToken = _ref10.jwtToken,
@@ -151,6 +282,15 @@ function shiftsFactory(_ref) {
   };
 
   var payments = {
+    /**
+     * GET /shifts/:shiftId/payments - get payments for shift.
+     * @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.headers] - Optional headers
+     * @returns {Promise<import("axios").AxiosResponse>}
+     */
     get: function get(_ref11) {
       var token = _ref11.token,
           jwtToken = _ref11.jwtToken,
@@ -163,6 +303,15 @@ function shiftsFactory(_ref) {
     }
   };
   var transactions = {
+    /**
+     * GET /shifts/:shiftId/transactions - get transactions for shift.
+     * @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.headers] - Optional headers
+     * @returns {Promise<import("axios").AxiosResponse>}
+     */
     get: function get(_ref12) {
       var token = _ref12.token,
           jwtToken = _ref12.jwtToken,
@@ -175,6 +324,15 @@ function shiftsFactory(_ref) {
     }
   };
   var tickets = {
+    /**
+     * GET /shifts/:shiftId/tickets - get tickets for shift.
+     * @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.headers] - Optional headers
+     * @returns {Promise<import("axios").AxiosResponse>}
+     */
     get: function get(_ref13) {
       var token = _ref13.token,
           jwtToken = _ref13.jwtToken,
@@ -187,6 +345,15 @@ function shiftsFactory(_ref) {
     }
   };
   var fees = {
+    /**
+     * GET /shifts/:shiftId/fees - get fees for shift.
+     * @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.headers] - Optional headers
+     * @returns {Promise<import("axios").AxiosResponse>}
+     */
     get: function get(_ref14) {
       var token = _ref14.token,
           jwtToken = _ref14.jwtToken,
@@ -199,6 +366,15 @@ function shiftsFactory(_ref) {
     }
   };
   var refunds = {
+    /**
+     * GET /shifts/:shiftId/refunds - get refunds for shift.
+     * @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.headers] - Optional headers
+     * @returns {Promise<import("axios").AxiosResponse>}
+     */
     get: function get(_ref15) {
       var token = _ref15.token,
           jwtToken = _ref15.jwtToken,
@@ -211,6 +387,15 @@ function shiftsFactory(_ref) {
     }
   };
   var items = {
+    /**
+     * GET /shifts/:shiftId/items - get items for shift.
+     * @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.headers] - Optional headers
+     * @returns {Promise<import("axios").AxiosResponse>}
+     */
     get: function get(_ref16) {
       var token = _ref16.token,
           jwtToken = _ref16.jwtToken,
@@ -223,6 +408,15 @@ function shiftsFactory(_ref) {
     }
   };
   var redeemableItems = {
+    /**
+     * GET /shifts/:shiftId/redeemable-items - get redeemable items for shift.
+     * @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.headers] - Optional headers
+     * @returns {Promise<import("axios").AxiosResponse>}
+     */
     get: function get(_ref17) {
       var token = _ref17.token,
           jwtToken = _ref17.jwtToken,
@@ -235,6 +429,15 @@ function shiftsFactory(_ref) {
     }
   };
   var giftCertificates = {
+    /**
+     * GET /shifts/:shiftId/gift-certificates - get gift certificates for shift.
+     * @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.headers] - Optional headers
+     * @returns {Promise<import("axios").AxiosResponse>}
+     */
     get: function get(_ref18) {
       var token = _ref18.token,
           jwtToken = _ref18.jwtToken,
@@ -247,6 +450,15 @@ function shiftsFactory(_ref) {
     }
   };
   var parcels = {
+    /**
+     * GET /shifts/:shiftId/parcels - get parcels for shift.
+     * @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.headers] - Optional headers
+     * @returns {Promise<import("axios").AxiosResponse>}
+     */
     get: function get(_ref19) {
       var token = _ref19.token,
           jwtToken = _ref19.jwtToken,
@@ -259,6 +471,15 @@ function shiftsFactory(_ref) {
     }
   };
   var insurances = {
+    /**
+     * GET /shifts/:shiftId/insurances - get insurances for shift.
+     * @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.headers] - Optional headers
+     * @returns {Promise<import("axios").AxiosResponse>}
+     */
     get: function get(_ref20) {
       var token = _ref20.token,
           jwtToken = _ref20.jwtToken,
@@ -271,6 +492,15 @@ function shiftsFactory(_ref) {
     }
   };
   var invoices = {
+    /**
+     * GET /shifts/:shiftId/invoices - get invoices for shift.
+     * @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.headers] - Optional headers
+     * @returns {Promise<import("axios").AxiosResponse>}
+     */
     get: function get(_ref21) {
       var token = _ref21.token,
           jwtToken = _ref21.jwtToken,
@@ -283,6 +513,15 @@ function shiftsFactory(_ref) {
     }
   };
   var deposits = {
+    /**
+     * GET /shifts/:shiftId/deposits - get deposits for shift.
+     * @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.headers] - Optional headers
+     * @returns {Promise<import("axios").AxiosResponse>}
+     */
     get: function get(_ref22) {
       var token = _ref22.token,
           jwtToken = _ref22.jwtToken,
@@ -293,6 +532,17 @@ function shiftsFactory(_ref) {
         headers: authorizationHeaders({ token: token, jwtToken: jwtToken, internalAuthTokenProvider: internalAuthTokenProvider, headers: headers })
       });
     },
+
+    /**
+     * POST /shifts/:shiftId/deposits - create a deposit for shift.
+     * @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.deposit - Deposit payload
+     * @param {Object} [opts.headers] - Optional headers
+     * @returns {Promise<import("axios").AxiosResponse>}
+     */
     create: function create(_ref23) {
       var jwtToken = _ref23.jwtToken,
           token = _ref23.token,
@@ -309,6 +559,15 @@ function shiftsFactory(_ref) {
     }
   };
   var manualTickets = {
+    /**
+     * GET /shifts/:shiftId/manual-tickets - get manual tickets for shift.
+     * @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.headers] - Optional headers
+     * @returns {Promise<import("axios").AxiosResponse>}
+     */
     get: function get(_ref24) {
       var token = _ref24.token,
           jwtToken = _ref24.jwtToken,
@@ -319,6 +578,17 @@ function shiftsFactory(_ref) {
         headers: authorizationHeaders({ token: token, jwtToken: jwtToken, internalAuthTokenProvider: internalAuthTokenProvider, headers: headers })
       });
     },
+
+    /**
+     * POST /shifts/:shiftId/manual-tickets - create a manual ticket for shift.
+     * @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.manualTicket - Manual ticket payload
+     * @param {Object} [opts.headers] - Optional headers
+     * @returns {Promise<import("axios").AxiosResponse>}
+     */
     create: function create(_ref25) {
       var jwtToken = _ref25.jwtToken,
           token = _ref25.token,
@@ -335,6 +605,16 @@ function shiftsFactory(_ref) {
     }
   };
   var startingBalances = {
+    /**
+     * POST /shifts/:shiftId/starting-balance - create starting balance for shift.
+     * @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.startingBalance - Starting balance payload
+     * @param {Object} [opts.headers] - Optional headers
+     * @returns {Promise<import("axios").AxiosResponse>}
+     */
     create: function create(_ref26) {
       var jwtToken = _ref26.jwtToken,
           token = _ref26.token,
@@ -351,6 +631,16 @@ function shiftsFactory(_ref) {
     }
   };
   var purchaseLimitPayments = {
+    /**
+     * GET /shifts/:locationId/purchase-limit-payments - get purchase limit payments for location.
+     * @param {Object} opts
+     * @param {string} [opts.token] - API key
+     * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+     * @param {string} opts.locationId - Location id (ObjectId)
+     * @param {PurchaseLimitPaymentsQuery} [opts.query] - Query params; day (YYYY-MM-DD) is required
+     * @param {Object} [opts.headers] - Optional headers
+     * @returns {Promise<import("axios").AxiosResponse>}
+     */
     get: function get(_ref27) {
       var token = _ref27.token,
           jwtToken = _ref27.jwtToken,
@@ -367,6 +657,16 @@ function shiftsFactory(_ref) {
     }
   };
   var salesSummary = {
+    /**
+     * GET /shifts/:shiftId/sales-summary - get sales summary for shift.
+     * @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 {ShiftSalesSummaryQuery} [opts.query] - Query params (type, depositable, paymentsAndRefundsDetails)
+     * @param {Object} [opts.headers] - Optional headers
+     * @returns {Promise<import("axios").AxiosResponse>}
+     */
     get: function get(_ref28) {
       var token = _ref28.token,
           jwtToken = _ref28.jwtToken,
@@ -383,6 +683,15 @@ function shiftsFactory(_ref) {
     }
   };
   var commissions = {
+    /**
+     * GET /shifts/:shiftId/commissions - get commissions for shift.
+     * @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.headers] - Optional headers
+     * @returns {Promise<import("axios").AxiosResponse>}
+     */
     get: function get(_ref29) {
       var token = _ref29.token,
           jwtToken = _ref29.jwtToken,
@@ -396,6 +705,16 @@ function shiftsFactory(_ref) {
   };
 
   var requiresAgencyShiftClosure = {
+    /**
+     * PUT /shifts/:shiftId/requires-agency-shift-closure - set requires agency shift closure.
+     * @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.shiftData] - Shift data payload
+     * @param {Object} [opts.headers] - Optional headers
+     * @returns {Promise<import("axios").AxiosResponse>}
+     */
     put: function put(_ref30) {
       var token = _ref30.token,
           jwtToken = _ref30.jwtToken,

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

@@ -1,12 +1,59 @@
 "use strict";
 
+/* eslint-disable max-len */
 var _require = require("../endpoints_helpers.js"),
     authorizationHeaders = _require.authorizationHeaders;
 
+/**
+ * Query params for GET /sms-templates (btrz-api-accounts). See get-handler getSpec().
+ * @typedef {Object} SmsTemplatesListQuery
+ * @property {string} [providerId] - Filter by provider account (ObjectId)
+ * @property {string} [type] - Filter by template type
+ * @property {string} [channel] - backoffice | agency-backoffice | websales | agency-websales | any
+ * @property {string} [sort] - relevance | natural | createdAsc | createdDesc | updatedAsc | updatedDesc
+ * @property {string} [templateCollectionId] - default | custom
+ * @property {string} [status] - draft | published
+ * @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
+ */
+
+/**
+ * Query params for GET /sms-templates/:smsTemplateId (btrz-api-accounts). See get-by-id-handler getSpec().
+ * @typedef {Object} SmsTemplateGetByIdQuery
+ * @property {string} [providerId] - Filter by provider; template must belong to this account, current, or global (ObjectId)
+ * @property {string} [superUserId] - Super user ID for authentication (ObjectId)
+ * @property {string} [superUserHash] - Super user hash for authentication
+ */
+
+/**
+ * Query params for PUT /sms-templates/:smsTemplateId/versions/:versionId (btrz-api-accounts). See put-version-handler getSpec().
+ * @typedef {Object} SmsTemplateVersionUpdateQuery
+ * @property {string} [superUserId] - Super user ID (ObjectId)
+ * @property {string} [superUserHash] - Super user hash for authentication
+ */
+
+/**
+ * Factory for sms-templates API (btrz-api-accounts).
+ * @param {Object} deps
+ * @param {import("axios").AxiosInstance} deps.client
+ * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
+ * @returns {{ getTypes: function, all: function, get: function, create: function, update: function, remove: function, createSub: function, versions: { update: function } }}
+ */
+
+
 function smsTemplatesFactory(_ref) {
   var client = _ref.client,
       internalAuthTokenProvider = _ref.internalAuthTokenProvider;
 
+  /**
+   * GET /sms-templates/types - returns available template types. API does not accept query params.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function getTypes(_ref2) {
     var token = _ref2.token,
         jwtToken = _ref2.jwtToken,
@@ -18,6 +65,15 @@ function smsTemplatesFactory(_ref) {
     });
   }
 
+  /**
+   * GET /sms-templates - list SMS templates.
+   * @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 {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function all(_ref3) {
     var token = _ref3.token,
         jwtToken = _ref3.jwtToken,
@@ -32,6 +88,16 @@ function smsTemplatesFactory(_ref) {
     });
   }
 
+  /**
+   * GET /sms-templates/:smsTemplateId - get a single 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 {SmsTemplateGetByIdQuery} [opts.query] - Query params (providerId, superUserId, superUserHash)
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function get(_ref4) {
     var token = _ref4.token,
         jwtToken = _ref4.jwtToken,
@@ -47,6 +113,15 @@ function smsTemplatesFactory(_ref) {
     });
   }
 
+  /**
+   * POST /sms-templates - create an SMS template. API does not accept query params.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {Object} opts.data - Request body
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function create(_ref5) {
     var token = _ref5.token,
         jwtToken = _ref5.jwtToken,
@@ -61,6 +136,16 @@ function smsTemplatesFactory(_ref) {
     });
   }
 
+  /**
+   * PUT /sms-templates/:smsTemplateId - update an SMS template. 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.smsTemplateId - Template id (ObjectId)
+   * @param {Object} opts.data - Request body
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function update(_ref6) {
     var token = _ref6.token,
         jwtToken = _ref6.jwtToken,
@@ -76,6 +161,15 @@ function smsTemplatesFactory(_ref) {
     });
   }
 
+  /**
+   * DELETE /sms-templates/:smsTemplateId - delete an SMS template. 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.smsTemplateId - Template id (ObjectId)
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function remove(_ref7) {
     var token = _ref7.token,
         jwtToken = _ref7.jwtToken,
@@ -89,6 +183,16 @@ function smsTemplatesFactory(_ref) {
     });
   }
 
+  /**
+   * POST /sub-sms-templates - create a sub SMS template from a main template. 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.mainTemplateId - Main template id (ObjectId)
+   * @param {string} opts.agencyId - Agency id (ObjectId)
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function createSub(_ref8) {
     var token = _ref8.token,
         jwtToken = _ref8.jwtToken,
@@ -105,6 +209,17 @@ function smsTemplatesFactory(_ref) {
   }
 
   var versions = {
+    /**
+     * PUT /sms-templates/:smsTemplateId/versions/:versionId - roll back sms template to a version.
+     * @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 {Object} [opts.headers] - Optional headers
+     * @returns {Promise<import("axios").AxiosResponse>}
+     */
     update: function update(_ref9) {
       var token = _ref9.token,
           jwtToken = _ref9.jwtToken,