@dereekb/zoho 13.11.14 → 13.11.15

package/nestjs/index.cjs.js

@@ -73,7 +73,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.");
@@ -165,7 +166,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);
@@ -486,7 +487,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) {
@@ -506,10 +507,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;
@@ -589,9 +590,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) {
@@ -708,18 +709,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.
@@ -729,9 +733,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 = nestjs.createJsonFileAsyncKeyedValueCache({
@@ -822,7 +826,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:
@@ -833,31 +837,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,
@@ -1112,7 +1115,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);
             }
@@ -1212,7 +1215,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;
             }
@@ -1222,7 +1225,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;
             }
@@ -1233,7 +1236,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 zoho.zohoCrmInsertRecord(this.crmContext);
             }
@@ -1243,7 +1246,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 zoho.zohoCrmUpsertRecord(this.crmContext);
             }
@@ -1253,7 +1256,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 zoho.zohoCrmUpdateRecord(this.crmContext);
             }
@@ -1263,7 +1266,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 zoho.zohoCrmDeleteRecord(this.crmContext);
             }
@@ -1273,7 +1276,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 zoho.zohoCrmGetRecordById(this.crmContext);
             }
@@ -1283,7 +1286,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 zoho.zohoCrmGetRecords(this.crmContext);
             }
@@ -1293,7 +1296,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 zoho.zohoCrmSearchRecords(this.crmContext);
             }
@@ -1303,7 +1306,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 zoho.zohoCrmSearchRecordsPageFactory(this.crmContext);
             }
@@ -1313,7 +1316,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 zoho.zohoCrmGetRelatedRecordsFunctionFactory(this.crmContext);
             }
@@ -1323,7 +1326,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 zoho.zohoCrmGetEmailsForRecord(this.crmContext);
             }
@@ -1333,7 +1336,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 zoho.zohoCrmGetEmailsForRecordPageFactory(this.crmContext);
             }
@@ -1343,7 +1346,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 zoho.zohoCrmGetAttachmentsForRecord(this.crmContext);
             }
@@ -1353,7 +1356,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 zoho.zohoCrmGetAttachmentsForRecordPageFactory(this.crmContext);
             }
@@ -1363,7 +1366,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 zoho.zohoCrmUploadAttachmentForRecord(this.crmContext);
             }
@@ -1373,7 +1376,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 zoho.zohoCrmDownloadAttachmentForRecord(this.crmContext);
             }
@@ -1383,7 +1386,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 zoho.zohoCrmDeleteAttachmentFromRecord(this.crmContext);
             }
@@ -1393,7 +1396,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 zoho.zohoCrmCreateNotes(this.crmContext);
             }
@@ -1403,7 +1406,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 zoho.zohoCrmDeleteNotes(this.crmContext);
             }
@@ -1413,7 +1416,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 zoho.zohoCrmCreateNotesForRecord(this.crmContext);
             }
@@ -1423,7 +1426,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 zoho.zohoCrmGetNotesForRecord(this.crmContext);
             }
@@ -1433,7 +1436,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 zoho.zohoCrmGetNotesForRecordPageFactory(this.crmContext);
             }
@@ -1443,7 +1446,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 zoho.zohoCrmExecuteRestApiFunction(this.crmContext);
             }
@@ -1453,7 +1456,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 zoho.zohoCrmCreateTagsForModule(this.crmContext);
             }
@@ -1463,7 +1466,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 zoho.zohoCrmDeleteTag(this.crmContext);
             }
@@ -1473,7 +1476,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 zoho.zohoCrmGetTagsForModule(this.crmContext);
             }
@@ -1483,7 +1486,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 zoho.zohoCrmAddTagsToRecords(this.crmContext);
             }
@@ -1493,7 +1496,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 zoho.zohoCrmRemoveTagsFromRecords(this.crmContext);
             }
@@ -1540,9 +1543,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
@@ -1566,8 +1569,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
@@ -1597,14 +1600,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,
@@ -1614,10 +1613,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$1) {
     var dependencyModule = config$1.dependencyModule, imports = config$1.imports, exports$1 = config$1.exports, providers = config$1.providers;
     var dependencyModuleImport = dependencyModule ? [
@@ -1704,7 +1706,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);
             }
