btrz-api-client 8.30.0 → 8.32.0

package/lib/client.js

@@ -212,6 +212,7 @@ function createAccounts(_ref4) {
 
   return {
     accounts: require("./endpoints/accounts/accounts.js")({ client: client, internalAuthTokenProvider: internalAuthTokenProvider }),
+    agencies: require("./endpoints/accounts/agencies.js")({ client: client, internalAuthTokenProvider: internalAuthTokenProvider }),
     application: require("./endpoints/accounts/application.js")({ client: client, internalAuthTokenProvider: internalAuthTokenProvider }),
     applications: require("./endpoints/accounts/applications.js")({ client: client, internalAuthTokenProvider: internalAuthTokenProvider }),
     applicationSettings: require("./endpoints/accounts/application-settings.js")({ client: client, internalAuthTokenProvider: internalAuthTokenProvider }),
@@ -227,6 +228,7 @@ function createAccounts(_ref4) {
     smsTemplates: require("./endpoints/accounts/sms-templates.js")({ client: client, internalAuthTokenProvider: internalAuthTokenProvider }),
     exchangeRates: require("./endpoints/accounts/exchange-rates.js")({ client: client, internalAuthTokenProvider: internalAuthTokenProvider }),
     exchangeReceipts: require("./endpoints/accounts/exchange-receipts.js")({ client: client, internalAuthTokenProvider: internalAuthTokenProvider }),
+    externalCustomers: require("./endpoints/accounts/external-customers.js")({ client: client, internalAuthTokenProvider: internalAuthTokenProvider }),
     goalSettings: require("./endpoints/accounts/goal-settings.js")({ client: client, internalAuthTokenProvider: internalAuthTokenProvider }),
     images: require("./endpoints/accounts/images.js")({ client: client, internalAuthTokenProvider: internalAuthTokenProvider }),
     interline: require("./endpoints/accounts/interline.js")({ client: client, internalAuthTokenProvider: internalAuthTokenProvider }),
@@ -265,6 +267,7 @@ function createAccounts(_ref4) {
     trustedMachines: require("./endpoints/accounts/trusted-machines.js")({ client: client, internalAuthTokenProvider: internalAuthTokenProvider }),
     twilioSettings: require("./endpoints/accounts/twilio-settings.js")({ client: client, internalAuthTokenProvider: internalAuthTokenProvider }),
     users: require("./endpoints/accounts/users.js")({ client: client, internalAuthTokenProvider: internalAuthTokenProvider }),
+    verifiedEmails: require("./endpoints/accounts/verified-emails.js")({ client: client, internalAuthTokenProvider: internalAuthTokenProvider }),
     __test: {
       client: client
     },

package/lib/endpoints/accounts/agencies.js

@@ -0,0 +1,52 @@
+"use strict";
+
+/* eslint-disable max-len */
+var _require = require("../endpoints_helpers.js"),
+    authorizationHeaders = _require.authorizationHeaders;
+
+/**
+ * Factory for agencies endpoints (btrz-api-accounts).
+ * @param {Object} deps
+ * @param {import("axios").AxiosInstance} deps.client
+ * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
+ * @returns {{ putCreditLimit: function }}
+ */
+
+
+function agenciesFactory(_ref) {
+  var client = _ref.client,
+      internalAuthTokenProvider = _ref.internalAuthTokenProvider;
+
+  /**
+   * 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 } }.
+   * Side effect: Emits webhook event creditlimit.updated.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {string} opts.agencyId - Agency (seller) ID, 24-char hex ObjectId. Must not be the provider's own accountId.
+   * @param {Object} opts.data - Credit limit payload: { limitAmount: number, unlimited: boolean } or { creditLimit: { limitAmount, unlimited } }
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse<{ creditLimit: { _id: string, sellerId: string, providerId: string, unlimited: boolean, overrideLimit: number, currentLimit: number } }>>}
+   */
+  function putCreditLimit(_ref2) {
+    var token = _ref2.token,
+        jwtToken = _ref2.jwtToken,
+        agencyId = _ref2.agencyId,
+        data = _ref2.data,
+        headers = _ref2.headers;
+
+    return client({
+      url: "/agencies/" + agencyId + "/credit-limit",
+      method: "put",
+      headers: authorizationHeaders({ token: token, jwtToken: jwtToken, internalAuthTokenProvider: internalAuthTokenProvider, headers: headers }),
+      data: data
+    });
+  }
+
+  return {
+    putCreditLimit: putCreditLimit
+  };
+}
+
+module.exports = agenciesFactory;

package/lib/endpoints/accounts/application-settings.js

@@ -1,8 +1,14 @@
 "use strict";
 
+/* eslint-disable max-len */
 var _require = require("./../endpoints_helpers.js"),
     authorizationHeaders = _require.authorizationHeaders;
 
+/**
+ * @typedef {Object} ApplicationSettingsQuery
+ * @property {string} [name] - Optional. Filter by application name. When set, unauthenticated returns one object or 404; authenticated returns array with at most one item.
+ */
+
 /**
  * Factory for application-settings API (btrz-api-accounts).
  * @param {Object} deps
@@ -17,14 +23,14 @@ function applicationSettingsFactory(_ref) {
       internalAuthTokenProvider = _ref.internalAuthTokenProvider;
 
   /**
-   * GET /application-settings/:providerId - get application settings for provider.
+   * GET /application-settings/:providerId - get application settings for a provider (account). Auth is optional: without auth returns one public object { key, settings, requestEndpoint }; with valid token returns array of application documents (see API docs for privateKey handling for internal apps).
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.providerId - Provider id (ObjectId)
-   * @param {Object} [opts.query] - Query params
+   * @param {string} opts.providerId - Account (provider) ID whose application settings to return
+   * @param {ApplicationSettingsQuery} [opts.query] - Optional query; use name to filter by application name
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse>} Response data: unauthenticated = { key, settings, requestEndpoint }; authenticated = array of application objects (see API docs)
    */
   function get(_ref2) {
     var token = _ref2.token,
@@ -41,14 +47,14 @@ function applicationSettingsFactory(_ref) {
   }
 
   /**
-   * PUT /application-settings/:id - update application settings.
+   * PUT /application-settings/:id - update an application. Body can be { application: { name, description?, settings?, requestEndpoint?, enableUserSignOn?, channels?, roles? } } or direct. Emits webhook applications.updated.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.id - Application settings id (ObjectId)
-   * @param {Object} opts.application - Application payload
+   * @param {string} opts.id - Application id (24-char hex ObjectId)
+   * @param {Object} opts.application - Application payload (name required; optional description, settings, requestEndpoint, enableUserSignOn, channels, roles)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse>} Response data: { application }
    */
   function update(_ref3) {
     var jwtToken = _ref3.jwtToken,
@@ -66,13 +72,13 @@ function applicationSettingsFactory(_ref) {
   }
 
   /**
-   * DELETE /application-settings/:id - remove application settings.
+   * DELETE /application-settings/:id - soft-delete an application. Emits webhook applications.deleted.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.id - Application settings id (ObjectId)
+   * @param {string} opts.id - Application id (24-char hex ObjectId)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse>} Response data: { id } (deleted application id)
    */
   function remove(_ref4) {
     var jwtToken = _ref4.jwtToken,
@@ -88,13 +94,13 @@ function applicationSettingsFactory(_ref) {
   }
 
   /**
-   * POST /application-settings/:id/keys - regenerate application keys.
+   * POST /application-settings/:id/keys - regenerate application keys; returns new key and privateKey. Emits webhook applications.updated.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.id - Application settings id (ObjectId)
+   * @param {string} opts.id - Application id (24-char hex ObjectId)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse>} Response data: { keys: { key, privateKey } }
    */
   function regenerateKeys(_ref5) {
     var jwtToken = _ref5.jwtToken,
@@ -110,13 +116,13 @@ function applicationSettingsFactory(_ref) {
   }
 
   /**
-   * POST /application-settings - create application settings.
+   * POST /application-settings - create an application. Body can be { application: { name, description?, settings?, requestEndpoint?, enableUserSignOn?, channels?, roles? } } or direct. Emits webhook applications.created.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {Object} opts.application - Application payload
+   * @param {Object} opts.application - Application payload (name required; optional description, settings, requestEndpoint, enableUserSignOn, channels, roles)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse>} Response data: { application }
    */
   function create(_ref6) {
     var jwtToken = _ref6.jwtToken,

package/lib/endpoints/accounts/applications.js

@@ -1,10 +1,11 @@
 "use strict";
 
+/* eslint-disable max-len */
 var _require = require("./../endpoints_helpers.js"),
     authorizationHeaders = _require.authorizationHeaders;
 
 /**
- * Factory for applications (by id/name) API (btrz-api-accounts).
+ * Factory for applications API (btrz-api-accounts): get by id or by name. Requires BETTEREZ_APP or MOBILE_SCANNER (get by id); get by name requires authentication.
  * @param {Object} deps
  * @param {import("axios").AxiosInstance} deps.client
  * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
@@ -17,13 +18,13 @@ function applicationsFactory(_ref) {
       internalAuthTokenProvider = _ref.internalAuthTokenProvider;
 
   /**
-   * GET /applications/:id - get an application by id.
+   * GET /applications/:id - get an application by id. Application must belong to the authenticated account.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.id - Application id (ObjectId)
+   * @param {string} opts.id - Application id (24-char hex ObjectId)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse>} Response data: { application } (full application document including privateKey)
    */
   function get(_ref2) {
     var token = _ref2.token,
@@ -36,13 +37,13 @@ function applicationsFactory(_ref) {
     });
   }
   /**
-   * GET /applications/name/:appName - get an application by name.
+   * GET /applications/name/:appName - get an application by name. Returns non-internal, non-deleted application for the account; response excludes privateKey.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.appName - Application name
+   * @param {string} opts.appName - Application name (exact match)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse>} Response data: { application } (application document without privateKey)
    */
   function getByName(_ref3) {
     var token = _ref3.token,

package/lib/endpoints/accounts/current-shifts.js

@@ -3,6 +3,11 @@
 var _require = require("./../endpoints_helpers.js"),
     authorizationHeaders = _require.authorizationHeaders;
 
+/**
+ * @typedef {Object} CurrentShiftsQuery
+ * @property {string} [includeActivity] - Set to 'false' to avoid returning sales activity data for the shift (default 'true')
+ */
+
 /**
  * Factory for current-shift (per user) API (btrz-api-accounts).
  * @param {Object} deps
@@ -21,7 +26,7 @@ function currentShiftsFactory(_ref) {
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} opts.userId - User id (ObjectId)
-   * @param {Object} [opts.query] - Query params
+   * @param {CurrentShiftsQuery} [opts.query] - Query params
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */

package/lib/endpoints/accounts/customers.js

@@ -2,11 +2,21 @@
 
 var _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; };
 
+/* eslint-disable max-len */
 var base64 = require("base-64");
 
 var _require = require("./../endpoints_helpers.js"),
     authorizationHeaders = _require.authorizationHeaders;
 
+/**
+ * Query params for GET /customers (btrz-api-accounts). Response is paginated (customers array + pagination).
+ * @typedef {Object} CustomersQuery
+ * @property {string} [customerNumber] - Filter: only that customer will be listed
+ * @property {string} [externalId] - Filter: same format as when creating the customer; only that customer listed
+ * @property {string} [providerIds] - Filter: provider ids to get customers from (comma-separated)
+ * @property {string} [lookupSearchParams] - Lookup search in format "documentTypeId|DNI,documentNumber|1234567" (documentNumber required)
+ */
+
 /**
  * Factory for customers API (btrz-api-accounts).
  * @param {Object} deps
@@ -21,14 +31,14 @@ function customersFactory(_ref) {
       internalAuthTokenProvider = _ref.internalAuthTokenProvider;
 
   /**
-   * PUT /customers/:customerId - update a customer (full replace).
+   * PUT /customers/:customerId - update a customer (full replace). Requires BETTEREZ_APP or CUSTOMER audience; customer token may only update own record. Side effect: may emit customer.updated webhook.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.customerId - Customer id (ObjectId)
-   * @param {Object} opts.customer - Customer payload
+   * @param {string} opts.customerId - Customer id (24-char hex ObjectId)
+   * @param {Object} opts.customer - Customer payload (CustomerData)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ _id: string, customerNumber: string, ... }>>}
    */
   function put(_ref2) {
     var customerId = _ref2.customerId,
@@ -46,14 +56,14 @@ function customersFactory(_ref) {
   }
 
   /**
-   * GET /customers - list customers.
+   * GET /customers - list customers (paginated). Optional filters: customerNumber, externalId, providerIds, lookupSearchParams.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {Object} [opts.query] - Query params
-   * @param {string} [opts.providerId] - Filter by provider id (ObjectId)
+   * @param {CustomersQuery} [opts.query] - Query params; API expects providerIds (comma-separated). Use providerId to send a single id.
+   * @param {string} [opts.providerId] - Convenience: added to query as providerId (single provider)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ customers: Array<object>, total: number, ... }>>}
    */
   function all(_ref3) {
     var token = _ref3.token,
@@ -72,14 +82,14 @@ function customersFactory(_ref) {
   }
 
   /**
-   * POST /customer - create a customer.
+   * POST /customer - create a customer. Body: { customer }. If password is included, activation token is created and activation email sent. Side effect: may emit customer.created webhook.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {Object} opts.customer - Customer payload
-   * @param {Object} [opts.query] - Query params
+   * @param {Object} opts.customer - Customer payload (CustomerPost); email, firstName, lastName required
+   * @param {Object} [opts.query] - Optional: uniqueEmail, lang, channel, platform, appVersion, appName, activateIfExists
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ _id: string, customerNumber: string, ... }>>}
    */
   function create(_ref4) {
     var customer = _ref4.customer,
@@ -154,15 +164,15 @@ function customersFactory(_ref) {
   }
 
   /**
-   * PATCH /customers/:customerId - partial update a customer.
+   * PATCH /customers/:customerId - apply operations (activate, reset password, activateEmailAndPwd). Body: { operations } array of PatchCustomerOperation. Returns Customer and auth tokens. Side effect: may emit customer.updated webhook.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.customerId - Customer id (ObjectId)
-   * @param {Object} opts.data - Partial customer payload
-   * @param {Object} [opts.query] - Query params
+   * @param {string} opts.customerId - Customer id (24-char hex ObjectId)
+   * @param {Object} opts.data - Body: { operations } or array of { op, path, value }
+   * @param {Object} [opts.query] - Optional query
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<CustomerWithAuthToken>>}
    */
   function update(_ref7) {
     var customerId = _ref7.customerId,
@@ -182,13 +192,13 @@ function customersFactory(_ref) {
   }
 
   /**
-   * POST /customers/merge - merge source customers into destination.
+   * POST /customers/merge - merge source customers into destination. Requires BETTEREZ_APP. Side effect: emits customers.merged webhook.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.destinationCustomerId - Destination customer id (ObjectId)
-   * @param {Array<string>} opts.sourceCustomerIds - Source customer ids (ObjectIds)
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @param {string} opts.destinationCustomerId - Destination customer id (24-char hex ObjectId)
+   * @param {Array<string>} opts.sourceCustomerIds - Source customer ids (24-char hex ObjectIds)
+   * @returns {Promise<import("axios").AxiosResponse<{ customerMerge: object }>>}
    */
   function merge(_ref8) {
     var destinationCustomerId = _ref8.destinationCustomerId,

package/lib/endpoints/accounts/domains.js

@@ -5,6 +5,7 @@ var _require = require("./../endpoints_helpers.js"),
 
 /**
  * Factory for domains API (btrz-api-accounts).
+ * Endpoints manage subdomains for the account: list, create (with DNS and websales config), and delete.
  * @param {Object} deps
  * @param {import("axios").AxiosInstance} deps.client
  * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
@@ -17,12 +18,12 @@ function domainsFactory(_ref) {
       internalAuthTokenProvider = _ref.internalAuthTokenProvider;
 
   /**
-   * GET /domains - list domains.
+   * GET /domains – List all domain names for the current account.
+   * Response body is an array of strings (primary domain first, then secondary domains). No query parameters.
    * @param {Object} opts
-   * @param {string} [opts.token] - API key
-   * @param {Object} [opts.query] - Query params
+   * @param {string} [opts.token] - API key (X-API-KEY)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<string[]>>} response.data is string[]
    */
   function all(_ref2) {
     var token = _ref2.token,
@@ -38,13 +39,14 @@ function domainsFactory(_ref) {
   }
 
   /**
-   * POST /domains - create a domain.
+   * POST /domains – Create a new subdomain for the account.
+   * Adds DNS CNAME and default websales config. Requires BETTEREZ_APP JWT. Emits domains.created (and websalesConfig.created) webhooks.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
-   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {Object} opts.data - Domain payload
+   * @param {string} [opts.jwtToken] - JWT (required for BETTEREZ_APP audience)
+   * @param {Object} opts.data - Body: { domain } or { domainInfo: { domain } }. domain must match pattern (no dots, no underscores).
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ domain: string }>>} response.data is AddedDomainResponse
    */
   function create(_ref3) {
     var data = _ref3.data,
@@ -61,13 +63,15 @@ function domainsFactory(_ref) {
   }
 
   /**
-   * DELETE /domains/:domain - remove a domain.
+   * DELETE /domains/:domain – Remove a subdomain from the account.
+   * Removes DNS entry, websales config, and domain from payment methods and inventory products.
+   * Primary domain cannot be deleted. Emits domains.deleted and websalesConfig.deleted.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
-   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.domain - Domain name
+   * @param {string} [opts.jwtToken] - JWT (required for BETTEREZ_APP audience)
+   * @param {string} opts.domain - Domain name (path parameter)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ domain: string }>>} response.data is DeletedDomainResponse
    */
   function remove(_ref4) {
     var domain = _ref4.domain,

package/lib/endpoints/accounts/dynamic-forms.js

@@ -6,6 +6,20 @@ var _extends = Object.assign || function (target) { for (var i = 1; i < argument
 var _require = require("../endpoints_helpers.js"),
     authorizationHeaders = _require.authorizationHeaders;
 
+/**
+ * Query params for GET /dynamic-forms (btrz-api-accounts). See get-handler getSpec().
+ * @typedef {Object} DynamicFormsQuery
+ * @property {string} [dynamicFormFieldId] - Get all dynamic forms for the given field id (ObjectId)
+ * @property {string} [providerId] - Get all dynamic forms for the given provider id (ObjectId)
+ * @property {string} [type] - Filter by type: "reservation" | "parcel" | "checkin" | "paid_in" | "pay_on_account"
+ */
+
+/**
+ * Query params for GET /dynamic-forms/:dynamicFormId (btrz-api-accounts). See get-by-id-handler getSpec().
+ * @typedef {Object} DynamicFormByIdQuery
+ * @property {string} [providerId] - Fetch the dynamic form for the given providerId (ObjectId)
+ */
+
 /**
  * Factory for dynamic-forms API (btrz-api-accounts).
  * @param {Object} deps
@@ -25,8 +39,8 @@ function dynamicFormsFactory(_ref) {
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.dynamicFormId - Dynamic form id (ObjectId)
-   * @param {Object} [opts.query] - Query params
-   * @param {string} [opts.providerId] - Provider id (ObjectId)
+   * @param {DynamicFormByIdQuery} [opts.query] - Query params (providerId)
+   * @param {string} [opts.providerId] - Provider id; if set, added to query (convenience)
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -52,7 +66,7 @@ function dynamicFormsFactory(_ref) {
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {Object} [opts.query] - Query params
+   * @param {DynamicFormsQuery} [opts.query] - Query params (dynamicFormFieldId, providerId, type)
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -75,7 +89,6 @@ function dynamicFormsFactory(_ref) {
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {Object} [opts.query] - Query params
    * @param {Object} opts.data - Form payload
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
@@ -172,7 +185,6 @@ function dynamicFormsFactory(_ref) {
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-     * @param {Object} [opts.query] - Query params
      * @param {Object} [opts.headers] - Optional headers
      * @returns {Promise<import("axios").AxiosResponse>}
      */

package/lib/endpoints/accounts/email-settings.js

@@ -6,6 +6,7 @@ var _require = require("./../endpoints_helpers.js"),
 
 /**
  * Factory for email-settings API (btrz-api-accounts).
+ * Manage account email settings (identity/verified senders). Path parameter is email address.
  * @param {Object} deps
  * @param {import("axios").AxiosInstance} deps.client
  * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
@@ -18,13 +19,13 @@ function emailSettingsFactory(_ref) {
       internalAuthTokenProvider = _ref.internalAuthTokenProvider;
 
   /**
-   * GET /email-settings - list email settings.
+   * GET /email-settings – List all email settings for the account.
+   * Response may trigger AWS verification and commIdentity updates. 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] - Query params
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ emailSettings: object[] }>>}
    */
   function all(_ref2) {
     var token = _ref2.token,
@@ -40,14 +41,13 @@ function emailSettingsFactory(_ref) {
     });
   }
   /**
-   * GET /email-settings/:email - get email settings by email.
+   * GET /email-settings/:email – Get one email setting by email address (path param).
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.email - Email address
-   * @param {Object} [opts.query] - Query params
+   * @param {string} opts.email - Email address (path parameter; must match email pattern)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<object>>} response.data is EmailSetting
    */
   function getByEmail(_ref3) {
     var token = _ref3.token,
@@ -65,13 +65,14 @@ function emailSettingsFactory(_ref) {
   }
 
   /**
-   * POST /email-settings - create email settings.
+   * POST /email-settings – Create an email setting. Requires BETTEREZ_APP JWT. Emits emailSetting.created.
+   * Body: { emailSetting } or { name, email, active }. Email and domain are verified in AWS.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
-   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {Object} opts.data - Email settings payload
+   * @param {string} [opts.jwtToken] - JWT (required for BETTEREZ_APP audience)
+   * @param {Object} opts.data - Body: { name, email, active? } or { emailSetting: { name, email, active? } }
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ emailSetting: object }>>}
    */
   function create(_ref4) {
     var data = _ref4.data,
@@ -88,14 +89,14 @@ function emailSettingsFactory(_ref) {
   }
 
   /**
-   * PUT /email-settings/:email - update email settings.
+   * PUT /email-settings/:email – Update an email setting. Requires BETTEREZ_APP JWT. Emits emailSetting.updated.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
-   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.email - Email address
-   * @param {Object} opts.data - Email settings payload
+   * @param {string} [opts.jwtToken] - JWT (required for BETTEREZ_APP audience)
+   * @param {string} opts.email - Email address (path parameter)
+   * @param {Object} opts.data - Body: { name, email, active?, ... } or { emailSetting: { ... } }
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ emailSetting: object }>>}
    */
   function update(_ref5) {
     var token = _ref5.token,
@@ -113,13 +114,14 @@ function emailSettingsFactory(_ref) {
   }
 
   /**
-   * DELETE /email-settings/:email - remove email settings.
+   * DELETE /email-settings/:email – Remove an email setting. Requires BETTEREZ_APP JWT. Emits emailSetting.deleted.
+   * Fails with 400 if the email is currently active.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
-   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.email - Email address
+   * @param {string} [opts.jwtToken] - JWT (required for BETTEREZ_APP audience)
+   * @param {string} opts.email - Email address (path parameter)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ emailSetting: object }>>}
    */
   function remove(_ref6) {
     var email = _ref6.email,