@dereekb/zoho 13.4.0 → 13.4.1

package/index.cjs.js

@@ -88,13 +88,15 @@ function _object_spread_props$c(target, source) {
  *   const secondPage = await firstPage.fetchNext();
  * }
  * ```
- */ function zohoFetchPageFactory(fetch$1, defaults) {
+ */ // eslint-disable-next-line @typescript-eslint/no-explicit-any -- generic constraint requires any
+function zohoFetchPageFactory(fetch$1, defaults) {
     return fetch.fetchPageFactory(_object_spread_props$c(_object_spread$d({}, defaults), {
         fetch: fetch$1,
         readFetchPageResultInfo: function readFetchPageResultInfo(result) {
             var _ref;
             var _result_info;
             return {
+                // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- info may be missing in malformed responses
                 hasNext: (_ref = (_result_info = result.info) === null || _result_info === void 0 ? void 0 : _result_info.more_records) !== null && _ref !== void 0 ? _ref : false // if no info is returned, assume something wrong and there are no more records
             };
         },
@@ -113,6 +115,9 @@ function _object_spread_props$c(target, source) {
  */ var ZOHO_RECRUIT_SERVICE_NAME = 'recruit';
 /**
  * Resolves an environment key or passthrough URL to the full Zoho Recruit API URL.
+ *
+ * @param input - An environment key ('sandbox' or 'production') or a full API URL
+ * @returns The resolved Zoho Recruit API URL
  */ function zohoRecruitConfigApiUrl(input) {
     switch(input){
         case 'sandbox':
@@ -187,23 +192,26 @@ function _type_of$6(obj) {
  */ function zohoSearchRecordsCriteriaString(input) {
     var result;
     if (input != null) {
+        // eslint-disable-next-line @typescript-eslint/switch-exhaustiveness-check -- only string and object are valid for criteria input
         switch(typeof input === "undefined" ? "undefined" : _type_of$6(input)){
             case 'string':
                 result = input;
                 break;
             case 'object':
-                var tree;
-                if (Array.isArray(input)) {
-                    tree = {
-                        and: [
-                            input
-                        ]
-                    };
-                } else {
-                    tree = input;
+                {
+                    var tree;
+                    if (Array.isArray(input)) {
+                        tree = {
+                            and: [
+                                input
+                            ]
+                        };
+                    } else {
+                        tree = input;
+                    }
+                    result = zohoSearchRecordsCriteriaStringForTree(tree);
+                    break;
                 }
-                result = zohoSearchRecordsCriteriaStringForTree(tree);
-                break;
         }
     }
     return result;
@@ -543,6 +551,7 @@ function _ts_generator$9(thisArg, body) {
  * @param value
  * @returns
  */ function isZohoServerErrorResponseDataArrayRef(value) {
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- value is unknown at runtime, optional chain needed for safety
     return Array.isArray(value === null || value === void 0 ? void 0 : value.data);
 }
 /**
@@ -554,7 +563,12 @@ function _ts_generator$9(thisArg, body) {
 /**
  * Set in the status field
  */ var ZOHO_ERROR_STATUS = 'error';
-function zohoServerErrorData(error) {
+/**
+ * Normalizes a Zoho error response entry into a consistent {@link ZohoServerErrorData} shape, handling both object and string error formats.
+ *
+ * @param error - The raw error entry, either a structured object or a plain error code string
+ * @returns Normalized error data with code and message fields
+ */ function zohoServerErrorData(error) {
     var errorType = typeof error === "undefined" ? "undefined" : _type_of$5(error);
     var errorData;
     if (errorType === 'object') {
@@ -638,8 +652,9 @@ function zohoServerErrorData(error) {
 /**
  * Creates a logZohoServerErrorFunction that logs the error to console.
  *
- * @param zohoApiNamePrefix Prefix to use when logging. I.E. ZohoRecruitError, etc.
- * @returns
+ * @param zohoApiNamePrefix - Prefix to use when logging (e.g. 'ZohoRecruit', 'ZohoSign')
+ * @param options - Optional configuration for controlling which error types are logged
+ * @returns A function that logs Zoho server errors to the console
  */ function logZohoServerErrorFunction(zohoApiNamePrefix, options) {
     var _ref = options !== null && options !== void 0 ? options : {}, _ref_logDataArrayErrors = _ref.logDataArrayErrors, logDataArrayErrors = _ref_logDataArrayErrors === void 0 ? false : _ref_logDataArrayErrors;
     return function(error) {
@@ -662,8 +677,9 @@ function zohoServerErrorData(error) {
 /**
  * Wraps a ConfiguredFetch to support handling errors returned by fetch.
  *
- * @param fetch
- * @returns
+ * @param parseZohoError - Function that parses a fetch response error into a Zoho-specific error
+ * @param defaultLogError - Default error logging function used when no custom logger is provided
+ * @returns Factory that wraps a ConfiguredFetch with Zoho error handling
  */ function handleZohoErrorFetchFactory(parseZohoError, defaultLogError) {
     return function(fetch$1) {
         var logError = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : defaultLogError, onError = arguments.length > 2 ? arguments[2] : void 0;
@@ -720,16 +736,19 @@ function zohoServerErrorData(error) {
 }
 /**
  * FetchJsonInterceptJsonResponseFunction that intercepts a 200 response that actually contains a ZohoServerError and throws a ZohoServerError for the error handling to catch.
+ *
+ * @param parseZohoServerErrorResponseData - Function that parses raw error response data into a structured error
+ * @returns Interceptor function that detects and throws hidden errors in 200 responses
  */ function interceptZohoErrorResponseFactory(parseZohoServerErrorResponseData) {
     return function(json, response) {
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- json is typed as unknown union, optional chain needed for runtime safety
         var error = json === null || json === void 0 ? void 0 : json.error;
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- error may be undefined at runtime despite cast
         if (error != null) {
             var responseError = new fetch.FetchResponseError(response);
-            if (responseError) {
-                var parsedError = parseZohoServerErrorResponseData(json, responseError);
-                if (parsedError) {
-                    throw parsedError;
-                }
+            var parsedError = parseZohoServerErrorResponseData(json, responseError);
+            if (parsedError) {
+                throw parsedError;
             }
         }
         return json;
@@ -819,7 +838,12 @@ var ZOHO_RATE_LIMIT_REMAINING_HEADER = 'X-RATELIMIT-REMAINING';
 var ZOHO_RATE_LIMIT_RESET_HEADER = 'X-RATELIMIT-RESET';
 var DEFAULT_ZOHO_API_RATE_LIMIT = 100;
 var DEFAULT_ZOHO_API_RATE_LIMIT_RESET_PERIOD = util.MS_IN_MINUTE;
-function zohoRateLimitHeaderDetails(headers) {
+/**
+ * Extracts rate limit details from Zoho API response headers, returning null if the headers are absent.
+ *
+ * @param headers - HTTP response headers from a Zoho API call
+ * @returns Parsed rate limit details, or null if rate limit headers are missing
+ */ function zohoRateLimitHeaderDetails(headers) {
     var limitHeader = headers.get(ZOHO_RATE_LIMIT_LIMIT_HEADER);
     var remainingHeader = headers.get(ZOHO_RATE_LIMIT_REMAINING_HEADER);
     var resetHeader = headers.get(ZOHO_RATE_LIMIT_RESET_HEADER);
@@ -857,9 +881,9 @@ var ZohoTooManyRequestsError = /*#__PURE__*/ function(ZohoServerFetchResponseErr
 /**
  * Function that parses/transforms a ZohoServerErrorResponseData into a general ZohoServerError or other known error type.
  *
- * @param errorResponseData
- * @param responseError
- * @returns
+ * @param errorResponseData - Raw error response data from the Zoho API
+ * @param responseError - The underlying fetch response error
+ * @returns A typed Zoho server error, or undefined if no error is found
  */ function parseZohoServerErrorResponseData(errorResponseData, responseError) {
     var result;
     if (isZohoServerErrorResponseDataArrayRef(errorResponseData)) {
@@ -904,8 +928,8 @@ var ZohoTooManyRequestsError = /*#__PURE__*/ function(ZohoServerFetchResponseErr
  */ function tryFindZohoServerErrorData(errorResponseData, responseError) {
     var _ref, _errorResponseData_error;
     var _errorResponseData_data;
-    var error = (_ref = (_errorResponseData_error = errorResponseData.error) !== null && _errorResponseData_error !== void 0 ? _errorResponseData_error : (_errorResponseData_data = errorResponseData.data) === null || _errorResponseData_data === void 0 ? void 0 : _errorResponseData_data[0]) !== null && _ref !== void 0 ? _ref : !responseError.response.ok ? errorResponseData : undefined;
-    return error;
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- errorResponseData shape is unknown at runtime, fallthrough chain needed
+    return (_ref = (_errorResponseData_error = errorResponseData.error) !== null && _errorResponseData_error !== void 0 ? _errorResponseData_error : (_errorResponseData_data = errorResponseData.data) === null || _errorResponseData_data === void 0 ? void 0 : _errorResponseData_data[0]) !== null && _ref !== void 0 ? _ref : !responseError.response.ok ? errorResponseData : undefined;
 }
 
 function _assert_this_initialized$4(self) {
@@ -1202,17 +1226,22 @@ function _ts_generator$8(thisArg, body) {
 }(ZohoRecruitRecordCrudInvalidDataError);
 /**
  * Creates a typed CRUD error subclass based on the error code returned by the Zoho Recruit API, enabling callers to catch specific failure modes.
+ *
+ * @param error - Structured error data from the Zoho Recruit API response
+ * @returns A specific CRUD error subclass matching the error code
  */ function zohoRecruitRecordCrudError(error) {
     var result;
     switch(error.code){
         case ZOHO_INVALID_DATA_ERROR_CODE:
-            var invalidDataError = new ZohoRecruitRecordCrudInvalidDataError(error);
-            if (invalidDataError.invalidFieldDetails['id']) {
-                result = new ZohoRecruitRecordCrudNoMatchingRecordError(error);
-            } else {
-                result = invalidDataError;
+            {
+                var invalidDataError = new ZohoRecruitRecordCrudInvalidDataError(error);
+                if (invalidDataError.invalidFieldDetails['id']) {
+                    result = new ZohoRecruitRecordCrudNoMatchingRecordError(error);
+                } else {
+                    result = invalidDataError;
+                }
+                break;
             }
-            break;
         case ZOHO_MANDATORY_NOT_FOUND_ERROR_CODE:
             result = new ZohoRecruitRecordCrudMandatoryFieldNotFoundError(error);
             break;
@@ -1227,9 +1256,14 @@ function _ts_generator$8(thisArg, body) {
 }
 /**
  * Returns an assertion function that throws {@link ZohoRecruitRecordNoContentError} when the data array result is empty or null, indicating the requested record does not exist.
+ *
+ * @param moduleName - Optional module name for the error context
+ * @param recordId - Optional record ID for the error context
+ * @returns Assertion function that validates the data array is non-empty
  */ function assertZohoRecruitRecordDataArrayResultHasContent(moduleName, recordId) {
     return function(x) {
         var _x_data;
+        // eslint-disable-next-line eqeqeq -- fetchJson may return null for empty results despite type
         if (x == null || !((_x_data = x.data) === null || _x_data === void 0 ? void 0 : _x_data.length)) {
             throw new ZohoRecruitRecordNoContentError(moduleName, recordId);
         } else {
@@ -1242,6 +1276,9 @@ function _ts_generator$8(thisArg, body) {
  */ var logZohoRecruitErrorToConsole = logZohoServerErrorFunction('ZohoRecruit');
 /**
  * Parses the JSON body of a failed Zoho Recruit fetch response into a structured error, returning undefined if the body cannot be parsed.
+ *
+ * @param responseError - The fetch response error to parse
+ * @returns Parsed Zoho server error, or undefined if parsing fails
  */ function parseZohoRecruitError(responseError) {
     return _async_to_generator$8(function() {
         var data, result;
@@ -1250,7 +1287,7 @@ function _ts_generator$8(thisArg, body) {
                 case 0:
                     return [
                         4,
-                        responseError.response.json().catch(function(x) {
+                        responseError.response.json().catch(function() {
                             return undefined;
                         })
                     ];
@@ -1269,6 +1306,10 @@ function _ts_generator$8(thisArg, body) {
 }
 /**
  * Converts raw Zoho Recruit error response data into a parsed error, delegating to Recruit-specific handlers for known error codes and falling back to the shared Zoho parser.
+ *
+ * @param errorResponseData - Raw error response data from the Zoho Recruit API
+ * @param responseError - The underlying fetch response error
+ * @returns Parsed Zoho server error, or undefined if the data contains no recognizable error
  */ function parseZohoRecruitServerErrorResponseData(errorResponseData, responseError) {
     var result;
     var error = tryFindZohoServerErrorData(errorResponseData, responseError);
@@ -1411,6 +1452,11 @@ function _is_native_reflect_construct$3() {
  *
  * When a single record is provided, the function returns the change details directly or throws on error.
  * When multiple records are provided, it returns a paired success/error result.
+ *
+ * @param context - Zoho Recruit API context providing fetch and authentication
+ * @param fetchUrlPrefix - URL path suffix for the endpoint (empty for insert/update, '/upsert' for upsert)
+ * @param fetchMethod - HTTP method to use for the request
+ * @returns Factory function that inserts, updates, or upserts records
  */ function updateRecordLikeFunction$1(context, fetchUrlPrefix, fetchMethod) {
     return function(param) {
         var data = param.data, module = param.module;
@@ -1423,6 +1469,7 @@ function _is_native_reflect_construct$3() {
                 return result;
             } else {
                 var successItems = result.successItems, errorItems = result.errorItems;
+                // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- array may be empty at runtime
                 if (errorItems[0] != null) {
                     throw zohoRecruitRecordCrudError(errorItems[0].result);
                 } else {
@@ -1671,12 +1718,13 @@ function _is_native_reflect_construct$3() {
             var criteriaString = zohoRecruitSearchRecordsCriteriaString(input.criteria);
             baseInput.criteria = criteriaString;
         }
+        // eslint-disable-next-line @typescript-eslint/no-deprecated -- Zoho API migration pending
         if (!baseInput.word && !input.criteria && !input.email && !input.phone) {
             throw new Error('At least one of word, criteria, email, or phone must be provided');
         }
-        var urlParams = zohoRecruitUrlSearchParamsMinusModule(baseInput);
-        return urlParams;
+        return zohoRecruitUrlSearchParamsMinusModule(baseInput);
     }
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- fetchJson may return null for empty results
     return function(input) {
         return context.fetchJson("/v2/".concat(input.module, "/search?").concat(searchRecordsUrlSearchParams(input).toString()), zohoRecruitApiFetchJsonInput('GET')).then(function(x) {
             return x !== null && x !== void 0 ? x : {
@@ -1744,11 +1792,12 @@ function _is_native_reflect_construct$3() {
  */ function zohoRecruitGetRelatedRecordsFunctionFactory(context) {
     return function(config) {
         var targetModule = config.targetModule, _config_returnEmptyRecordsInsteadOfNull = config.returnEmptyRecordsInsteadOfNull, returnEmptyRecordsInsteadOfNull = _config_returnEmptyRecordsInsteadOfNull === void 0 ? true : _config_returnEmptyRecordsInsteadOfNull;
+        // eslint-disable-next-line @typescript-eslint/no-deprecated -- Zoho API migration pending
         return function(input) {
             return context.fetchJson("/v2/".concat(input.module, "/").concat(input.id, "/").concat(targetModule, "?").concat(zohoRecruitUrlSearchParamsMinusIdAndModule(input, input.filter).toString()), zohoRecruitApiFetchJsonInput('GET')).then(function(x) {
                 return x !== null && x !== void 0 ? x : returnEmptyRecordsInsteadOfNull !== false ? emptyZohoPageResult() : x;
             });
-        };
+        }; // eslint-disable-line @typescript-eslint/no-unnecessary-condition -- fetchJson may return null for empty results
     };
 }
 /**
@@ -2076,6 +2125,9 @@ function _is_native_reflect_construct$3() {
 // MARK: Util
 /**
  * Builds URL search params from input objects, omitting the `module` key since it is used in the URL path rather than query string.
+ *
+ * @param input - One or more objects whose key-value pairs become query parameters
+ * @returns URLSearchParams with the `module` key excluded
  */ function zohoRecruitUrlSearchParamsMinusModule() {
     for(var _len = arguments.length, input = new Array(_len), _key = 0; _key < _len; _key++){
         input[_key] = arguments[_key];
@@ -2086,6 +2138,9 @@ function _is_native_reflect_construct$3() {
 }
 /**
  * Builds URL search params from input objects, omitting both `id` and `module` keys since they are used in the URL path.
+ *
+ * @param input - One or more objects whose key-value pairs become query parameters
+ * @returns URLSearchParams with `id` and `module` keys excluded
  */ function zohoRecruitUrlSearchParamsMinusIdAndModule() {
     for(var _len = arguments.length, input = new Array(_len), _key = 0; _key < _len; _key++){
         input[_key] = arguments[_key];
@@ -2102,12 +2157,15 @@ function _is_native_reflect_construct$3() {
  */ var zohoRecruitUrlSearchParams = fetch.makeUrlSearchParams;
 /**
  * Constructs a standard {@link FetchJsonInput} for Zoho Recruit API calls with the given HTTP method and optional body.
+ *
+ * @param method - HTTP method for the request
+ * @param body - Optional JSON body to include in the request
+ * @returns Configured fetch JSON input
  */ function zohoRecruitApiFetchJsonInput(method, body) {
-    var result = {
+    return {
         method: method,
         body: body !== null && body !== void 0 ? body : undefined
     };
-    return result;
 }
 /**
  * Separates a change response's entries into success and error arrays based on their status.
@@ -2287,6 +2345,9 @@ function _object_spread_props$a(target, source) {
  *
  * The result separates "already associated" errors from other errors, allowing callers to treat duplicate associations as non-fatal.
  *
+ * @param context - Zoho Recruit API context providing fetch and authentication
+ * @returns Factory function that associates candidates with job openings
+ *
  * https://www.zoho.com/recruit/developer-guide/apiv2/associate-candidate.html
  */ function zohoRecruitAssociateCandidateRecordsWithJobOpenings(context) {
     return function(input) {
@@ -2310,6 +2371,9 @@ function _object_spread_props$a(target, source) {
 }
 /**
  * Searches for records associated with a given candidate or job opening. Returns an empty page result when no records are found.
+ *
+ * @param context - Zoho Recruit API context providing fetch and authentication
+ * @returns Factory function that searches for associated records
  */ function zohoRecruitSearchAssociatedRecords(context) {
     return function(input) {
         return context.fetchJson("/v2/".concat(input.module, "/").concat(input.id, "/associate?").concat(zohoRecruitUrlSearchParamsMinusIdAndModule(input).toString()), zohoRecruitApiFetchJsonInput('GET')).then(function(x) {
@@ -2320,6 +2384,9 @@ function _object_spread_props$a(target, source) {
 }
 /**
  * Searches for job openings associated with a specific candidate.
+ *
+ * @param context - Zoho Recruit API context providing fetch and authentication
+ * @returns Factory function that searches for job openings associated with a candidate
  */ function zohoRecruitSearchCandidateAssociatedJobOpeningRecords(context) {
     var searchAssociatedRecordsFactory = zohoRecruitSearchAssociatedRecords(context);
     return function(input) {
@@ -2330,11 +2397,18 @@ function _object_spread_props$a(target, source) {
 }
 /**
  * Creates a page factory for paginating over job openings associated with a candidate.
+ *
+ * @param context - Zoho Recruit API context providing fetch and authentication
+ * @returns Page factory for iterating through associated job openings
  */ function zohoRecruitSearchCandidateAssociatedJobOpeningRecordsPageFactory(context) {
     return zohoFetchPageFactory(zohoRecruitSearchCandidateAssociatedJobOpeningRecords(context));
 }
 /**
  * Searches for candidates associated with a specific job opening.
+ *
+ * @param context - Zoho Recruit API context providing fetch and authentication
+ * @param jobOpeningModuleName - Module name for job openings, defaults to the standard module
+ * @returns Factory function that searches for candidates associated with a job opening
  */ function zohoRecruitSearchJobOpeningAssociatedCandidateRecords(context) {
     var jobOpeningModuleName = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : ZOHO_RECRUIT_JOB_OPENINGS_MODULE;
     var searchAssociatedRecordsFactory = zohoRecruitSearchAssociatedRecords(context);
@@ -2346,6 +2420,9 @@ function _object_spread_props$a(target, source) {
 }
 /**
  * Creates a page factory for paginating over candidates associated with a job opening.
+ *
+ * @param context - Zoho Recruit API context providing fetch and authentication
+ * @returns Page factory for iterating through associated candidates
  */ function zohoRecruitSearchJobOpeningAssociatedCandidateRecordsPageFactory(context) {
     return zohoFetchPageFactory(zohoRecruitSearchJobOpeningAssociatedCandidateRecords(context));
 }
@@ -3014,7 +3091,12 @@ var ZOHO_ACCOUNTS_INVALID_CLIENT_ERROR_CODE = 'invalid_client';
     return ZohoAccountsAuthFailureError;
 }(fetch.FetchRequestFactoryError);
 var logZohoAccountsErrorToConsole = logZohoServerErrorFunction('ZohoAccounts');
-function parseZohoAccountsError(responseError) {
+/**
+ * Parses a fetch response error into a typed Zoho Accounts server error by extracting and interpreting the JSON error body.
+ *
+ * @param responseError - The fetch response error to parse
+ * @returns The parsed Zoho server error, or undefined if the response could not be parsed
+ */ function parseZohoAccountsError(responseError) {
     return _async_to_generator$7(function() {
         var data, result;
         return _ts_generator$7(this, function(_state) {
@@ -3022,7 +3104,7 @@ function parseZohoAccountsError(responseError) {
                 case 0:
                     return [
                         4,
-                        responseError.response.json().catch(function(x) {
+                        responseError.response.json().catch(function() {
                             return undefined;
                         })
                     ];
@@ -3039,7 +3121,13 @@ function parseZohoAccountsError(responseError) {
         });
     })();
 }
-function parseZohoAccountsServerErrorResponseData(errorResponseData, responseError) {
+/**
+ * Parses a Zoho Accounts error response body into a typed error. Handles account-specific error codes before falling back to the generic Zoho error parser.
+ *
+ * @param errorResponseData - The raw error response data from the Zoho Accounts API
+ * @param responseError - The original fetch response error for context
+ * @returns The parsed Zoho server error, or undefined if the error could not be classified
+ */ function parseZohoAccountsServerErrorResponseData(errorResponseData, responseError) {
     var result;
     var error = errorResponseData.error;
     if (error) {
@@ -3189,6 +3277,9 @@ function _ts_generator$6(thisArg, body) {
 }
 /**
  * Generates a new ZohoAccessTokenStringFactory.
+ *
+ * @param zohoAccessTokenFactory - Factory that produces ZohoAccessToken instances
+ * @returns A factory function that resolves to the access token string
  */ function zohoAccessTokenStringFactory(zohoAccessTokenFactory) {
     return function() {
         return _async_to_generator$6(function() {
@@ -3202,7 +3293,7 @@ function _ts_generator$6(thisArg, body) {
                         ];
                     case 1:
                         token = _state.sent();
-                        if (!(token === null || token === void 0 ? void 0 : token.accessToken)) {
+                        if (!token.accessToken) {
                             throw new ZohoAccountsAuthFailureError();
                         }
                         return [
@@ -3217,7 +3308,9 @@ function _ts_generator$6(thisArg, body) {
 
 /**
  * Default handler that logs a warning to the console when the Zoho API rate limit is exceeded.
- */ var DEFAULT_ZOHO_RATE_LIMITED_TOO_MANY_REQUETS_LOG_FUNCTION = function DEFAULT_ZOHO_RATE_LIMITED_TOO_MANY_REQUETS_LOG_FUNCTION(headers) {
+ *
+ * @param headers - Rate limit details extracted from the Zoho API response headers
+ */ var DEFAULT_ZOHO_RATE_LIMITED_TOO_MANY_REQUESTS_LOG_FUNCTION = function DEFAULT_ZOHO_RATE_LIMITED_TOO_MANY_REQUESTS_LOG_FUNCTION(headers) {
     console.warn("zohoRateLimitedFetchHandler(): Too many requests made. The limit is ".concat(headers.limit, " requests per reset period. Will be reset at ").concat(headers.resetAt, "."));
 };
 /**
@@ -3236,13 +3329,17 @@ function _ts_generator$6(thisArg, body) {
  * @returns A rate-limited fetch handler with the underlying rate limiter accessible via `_rateLimiter`
  */ function zohoRateLimitedFetchHandler(config) {
     var _ref, _ref1, _ref2;
-    var onTooManyRequests = (config === null || config === void 0 ? void 0 : config.onTooManyRequests) !== false ? (_ref = config === null || config === void 0 ? void 0 : config.onTooManyRequests) !== null && _ref !== void 0 ? _ref : DEFAULT_ZOHO_RATE_LIMITED_TOO_MANY_REQUETS_LOG_FUNCTION : undefined;
+    var onTooManyRequests = (config === null || config === void 0 ? void 0 : config.onTooManyRequests) !== false ? (_ref = config === null || config === void 0 ? void 0 : config.onTooManyRequests) !== null && _ref !== void 0 ? _ref : DEFAULT_ZOHO_RATE_LIMITED_TOO_MANY_REQUESTS_LOG_FUNCTION : undefined;
     var defaultLimit = (_ref1 = config === null || config === void 0 ? void 0 : config.maxRateLimit) !== null && _ref1 !== void 0 ? _ref1 : DEFAULT_ZOHO_API_RATE_LIMIT;
     var defaultResetPeriod = (_ref2 = config === null || config === void 0 ? void 0 : config.resetPeriod) !== null && _ref2 !== void 0 ? _ref2 : DEFAULT_ZOHO_API_RATE_LIMIT_RESET_PERIOD;
     /**
      * Builds a rate limiter config derived from the given limit.
      * Called once at initialization with `defaultLimit`, and again dynamically
      * when the API's `X-RATELIMIT-LIMIT` header reports a different value.
+     *
+     * @param limit - Maximum number of requests allowed per reset period
+     * @param resetAt - Optional date when the rate limit window resets
+     * @returns Rate limiter configuration scaled to the given limit
      */ function configForLimit(limit, resetAt) {
         return {
             limit: limit,
@@ -3261,6 +3358,10 @@ function _ts_generator$6(thisArg, body) {
         /**
          * Inspects each response for Zoho rate limit headers and updates the limiter accordingly.
          * Returns `true` to signal a retry when a 429 status is received.
+         *
+         * @param response - The HTTP response to inspect for rate limit headers
+         * @param fetchResponseError - Optional fetch error if the response was an error
+         * @returns Whether the request should be retried
          */ updateWithResponse: function updateWithResponse(response, fetchResponseError) {
             var hasLimitHeader = response.headers.has(ZOHO_RATE_LIMIT_REMAINING_HEADER);
             var shouldRetry = false;
@@ -3280,8 +3381,9 @@ function _ts_generator$6(thisArg, body) {
                     if (response.status === ZOHO_TOO_MANY_REQUESTS_HTTP_STATUS_CODE) {
                         shouldRetry = true;
                         try {
-                            onTooManyRequests === null || onTooManyRequests === void 0 ? void 0 : onTooManyRequests(headerDetails, response, fetchResponseError);
-                        } catch (e) {}
+                            void (onTooManyRequests === null || onTooManyRequests === void 0 ? void 0 : onTooManyRequests(headerDetails, response, fetchResponseError));
+                        } catch (unused) {
+                        /* ignored */ }
                     }
                 }
             }
@@ -3290,6 +3392,10 @@ function _ts_generator$6(thisArg, body) {
         }
     });
 }
+// MARK: Compat
+/**
+ * @deprecated use DEFAULT_ZOHO_RATE_LIMITED_TOO_MANY_REQUESTS_LOG_FUNCTION instead.
+ */ var DEFAULT_ZOHO_RATE_LIMITED_TOO_MANY_REQUETS_LOG_FUNCTION = DEFAULT_ZOHO_RATE_LIMITED_TOO_MANY_REQUESTS_LOG_FUNCTION;
 
 function asyncGeneratorStep$5(gen, resolve, reject, _next, _throw, key, arg) {
     try {
@@ -3546,7 +3652,7 @@ function _ts_generator$5(thisArg, body) {
         });
         var fetch$1 = handleZohoRecruitErrorFetch(baseFetch, logZohoServerErrorFunction, function(x) {
             if (_instanceof$4(x, ZohoInvalidTokenError)) {
-                accountsContext.loadAccessToken.resetAccessToken();
+                void accountsContext.loadAccessToken.resetAccessToken();
             }
         });
         var fetchJson = fetch.fetchJsonFunction(fetch$1, {
@@ -3578,6 +3684,9 @@ function _ts_generator$5(thisArg, body) {
  */ var ZOHO_CRM_SERVICE_NAME = 'crm';
 /**
  * Resolves a CRM API URL input to its full base URL. Well-known keys ('sandbox', 'production') map to their respective Zoho CRM endpoints; custom URLs pass through unchanged.
+ *
+ * @param input - A well-known environment key or a custom CRM API URL
+ * @returns The resolved full Zoho CRM API base URL
  */ function zohoCrmConfigApiUrl(input) {
     switch(input){
         case 'sandbox':
@@ -3939,17 +4048,22 @@ function _ts_generator$4(thisArg, body) {
 }(ZohoCrmRecordCrudInvalidDataError);
 /**
  * Maps a Zoho CRM server error to the appropriate typed {@link ZohoCrmRecordCrudError} subclass based on the error code and affected field.
+ *
+ * @param error - The server error data containing the error code and field details
+ * @returns The appropriate typed CRM CRUD error instance
  */ function zohoCrmRecordCrudError(error) {
     var result;
     switch(error.code){
         case ZOHO_INVALID_DATA_ERROR_CODE:
-            var invalidDataError = new ZohoCrmRecordCrudInvalidDataError(error);
-            if (invalidDataError.invalidFieldDetails.api_name === 'id') {
-                result = new ZohoCrmRecordCrudNoMatchingRecordError(error);
-            } else {
-                result = invalidDataError;
+            {
+                var invalidDataError = new ZohoCrmRecordCrudInvalidDataError(error);
+                if (invalidDataError.invalidFieldDetails.api_name === 'id') {
+                    result = new ZohoCrmRecordCrudNoMatchingRecordError(error);
+                } else {
+                    result = invalidDataError;
+                }
+                break;
             }
-            break;
         case ZOHO_MANDATORY_NOT_FOUND_ERROR_CODE:
             result = new ZohoCrmRecordCrudMandatoryFieldNotFoundError(error);
             break;
@@ -3964,9 +4078,14 @@ function _ts_generator$4(thisArg, body) {
 }
 /**
  * Returns an assertion function that throws {@link ZohoCrmRecordNoContentError} when a data array result is empty or null, typically indicating a missing record.
+ *
+ * @param moduleName - Optional CRM module name for the error context
+ * @param recordId - Optional record ID for the error context
+ * @returns Assertion function that throws if the data array is empty
  */ function assertZohoCrmRecordDataArrayResultHasContent(moduleName, recordId) {
     return function(x) {
         var _x_data;
+        // eslint-disable-next-line eqeqeq -- fetchJson may return null for empty results despite type
         if (x == null || !((_x_data = x.data) === null || _x_data === void 0 ? void 0 : _x_data.length)) {
             throw new ZohoCrmRecordNoContentError(moduleName, recordId);
         } else {
@@ -3981,6 +4100,9 @@ function _ts_generator$4(thisArg, body) {
 });
 /**
  * Parses a fetch response error into a typed Zoho CRM server error by extracting and interpreting the JSON error body.
+ *
+ * @param responseError - The fetch response error to parse
+ * @returns The parsed Zoho server error, or undefined if the response could not be parsed
  */ function parseZohoCrmError(responseError) {
     return _async_to_generator$4(function() {
         var data, result;
@@ -3989,7 +4111,7 @@ function _ts_generator$4(thisArg, body) {
                 case 0:
                     return [
                         4,
-                        responseError.response.json().catch(function(x) {
+                        responseError.response.json().catch(function() {
                             return undefined;
                         })
                     ];
@@ -4008,6 +4130,10 @@ function _ts_generator$4(thisArg, body) {
 }
 /**
  * Parses a Zoho CRM error response body into a typed error. Delegates to CRM-specific error code handling before falling back to the generic Zoho error parser.
+ *
+ * @param errorResponseData - The raw error response data from the Zoho CRM API
+ * @param responseError - The original fetch response error for context
+ * @returns The parsed Zoho server error, or undefined if the error could not be classified
  */ function parseZohoCrmServerErrorResponseData(errorResponseData, responseError) {
     var result;
     var error = tryFindZohoServerErrorData(errorResponseData, responseError);
@@ -4153,6 +4279,11 @@ function _is_native_reflect_construct() {
  *
  * When a single record is provided, the function returns the change details directly or throws on error.
  * When multiple records are provided, it returns a paired success/error result.
+ *
+ * @param context - Authenticated Zoho CRM context for making API calls
+ * @param fetchUrlPrefix - URL path segment appended after the module name (empty string for insert/update, '/upsert' for upsert)
+ * @param fetchMethod - HTTP method to use for the request (POST for insert/upsert, PUT for update)
+ * @returns Overloaded function handling both single and multi-record operations
  */ function updateRecordLikeFunction(context, fetchUrlPrefix, fetchMethod) {
     return function(param) {
         var data = param.data, module = param.module;
@@ -4165,6 +4296,7 @@ function _is_native_reflect_construct() {
                 return result;
             } else {
                 var successItems = result.successItems, errorItems = result.errorItems;
+                // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- array may be empty at runtime
                 if (errorItems[0] != null) {
                     throw zohoCrmRecordCrudError(errorItems[0].result);
                 } else {
@@ -4417,9 +4549,9 @@ function _is_native_reflect_construct() {
         if (!baseInput.word && !input.cvid && !input.criteria && !input.email && !input.phone) {
             throw new Error('At least one of word, cvid, criteria, email, or phone must be provided');
         }
-        var urlParams = zohoCrmUrlSearchParamsMinusModule(baseInput);
-        return urlParams;
+        return zohoCrmUrlSearchParamsMinusModule(baseInput);
     }
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- fetchJson may return null for empty results
     return function(input) {
         return context.fetchJson("/v8/".concat(input.module, "/search?").concat(searchRecordsUrlSearchParams(input).toString()), zohoCrmApiFetchJsonInput('GET')).then(function(x) {
             return x !== null && x !== void 0 ? x : {
@@ -4487,11 +4619,12 @@ function _is_native_reflect_construct() {
  */ function zohoCrmGetRelatedRecordsFunctionFactory(context) {
     return function(config) {
         var targetModule = config.targetModule, _config_returnEmptyRecordsInsteadOfNull = config.returnEmptyRecordsInsteadOfNull, returnEmptyRecordsInsteadOfNull = _config_returnEmptyRecordsInsteadOfNull === void 0 ? true : _config_returnEmptyRecordsInsteadOfNull;
+        // eslint-disable-next-line @typescript-eslint/no-deprecated -- Zoho API migration pending
         return function(input) {
             return context.fetchJson("/v8/".concat(input.module, "/").concat(input.id, "/").concat(targetModule, "?").concat(zohoCrmUrlSearchParamsMinusIdAndModule(input, input.filter).toString()), zohoCrmApiFetchJsonInput('GET')).then(function(x) {
                 return x !== null && x !== void 0 ? x : returnEmptyRecordsInsteadOfNull !== false ? emptyZohoPageResult() : x;
             });
-        };
+        }; // eslint-disable-line @typescript-eslint/no-unnecessary-condition -- fetchJson may return null for empty results
     };
 }
 /**
@@ -4523,6 +4656,7 @@ function _is_native_reflect_construct() {
     return function(input) {
         return getEmailsFactory(input).then(function(x) {
             var _x_data;
+            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- Zoho API may return Emails instead of data
             var data = (_x_data = x.data) !== null && _x_data !== void 0 ? _x_data : x.Emails;
             return _object_spread_props$6(_object_spread$7({}, x), {
                 data: data
@@ -4804,6 +4938,9 @@ function _is_native_reflect_construct() {
 // MARK: Util
 /**
  * Builds URL search params from the input objects, omitting the `module` key since it is used in the URL path rather than as a query parameter.
+ *
+ * @param input - One or more objects to convert into URL search parameters
+ * @returns URL search params string with the `module` key excluded
  */ function zohoCrmUrlSearchParamsMinusModule() {
     for(var _len = arguments.length, input = new Array(_len), _key = 0; _key < _len; _key++){
         input[_key] = arguments[_key];
@@ -4814,6 +4951,9 @@ function _is_native_reflect_construct() {
 }
 /**
  * Builds URL search params from the input objects, omitting both `id` and `module` keys since they are used in the URL path.
+ *
+ * @param input - One or more objects to convert into URL search parameters
+ * @returns URL search params string with `id` and `module` keys excluded
  */ function zohoCrmUrlSearchParamsMinusIdAndModule() {
     for(var _len = arguments.length, input = new Array(_len), _key = 0; _key < _len; _key++){
         input[_key] = arguments[_key];
@@ -4830,19 +4970,26 @@ function _is_native_reflect_construct() {
  */ var zohoCrmUrlSearchParams = fetch.makeUrlSearchParams;
 /**
  * Constructs the standard FetchJsonInput used by CRM API calls, pairing the HTTP method with an optional body.
+ *
+ * @param method - HTTP method to use for the request
+ * @param body - Optional request body to include
+ * @returns Configured fetch input for the Zoho CRM API call
  */ function zohoCrmApiFetchJsonInput(method, body) {
-    var result = {
+    return {
         method: method,
         body: body !== null && body !== void 0 ? body : undefined
     };
-    return result;
 }
 // MARK: Results
 /**
  * Catches ZohoServerFetchResponseDataArrayError and returns the error data array as the response data, as each data element will have the error details.
  *
  * Use to catch errors from functions that return ZohoCrmChangeObjectLikeResponse and pass the result to zohoCrmChangeObjectLikeResponseSuccessAndErrorPairs.
- */ function zohoCrmCatchZohoCrmChangeObjectLikeResponseError(e) {
+ *
+ * @param e - The error to catch and potentially convert
+ * @returns The error data array wrapped as a change object response
+ */ // eslint-disable-next-line @typescript-eslint/no-explicit-any -- generic constraint requires any
+function zohoCrmCatchZohoCrmChangeObjectLikeResponseError(e) {
     var result;
     if (_instanceof$3(e, ZohoServerFetchResponseDataArrayError)) {
         result = {
@@ -4979,6 +5126,9 @@ function _object_spread_props$5(target, source) {
  * Creates notes directly in the CRM Notes module. Each note must include the parent record reference and module name.
  *
  * For creating notes associated with a specific record, prefer {@link zohoCrmCreateNotesForRecord} which handles parent binding automatically.
+ *
+ * @param context - Authenticated Zoho CRM context for making API calls
+ * @returns Function that creates notes in the CRM Notes module
  */ function zohoCrmCreateNotes(context) {
     return function(input) {
         return context.fetchJson("/v2/".concat(ZOHO_CRM_NOTES_MODULE), zohoCrmApiFetchJsonInput('POST', {
@@ -4990,6 +5140,9 @@ function _object_spread_props$5(target, source) {
 }
 /**
  * Deletes one or more notes from the CRM Notes module by their IDs.
+ *
+ * @param context - Authenticated Zoho CRM context for making API calls
+ * @returns Function that deletes notes by their IDs
  */ function zohoCrmDeleteNotes(context) {
     return function(input) {
         return context.fetchJson("/v2/".concat(ZOHO_CRM_NOTES_MODULE, "?").concat(fetch.makeUrlSearchParams({
@@ -5001,6 +5154,9 @@ function _object_spread_props$5(target, source) {
 }
 /**
  * Retrieves paginated notes associated with a specific CRM record using the related records API.
+ *
+ * @param context - Authenticated Zoho CRM context for making API calls
+ * @returns Function that retrieves notes for a specific record
  */ function zohoCrmGetNotesForRecord(context) {
     return zohoCrmGetRelatedRecordsFunctionFactory(context)({
         targetModule: ZOHO_CRM_NOTES_MODULE
@@ -5008,6 +5164,9 @@ function _object_spread_props$5(target, source) {
 }
 /**
  * Creates a page factory for iterating through all notes for a record across multiple pages.
+ *
+ * @param context - Authenticated Zoho CRM context for making API calls
+ * @returns Page factory for paginating through notes for a record
  */ function zohoCrmGetNotesForRecordPageFactory(context) {
     return zohoFetchPageFactory(zohoCrmGetNotesForRecord(context));
 }
@@ -5015,6 +5174,9 @@ function _object_spread_props$5(target, source) {
  * Creates notes for a specific record, automatically binding the parent module and record ID to each note entry.
  *
  * https://www.zoho.com/crm/developer/docs/api/v8/create-notes.html
+ *
+ * @param context - Authenticated Zoho CRM context for making API calls
+ * @returns Function that creates notes bound to a specific record
  */ function zohoCrmCreateNotesForRecord(context) {
     var createNotesInstance = zohoCrmCreateNotes(context);
     return function(input) {
@@ -5112,6 +5274,9 @@ function _unsupported_iterable_to_array(o, minLen) {
 }
 /**
  * Creates one or more tags for a CRM module. Duplicate tag errors are separated from other errors in the result to simplify idempotent workflows.
+ *
+ * @param context - Authenticated Zoho CRM context for making API calls
+ * @returns Function that creates tags for a module
  */ function zohoCrmCreateTagsForModule(context) {
     return function(input) {
         return context.fetchJson("/v8/settings/tags?".concat(fetch.makeUrlSearchParams({
@@ -5153,8 +5318,8 @@ function _unsupported_iterable_to_array(o, minLen) {
  *
  * https://www.zoho.com/crm/developer/docs/api/v8/delete-tag.html
  *
- * @param context
- * @returns
+ * @param context - Authenticated Zoho CRM context for making API calls
+ * @returns Function that deletes a tag by ID
  */ function zohoCrmDeleteTag(context) {
     return function(input) {
         return context.fetchJson("/v8/settings/tags/".concat(input.id), zohoCrmApiFetchJsonInput('DELETE')).then(function(x) {
@@ -5167,8 +5332,8 @@ function _unsupported_iterable_to_array(o, minLen) {
  *
  * https://www.zoho.com/crm/developer-guide/apiv2/get-tag-list.html
  *
- * @param context
- * @returns
+ * @param context - Authenticated Zoho CRM context for making API calls
+ * @returns Function that retrieves tags for a module
  */ function zohoCrmGetTagsForModule(context) {
     return function(input) {
         return context.fetchJson("/v8/settings/tags?".concat(fetch.makeUrlSearchParams({
@@ -5184,6 +5349,9 @@ function _unsupported_iterable_to_array(o, minLen) {
 }
 /**
  * Creates a page factory for iterating through all tags in a module across multiple pages.
+ *
+ * @param context - Authenticated Zoho CRM context for making API calls
+ * @returns Page factory for paginating through tags in a module
  */ function zohoCrmGetTagsForModulePageFactory(context) {
     return zohoFetchPageFactory(zohoCrmGetTagsForModule(context));
 }
@@ -5196,8 +5364,8 @@ function _unsupported_iterable_to_array(o, minLen) {
  *
  * https://www.zoho.com/crm/developer-guide/apiv2/add-tags.html
  *
- * @param context
- * @returns
+ * @param context - Authenticated Zoho CRM context for making API calls
+ * @returns Function that adds tags to records
  */ function zohoCrmAddTagsToRecords(context) {
     return function(input) {
         return context.fetchJson("/v8/".concat(input.module, "/actions/add_tags"), zohoCrmApiFetchJsonInput('POST', zohoCrmAddTagsToRecordsRequestBody(input))).then(function(x) {
@@ -5210,6 +5378,9 @@ function _unsupported_iterable_to_array(o, minLen) {
 }
 /**
  * Builds the request body for the add/remove tags endpoints, merging `tag_names` into `tags` and enforcing the max ID limit.
+ *
+ * @param input - The add/remove tags request containing tag names, tag objects, and record IDs
+ * @returns The formatted request body with merged tags and record IDs
  */ function zohoCrmAddTagsToRecordsRequestBody(input) {
     if (Array.isArray(input.ids) && input.ids.length > ZOHO_CRM_ADD_TAGS_TO_RECORDS_MAX_IDS_ALLOWED) {
         throw new Error("Cannot add/remove tags from more than ".concat(ZOHO_CRM_ADD_TAGS_TO_RECORDS_MAX_IDS_ALLOWED, " records at once."));
@@ -5242,8 +5413,8 @@ function _unsupported_iterable_to_array(o, minLen) {
  *
  * https://www.zoho.com/crm/developer-guide/apiv2/remove-tags.html
  *
- * @param context
- * @returns
+ * @param context - Authenticated Zoho CRM context for making API calls
+ * @returns Function that removes tags from records
  */ function zohoCrmRemoveTagsFromRecords(context) {
     return function(input) {
         return context.fetchJson("/v8/".concat(input.module, "/actions/remove_tags"), zohoCrmApiFetchJsonInput('POST', zohoCrmAddTagsToRecordsRequestBody(input))).then(function(x) {
@@ -5510,7 +5681,7 @@ function _ts_generator$3(thisArg, body) {
         });
         var fetch$1 = handleZohoCrmErrorFetch(baseFetch, logZohoServerErrorFunction, function(x) {
             if (_instanceof$1(x, ZohoInvalidTokenError)) {
-                accountsContext.loadAccessToken.resetAccessToken();
+                void accountsContext.loadAccessToken.resetAccessToken();
             }
         });
         var fetchJson = fetch.fetchJsonFunction(fetch$1, {
@@ -5605,13 +5776,15 @@ function _object_spread_props$2(target, source) {
  *   const secondPage = await firstPage.fetchNext();
  * }
  * ```