@@ -1804,7 +1806,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;
             }
@@ -1814,7 +1816,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;
             }
@@ -1825,7 +1827,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 zoho.zohoRecruitInsertRecord(this.recruitContext);
             }
@@ -1835,7 +1837,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 zoho.zohoRecruitUpsertRecord(this.recruitContext);
             }
@@ -1845,7 +1847,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 zoho.zohoRecruitUpdateRecord(this.recruitContext);
             }
@@ -1855,7 +1857,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 zoho.zohoRecruitDeleteRecord(this.recruitContext);
             }
@@ -1865,7 +1867,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 zoho.zohoRecruitGetRecordById(this.recruitContext);
             }
@@ -1875,7 +1877,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 zoho.zohoRecruitGetRecords(this.recruitContext);
             }
@@ -1885,7 +1887,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 zoho.zohoRecruitSearchRecords(this.recruitContext);
             }
@@ -1895,7 +1897,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 zoho.zohoRecruitSearchRecordsPageFactory(this.recruitContext);
             }
@@ -1905,7 +1907,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 zoho.zohoRecruitGetRelatedRecordsFunctionFactory(this.recruitContext);
             }
@@ -1915,7 +1917,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 zoho.zohoRecruitGetEmailsForRecord(this.recruitContext);
             }
@@ -1925,7 +1927,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 zoho.zohoRecruitGetEmailsForRecordPageFactory(this.recruitContext);
             }
@@ -1935,7 +1937,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 zoho.zohoRecruitGetAttachmentsForRecord(this.recruitContext);
             }
@@ -1945,7 +1947,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 zoho.zohoRecruitGetAttachmentsForRecordPageFactory(this.recruitContext);
             }
@@ -1955,7 +1957,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 zoho.zohoRecruitUploadAttachmentForRecord(this.recruitContext);
             }
@@ -1965,7 +1967,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 zoho.zohoRecruitDownloadAttachmentForRecord(this.recruitContext);
             }
@@ -1975,7 +1977,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 zoho.zohoRecruitDeleteAttachmentFromRecord(this.recruitContext);
             }
@@ -1985,7 +1987,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 zoho.zohoRecruitCreateNotes(this.recruitContext);
             }
@@ -1995,7 +1997,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 zoho.zohoRecruitDeleteNotes(this.recruitContext);
             }
@@ -2005,7 +2007,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 zoho.zohoRecruitCreateNotesForRecord(this.recruitContext);
             }
@@ -2015,7 +2017,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 zoho.zohoRecruitGetNotesForRecord(this.recruitContext);
             }
@@ -2025,7 +2027,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 zoho.zohoRecruitGetNotesForRecordPageFactory(this.recruitContext);
             }
@@ -2035,7 +2037,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 zoho.zohoRecruitExecuteRestApiFunction(this.recruitContext);
             }
@@ -2045,7 +2047,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 zoho.zohoRecruitAssociateCandidateRecordsWithJobOpenings(this.recruitContext);
             }
@@ -2055,7 +2057,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 zoho.zohoRecruitSearchCandidateAssociatedJobOpeningRecords(this.recruitContext);
             }
@@ -2065,7 +2067,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 zoho.zohoRecruitSearchCandidateAssociatedJobOpeningRecordsPageFactory(this.recruitContext);
             }
@@ -2075,7 +2077,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 zoho.zohoRecruitSearchJobOpeningAssociatedCandidateRecords(this.recruitContext);
             }
@@ -2085,7 +2087,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 zoho.zohoRecruitSearchJobOpeningAssociatedCandidateRecordsPageFactory(this.recruitContext);
             }
@@ -2095,7 +2097,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 zoho.zohoRecruitCreateTagsForModule(this.recruitContext);
             }
@@ -2105,7 +2107,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 zoho.zohoRecruitGetTagsForModule(this.recruitContext);
             }
@@ -2115,7 +2117,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 zoho.zohoRecruitAddTagsToRecords(this.recruitContext);
             }
@@ -2125,7 +2127,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 zoho.zohoRecruitRemoveTagsFromRecords(this.recruitContext);
             }
