@dereekb/zoho 13.11.13 → 13.11.15

package/nestjs/index.esm.js

@@ -71,7 +71,8 @@ function readZohoConfigFromConfigService(configOrService, servicePrefix) {
 /**
  * Asserts that the provided ZohoConfig has a valid API URL configured.
  *
- * @param config - the Zoho config to validate
+ * @param config - The Zoho config to validate.
+ * @throws {Error} When `config.apiUrl` is missing.
  */ function assertValidZohoConfig(config) {
     if (!config.apiUrl) {
         throw new Error("No Zoho API url or type specified.");
@@ -163,7 +164,7 @@ function _define_property$e(obj, key, value) {
  * @param input - The {@link ZohoAccountsServiceConfigFromConfigServiceInput} containing the
  *   `ConfigService` and the `serviceAccessTokenKey` for the target Zoho service.
  * @returns A validated {@link ZohoAccountsServiceConfig} ready for use with `ZohoAccountsApi`.
- * @throws If any required credential (apiUrl, refreshToken, clientId) is missing.
+ * @throws {Error} If any required credential (apiUrl, refreshToken, clientId) is missing.
  */ function zohoAccountsServiceConfigFromConfigService(input) {
     var serviceAccessTokenKey = input.serviceAccessTokenKey;
     var getFromConfigService = zohoConfigServiceReaderFunction(input);
@@ -484,7 +485,7 @@ function updateZohoCacheCapturingError(cache, accessToken) {
 /**
  * Default error logging function for merged Zoho access token cache services.
  *
- * @param failedUpdates - array of cache/error tuples that failed during update
+ * @param failedUpdates - Array of cache/error tuples that failed during update.
  */ function logMergeZohoAccountsAccessTokenCacheServiceErrorFunction(failedUpdates) {
     console.warn("mergeZohoAccountsAccessTokenCacheServices(): failed updating ".concat(failedUpdates.length, " caches."));
     failedUpdates.forEach(function(param, i) {
@@ -504,10 +505,10 @@ function updateZohoCacheCapturingError(cache, accessToken) {
  * never short-circuits the lookup. Updates and clears run across all services in parallel
  * via `Promise.allSettled`, mirroring the previous behavior, with optional error logging.
  *
- * @param servicesToMerge Must include atleast one service. Empty arrays will throw an error.
- * @param inputServicesToMerge - cache services to merge in priority order
- * @param logError - optional error logging toggle or custom logging function
- * @returns a merged ZohoAccountsAccessTokenCacheService that delegates across all inputs
+ * @param inputServicesToMerge - Cache services to merge in priority order. Must include at least one service.
+ * @param logError - Optional error logging toggle or custom logging function.
+ * @returns A merged ZohoAccountsAccessTokenCacheService that delegates across all inputs.
+ * @throws {Error} When `inputServicesToMerge` is empty.
  */ function mergeZohoAccountsAccessTokenCacheServices(inputServicesToMerge, logError) {
     var services = _to_consumable_array$4(inputServicesToMerge);
     var logErrorFunction = typeof logError === 'function' ? logError : logError !== false ? logMergeZohoAccountsAccessTokenCacheServiceErrorFunction : undefined;
@@ -587,9 +588,9 @@ function updateZohoCacheCapturingError(cache, accessToken) {
  * Backed by {@link inMemoryAsyncKeyedValueCache} so all per-service caches share the
  * same record instance.
  *
- * @param existingCache - optional pre-populated token cache record to use as initial state
- * @param logAccessToConsole - whether to log cache reads and writes to the console
- * @returns a ZohoAccountsAccessTokenCacheService backed by in-memory storage
+ * @param existingCache - Optional pre-populated token cache record to use as initial state.
+ * @param logAccessToConsole - Whether to log cache reads and writes to the console.
+ * @returns A ZohoAccountsAccessTokenCacheService backed by in-memory storage.
  */ function memoryZohoAccountsAccessTokenCacheService(existingCache, logAccessToConsole) {
     var initialEntries = {};
     if (existingCache != null) {
@@ -706,18 +707,21 @@ var DEFAULT_FILE_ZOHO_ACCOUNTS_ACCESS_TOKEN_CACHE_SERVICE_PATH = '.tmp/zoho-acce
  * Reviver applied to each cached token entry on load so `expiresAt` is always a `Date`
  * regardless of how it was serialized.
  *
- * @param raw - the raw value loaded from storage; expected to be an object shaped like a ZohoAccessToken with a serialized `expiresAt`
- * @returns the parsed ZohoAccessToken with `expiresAt` coerced to a Date, or undefined when the input is not an object
+ * @param raw - The raw value loaded from storage; expected to be an object shaped like a ZohoAccessToken with a serialized `expiresAt`
+ * @returns The parsed ZohoAccessToken with `expiresAt` coerced to a Date, or undefined when the input is not an object.
  */ function reviveZohoAccessToken(raw) {
+    var result;
     if (raw == null || (typeof raw === "undefined" ? "undefined" : _type_of(raw)) !== 'object') {
-        return undefined;
+        result = undefined;
+    } else {
+        var value = raw;
+        var rawExpiresAt = value.expiresAt;
+        var expiresAt = rawExpiresAt != null && !_instanceof(rawExpiresAt, Date) ? new Date(rawExpiresAt) : rawExpiresAt;
+        result = _object_spread_props$5(_object_spread$6({}, value), {
+            expiresAt: expiresAt
+        });
     }
-    var value = raw;
-    var rawExpiresAt = value.expiresAt;
-    var expiresAt = rawExpiresAt != null && !_instanceof(rawExpiresAt, Date) ? new Date(rawExpiresAt) : rawExpiresAt;
-    return _object_spread_props$5(_object_spread$6({}, value), {
-        expiresAt: expiresAt
-    });
+    return result;
 }
 /**
  * Creates a ZohoAccountsAccessTokenCacheService that reads and writes the access token to the file system.
@@ -727,9 +731,9 @@ var DEFAULT_FILE_ZOHO_ACCOUNTS_ACCESS_TOKEN_CACHE_SERVICE_PATH = '.tmp/zoho-acce
  *
  * Useful for testing.
  *
- * @param filename - path to the JSON file used for token persistence
- * @param useMemoryCache - whether to also cache tokens in memory for faster reads
- * @returns a FileSystemZohoAccountsAccessTokenCacheService backed by file storage
+ * @param filename - Path to the JSON file used for token persistence.
+ * @param useMemoryCache - Whether to also cache tokens in memory for faster reads.
+ * @returns A FileSystemZohoAccountsAccessTokenCacheService backed by file storage.
  */ function fileZohoAccountsAccessTokenCacheService() {
     var filename = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : DEFAULT_FILE_ZOHO_ACCOUNTS_ACCESS_TOKEN_CACHE_SERVICE_PATH, useMemoryCache = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : true;
     var fileCache = createJsonFileAsyncKeyedValueCache({
@@ -820,7 +824,7 @@ var DEFAULT_FILE_ZOHO_ACCOUNTS_ACCESS_TOKEN_CACHE_SERVICE_PATH = '.tmp/zoho-acce
     }
     function readTokenFile() {
         return _async_to_generator$3(function() {
-            var raw, result, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, key;
+            var raw, result, revived, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, key;
             return _ts_generator$3(this, function(_state) {
                 switch(_state.label){
                     case 0:
@@ -831,31 +835,30 @@ var DEFAULT_FILE_ZOHO_ACCOUNTS_ACCESS_TOKEN_CACHE_SERVICE_PATH = '.tmp/zoho-acce
                     case 1:
                         raw = _state.sent();
                         if (raw == null) {
-                            return [
-                                2,
-                                undefined
-                            ];
-                        }
-                        result = {};
-                        _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-                        try {
-                            for(_iterator = Object.keys(raw)[Symbol.iterator](); !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-                                key = _step.value;
-                                result[key] = reviveZohoAccessToken(raw[key]);
-                            }
-                        } catch (err) {
-                            _didIteratorError = true;
-                            _iteratorError = err;
-                        } finally{
+                            result = undefined;
+                        } else {
+                            revived = {};
+                            _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
                             try {
-                                if (!_iteratorNormalCompletion && _iterator.return != null) {
-                                    _iterator.return();
+                                for(_iterator = Object.keys(raw)[Symbol.iterator](); !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                                    key = _step.value;
+                                    revived[key] = reviveZohoAccessToken(raw[key]);
                                 }
+                            } catch (err) {
+                                _didIteratorError = true;
+                                _iteratorError = err;
                             } finally{
-                                if (_didIteratorError) {
-                                    throw _iteratorError;
+                                try {
+                                    if (!_iteratorNormalCompletion && _iterator.return != null) {
+                                        _iterator.return();
+                                    }
+                                } finally{
+                                    if (_didIteratorError) {
+                                        throw _iteratorError;
+                                    }
                                 }
                             }
+                            result = revived;
                         }
                         return [
                             2,
@@ -1110,7 +1113,7 @@ function _define_property$b(obj, key, value) {
             value: /**
      * Validates that the required Zoho CRM connection fields are present and well-formed.
      *
-     * @param config - the CRM service config to validate
+     * @param config - The CRM service config to validate.
      */ function assertValidConfig(config) {
                 assertValidZohoConfig(config.zohoCrm);
             }
@@ -1210,7 +1213,7 @@ function _object_spread_props$4(target, source) {
             get: /**
      * The authenticated CRM context used by all operation accessors.
      *
-     * @returns the CRM context from the underlying client
+     * @returns The CRM context from the underlying client.
      */ function get() {
                 return this.zohoCrm.crmContext;
             }
@@ -1220,7 +1223,7 @@ function _object_spread_props$4(target, source) {
             get: /**
      * Rate limiter shared across all CRM requests to respect Zoho API quotas.
      *
-     * @returns the shared rate limiter instance
+     * @returns The shared rate limiter instance.
      */ function get() {
                 return this.zohoCrm.crmContext.zohoRateLimiter;
             }
@@ -1231,7 +1234,7 @@ function _object_spread_props$4(target, source) {
             /**
      * Configured pass-through for {@link zohoCrmInsertRecord}.
      *
-     * @returns bound insert record function
+     * @returns Bound insert record function.
      */ function get() {
                 return zohoCrmInsertRecord(this.crmContext);
             }
@@ -1241,7 +1244,7 @@ function _object_spread_props$4(target, source) {
             get: /**
      * Configured pass-through for {@link zohoCrmUpsertRecord}.
      *
-     * @returns bound upsert record function
+     * @returns Bound upsert record function.
      */ function get() {
                 return zohoCrmUpsertRecord(this.crmContext);
             }
@@ -1251,7 +1254,7 @@ function _object_spread_props$4(target, source) {
             get: /**
      * Configured pass-through for {@link zohoCrmUpdateRecord}.
      *
-     * @returns bound update record function
+     * @returns Bound update record function.
      */ function get() {
                 return zohoCrmUpdateRecord(this.crmContext);
             }
@@ -1261,7 +1264,7 @@ function _object_spread_props$4(target, source) {
             get: /**
      * Configured pass-through for {@link zohoCrmDeleteRecord}.
      *
-     * @returns bound delete record function
+     * @returns Bound delete record function.
      */ function get() {
                 return zohoCrmDeleteRecord(this.crmContext);
             }
@@ -1271,7 +1274,7 @@ function _object_spread_props$4(target, source) {
             get: /**
      * Configured pass-through for {@link zohoCrmGetRecordById}.
      *
-     * @returns bound get record by ID function
+     * @returns Bound get record by ID function.
      */ function get() {
                 return zohoCrmGetRecordById(this.crmContext);
             }
@@ -1281,7 +1284,7 @@ function _object_spread_props$4(target, source) {
             get: /**
      * Configured pass-through for {@link zohoCrmGetRecords}.
      *
-     * @returns bound get records function
+     * @returns Bound get records function.
      */ function get() {
                 return zohoCrmGetRecords(this.crmContext);
             }
@@ -1291,7 +1294,7 @@ function _object_spread_props$4(target, source) {
             get: /**
      * Configured pass-through for {@link zohoCrmSearchRecords}.
      *
-     * @returns bound search records function
+     * @returns Bound search records function.
      */ function get() {
                 return zohoCrmSearchRecords(this.crmContext);
             }
@@ -1301,7 +1304,7 @@ function _object_spread_props$4(target, source) {
             get: /**
      * Configured pass-through for {@link zohoCrmSearchRecordsPageFactory}.
      *
-     * @returns bound search records page factory function
+     * @returns Bound search records page factory function.
      */ function get() {
                 return zohoCrmSearchRecordsPageFactory(this.crmContext);
             }
@@ -1311,7 +1314,7 @@ function _object_spread_props$4(target, source) {
             get: /**
      * Configured pass-through for {@link zohoCrmGetRelatedRecordsFunctionFactory}.
      *
-     * @returns bound get related records factory function
+     * @returns Bound get related records factory function.
      */ function get() {
                 return zohoCrmGetRelatedRecordsFunctionFactory(this.crmContext);
             }
@@ -1321,7 +1324,7 @@ function _object_spread_props$4(target, source) {
             get: /**
      * Configured pass-through for {@link zohoCrmGetEmailsForRecord}.
      *
-     * @returns bound get emails for record function
+     * @returns Bound get emails for record function.
      */ function get() {
                 return zohoCrmGetEmailsForRecord(this.crmContext);
             }
@@ -1331,7 +1334,7 @@ function _object_spread_props$4(target, source) {
             get: /**
      * Configured pass-through for {@link zohoCrmGetEmailsForRecordPageFactory}.
      *
-     * @returns bound get emails page factory function
+     * @returns Bound get emails page factory function.
      */ function get() {
                 return zohoCrmGetEmailsForRecordPageFactory(this.crmContext);
             }
@@ -1341,7 +1344,7 @@ function _object_spread_props$4(target, source) {
             get: /**
      * Configured pass-through for {@link zohoCrmGetAttachmentsForRecord}.
      *
-     * @returns bound get attachments for record function
+     * @returns Bound get attachments for record function.
      */ function get() {
                 return zohoCrmGetAttachmentsForRecord(this.crmContext);
             }
@@ -1351,7 +1354,7 @@ function _object_spread_props$4(target, source) {
             get: /**
      * Configured pass-through for {@link zohoCrmGetAttachmentsForRecordPageFactory}.
      *
-     * @returns bound get attachments page factory function
+     * @returns Bound get attachments page factory function.
      */ function get() {
                 return zohoCrmGetAttachmentsForRecordPageFactory(this.crmContext);
             }
@@ -1361,7 +1364,7 @@ function _object_spread_props$4(target, source) {
             get: /**
      * Configured pass-through for {@link zohoCrmUploadAttachmentForRecord}.
      *
-     * @returns bound upload attachment function
+     * @returns Bound upload attachment function.
      */ function get() {
                 return zohoCrmUploadAttachmentForRecord(this.crmContext);
             }
@@ -1371,7 +1374,7 @@ function _object_spread_props$4(target, source) {
             get: /**
      * Configured pass-through for {@link zohoCrmDownloadAttachmentForRecord}.
      *
-     * @returns bound download attachment function
+     * @returns Bound download attachment function.
      */ function get() {
                 return zohoCrmDownloadAttachmentForRecord(this.crmContext);
             }
@@ -1381,7 +1384,7 @@ function _object_spread_props$4(target, source) {
             get: /**
      * Configured pass-through for {@link zohoCrmDeleteAttachmentFromRecord}.
      *
-     * @returns bound delete attachment function
+     * @returns Bound delete attachment function.
      */ function get() {
                 return zohoCrmDeleteAttachmentFromRecord(this.crmContext);
             }
@@ -1391,7 +1394,7 @@ function _object_spread_props$4(target, source) {
             get: /**
      * Configured pass-through for {@link zohoCrmCreateNotes}.
      *
-     * @returns bound create notes function
+     * @returns Bound create notes function.
      */ function get() {
                 return zohoCrmCreateNotes(this.crmContext);
             }
@@ -1401,7 +1404,7 @@ function _object_spread_props$4(target, source) {
             get: /**
      * Configured pass-through for {@link zohoCrmDeleteNotes}.
      *
-     * @returns bound delete notes function
+     * @returns Bound delete notes function.
      */ function get() {
                 return zohoCrmDeleteNotes(this.crmContext);
             }
@@ -1411,7 +1414,7 @@ function _object_spread_props$4(target, source) {
             get: /**
      * Configured pass-through for {@link zohoCrmCreateNotesForRecord}.
      *
-     * @returns bound create notes for record function
+     * @returns Bound create notes for record function.
      */ function get() {
                 return zohoCrmCreateNotesForRecord(this.crmContext);
             }
@@ -1421,7 +1424,7 @@ function _object_spread_props$4(target, source) {
             get: /**
      * Configured pass-through for {@link zohoCrmGetNotesForRecord}.
      *
-     * @returns bound get notes for record function
+     * @returns Bound get notes for record function.
      */ function get() {
                 return zohoCrmGetNotesForRecord(this.crmContext);
             }
@@ -1431,7 +1434,7 @@ function _object_spread_props$4(target, source) {
             get: /**
      * Configured pass-through for {@link zohoCrmGetNotesForRecordPageFactory}.
      *
-     * @returns bound get notes page factory function
+     * @returns Bound get notes page factory function.
      */ function get() {
                 return zohoCrmGetNotesForRecordPageFactory(this.crmContext);
             }
@@ -1441,7 +1444,7 @@ function _object_spread_props$4(target, source) {
             get: /**
      * Configured pass-through for {@link zohoCrmExecuteRestApiFunction}.
      *
-     * @returns bound execute REST API function
+     * @returns Bound execute REST API function.
      */ function get() {
                 return zohoCrmExecuteRestApiFunction(this.crmContext);
             }
@@ -1451,7 +1454,7 @@ function _object_spread_props$4(target, source) {
             get: /**
      * Configured pass-through for {@link zohoCrmCreateTagsForModule}.
      *
-     * @returns bound create tags for module function
+     * @returns Bound create tags for module function.
      */ function get() {
                 return zohoCrmCreateTagsForModule(this.crmContext);
             }
@@ -1461,7 +1464,7 @@ function _object_spread_props$4(target, source) {
             get: /**
      * Configured pass-through for {@link zohoCrmDeleteTag}.
      *
-     * @returns bound delete tag function
+     * @returns Bound delete tag function.
      */ function get() {
                 return zohoCrmDeleteTag(this.crmContext);
             }
@@ -1471,7 +1474,7 @@ function _object_spread_props$4(target, source) {
             get: /**
      * Configured pass-through for {@link zohoCrmGetTagsForModule}.
      *
-     * @returns bound get tags for module function
+     * @returns Bound get tags for module function.
      */ function get() {
                 return zohoCrmGetTagsForModule(this.crmContext);
             }
@@ -1481,7 +1484,7 @@ function _object_spread_props$4(target, source) {
             get: /**
      * Configured pass-through for {@link zohoCrmAddTagsToRecords}.
      *
-     * @returns bound add tags to records function
+     * @returns Bound add tags to records function.
      */ function get() {
                 return zohoCrmAddTagsToRecords(this.crmContext);
             }
@@ -1491,7 +1494,7 @@ function _object_spread_props$4(target, source) {
             get: /**
      * Configured pass-through for {@link zohoCrmRemoveTagsFromRecords}.
      *
-     * @returns bound remove tags from records function
+     * @returns Bound remove tags from records function.
      */ function get() {
                 return zohoCrmRemoveTagsFromRecords(this.crmContext);
             }
@@ -1538,9 +1541,9 @@ function _unsupported_iterable_to_array$3(o, minLen) {
  * Resolves the API URL via environment variables following the naming convention
  * `ZOHO_CRM_API_URL` (service-specific) or `ZOHO_API_URL` (shared fallback).
  *
- * @param configService - NestJS config service populated with Zoho environment variables
- * @returns Validated Zoho CRM service configuration
- * @throws {Error} If required config values (e.g. API URL) are missing
+ * @param configService - NestJS config service populated with Zoho environment variables.
+ * @returns Validated Zoho CRM service configuration.
+ * @throws {Error} If required config values (e.g. API URL) are missing.
  *
  * @example
  * ```typescript
@@ -1564,8 +1567,8 @@ function _unsupported_iterable_to_array$3(o, minLen) {
  * Reads Zoho Accounts (OAuth) settings scoped to the CRM service from
  * the NestJS ConfigService and returns an accounts service config.
  *
- * @param configService - NestJS config service populated with Zoho OAuth environment variables
- * @returns Zoho Accounts service config scoped to the CRM service access token
+ * @param configService - NestJS config service populated with Zoho OAuth environment variables.
+ * @returns Zoho Accounts service config scoped to the CRM service access token.
  *
  * @example
  * ```typescript
@@ -1595,14 +1598,10 @@ function _unsupported_iterable_to_array$3(o, minLen) {
  * exports {@link ZohoCrmApi} by default. Additional imports, exports, and providers
  * from the config are merged in.
  *
- * @param config - Module configuration with optional dependency module and extra metadata
+ * @param config - Module configuration with optional dependency module and extra metadata.
  * @returns Complete NestJS module metadata ready to pass to `@Module()`
  *
- * @example
- * ```typescript
- * const cacheService = fileZohoAccountsAccessTokenCacheService();
- *
- * @Module({
+ * @Module ({
  *   providers: [
  *     {
  *       provide: ZohoAccountsAccessTokenCacheService,
@@ -1612,10 +1611,13 @@ function _unsupported_iterable_to_array$3(o, minLen) {
  *   exports: [ZohoAccountsAccessTokenCacheService]
  * })
  * export class ZohoCrmDependencyModule {}
- *
- * @Module(appZohoCrmModuleMetadata({ dependencyModule: ZohoCrmDependencyModule }))
+ * @Module (appZohoCrmModuleMetadata({ dependencyModule: ZohoCrmDependencyModule }))
  * export class AppZohoCrmModule {}
  * ```
+ *
+ * @example
+ * ```typescript
+ * const cacheService = fileZohoAccountsAccessTokenCacheService();
  */ function appZohoCrmModuleMetadata(config) {
     var dependencyModule = config.dependencyModule, imports = config.imports, exports = config.exports, providers = config.providers;
     var dependencyModuleImport = dependencyModule ? [
@@ -1702,7 +1704,7 @@ function _define_property$9(obj, key, value) {
             value: /**
      * Validates that the required Zoho Recruit connection fields are present and well-formed.
      *
-     * @param config - the Recruit service config to validate
+     * @param config - The Recruit service config to validate.
      */ function assertValidConfig(config) {
                 assertValidZohoConfig(config.zohoRecruit);
             }
@@ -1802,7 +1804,7 @@ function _object_spread_props$3(target, source) {
             get: /**
      * The authenticated Recruit context used by all operation accessors.
      *
-     * @returns the Recruit context from the underlying client
+     * @returns The Recruit context from the underlying client.
      */ function get() {
                 return this.zohoRecruit.recruitContext;
             }
@@ -1812,7 +1814,7 @@ function _object_spread_props$3(target, source) {
             get: /**
      * Rate limiter shared across all Recruit requests to respect Zoho API quotas.
      *
-     * @returns the shared rate limiter instance
+     * @returns The shared rate limiter instance.
      */ function get() {
                 return this.zohoRecruit.recruitContext.zohoRateLimiter;
             }
@@ -1823,7 +1825,7 @@ function _object_spread_props$3(target, source) {
             /**
      * Configured pass-through for {@link zohoRecruitInsertRecord}.
      *
-     * @returns bound insert record function
+     * @returns Bound insert record function.
      */ function get() {
                 return zohoRecruitInsertRecord(this.recruitContext);
             }
@@ -1833,7 +1835,7 @@ function _object_spread_props$3(target, source) {
             get: /**
      * Configured pass-through for {@link zohoRecruitUpsertRecord}.
      *
-     * @returns bound upsert record function
+     * @returns Bound upsert record function.
      */ function get() {
                 return zohoRecruitUpsertRecord(this.recruitContext);
             }
@@ -1843,7 +1845,7 @@ function _object_spread_props$3(target, source) {
             get: /**
      * Configured pass-through for {@link zohoRecruitUpdateRecord}.
      *
-     * @returns bound update record function
+     * @returns Bound update record function.
      */ function get() {
                 return zohoRecruitUpdateRecord(this.recruitContext);
             }
@@ -1853,7 +1855,7 @@ function _object_spread_props$3(target, source) {
             get: /**
      * Configured pass-through for {@link zohoRecruitDeleteRecord}.
      *
-     * @returns bound delete record function
+     * @returns Bound delete record function.
      */ function get() {
                 return zohoRecruitDeleteRecord(this.recruitContext);
             }
@@ -1863,7 +1865,7 @@ function _object_spread_props$3(target, source) {
             get: /**
      * Configured pass-through for {@link zohoRecruitGetRecordById}.
      *
-     * @returns bound get record by ID function
+     * @returns Bound get record by ID function.
      */ function get() {
                 return zohoRecruitGetRecordById(this.recruitContext);
             }
@@ -1873,7 +1875,7 @@ function _object_spread_props$3(target, source) {
             get: /**
      * Configured pass-through for {@link zohoRecruitGetRecords}.
      *
-     * @returns bound get records function
+     * @returns Bound get records function.
      */ function get() {
                 return zohoRecruitGetRecords(this.recruitContext);
             }
@@ -1883,7 +1885,7 @@ function _object_spread_props$3(target, source) {
             get: /**
      * Configured pass-through for {@link zohoRecruitSearchRecords}.
      *
-     * @returns bound search records function
+     * @returns Bound search records function.
      */ function get() {
                 return zohoRecruitSearchRecords(this.recruitContext);
             }
@@ -1893,7 +1895,7 @@ function _object_spread_props$3(target, source) {
             get: /**
      * Configured pass-through for {@link zohoRecruitSearchRecordsPageFactory}.
      *
-     * @returns bound search records page factory function
+     * @returns Bound search records page factory function.
      */ function get() {
                 return zohoRecruitSearchRecordsPageFactory(this.recruitContext);
             }
@@ -1903,7 +1905,7 @@ function _object_spread_props$3(target, source) {
             get: /**
      * Configured pass-through for {@link zohoRecruitGetRelatedRecordsFunctionFactory}.
      *
-     * @returns bound get related records factory function
+     * @returns Bound get related records factory function.
      */ function get() {
                 return zohoRecruitGetRelatedRecordsFunctionFactory(this.recruitContext);
             }
@@ -1913,7 +1915,7 @@ function _object_spread_props$3(target, source) {
             get: /**
      * Configured pass-through for {@link zohoRecruitGetEmailsForRecord}.
      *
-     * @returns bound get emails for record function
+     * @returns Bound get emails for record function.
      */ function get() {
                 return zohoRecruitGetEmailsForRecord(this.recruitContext);
             }
@@ -1923,7 +1925,7 @@ function _object_spread_props$3(target, source) {
             get: /**
      * Configured pass-through for {@link zohoRecruitGetEmailsForRecordPageFactory}.
      *
-     * @returns bound get emails page factory function
+     * @returns Bound get emails page factory function.
      */ function get() {
                 return zohoRecruitGetEmailsForRecordPageFactory(this.recruitContext);
             }
@@ -1933,7 +1935,7 @@ function _object_spread_props$3(target, source) {
             get: /**
      * Configured pass-through for {@link zohoRecruitGetAttachmentsForRecord}.
      *
-     * @returns bound get attachments for record function
+     * @returns Bound get attachments for record function.
      */ function get() {
                 return zohoRecruitGetAttachmentsForRecord(this.recruitContext);
             }
@@ -1943,7 +1945,7 @@ function _object_spread_props$3(target, source) {
             get: /**
      * Configured pass-through for {@link zohoRecruitGetAttachmentsForRecordPageFactory}.
      *
-     * @returns bound get attachments page factory function
+     * @returns Bound get attachments page factory function.
      */ function get() {
                 return zohoRecruitGetAttachmentsForRecordPageFactory(this.recruitContext);
             }
@@ -1953,7 +1955,7 @@ function _object_spread_props$3(target, source) {
             get: /**
      * Configured pass-through for {@link zohoRecruitUploadAttachmentForRecord}.
      *
-     * @returns bound upload attachment function
+     * @returns Bound upload attachment function.
      */ function get() {
                 return zohoRecruitUploadAttachmentForRecord(this.recruitContext);
             }
@@ -1963,7 +1965,7 @@ function _object_spread_props$3(target, source) {
             get: /**
      * Configured pass-through for {@link zohoRecruitDownloadAttachmentForRecord}.
      *
-     * @returns bound download attachment function
+     * @returns Bound download attachment function.
      */ function get() {
                 return zohoRecruitDownloadAttachmentForRecord(this.recruitContext);
             }
@@ -1973,7 +1975,7 @@ function _object_spread_props$3(target, source) {
             get: /**
      * Configured pass-through for {@link zohoRecruitDeleteAttachmentFromRecord}.
      *
-     * @returns bound delete attachment function
+     * @returns Bound delete attachment function.
      */ function get() {
                 return zohoRecruitDeleteAttachmentFromRecord(this.recruitContext);
             }
@@ -1983,7 +1985,7 @@ function _object_spread_props$3(target, source) {
             get: /**
      * Configured pass-through for {@link zohoRecruitCreateNotes}.
      *
-     * @returns bound create notes function
+     * @returns Bound create notes function.
      */ function get() {
                 return zohoRecruitCreateNotes(this.recruitContext);
             }
@@ -1993,7 +1995,7 @@ function _object_spread_props$3(target, source) {
             get: /**
      * Configured pass-through for {@link zohoRecruitDeleteNotes}.
      *
-     * @returns bound delete notes function
+     * @returns Bound delete notes function.
      */ function get() {
                 return zohoRecruitDeleteNotes(this.recruitContext);
             }
@@ -2003,7 +2005,7 @@ function _object_spread_props$3(target, source) {
             get: /**
      * Configured pass-through for {@link zohoRecruitCreateNotesForRecord}.
      *
-     * @returns bound create notes for record function
+     * @returns Bound create notes for record function.
      */ function get() {
                 return zohoRecruitCreateNotesForRecord(this.recruitContext);
             }
@@ -2013,7 +2015,7 @@ function _object_spread_props$3(target, source) {
             get: /**
      * Configured pass-through for {@link zohoRecruitGetNotesForRecord}.
      *
-     * @returns bound get notes for record function
+     * @returns Bound get notes for record function.
      */ function get() {
                 return zohoRecruitGetNotesForRecord(this.recruitContext);
             }
@@ -2023,7 +2025,7 @@ function _object_spread_props$3(target, source) {
             get: /**
      * Configured pass-through for {@link zohoRecruitGetNotesForRecordPageFactory}.
      *
-     * @returns bound get notes page factory function
+     * @returns Bound get notes page factory function.
      */ function get() {
                 return zohoRecruitGetNotesForRecordPageFactory(this.recruitContext);
             }
@@ -2033,7 +2035,7 @@ function _object_spread_props$3(target, source) {
             get: /**
      * Configured pass-through for {@link zohoRecruitExecuteRestApiFunction}.
      *
-     * @returns bound execute REST API function
+     * @returns Bound execute REST API function.
      */ function get() {
                 return zohoRecruitExecuteRestApiFunction(this.recruitContext);
             }
@@ -2043,7 +2045,7 @@ function _object_spread_props$3(target, source) {
             get: /**
      * Configured pass-through for {@link zohoRecruitAssociateCandidateRecordsWithJobOpenings}.
      *
-     * @returns bound associate candidates with job openings function
+     * @returns Bound associate candidates with job openings function.
      */ function get() {
                 return zohoRecruitAssociateCandidateRecordsWithJobOpenings(this.recruitContext);
             }
@@ -2053,7 +2055,7 @@ function _object_spread_props$3(target, source) {
             get: /**
      * Configured pass-through for {@link zohoRecruitSearchCandidateAssociatedJobOpeningRecords}.
      *
-     * @returns bound search candidate associated job openings function
+     * @returns Bound search candidate associated job openings function.
      */ function get() {
                 return zohoRecruitSearchCandidateAssociatedJobOpeningRecords(this.recruitContext);
             }
@@ -2063,7 +2065,7 @@ function _object_spread_props$3(target, source) {
             get: /**
      * Configured pass-through for {@link zohoRecruitSearchCandidateAssociatedJobOpeningRecordsPageFactory}.
      *
-     * @returns bound search candidate job openings page factory function
+     * @returns Bound search candidate job openings page factory function.
      */ function get() {
                 return zohoRecruitSearchCandidateAssociatedJobOpeningRecordsPageFactory(this.recruitContext);
             }
@@ -2073,7 +2075,7 @@ function _object_spread_props$3(target, source) {
             get: /**
      * Configured pass-through for {@link zohoRecruitSearchJobOpeningAssociatedCandidateRecords}.
      *
-     * @returns bound search job opening associated candidates function
+     * @returns Bound search job opening associated candidates function.
      */ function get() {
                 return zohoRecruitSearchJobOpeningAssociatedCandidateRecords(this.recruitContext);
             }
@@ -2083,7 +2085,7 @@ function _object_spread_props$3(target, source) {
             get: /**
      * Configured pass-through for {@link zohoRecruitSearchJobOpeningAssociatedCandidateRecordsPageFactory}.
      *
-     * @returns bound search job opening candidates page factory function
+     * @returns Bound search job opening candidates page factory function.
      */ function get() {
                 return zohoRecruitSearchJobOpeningAssociatedCandidateRecordsPageFactory(this.recruitContext);
             }
@@ -2093,7 +2095,7 @@ function _object_spread_props$3(target, source) {
             get: /**
      * Configured pass-through for {@link zohoRecruitCreateTagsForModule}.
      *
-     * @returns bound create tags for module function
+     * @returns Bound create tags for module function.
      */ function get() {
                 return zohoRecruitCreateTagsForModule(this.recruitContext);
             }
@@ -2103,7 +2105,7 @@ function _object_spread_props$3(target, source) {
             get: /**
      * Configured pass-through for {@link zohoRecruitGetTagsForModule}.
      *
-     * @returns bound get tags for module function
+     * @returns Bound get tags for module function.
      */ function get() {
                 return zohoRecruitGetTagsForModule(this.recruitContext);
             }
@@ -2113,7 +2115,7 @@ function _object_spread_props$3(target, source) {
             get: /**
      * Configured pass-through for {@link zohoRecruitAddTagsToRecords}.
      *
-     * @returns bound add tags to records function
+     * @returns Bound add tags to records function.
      */ function get() {
                 return zohoRecruitAddTagsToRecords(this.recruitContext);
             }
@@ -2123,7 +2125,7 @@ function _object_spread_props$3(target, source) {
             get: /**
      * Configured pass-through for {@link zohoRecruitRemoveTagsFromRecords}.
      *
-     * @returns bound remove tags from records function
+     * @returns Bound remove tags from records function.
      */ function get() {
                 return zohoRecruitRemoveTagsFromRecords(this.recruitContext);
             }
@@ -2170,9 +2172,9 @@ function _unsupported_iterable_to_array$2(o, minLen) {
  * Resolves the API URL via environment variables following the naming convention
  * `ZOHO_RECRUIT_API_URL` (service-specific) or `ZOHO_API_URL` (shared fallback).
  *
- * @param configService - NestJS config service populated with Zoho environment variables
- * @returns Validated Zoho Recruit service configuration
- * @throws {Error} If required config values (e.g. API URL) are missing
+ * @param configService - NestJS config service populated with Zoho environment variables.
+ * @returns Validated Zoho Recruit service configuration.
+ * @throws {Error} If required config values (e.g. API URL) are missing.
  *
  * @example
  * ```typescript
@@ -2196,8 +2198,8 @@ function _unsupported_iterable_to_array$2(o, minLen) {
  * Reads Zoho Accounts (OAuth) settings scoped to the Recruit service from
  * the NestJS ConfigService and returns an accounts service config.
  *
- * @param configService - NestJS config service populated with Zoho OAuth environment variables
- * @returns Zoho Accounts service config scoped to the Recruit service access token
+ * @param configService - NestJS config service populated with Zoho OAuth environment variables.
+ * @returns Zoho Accounts service config scoped to the Recruit service access token.
  *
  * @example
  * ```typescript
@@ -2227,14 +2229,10 @@ function _unsupported_iterable_to_array$2(o, minLen) {
  * exports {@link ZohoRecruitApi} by default. Additional imports, exports, and providers
  * from the config are merged in.
  *
- * @param config - Module configuration with optional dependency module and extra metadata
+ * @param config - Module configuration with optional dependency module and extra metadata.
  * @returns Complete NestJS module metadata ready to pass to `@Module()`
  *
- * @example
- * ```typescript
- * const cacheService = fileZohoAccountsAccessTokenCacheService();
- *
- * @Module({
+ * @Module ({
  *   providers: [
  *     {
  *       provide: ZohoAccountsAccessTokenCacheService,
@@ -2244,10 +2242,13 @@ function _unsupported_iterable_to_array$2(o, minLen) {
  *   exports: [ZohoAccountsAccessTokenCacheService]
  * })
  * export class ZohoRecruitDependencyModule {}
- *
- * @Module(appZohoRecruitModuleMetadata({ dependencyModule: ZohoRecruitDependencyModule }))
+ * @Module (appZohoRecruitModuleMetadata({ dependencyModule: ZohoRecruitDependencyModule }))
  * export class AppZohoRecruitModule {}
  * ```
+ *
+ * @example
+ * ```typescript
+ * const cacheService = fileZohoAccountsAccessTokenCacheService();
  */ function appZohoRecruitModuleMetadata(config) {
     var dependencyModule = config.dependencyModule, imports = config.imports, exports = config.exports, providers = config.providers;
     var dependencyModuleImport = dependencyModule ? [
@@ -2423,7 +2424,7 @@ function _object_spread_props$2(target, source) {
             get: /**
      * The authenticated Sign context used by all operation accessors.
      *
-     * @returns the Sign context from the underlying client
+     * @returns The Sign context from the underlying client.
      */ function get() {
                 return this.zohoSign.signContext;
             }
@@ -2433,7 +2434,7 @@ function _object_spread_props$2(target, source) {
             get: /**
      * Rate limiter shared across all Sign requests to respect Zoho API quotas.
      *
-     * @returns the shared rate limiter instance
+     * @returns The shared rate limiter instance.
      */ function get() {
                 return this.zohoSign.signContext.zohoRateLimiter;
             }
@@ -2444,7 +2445,7 @@ function _object_spread_props$2(target, source) {
             /**
      * Configured pass-through for {@link zohoSignGetDocument}.
      *
-     * @returns bound get document function
+     * @returns Bound get document function.
      */ function get() {
                 return zohoSignGetDocument(this.signContext);
             }
@@ -2454,7 +2455,7 @@ function _object_spread_props$2(target, source) {
             get: /**
      * Configured pass-through for {@link zohoSignGetDocuments}.
      *
-     * @returns bound get documents function
+     * @returns Bound get documents function.
      */ function get() {
                 return zohoSignGetDocuments(this.signContext);
             }
@@ -2464,7 +2465,7 @@ function _object_spread_props$2(target, source) {
             get: /**
      * Configured pass-through for {@link zohoSignGetDocumentsPageFactory}.
      *
-     * @returns bound get documents page factory function
+     * @returns Bound get documents page factory function.
      */ function get() {
                 return zohoSignGetDocumentsPageFactory(this.signContext);
             }
@@ -2474,7 +2475,7 @@ function _object_spread_props$2(target, source) {
             get: /**
      * Configured pass-through for {@link zohoSignGetDocumentFormData}.
      *
-     * @returns bound get document form data function
+     * @returns Bound get document form data function.
      */ function get() {
                 return zohoSignGetDocumentFormData(this.signContext);
             }
@@ -2484,7 +2485,7 @@ function _object_spread_props$2(target, source) {
             get: /**
      * Configured pass-through for {@link zohoSignRetrieveFieldTypes}.
      *
-     * @returns bound retrieve field types function
+     * @returns Bound retrieve field types function.
      */ function get() {
                 return zohoSignRetrieveFieldTypes(this.signContext);
             }
@@ -2494,7 +2495,7 @@ function _object_spread_props$2(target, source) {
             get: /**
      * Configured pass-through for {@link zohoSignDownloadPdf}.
      *
-     * @returns bound download PDF function
+     * @returns Bound download PDF function.
      */ function get() {
                 return zohoSignDownloadPdf(this.signContext);
             }
@@ -2504,7 +2505,7 @@ function _object_spread_props$2(target, source) {
             get: /**
      * Configured pass-through for {@link zohoSignDownloadCompletionCertificate}.
      *
-     * @returns bound download completion certificate function
+     * @returns Bound download completion certificate function.
      */ function get() {
                 return zohoSignDownloadCompletionCertificate(this.signContext);
             }
@@ -2514,7 +2515,7 @@ function _object_spread_props$2(target, source) {
             get: /**
      * Configured pass-through for {@link zohoSignCreateDocument}.
      *
-     * @returns bound create document function
+     * @returns Bound create document function.
      */ function get() {
                 return zohoSignCreateDocument(this.signContext);
             }
@@ -2524,7 +2525,7 @@ function _object_spread_props$2(target, source) {
             get: /**
      * Configured pass-through for {@link zohoSignUpdateDocument}.
      *
-     * @returns bound update document function
+     * @returns Bound update document function.
      */ function get() {
                 return zohoSignUpdateDocument(this.signContext);
             }
@@ -2534,7 +2535,7 @@ function _object_spread_props$2(target, source) {
             get: /**
      * Configured pass-through for {@link zohoSignSendDocumentForSignature}.
      *
-     * @returns bound send document for signature function
+     * @returns Bound send document for signature function.
      */ function get() {
                 return zohoSignSendDocumentForSignature(this.signContext);
             }
@@ -2544,7 +2545,7 @@ function _object_spread_props$2(target, source) {
             get: /**
      * Configured pass-through for {@link zohoSignExtendDocument}.
      *
-     * @returns bound extend document function
+     * @returns Bound extend document function.
      */ function get() {
                 return zohoSignExtendDocument(this.signContext);
             }
@@ -2554,7 +2555,7 @@ function _object_spread_props$2(target, source) {
             get: /**
      * Configured pass-through for {@link zohoSignDeleteDocument}.
      *
-     * @returns bound delete document function
+     * @returns Bound delete document function.
      */ function get() {
                 return zohoSignDeleteDocument(this.signContext);
             }
@@ -2601,9 +2602,9 @@ function _unsupported_iterable_to_array$1(o, minLen) {
  * Resolves the API URL via environment variables following the naming convention
  * `ZOHO_SIGN_API_URL` (service-specific) or `ZOHO_API_URL` (shared fallback).
  *
- * @param configService - NestJS config service populated with Zoho environment variables
- * @returns Validated Zoho Sign service configuration
- * @throws {Error} If required config values (e.g. API URL) are missing
+ * @param configService - NestJS config service populated with Zoho environment variables.
+ * @returns Validated Zoho Sign service configuration.
+ * @throws {Error} If required config values (e.g. API URL) are missing.
  *
  * @example
  * ```typescript
@@ -2628,8 +2629,8 @@ function _unsupported_iterable_to_array$1(o, minLen) {
  * Reads Zoho Accounts (OAuth) settings scoped to the Sign service from
  * the NestJS ConfigService and returns an accounts service config.
  *
- * @param configService - NestJS config service populated with Zoho OAuth environment variables
- * @returns Zoho Accounts service config scoped to the Sign service access token
+ * @param configService - NestJS config service populated with Zoho OAuth environment variables.
+ * @returns Zoho Accounts service config scoped to the Sign service access token.
  *
  * @example
  * ```typescript
@@ -2659,14 +2660,10 @@ function _unsupported_iterable_to_array$1(o, minLen) {
  * exports {@link ZohoSignApi} by default. Additional imports, exports, and providers
  * from the config are merged in.
  *
- * @param config - Module configuration with optional dependency module and extra metadata
+ * @param config - Module configuration with optional dependency module and extra metadata.
  * @returns Complete NestJS module metadata ready to pass to `@Module()`
  *
- * @example
- * ```typescript
- * const cacheService = fileZohoAccountsAccessTokenCacheService();
- *
- * @Module({
+ * @Module ({
  *   providers: [
  *     {
  *       provide: ZohoAccountsAccessTokenCacheService,
@@ -2676,10 +2673,13 @@ function _unsupported_iterable_to_array$1(o, minLen) {
  *   exports: [ZohoAccountsAccessTokenCacheService]
  * })
  * export class ZohoSignDependencyModule {}
- *
- * @Module(appZohoSignModuleMetadata({ dependencyModule: ZohoSignDependencyModule }))
+ * @Module (appZohoSignModuleMetadata({ dependencyModule: ZohoSignDependencyModule }))
  * export class AppZohoSignModule {}
  * ```
+ *
+ * @example
+ * ```typescript
+ * const cacheService = fileZohoAccountsAccessTokenCacheService();
  */ function appZohoSignModuleMetadata(config) {
     var dependencyModule = config.dependencyModule, imports = config.imports, exports = config.exports, providers = config.providers;
     var dependencyModuleImport = dependencyModule ? [
@@ -2764,8 +2764,8 @@ function _object_spread_props$1(target, source) {
 /**
  * Creates a {@link ZohoSignWebhookEvent} from a raw payload.
  *
- * @param payload - the raw Zoho Sign webhook payload to convert
- * @returns a webhook event with the operation type extracted for convenience
+ * @param payload - The raw Zoho Sign webhook payload to convert.
+ * @returns A webhook event with the operation type extracted for convenience.
  */ function zohoSignWebhookEvent(payload) {
     return _object_spread_props$1(_object_spread$1({}, payload), {
         operationType: payload.notifications.operation_type
@@ -2984,8 +2984,8 @@ function _ts_generator$2(thisArg, body) {
  * in the `X-ZS-WEBHOOK-SIGNATURE` header. This verifier recomputes the signature
  * from the raw request body and compares using timing-safe equality.
  *
- * @param config - Configuration containing the webhook secret key
- * @returns A function that verifies webhook requests
+ * @param config - Configuration containing the webhook secret key.
+ * @returns Verifies webhook requests.
  *
  * @example
  * ```typescript
@@ -3000,53 +3000,45 @@ function _ts_generator$2(thisArg, body) {
     var secret = config.secret;
     return function(request, rawBody) {
         return _async_to_generator$2(function() {
-            var receivedSignature, payloadString, computedSignature, valid, receivedBuffer, computedBuffer, event, payload;
+            var receivedSignature, result, payloadString, computedSignature, valid, receivedBuffer, computedBuffer, event, payload;
             return _ts_generator$2(this, function(_state) {
                 receivedSignature = request.headers[ZOHO_SIGN_WEBHOOK_SIGNATURE_HEADER];
-                if (!receivedSignature) {
-                    return [
-                        2,
-                        {
-                            valid: false
-                        }
-                    ];
-                }
-                payloadString = rawBody.toString('utf-8');
-                // Compute HMAC-SHA256 and base64 encode
-                computedSignature = createHmac('sha256', secret).update(payloadString, 'utf-8').digest('base64');
-                // Use timing-safe comparison
-                valid = false;
-                try {
-                    receivedBuffer = Buffer.from(receivedSignature, 'base64');
-                    computedBuffer = Buffer.from(computedSignature, 'base64');
-                    if (receivedBuffer.length === computedBuffer.length) {
-                        valid = timingSafeEqual(receivedBuffer, computedBuffer);
-                    }
-                } catch (unused) {
+                result = {
+                    valid: false
+                };
+                if (receivedSignature) {
+                    payloadString = rawBody.toString('utf-8');
+                    // Compute HMAC-SHA256 and base64 encode
+                    computedSignature = createHmac('sha256', secret).update(payloadString, 'utf-8').digest('base64');
+                    // Use timing-safe comparison
                     valid = false;
-                }
-                if (valid) {
                     try {
-                        payload = JSON.parse(payloadString);
-                        event = zohoSignWebhookEvent(payload);
+                        receivedBuffer = Buffer.from(receivedSignature, 'base64');
+                        computedBuffer = Buffer.from(computedSignature, 'base64');
+                        if (receivedBuffer.length === computedBuffer.length) {
+                            valid = timingSafeEqual(receivedBuffer, computedBuffer);
+                        }
                     } catch (unused) {
                         valid = false;
                     }
-                }
-                if (valid && event) {
-                    return [
-                        2,
-                        {
+                    if (valid) {
+                        try {
+                            payload = JSON.parse(payloadString);
+                            event = zohoSignWebhookEvent(payload);
+                        } catch (unused) {
+                            valid = false;
+                        }
+                    }
+                    if (valid && event) {
+                        result = {
                             valid: true,
                             event: event
-                        }
-                    ];
+                        };
+                    }
                 }
                 return [
                     2,
-                    {
-                        valid: false
-                    }
+                    result
                 ];
             });
         })();
@@ -3509,9 +3501,9 @@ function _class_call_check$2(instance, Constructor) {
  * Reads the Zoho Sign webhook secret from the NestJS ConfigService
  * and returns a validated webhook service config.
  *
- * @param configService - NestJS config service populated with webhook environment variables
- * @returns Validated Zoho Sign webhook service configuration
- * @throws {Error} If the webhook secret is not configured
+ * @param configService - NestJS config service populated with webhook environment variables.
+ * @returns Validated Zoho Sign webhook service configuration.
+ * @throws {Error} If the webhook secret is not configured.
  */ function zohoSignWebhookServiceConfigFactory(configService) {
     var config = {
         zohoSignWebhook: {
@@ -3600,7 +3592,8 @@ function _define_property$1(obj, key, value) {
             value: /**
      * Validates that the required Zoho Desk connection fields are present and well-formed.
      *
-     * @param config - the Desk service config to validate
+     * @param config - The Desk service config to validate.
+     * @throws {Error} When `config.zohoDesk.orgId` is missing or fails the shared Zoho config assertion.
      */ function assertValidConfig(config) {
                 assertValidZohoConfig(config.zohoDesk);
                 if (!config.zohoDesk.orgId) {
@@ -3703,7 +3696,7 @@ function _object_spread_props(target, source) {
             get: /**
      * The authenticated Desk context used by all operation accessors.
      *
-     * @returns the Desk context from the underlying client
+     * @returns The Desk context from the underlying client.
      */ function get() {
                 return this.zohoDesk.deskContext;
             }
@@ -3713,7 +3706,7 @@ function _object_spread_props(target, source) {
             get: /**
      * Rate limiter shared across all Desk requests to respect Zoho API quotas.
      *
-     * @returns the shared rate limiter instance
+     * @returns The shared rate limiter instance.
      */ function get() {
                 return this.zohoDesk.deskContext.zohoRateLimiter;
             }
@@ -3724,7 +3717,7 @@ function _object_spread_props(target, source) {
             /**
      * Configured pass-through for {@link zohoDeskGetTickets}.
      *
-     * @returns a function that lists Desk tickets matching the supplied filter/pagination input
+     * @returns Lists Desk tickets matching the supplied filter/pagination input.
      */ function get() {
                 return zohoDeskGetTickets(this.deskContext);
             }
@@ -3734,7 +3727,7 @@ function _object_spread_props(target, source) {
             get: /**
      * Configured pass-through for {@link zohoDeskGetTicketById}.
      *
-     * @returns a function that fetches a single Desk ticket by its identifier
+     * @returns Fetches a single Desk ticket by its identifier.
      */ function get() {
                 return zohoDeskGetTicketById(this.deskContext);
             }
@@ -3744,7 +3737,7 @@ function _object_spread_props(target, source) {
             get: /**
      * Configured pass-through for {@link zohoDeskSearchTickets}.
      *
-     * @returns a function that runs a Desk ticket search with the provided criteria
+     * @returns Runs a Desk ticket search with the provided criteria.
      */ function get() {
                 return zohoDeskSearchTickets(this.deskContext);
             }
@@ -3754,7 +3747,7 @@ function _object_spread_props(target, source) {
             get: /**
      * Configured pass-through for {@link zohoDeskGetTicketsForContact}.
      *
-     * @returns a function that lists Desk tickets associated with the given contact id
+     * @returns Lists Desk tickets associated with the given contact id.
      */ function get() {
                 return zohoDeskGetTicketsForContact(this.deskContext);
             }
@@ -3764,7 +3757,7 @@ function _object_spread_props(target, source) {
             get: /**
      * Configured pass-through for {@link zohoDeskGetTicketsForProduct}.
      *
-     * @returns a function that lists Desk tickets associated with the given product id
+     * @returns Lists Desk tickets associated with the given product id.
      */ function get() {
                 return zohoDeskGetTicketsForProduct(this.deskContext);
             }
@@ -3774,7 +3767,7 @@ function _object_spread_props(target, source) {
             get: /**
      * Configured pass-through for {@link zohoDeskGetTicketMetrics}.
      *
-     * @returns a function that fetches aggregated metrics for the requested Desk tickets
+     * @returns Fetches aggregated metrics for the requested Desk tickets.
      */ function get() {
                 return zohoDeskGetTicketMetrics(this.deskContext);
             }
@@ -3784,7 +3777,7 @@ function _object_spread_props(target, source) {
             get: /**
      * Configured pass-through for {@link zohoDeskGetAgentsTicketsCount}.
      *
-     * @returns a function that returns ticket counts grouped by agent for the requested filter
+     * @returns Returns ticket counts grouped by agent for the requested filter.
      */ function get() {
                 return zohoDeskGetAgentsTicketsCount(this.deskContext);
             }
@@ -3794,7 +3787,7 @@ function _object_spread_props(target, source) {
             get: /**
      * Configured pass-through for {@link zohoDeskGetTicketsPageFactory}.
      *
-     * @returns a paged result factory for iterating over Desk ticket list responses
+     * @returns A paged result factory for iterating over Desk ticket list responses.
      */ function get() {
                 return zohoDeskGetTicketsPageFactory(this.deskContext);
             }
@@ -3804,7 +3797,7 @@ function _object_spread_props(target, source) {
             get: /**
      * Configured pass-through for {@link zohoDeskSearchTicketsPageFactory}.
      *
-     * @returns a paged result factory for iterating over Desk ticket search responses
+     * @returns A paged result factory for iterating over Desk ticket search responses.
      */ function get() {
                 return zohoDeskSearchTicketsPageFactory(this.deskContext);
             }
@@ -3815,7 +3808,7 @@ function _object_spread_props(target, source) {
             /**
      * Configured pass-through for {@link zohoDeskGetDepartments}.
      *
-     * @returns a function that lists Desk departments visible to the authenticated portal
+     * @returns Lists Desk departments visible to the authenticated portal.
      */ function get() {
                 return zohoDeskGetDepartments(this.deskContext);
             }
@@ -3825,7 +3818,7 @@ function _object_spread_props(target, source) {
             get: /**
      * Configured pass-through for {@link zohoDeskGetDepartmentById}.
      *
-     * @returns a function that fetches a single Desk department by its identifier
+     * @returns Fetches a single Desk department by its identifier.
      */ function get() {
                 return zohoDeskGetDepartmentById(this.deskContext);
             }
@@ -3836,7 +3829,7 @@ function _object_spread_props(target, source) {
             /**
      * Configured pass-through for {@link zohoDeskGetContacts}.
      *
-     * @returns a function that lists Desk contacts matching the supplied filter/pagination input
+     * @returns Lists Desk contacts matching the supplied filter/pagination input.
      */ function get() {
                 return zohoDeskGetContacts(this.deskContext);
             }
@@ -3846,7 +3839,7 @@ function _object_spread_props(target, source) {
             get: /**
      * Configured pass-through for {@link zohoDeskGetContactById}.
      *
-     * @returns a function that fetches a single Desk contact by its identifier
+     * @returns Fetches a single Desk contact by its identifier.
      */ function get() {
                 return zohoDeskGetContactById(this.deskContext);
             }
@@ -3856,7 +3849,7 @@ function _object_spread_props(target, source) {
             get: /**
      * Configured pass-through for {@link zohoDeskGetContactsByIds}.
      *
-     * @returns a function that fetches multiple Desk contacts in a single request by their identifiers
+     * @returns Fetches multiple Desk contacts in a single request by their identifiers.
      */ function get() {
                 return zohoDeskGetContactsByIds(this.deskContext);
             }
@@ -3866,7 +3859,7 @@ function _object_spread_props(target, source) {
             get: /**
      * Configured pass-through for {@link zohoDeskGetContactsPageFactory}.
      *
-     * @returns a paged result factory for iterating over Desk contact list responses
+     * @returns A paged result factory for iterating over Desk contact list responses.
      */ function get() {
                 return zohoDeskGetContactsPageFactory(this.deskContext);
             }
@@ -3877,7 +3870,7 @@ function _object_spread_props(target, source) {
             /**
      * Configured pass-through for {@link zohoDeskGetTicketTags}.
      *
-     * @returns a function that lists the tags currently associated with a given Desk ticket
+     * @returns Lists the tags currently associated with a given Desk ticket.
      */ function get() {
                 return zohoDeskGetTicketTags(this.deskContext);
             }
@@ -3887,7 +3880,7 @@ function _object_spread_props(target, source) {
             get: /**
      * Configured pass-through for {@link zohoDeskAssociateTicketTags}.
      *
-     * @returns a function that associates one or more tags with a Desk ticket
+     * @returns Associates one or more tags with a Desk ticket.
      */ function get() {
                 return zohoDeskAssociateTicketTags(this.deskContext);
             }
@@ -3897,7 +3890,7 @@ function _object_spread_props(target, source) {
             get: /**
      * Configured pass-through for {@link zohoDeskDissociateTicketTag}.
      *
-     * @returns a function that removes a single tag association from a Desk ticket
+     * @returns Removes a single tag association from a Desk ticket.
      */ function get() {
                 return zohoDeskDissociateTicketTag(this.deskContext);
             }
@@ -3907,7 +3900,7 @@ function _object_spread_props(target, source) {
             get: /**
      * Configured pass-through for {@link zohoDeskSearchTags}.
      *
-     * @returns a function that searches the Desk tag catalog by the supplied criteria
+     * @returns Searches the Desk tag catalog by the supplied criteria.
      */ function get() {
                 return zohoDeskSearchTags(this.deskContext);
             }
@@ -3917,7 +3910,7 @@ function _object_spread_props(target, source) {
             get: /**
      * Configured pass-through for {@link zohoDeskGetAllTags}.
      *
-     * @returns a function that lists every tag defined on the Desk portal
+     * @returns Lists every tag defined on the Desk portal.
      */ function get() {
                 return zohoDeskGetAllTags(this.deskContext);
             }
@@ -3928,7 +3921,7 @@ function _object_spread_props(target, source) {
             /**
      * Configured pass-through for {@link zohoDeskGetTicketFollowers}.
      *
-     * @returns a function that lists the agents following a given Desk ticket
+     * @returns Lists the agents following a given Desk ticket.
      */ function get() {
                 return zohoDeskGetTicketFollowers(this.deskContext);
             }
@@ -3938,7 +3931,7 @@ function _object_spread_props(target, source) {
             get: /**
      * Configured pass-through for {@link zohoDeskAddTicketFollowers}.
      *
-     * @returns a function that adds one or more agents as followers of a Desk ticket
+     * @returns Adds one or more agents as followers of a Desk ticket.
      */ function get() {
                 return zohoDeskAddTicketFollowers(this.deskContext);
             }
@@ -3948,7 +3941,7 @@ function _object_spread_props(target, source) {
             get: /**
      * Configured pass-through for {@link zohoDeskRemoveTicketFollowers}.
      *
-     * @returns a function that removes one or more agents from a Desk ticket's follower list
+     * @returns Removes one or more agents from a Desk ticket's follower list.
      */ function get() {
                 return zohoDeskRemoveTicketFollowers(this.deskContext);
             }
@@ -3959,7 +3952,7 @@ function _object_spread_props(target, source) {
             /**
      * Configured pass-through for {@link zohoDeskGetTicketAttachments}.
      *
-     * @returns a function that lists the file attachments on a given Desk ticket
+     * @returns Lists the file attachments on a given Desk ticket.
      */ function get() {
                 return zohoDeskGetTicketAttachments(this.deskContext);
             }
@@ -3969,7 +3962,7 @@ function _object_spread_props(target, source) {
             get: /**
      * Configured pass-through for {@link zohoDeskDeleteTicketAttachment}.
      *
-     * @returns a function that deletes a single attachment from a Desk ticket by attachment id
+     * @returns Deletes a single attachment from a Desk ticket by attachment id.
      */ function get() {
                 return zohoDeskDeleteTicketAttachment(this.deskContext);
             }
@@ -3980,7 +3973,7 @@ function _object_spread_props(target, source) {
             /**
      * Configured pass-through for {@link zohoDeskGetTicketComments}.
      *
-     * @returns a function that lists the comments on a given Desk ticket
+     * @returns Lists the comments on a given Desk ticket.
      */ function get() {
                 return zohoDeskGetTicketComments(this.deskContext);
             }
@@ -3990,7 +3983,7 @@ function _object_spread_props(target, source) {
             get: /**
      * Configured pass-through for {@link zohoDeskGetTicketCommentById}.
      *
-     * @returns a function that fetches a single comment on a Desk ticket by comment id
+     * @returns Fetches a single comment on a Desk ticket by comment id.
      */ function get() {
                 return zohoDeskGetTicketCommentById(this.deskContext);
             }
@@ -4000,7 +3993,7 @@ function _object_spread_props(target, source) {
             get: /**
      * Configured pass-through for {@link zohoDeskCreateTicketComment}.
      *
-     * @returns a function that creates a new comment on a Desk ticket from the supplied body
+     * @returns Creates a new comment on a Desk ticket from the supplied body.
      */ function get() {
                 return zohoDeskCreateTicketComment(this.deskContext);
             }
@@ -4010,7 +4003,7 @@ function _object_spread_props(target, source) {
             get: /**
      * Configured pass-through for {@link zohoDeskDeleteTicketComment}.
      *
-     * @returns a function that deletes a single comment from a Desk ticket by comment id
+     * @returns Deletes a single comment from a Desk ticket by comment id.
      */ function get() {
                 return zohoDeskDeleteTicketComment(this.deskContext);
             }
@@ -4021,7 +4014,7 @@ function _object_spread_props(target, source) {
             /**
      * Configured pass-through for {@link zohoDeskGetTicketTimer}.
      *
-     * @returns a function that fetches the current timer state for a Desk ticket
+     * @returns Fetches the current timer state for a Desk ticket.
      */ function get() {
                 return zohoDeskGetTicketTimer(this.deskContext);
             }
@@ -4031,7 +4024,7 @@ function _object_spread_props(target, source) {
             get: /**
      * Configured pass-through for {@link zohoDeskPerformTicketTimerAction}.
      *
-     * @returns a function that performs a timer action (start/pause/stop) on a Desk ticket
+     * @returns Performs a timer action (start/pause/stop) on a Desk ticket.
      */ function get() {
                 return zohoDeskPerformTicketTimerAction(this.deskContext);
             }
@@ -4041,7 +4034,7 @@ function _object_spread_props(target, source) {
             get: /**
      * Configured pass-through for {@link zohoDeskGetTicketTimeEntries}.
      *
-     * @returns a function that lists the time entries logged against a Desk ticket
+     * @returns Lists the time entries logged against a Desk ticket.
      */ function get() {
                 return zohoDeskGetTicketTimeEntries(this.deskContext);
             }
@@ -4051,7 +4044,7 @@ function _object_spread_props(target, source) {
             get: /**
      * Configured pass-through for {@link zohoDeskGetTicketTimeEntryById}.
      *
-     * @returns a function that fetches a single time entry on a Desk ticket by entry id
+     * @returns Fetches a single time entry on a Desk ticket by entry id.
      */ function get() {
                 return zohoDeskGetTicketTimeEntryById(this.deskContext);
             }
@@ -4061,7 +4054,7 @@ function _object_spread_props(target, source) {
             get: /**
      * Configured pass-through for {@link zohoDeskGetTicketTimeEntrySummation}.
      *
-     * @returns a function that fetches the aggregated time-entry totals for a Desk ticket
+     * @returns Fetches the aggregated time-entry totals for a Desk ticket.
      */ function get() {
                 return zohoDeskGetTicketTimeEntrySummation(this.deskContext);
             }
@@ -4072,7 +4065,7 @@ function _object_spread_props(target, source) {
             /**
      * Configured pass-through for {@link zohoDeskGetTicketThreads}.
      *
-     * @returns a function that lists the conversation threads on a given Desk ticket
+     * @returns Lists the conversation threads on a given Desk ticket.
      */ function get() {
                 return zohoDeskGetTicketThreads(this.deskContext);
             }
@@ -4082,7 +4075,7 @@ function _object_spread_props(target, source) {
             get: /**
      * Configured pass-through for {@link zohoDeskGetTicketThreadById}.
      *
-     * @returns a function that fetches a single thread on a Desk ticket by thread id
+     * @returns Fetches a single thread on a Desk ticket by thread id.
      */ function get() {
                 return zohoDeskGetTicketThreadById(this.deskContext);
             }
@@ -4092,7 +4085,7 @@ function _object_spread_props(target, source) {
             get: /**
      * Configured pass-through for {@link zohoDeskGetTicketThreadsPageFactory}.
      *
-     * @returns a paged result factory for iterating over Desk ticket thread responses
+     * @returns A paged result factory for iterating over Desk ticket thread responses.
      */ function get() {
                 return zohoDeskGetTicketThreadsPageFactory(this.deskContext);
             }
@@ -4103,7 +4096,7 @@ function _object_spread_props(target, source) {
             /**
      * Configured pass-through for {@link zohoDeskGetTicketActivities}.
      *
-     * @returns a function that lists the activity log entries for a given Desk ticket
+     * @returns Lists the activity log entries for a given Desk ticket.
      */ function get() {
                 return zohoDeskGetTicketActivities(this.deskContext);
             }
@@ -4113,7 +4106,7 @@ function _object_spread_props(target, source) {
             get: /**
      * Configured pass-through for {@link zohoDeskGetTicketActivitiesPageFactory}.
      *
-     * @returns a paged result factory for iterating over Desk ticket activity responses
+     * @returns A paged result factory for iterating over Desk ticket activity responses.
      */ function get() {
                 return zohoDeskGetTicketActivitiesPageFactory(this.deskContext);
             }
@@ -4124,7 +4117,7 @@ function _object_spread_props(target, source) {
             /**
      * Configured pass-through for {@link zohoDeskGetAgents}.
      *
-     * @returns a function that lists Desk agents matching the supplied filter/pagination input
+     * @returns Lists Desk agents matching the supplied filter/pagination input.
      */ function get() {
                 return zohoDeskGetAgents(this.deskContext);
             }
@@ -4134,7 +4127,7 @@ function _object_spread_props(target, source) {
             get: /**
      * Configured pass-through for {@link zohoDeskGetAgentById}.
      *
-     * @returns a function that fetches a single Desk agent by agent id
+     * @returns Fetches a single Desk agent by agent id.
      */ function get() {
                 return zohoDeskGetAgentById(this.deskContext);
             }
@@ -4144,7 +4137,7 @@ function _object_spread_props(target, source) {
             get: /**
      * Configured pass-through for {@link zohoDeskGetAgentsByIds}.
      *
-     * @returns a function that fetches multiple Desk agents in a single request by their identifiers
+     * @returns Fetches multiple Desk agents in a single request by their identifiers.
      */ function get() {
                 return zohoDeskGetAgentsByIds(this.deskContext);
             }
@@ -4154,7 +4147,7 @@ function _object_spread_props(target, source) {
             get: /**
      * Configured pass-through for {@link zohoDeskGetMyInfo}.
      *
-     * @returns a function that fetches the profile information for the currently authenticated agent
+     * @returns Fetches the profile information for the currently authenticated agent.
      */ function get() {
                 return zohoDeskGetMyInfo(this.deskContext);
             }
@@ -4164,7 +4157,7 @@ function _object_spread_props(target, source) {
             get: /**
      * Configured pass-through for {@link zohoDeskGetAgentsPageFactory}.
      *
-     * @returns a paged result factory for iterating over Desk agent list responses
+     * @returns A paged result factory for iterating over Desk agent list responses.
      */ function get() {
                 return zohoDeskGetAgentsPageFactory(this.deskContext);
             }
@@ -4216,9 +4209,9 @@ function _unsupported_iterable_to_array(o, minLen) {
  * `ZOHO_DESK_API_URL` (service-specific) or `ZOHO_API_URL` (shared fallback).
  * The organization ID is read from `ZOHO_DESK_ORG_ID` or `ZOHO_ORG_ID`.
  *
- * @param configService - NestJS config service populated with Zoho environment variables
- * @returns Validated Zoho Desk service configuration
- * @throws {Error} If required config values (API URL or orgId) are missing
+ * @param configService - NestJS config service populated with Zoho environment variables.
+ * @returns Validated Zoho Desk service configuration.
+ * @throws {Error} If required config values (API URL or orgId) are missing.
  */ function zohoDeskServiceConfigFactory(configService) {
     var getFromConfigService = zohoConfigServiceReaderFunction(ZOHO_DESK_SERVICE_NAME, configService);
     var config = {
@@ -4234,8 +4227,8 @@ function _unsupported_iterable_to_array(o, minLen) {
  * Reads Zoho Accounts (OAuth) settings scoped to the Desk service from
  * the NestJS ConfigService and returns an accounts service config.
  *
- * @param configService - NestJS config service populated with Zoho OAuth environment variables
- * @returns Zoho Accounts service config scoped to the Desk service access token
+ * @param configService - NestJS config service populated with Zoho OAuth environment variables.
+ * @returns Zoho Accounts service config scoped to the Desk service access token.
  */ function zohoDeskAccountServiceConfigFactory(configService) {
     return zohoAccountsServiceConfigFromConfigService({
         configService: configService,
@@ -4256,7 +4249,7 @@ function _unsupported_iterable_to_array(o, minLen) {
  * exports {@link ZohoDeskApi} by default. Additional imports, exports, and providers
  * from the config are merged in.
  *
- * @param config - Module configuration with optional dependency module and extra metadata
+ * @param config - Module configuration with optional dependency module and extra metadata.
  * @returns Complete NestJS module metadata ready to pass to `@Module()`
  */ function appZohoDeskModuleMetadata(config) {
     var dependencyModule = config.dependencyModule, imports = config.imports, exports = config.exports, providers = config.providers;