- */ function zohoSignFetchPageFactory(fetch$1, defaults) {
+ */ // eslint-disable-next-line @typescript-eslint/no-explicit-any -- generic constraint requires any
+function zohoSignFetchPageFactory(fetch$1, defaults) {
     return fetch.fetchPageFactory(_object_spread_props$2(_object_spread$3({}, defaults), {
         fetch: fetch$1,
         readFetchPageResultInfo: function readFetchPageResultInfo(result) {
             var _ref;
             var _result_page_context;
             return {
+                // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- page_context may be missing in malformed responses
                 hasNext: (_ref = (_result_page_context = result.page_context) === null || _result_page_context === void 0 ? void 0 : _result_page_context.has_more_rows) !== null && _ref !== void 0 ? _ref : false
             };
         },
@@ -5696,6 +5869,10 @@ function _object_without_properties_loose(source, excluded) {
 // MARK: Utility
 /**
  * Builds a {@link FetchJsonInput} for Zoho Sign API calls.
+ *
+ * @param method - HTTP method for the request
+ * @param body - Optional JSON body to include in the request
+ * @returns Configured fetch JSON input
  */ function zohoSignApiFetchJsonInput(method, body) {
     return {
         method: method,
@@ -5861,7 +6038,8 @@ function _object_without_properties_loose(source, excluded) {
         ]);
         var searchParams = fetch.makeUrlSearchParams(params);
         var queryString = searchParams.toString();
-        var url = "/requests/".concat(requestId, "/pdf").concat(queryString ? "?".concat(queryString) : '');
+        var suffix = queryString ? "?".concat(queryString) : '';
+        var url = "/requests/".concat(requestId, "/pdf").concat(suffix);
         return context.fetch(url, {
             method: 'GET'
         });
@@ -6091,7 +6269,12 @@ function _object_without_properties_loose(source, excluded) {
 }
 
 var ZOHO_SIGN_SERVICE_NAME = 'sign';
-function zohoSignConfigApiUrl(input) {
+/**
+ * Resolves an environment key or passthrough URL to the full Zoho Sign API URL.
+ *
+ * @param input - An environment key ('sandbox' or 'production') or a full API URL
+ * @returns The resolved Zoho Sign API URL
+ */ function zohoSignConfigApiUrl(input) {
     switch(input){
         case 'sandbox':
             return 'https://signsandbox.zoho.com/api/v1';
@@ -6233,7 +6416,12 @@ function _ts_generator$2(thisArg, body) {
 var logZohoSignErrorToConsole = logZohoServerErrorFunction('ZohoSign', {
     logDataArrayErrors: false
 });
-function parseZohoSignError(responseError) {
+/**
+ * Parses the JSON body of a failed Zoho Sign fetch response into a structured error, returning undefined if the body cannot be parsed.
+ *
+ * @param responseError - The fetch response error to parse
+ * @returns Parsed Zoho server error, or undefined if parsing fails
+ */ function parseZohoSignError(responseError) {
     return _async_to_generator$2(function() {
         var data, result;
         return _ts_generator$2(this, function(_state) {
@@ -6258,7 +6446,13 @@ function parseZohoSignError(responseError) {
         });
     })();
 }
-function parseZohoSignServerErrorResponseData(errorResponseData, responseError) {
+/**
+ * Converts raw Zoho Sign error response data into a parsed error, delegating to Sign-specific handlers for known error codes and falling back to the shared Zoho parser.
+ *
+ * @param errorResponseData - Raw error response data from the Zoho Sign API
+ * @param responseError - The underlying fetch response error
+ * @returns Parsed Zoho server error, or undefined if the data contains no recognizable error
+ */ function parseZohoSignServerErrorResponseData(errorResponseData, responseError) {
     var result;
     var error = tryFindZohoServerErrorData(errorResponseData, responseError);
     if (error) {
@@ -6530,7 +6724,7 @@ function _ts_generator$1(thisArg, body) {
         });
         var fetch$1 = handleZohoSignErrorFetch(baseFetch, logZohoServerErrorFunction, function(x) {
             if (_instanceof(x, ZohoInvalidTokenError)) {
-                accountsContext.loadAccessToken.resetAccessToken();
+                void accountsContext.loadAccessToken.resetAccessToken();
             }
         });
         var fetchJson = fetch.fetchJsonFunction(fetch$1, {
@@ -6641,18 +6835,26 @@ function _ts_generator$1(thisArg, body) {
 }
 /**
  * Constructs a standard {@link FetchJsonInput} for Zoho Accounts API calls with the given HTTP method and optional body.
+ *
+ * @param method - HTTP method to use for the request
+ * @param body - Optional request body to include
+ * @returns Configured fetch input for the Zoho Accounts API call
  */ function zohoAccountsApiFetchJsonInput(method, body) {
-    var result = {
+    return {
         method: method,
         body: body
     };
-    return result;
 }
 
 /**
  * The Zoho Accounts API URL for the US datacenter.
  */ var ZOHO_ACCOUNTS_US_API_URL = 'https://accounts.zoho.com';
-function zohoAccountsConfigApiUrl(input) {
+/**
+ * Resolves a Zoho Accounts API URL input to the full base URL. The 'us' key maps to the US datacenter; custom URLs pass through unchanged.
+ *
+ * @param input - A well-known datacenter key or a custom Zoho Accounts API URL
+ * @returns The resolved full Zoho Accounts API base URL
+ */ function zohoAccountsConfigApiUrl(input) {
     switch(input){
         case 'us':
             return ZOHO_ACCOUNTS_US_API_URL;
@@ -7019,7 +7221,7 @@ function _ts_generator(thisArg, body) {
                         }
                         if (!!currentToken) return [
                             3,
-                            10
+                            9
                         ];
                         _state.label = 3;
                     case 3:
@@ -7044,35 +7246,29 @@ function _ts_generator(thisArg, body) {
                         console.error("zohoAccountsZohoAccessTokenFactory(): Failed retrieving new token from tokenRefresher: ", e);
                         throw new ZohoAccountsAuthFailureError('Token Refresh Failed');
                     case 6:
-                        if (!currentToken) return [
-                            3,
-                            10
-                        ];
-                        _state.label = 7;
-                    case 7:
                         _state.trys.push([
-                            7,
-                            9,
+                            6,
+                            8,
                             ,
-                            10
+                            9
                         ]);
                         return [
                             4,
                             accessTokenCache === null || accessTokenCache === void 0 ? void 0 : accessTokenCache.updateCachedToken(currentToken)
                         ];
-                    case 8:
+                    case 7:
                         _state.sent();
                         return [
                             3,
-                            10
+                            9
                         ];
-                    case 9:
+                    case 8:
                         _state.sent();
                         return [
                             3,
-                            10
+                            9
                         ];
-                    case 10:
+                    case 9:
                         return [
                             2,
                             currentToken
@@ -7107,6 +7303,7 @@ function safeZohoDateTimeString(date) {
 
 exports.DEFAULT_ZOHO_API_RATE_LIMIT = DEFAULT_ZOHO_API_RATE_LIMIT;
 exports.DEFAULT_ZOHO_API_RATE_LIMIT_RESET_PERIOD = DEFAULT_ZOHO_API_RATE_LIMIT_RESET_PERIOD;
+exports.DEFAULT_ZOHO_RATE_LIMITED_TOO_MANY_REQUESTS_LOG_FUNCTION = DEFAULT_ZOHO_RATE_LIMITED_TOO_MANY_REQUESTS_LOG_FUNCTION;
 exports.DEFAULT_ZOHO_RATE_LIMITED_TOO_MANY_REQUETS_LOG_FUNCTION = DEFAULT_ZOHO_RATE_LIMITED_TOO_MANY_REQUETS_LOG_FUNCTION;
 exports.MAX_ZOHO_CRM_SEARCH_MODULE_RECORDS_CRITERIA = MAX_ZOHO_CRM_SEARCH_MODULE_RECORDS_CRITERIA;
 exports.MAX_ZOHO_RECRUIT_SEARCH_MODULE_RECORDS_CRITERIA = MAX_ZOHO_RECRUIT_SEARCH_MODULE_RECORDS_CRITERIA;