@@ -2172,9 +2174,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
@@ -2198,8 +2200,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
@@ -2229,14 +2231,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,
@@ -2246,10 +2244,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$1) {
     var dependencyModule = config$1.dependencyModule, imports = config$1.imports, exports$1 = config$1.exports, providers = config$1.providers;
     var dependencyModuleImport = dependencyModule ? [
@@ -2425,7 +2426,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;
             }
@@ -2435,7 +2436,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;
             }
@@ -2446,7 +2447,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 zoho.zohoSignGetDocument(this.signContext);
             }
@@ -2456,7 +2457,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 zoho.zohoSignGetDocuments(this.signContext);
             }
@@ -2466,7 +2467,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 zoho.zohoSignGetDocumentsPageFactory(this.signContext);
             }
@@ -2476,7 +2477,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 zoho.zohoSignGetDocumentFormData(this.signContext);
             }
@@ -2486,7 +2487,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 zoho.zohoSignRetrieveFieldTypes(this.signContext);
             }
@@ -2496,7 +2497,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 zoho.zohoSignDownloadPdf(this.signContext);
             }
@@ -2506,7 +2507,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 zoho.zohoSignDownloadCompletionCertificate(this.signContext);
             }
@@ -2516,7 +2517,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 zoho.zohoSignCreateDocument(this.signContext);
             }
@@ -2526,7 +2527,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 zoho.zohoSignUpdateDocument(this.signContext);
             }
@@ -2536,7 +2537,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 zoho.zohoSignSendDocumentForSignature(this.signContext);
             }
@@ -2546,7 +2547,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 zoho.zohoSignExtendDocument(this.signContext);
             }
@@ -2556,7 +2557,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 zoho.zohoSignDeleteDocument(this.signContext);
             }
@@ -2603,9 +2604,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
@@ -2630,8 +2631,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
@@ -2661,14 +2662,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,
@@ -2678,10 +2675,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$1) {
     var dependencyModule = config$1.dependencyModule, imports = config$1.imports, exports$1 = config$1.exports, providers = config$1.providers;
     var dependencyModuleImport = dependencyModule ? [
@@ -2766,8 +2766,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
@@ -2986,8 +2986,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
@@ -3002,53 +3002,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 = node_crypto.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 = node_crypto.timingSafeEqual(receivedBuffer, computedBuffer);
-                    }
-                } catch (unused) {
+                result = {
+                    valid: false
+                };
+                if (receivedSignature) {
+                    payloadString = rawBody.toString('utf-8');
+                    // Compute HMAC-SHA256 and base64 encode
+                    computedSignature = node_crypto.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 = node_crypto.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
                 ];
             });
         })();
@@ -3511,9 +3503,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: {
@@ -3602,7 +3594,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) {
@@ -3705,7 +3698,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;
             }
@@ -3715,7 +3708,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;
             }
@@ -3726,7 +3719,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 zoho.zohoDeskGetTickets(this.deskContext);
             }
@@ -3736,7 +3729,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 zoho.zohoDeskGetTicketById(this.deskContext);
             }
@@ -3746,7 +3739,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 zoho.zohoDeskSearchTickets(this.deskContext);
             }
@@ -3756,7 +3749,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 zoho.zohoDeskGetTicketsForContact(this.deskContext);
             }
@@ -3766,7 +3759,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 zoho.zohoDeskGetTicketsForProduct(this.deskContext);
             }
@@ -3776,7 +3769,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 zoho.zohoDeskGetTicketMetrics(this.deskContext);
             }
@@ -3786,7 +3779,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 zoho.zohoDeskGetAgentsTicketsCount(this.deskContext);
             }
@@ -3796,7 +3789,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 zoho.zohoDeskGetTicketsPageFactory(this.deskContext);
             }
@@ -3806,7 +3799,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 zoho.zohoDeskSearchTicketsPageFactory(this.deskContext);
             }
@@ -3817,7 +3810,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 zoho.zohoDeskGetDepartments(this.deskContext);
             }
@@ -3827,7 +3820,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 zoho.zohoDeskGetDepartmentById(this.deskContext);
             }
@@ -3838,7 +3831,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 zoho.zohoDeskGetContacts(this.deskContext);
             }
@@ -3848,7 +3841,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 zoho.zohoDeskGetContactById(this.deskContext);
             }
@@ -3858,7 +3851,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 zoho.zohoDeskGetContactsByIds(this.deskContext);
             }
@@ -3868,7 +3861,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 zoho.zohoDeskGetContactsPageFactory(this.deskContext);
             }
@@ -3879,7 +3872,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 zoho.zohoDeskGetTicketTags(this.deskContext);
             }
@@ -3889,7 +3882,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 zoho.zohoDeskAssociateTicketTags(this.deskContext);
             }
@@ -3899,7 +3892,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 zoho.zohoDeskDissociateTicketTag(this.deskContext);
             }
@@ -3909,7 +3902,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 zoho.zohoDeskSearchTags(this.deskContext);
             }
@@ -3919,7 +3912,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 zoho.zohoDeskGetAllTags(this.deskContext);
             }
@@ -3930,7 +3923,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 zoho.zohoDeskGetTicketFollowers(this.deskContext);
             }
@@ -3940,7 +3933,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 zoho.zohoDeskAddTicketFollowers(this.deskContext);
             }
@@ -3950,7 +3943,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 zoho.zohoDeskRemoveTicketFollowers(this.deskContext);
             }
@@ -3961,7 +3954,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 zoho.zohoDeskGetTicketAttachments(this.deskContext);
             }
@@ -3971,7 +3964,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 zoho.zohoDeskDeleteTicketAttachment(this.deskContext);
             }
@@ -3982,7 +3975,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 zoho.zohoDeskGetTicketComments(this.deskContext);
             }
@@ -3992,7 +3985,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 zoho.zohoDeskGetTicketCommentById(this.deskContext);
             }
@@ -4002,7 +3995,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 zoho.zohoDeskCreateTicketComment(this.deskContext);
             }
@@ -4012,7 +4005,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 zoho.zohoDeskDeleteTicketComment(this.deskContext);
             }
@@ -4023,7 +4016,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 zoho.zohoDeskGetTicketTimer(this.deskContext);
             }
@@ -4033,7 +4026,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 zoho.zohoDeskPerformTicketTimerAction(this.deskContext);
             }
@@ -4043,7 +4036,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 zoho.zohoDeskGetTicketTimeEntries(this.deskContext);
             }
@@ -4053,7 +4046,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 zoho.zohoDeskGetTicketTimeEntryById(this.deskContext);
             }
@@ -4063,7 +4056,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 zoho.zohoDeskGetTicketTimeEntrySummation(this.deskContext);
             }
@@ -4074,7 +4067,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 zoho.zohoDeskGetTicketThreads(this.deskContext);
             }
@@ -4084,7 +4077,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 zoho.zohoDeskGetTicketThreadById(this.deskContext);
             }
@@ -4094,7 +4087,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 zoho.zohoDeskGetTicketThreadsPageFactory(this.deskContext);
             }
@@ -4105,7 +4098,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 zoho.zohoDeskGetTicketActivities(this.deskContext);
             }
@@ -4115,7 +4108,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 zoho.zohoDeskGetTicketActivitiesPageFactory(this.deskContext);
             }
@@ -4126,7 +4119,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 zoho.zohoDeskGetAgents(this.deskContext);
             }
@@ -4136,7 +4129,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 zoho.zohoDeskGetAgentById(this.deskContext);
             }
@@ -4146,7 +4139,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 zoho.zohoDeskGetAgentsByIds(this.deskContext);
             }
@@ -4156,7 +4149,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 zoho.zohoDeskGetMyInfo(this.deskContext);
             }
@@ -4166,7 +4159,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 zoho.zohoDeskGetAgentsPageFactory(this.deskContext);
             }
@@ -4218,9 +4211,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.ZOHO_DESK_SERVICE_NAME, configService);
     var config = {
@@ -4236,8 +4229,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,
@@ -4258,7 +4251,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$1) {
     var dependencyModule = config$1.dependencyModule, imports = config$1.imports, exports$1 = config$1.exports, providers = config$1.providers;