@dereekb/zoho 13.10.9 → 13.11.0

package/nestjs/index.esm.js

@@ -1,19 +1,17 @@
 import { Injectable, Inject, Logger, Post, Req, Controller, Module } from '@nestjs/common';
 import { zohoAccountsFactory, zohoAccountsAccessToken, zohoCrmFactory, zohoCrmInsertRecord, zohoCrmUpsertRecord, zohoCrmUpdateRecord, zohoCrmDeleteRecord, zohoCrmGetRecordById, zohoCrmGetRecords, zohoCrmSearchRecords, zohoCrmSearchRecordsPageFactory, zohoCrmGetRelatedRecordsFunctionFactory, zohoCrmGetEmailsForRecord, zohoCrmGetEmailsForRecordPageFactory, zohoCrmGetAttachmentsForRecord, zohoCrmGetAttachmentsForRecordPageFactory, zohoCrmUploadAttachmentForRecord, zohoCrmDownloadAttachmentForRecord, zohoCrmDeleteAttachmentFromRecord, zohoCrmCreateNotes, zohoCrmDeleteNotes, zohoCrmCreateNotesForRecord, zohoCrmGetNotesForRecord, zohoCrmGetNotesForRecordPageFactory, zohoCrmExecuteRestApiFunction, zohoCrmCreateTagsForModule, zohoCrmDeleteTag, zohoCrmGetTagsForModule, zohoCrmAddTagsToRecords, zohoCrmRemoveTagsFromRecords, ZOHO_CRM_SERVICE_NAME, zohoRecruitFactory, zohoRecruitInsertRecord, zohoRecruitUpsertRecord, zohoRecruitUpdateRecord, zohoRecruitDeleteRecord, zohoRecruitGetRecordById, zohoRecruitGetRecords, zohoRecruitSearchRecords, zohoRecruitSearchRecordsPageFactory, zohoRecruitGetRelatedRecordsFunctionFactory, zohoRecruitGetEmailsForRecord, zohoRecruitGetEmailsForRecordPageFactory, zohoRecruitGetAttachmentsForRecord, zohoRecruitGetAttachmentsForRecordPageFactory, zohoRecruitUploadAttachmentForRecord, zohoRecruitDownloadAttachmentForRecord, zohoRecruitDeleteAttachmentFromRecord, zohoRecruitCreateNotes, zohoRecruitDeleteNotes, zohoRecruitCreateNotesForRecord, zohoRecruitGetNotesForRecord, zohoRecruitGetNotesForRecordPageFactory, zohoRecruitExecuteRestApiFunction, zohoRecruitAssociateCandidateRecordsWithJobOpenings, zohoRecruitSearchCandidateAssociatedJobOpeningRecords, zohoRecruitSearchCandidateAssociatedJobOpeningRecordsPageFactory, zohoRecruitSearchJobOpeningAssociatedCandidateRecords, zohoRecruitSearchJobOpeningAssociatedCandidateRecordsPageFactory, zohoRecruitCreateTagsForModule, zohoRecruitGetTagsForModule, zohoRecruitAddTagsToRecords, zohoRecruitRemoveTagsFromRecords, ZOHO_RECRUIT_SERVICE_NAME, zohoSignFactory, zohoSignGetDocument, zohoSignGetDocuments, zohoSignGetDocumentsPageFactory, zohoSignGetDocumentFormData, zohoSignRetrieveFieldTypes, zohoSignDownloadPdf, zohoSignDownloadCompletionCertificate, zohoSignCreateDocument, zohoSignUpdateDocument, zohoSignSendDocumentForSignature, zohoSignExtendDocument, zohoSignDeleteDocument, ZOHO_SIGN_SERVICE_NAME, zohoDeskFactory, zohoDeskGetTickets, zohoDeskGetTicketById, zohoDeskSearchTickets, zohoDeskGetTicketsForContact, zohoDeskGetTicketsForProduct, zohoDeskGetTicketMetrics, zohoDeskGetAgentsTicketsCount, zohoDeskGetTicketsPageFactory, zohoDeskSearchTicketsPageFactory, zohoDeskGetDepartments, zohoDeskGetDepartmentById, zohoDeskGetContacts, zohoDeskGetContactById, zohoDeskGetContactsByIds, zohoDeskGetContactsPageFactory, zohoDeskGetTicketTags, zohoDeskAssociateTicketTags, zohoDeskDissociateTicketTag, zohoDeskSearchTags, zohoDeskGetAllTags, zohoDeskGetTicketFollowers, zohoDeskAddTicketFollowers, zohoDeskRemoveTicketFollowers, zohoDeskGetTicketAttachments, zohoDeskDeleteTicketAttachment, zohoDeskGetTicketComments, zohoDeskGetTicketCommentById, zohoDeskCreateTicketComment, zohoDeskDeleteTicketComment, zohoDeskGetTicketTimer, zohoDeskPerformTicketTimerAction, zohoDeskGetTicketTimeEntries, zohoDeskGetTicketTimeEntryById, zohoDeskGetTicketTimeEntrySummation, zohoDeskGetTicketThreads, zohoDeskGetTicketThreadById, zohoDeskGetTicketThreadsPageFactory, zohoDeskGetTicketActivities, zohoDeskGetTicketActivitiesPageFactory, zohoDeskGetAgents, zohoDeskGetAgentById, zohoDeskGetAgentsByIds, zohoDeskGetMyInfo, zohoDeskGetAgentsPageFactory, ZOHO_DESK_SERVICE_NAME } from '@dereekb/zoho';
-import { forEachKeyValue, tryWithPromiseFactoriesFunction, isPast, filterMaybeArrayValues, handlerFactory, handlerConfigurerFactory, handlerMappedSetFunctionFactory } from '@dereekb/util';
-import { dirname } from 'node:path';
-import { mkdirSync, readFile, writeFile, rm } from 'node:fs';
+import { memoizeAsyncKeyedValueCache, inMemoryAsyncKeyedValueCache, mergeAsyncValueCaches, isExpired, filterMaybeArrayValues, handlerFactory, handlerConfigurerFactory, handlerMappedSetFunctionFactory } from '@dereekb/util';
+import { createJsonFileAsyncKeyedValueCache, readJsonFile, RawBody } from '@dereekb/nestjs';
 import { ConfigService, ConfigModule } from '@nestjs/config';
-import { RawBody } from '@dereekb/nestjs';
 import { createHmac, timingSafeEqual } from 'node:crypto';
 
-function _type_of(obj) {
+function _type_of$1(obj) {
     "@swc/helpers - typeof";
     return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
 }
 function __decorate(decorators, target, key, desc) {
     var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if ((typeof Reflect === "undefined" ? "undefined" : _type_of(Reflect)) === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    if ((typeof Reflect === "undefined" ? "undefined" : _type_of$1(Reflect)) === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
     else for(var i = decorators.length - 1; i >= 0; i--)if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
@@ -241,6 +239,14 @@ function _define_property$d(obj, key, value) {
     }
     return obj;
 }
+function _instanceof(left, right) {
+    "@swc/helpers - instanceof";
+    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
+        return !!right[Symbol.hasInstance](left);
+    } else {
+        return left instanceof right;
+    }
+}
 function _iterable_to_array$4(iter) {
     if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
 }
@@ -289,12 +295,35 @@ function _object_spread$6(target) {
     }
     return target;
 }
+function ownKeys$5(object, enumerableOnly) {
+    var keys = Object.keys(object);
+    if (Object.getOwnPropertySymbols) {
+        var symbols = Object.getOwnPropertySymbols(object);
+        keys.push.apply(keys, symbols);
+    }
+    return keys;
+}
+function _object_spread_props$5(target, source) {
+    source = source != null ? source : {};
+    if (Object.getOwnPropertyDescriptors) {
+        Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
+    } else {
+        ownKeys$5(Object(source)).forEach(function(key) {
+            Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
+        });
+    }
+    return target;
+}
 function _sliced_to_array(arr, i) {
     return _array_with_holes(arr) || _iterable_to_array_limit(arr, i) || _unsupported_iterable_to_array$4(arr, i) || _non_iterable_rest();
 }
 function _to_consumable_array$4(arr) {
     return _array_without_holes$4(arr) || _iterable_to_array$4(arr) || _unsupported_iterable_to_array$4(arr) || _non_iterable_spread$4();
 }
+function _type_of(obj) {
+    "@swc/helpers - typeof";
+    return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
+}
 function _unsupported_iterable_to_array$4(o, minLen) {
     if (!o) return;
     if (typeof o === "string") return _array_like_to_array$4(o, minLen);
@@ -410,6 +439,48 @@ function _ts_generator$3(thisArg, body) {
 ZohoAccountsAccessTokenCacheService = __decorate([
     Injectable()
 ], ZohoAccountsAccessTokenCacheService);
+function buildZohoReadAdapter(cache) {
+    return {
+        load: function load() {
+            return _async_to_generator$3(function() {
+                var value;
+                return _ts_generator$3(this, function(_state) {
+                    switch(_state.label){
+                        case 0:
+                            return [
+                                4,
+                                cache.loadCachedToken().catch(function() {
+                                    return undefined;
+                                })
+                            ];
+                        case 1:
+                            value = _state.sent();
+                            return [
+                                2,
+                                value != null && !isExpired(value) ? value : undefined
+                            ];
+                    }
+                });
+            })();
+        },
+        update: function update(token) {
+            return cache.updateCachedToken(token);
+        },
+        clear: function clear() {
+            return cache.clearCachedToken();
+        }
+    };
+}
+function updateZohoCacheCapturingError(cache, accessToken) {
+    return cache.updateCachedToken(accessToken).then(function() {
+        return null;
+    }).catch(function(e) {
+        return [
+            cache,
+            e
+        ];
+    });
+}
 /**
  * Default error logging function for merged Zoho access token cache services.
  *
@@ -428,6 +499,11 @@ ZohoAccountsAccessTokenCacheService = __decorate([
  *
  * When updating a cached token, it will update the token across all services.
  *
+ * Read fall-through is delegated to {@link mergeAsyncValueCaches} after wrapping each
+ * underlying cache with an {@link isExpired}-aware filter, so an expired cached token
+ * 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
@@ -438,149 +514,187 @@ ZohoAccountsAccessTokenCacheService = __decorate([
     if (services.length === 0) {
         throw new Error('mergeZohoAccountsAccessTokenCacheServices() input cannot be empty.');
     }
-    var service = {
-        loadZohoAccessTokenCache: function loadZohoAccessTokenCache(service) {
-            var accessCachesForServices = services.map(function(x) {
-                return x.loadZohoAccessTokenCache(service);
-            });
-            var loadCachedTokenFromFirstService = tryWithPromiseFactoriesFunction({
-                promiseFactories: accessCachesForServices.map(function(x) {
-                    return function() {
-                        return x.loadCachedToken().catch(function() {
-                            return null;
-                        }).then(function(x) {
-                            var result = undefined;
-                            if (x && !isPast(x.expiresAt)) {
-                                result = x; // only return from cache if it is not expired
-                            }
-                            return result;
-                        });
-                    };
-                }),
-                successOnMaybe: false,
-                throwErrors: false
-            });
-            var cacheForService = {
-                loadCachedToken: function loadCachedToken() {
-                    return loadCachedTokenFromFirstService();
-                },
-                updateCachedToken: function updateCachedToken(accessToken) {
-                    return _async_to_generator$3(function() {
-                        return _ts_generator$3(this, function(_state) {
-                            return [
-                                2,
-                                Promise.allSettled(accessCachesForServices.map(function(x) {
-                                    return x.updateCachedToken(accessToken).then(function() {
-                                        return null;
-                                    }).catch(function(e) {
-                                        return [
-                                            x,
-                                            e
-                                        ];
-                                    });
-                                })).then(function(x) {
-                                    // only find the failures if we're logging
-                                    if (logErrorFunction != null) {
-                                        var failedUpdates = filterMaybeArrayValues(x.map(function(y) {
-                                            return y.value;
-                                        }));
-                                        if (failedUpdates.length) {
-                                            logErrorFunction(failedUpdates);
-                                        }
+    function loadZohoAccessTokenCache(service) {
+        var accessCachesForService = services.map(function(x) {
+            return x.loadZohoAccessTokenCache(service);
+        });
+        // Per-cache adapters with expiry filtering so reads fall through to the next tier when a cache holds an expired token.
+        var readAdapters = accessCachesForService.map(buildZohoReadAdapter);
+        var merged = mergeAsyncValueCaches(readAdapters);
+        return {
+            loadCachedToken: function loadCachedToken() {
+                return merged.load();
+            },
+            updateCachedToken: function updateCachedToken(accessToken) {
+                return _async_to_generator$3(function() {
+                    var settled, failedUpdates;
+                    return _ts_generator$3(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                return [
+                                    4,
+                                    Promise.allSettled(accessCachesForService.map(function(cache) {
+                                        return updateZohoCacheCapturingError(cache, accessToken);
+                                    }))
+                                ];
+                            case 1:
+                                settled = _state.sent();
+                                if (logErrorFunction != null) {
+                                    failedUpdates = filterMaybeArrayValues(settled.map(function(y) {
+                                        return y.value;
+                                    }));
+                                    if (failedUpdates.length) {
+                                        logErrorFunction(failedUpdates);
                                     }
-                                })
-                            ];
-                        });
-                    })();
-                },
-                clearCachedToken: function clearCachedToken() {
-                    return _async_to_generator$3(function() {
-                        return _ts_generator$3(this, function(_state) {
-                            switch(_state.label){
-                                case 0:
-                                    return [
-                                        4,
-                                        Promise.allSettled(accessCachesForServices.map(function(x) {
-                                            return x.clearCachedToken();
-                                        }))
-                                    ];
-                                case 1:
-                                    _state.sent();
-                                    return [
-                                        2
-                                    ];
-                            }
-                        });
-                    })();
-                }
-            };
-            return cacheForService;
-        }
+                                }
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                })();
+            },
+            clearCachedToken: function clearCachedToken() {
+                return _async_to_generator$3(function() {
+                    return _ts_generator$3(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                return [
+                                    4,
+                                    Promise.allSettled(accessCachesForService.map(function(cache) {
+                                        return cache.clearCachedToken();
+                                    }))
+                                ];
+                            case 1:
+                                _state.sent();
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                })();
+            }
+        };
+    }
+    return {
+        loadZohoAccessTokenCache: loadZohoAccessTokenCache
     };
-    return service;
 }
 // MARK: Memory Access Token Cache
 /**
  * Creates a ZohoAccountsAccessTokenCacheService that uses in-memory storage.
  *
+ * 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
  */ function memoryZohoAccountsAccessTokenCacheService(existingCache, logAccessToConsole) {
-    var tokens = existingCache !== null && existingCache !== void 0 ? existingCache : {};
+    var initialEntries = {};
+    if (existingCache != null) {
+        var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+        try {
+            for(var _iterator = Object.keys(existingCache)[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                var key = _step.value;
+                var value = existingCache[key];
+                if (value != null) {
+                    initialEntries[key] = value;
+                }
+            }
+        } catch (err) {
+            _didIteratorError = true;
+            _iteratorError = err;
+        } finally{
+            try {
+                if (!_iteratorNormalCompletion && _iterator.return != null) {
+                    _iterator.return();
+                }
+            } finally{
+                if (_didIteratorError) {
+                    throw _iteratorError;
+                }
+            }
+        }
+    }
+    var cache = inMemoryAsyncKeyedValueCache(initialEntries);
     function loadZohoAccessTokenCache(service) {
-        var accessTokenCache = {
+        return {
             loadCachedToken: function loadCachedToken() {
                 return _async_to_generator$3(function() {
                     var token;
                     return _ts_generator$3(this, function(_state) {
-                        token = tokens[service];
-                        if (logAccessToConsole) {
-                            console.log('retrieving access token from memory: ', {
-                                token: token,
-                                service: service
-                            });
+                        switch(_state.label){
+                            case 0:
+                                return [
+                                    4,
+                                    cache.get(service)
+                                ];
+                            case 1:
+                                token = _state.sent();
+                                if (logAccessToConsole) {
+                                    console.log('retrieving access token from memory: ', {
+                                        service: service,
+                                        hit: token != null,
+                                        expiresAt: token === null || token === void 0 ? void 0 : token.expiresAt
+                                    });
+                                }
+                                return [
+                                    2,
+                                    token
+                                ];
                         }
-                        return [
-                            2,
-                            token
-                        ];
                     });
                 })();
             },
             updateCachedToken: function updateCachedToken(accessToken) {
                 return _async_to_generator$3(function() {
                     return _ts_generator$3(this, function(_state) {
-                        tokens[service] = accessToken;
-                        if (logAccessToConsole) {
-                            console.log('updating access token in memory: ', {
-                                accessToken: accessToken,
-                                service: service
-                            });
+                        switch(_state.label){
+                            case 0:
+                                return [
+                                    4,
+                                    cache.set(service, accessToken)
+                                ];
+                            case 1:
+                                _state.sent();
+                                if (logAccessToConsole) {
+                                    console.log('updating access token in memory: ', {
+                                        service: service,
+                                        expiresAt: accessToken === null || accessToken === void 0 ? void 0 : accessToken.expiresAt
+                                    });
+                                }
+                                return [
+                                    2
+                                ];
                         }
-                        return [
-                            2
-                        ];
                     });
                 })();
             },
             clearCachedToken: function clearCachedToken() {
                 return _async_to_generator$3(function() {
                     return _ts_generator$3(this, function(_state) {
-                        delete tokens[service];
-                        if (logAccessToConsole) {
-                            console.log('clearing access token in memory: ', {
-                                service: service
-                            });
+                        switch(_state.label){
+                            case 0:
+                                return [
+                                    4,
+                                    cache.remove(service)
+                                ];
+                            case 1:
+                                _state.sent();
+                                if (logAccessToConsole) {
+                                    console.log('clearing access token in memory: ', {
+                                        service: service
+                                    });
+                                }
+                                return [
+                                    2
+                                ];
                         }
-                        return [
-                            2
-                        ];
                     });
                 })();
             }
         };
-        return accessTokenCache;
     }
     return {
         loadZohoAccessTokenCache: loadZohoAccessTokenCache
@@ -588,9 +702,29 @@ ZohoAccountsAccessTokenCacheService = __decorate([
 }
 // MARK: File System Access Token Cache
 var DEFAULT_FILE_ZOHO_ACCOUNTS_ACCESS_TOKEN_CACHE_SERVICE_PATH = '.tmp/zoho-access-tokens.json';
+/**
+ * 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
+ */ function reviveZohoAccessToken(raw) {
+    if (raw == null || (typeof raw === "undefined" ? "undefined" : _type_of(raw)) !== 'object') {
+        return undefined;
+    }
+    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
+    });
+}
 /**
  * Creates a ZohoAccountsAccessTokenCacheService that reads and writes the access token to the file system.
  *
+ * Composes {@link createJsonFileAsyncKeyedValueCache} (for the on-disk record) optionally with
+ * {@link memoizeAsyncKeyedValueCache} so reads after the first hit memory.
+ *
  * Useful for testing.
  *
  * @param filename - path to the JSON file used for token persistence
@@ -598,170 +732,46 @@ var DEFAULT_FILE_ZOHO_ACCOUNTS_ACCESS_TOKEN_CACHE_SERVICE_PATH = '.tmp/zoho-acce
  * @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 loadedTokens = null;
-    function loadTokens() {
-        return _async_to_generator$3(function() {
-            var _ref, _tmp;
-            return _ts_generator$3(this, function(_state) {
-                switch(_state.label){
-                    case 0:
-                        if (!(loadedTokens !== null && loadedTokens !== void 0)) return [
-                            3,
-                            1
-                        ];
-                        _tmp = loadedTokens;
-                        return [
-                            3,
-                            3
-                        ];
-                    case 1:
-                        return [
-                            4,
-                            readTokenFile()
-                        ];
-                    case 2:
-                        _tmp = _state.sent();
-                        _state.label = 3;
-                    case 3:
-                        return [
-                            2,
-                            (_ref = _tmp) !== null && _ref !== void 0 ? _ref : {}
-                        ];
-                }
-            });
-        })();
-    }
-    function readTokenFile() {
-        return new Promise(function(resolve) {
-            mkdirSync(dirname(filename), {
-                recursive: true
-            }); // make the directory first
-            readFile(filename, {}, function(x, data) {
-                var result = undefined;
-                if (!x) {
-                    try {
-                        result = JSON.parse(data.toString());
-                        forEachKeyValue(result, {
-                            forEach: function forEach(x) {
-                                if (x[1]) {
-                                    x[1].expiresAt = new Date(x[1].expiresAt);
-                                }
-                            }
-                        });
-                    } catch (e) {
-                        console.error('Failed reading token file: ', e);
-                    }
-                }
-                resolve(result);
-            });
-        }).then(function(x) {
-            // update loaded tokens
-            if (useMemoryCache) {
-                loadedTokens = _object_spread$6({}, loadedTokens, x);
-            }
-            return x;
-        });
-    }
-    function writeTokenFile(tokens) {
-        return _async_to_generator$3(function() {
-            return _ts_generator$3(this, function(_state) {
-                return [
-                    2,
-                    new Promise(function(resolve, reject) {
-                        writeFile(filename, JSON.stringify(tokens), {}, function(x) {
-                            if (!x) {
-                                resolve();
-                            } else {
-                                reject(x);
-                            }
-                        });
-                    })
-                ];
-            });
-        })();
-    }
-    function deleteTokenFile() {
-        return _async_to_generator$3(function() {
-            return _ts_generator$3(this, function(_state) {
-                return [
-                    2,
-                    new Promise(function(resolve, reject) {
-                        rm(filename, function(x) {
-                            if (!x) {
-                                resolve();
-                            } else {
-                                reject(x);
-                            }
-                        });
-                    })
-                ];
-            });
-        })();
-    }
+    var fileCache = createJsonFileAsyncKeyedValueCache({
+        filePath: filename,
+        reviver: reviveZohoAccessToken
+    });
+    var cache = useMemoryCache ? memoizeAsyncKeyedValueCache(fileCache) : fileCache;
     function loadZohoAccessTokenCache(service) {
-        var accessTokenCache = {
+        return {
             loadCachedToken: function loadCachedToken() {
-                return _async_to_generator$3(function() {
-                    var tokens;
-                    return _ts_generator$3(this, function(_state) {
-                        switch(_state.label){
-                            case 0:
-                                return [
-                                    4,
-                                    loadTokens()
-                                ];
-                            case 1:
-                                tokens = _state.sent();
-                                // console.log('retrieving access token from file: ', { token, service });
-                                return [
-                                    2,
-                                    tokens[service]
-                                ];
-                        }
-                    });
-                })();
+                return cache.get(service);
             },
             updateCachedToken: function updateCachedToken(accessToken) {
                 return _async_to_generator$3(function() {
-                    var tokens, e;
+                    var e;
                     return _ts_generator$3(this, function(_state) {
                         switch(_state.label){
                             case 0:
-                                return [
-                                    4,
-                                    loadTokens()
-                                ];
-                            case 1:
-                                tokens = _state.sent();
-                                if (tokens) {
-                                    tokens[service] = accessToken;
-                                }
-                                _state.label = 2;
-                            case 2:
                                 _state.trys.push([
+                                    0,
                                     2,
-                                    4,
                                     ,
-                                    5
+                                    3
                                 ]);
                                 return [
                                     4,
-                                    writeTokenFile(tokens)
+                                    cache.set(service, accessToken)
                                 ];
-                            case 3:
+                            case 1:
                                 _state.sent();
                                 return [
                                     3,
-                                    5
+                                    3
                                 ];
-                            case 4:
+                            case 2:
                                 e = _state.sent();
                                 console.error('Failed updating access token in file: ', e);
                                 return [
                                     3,
-                                    5
+                                    3
                                 ];
-                            case 5:
+                            case 3:
                                 return [
                                     2
                                 ];
@@ -783,7 +793,7 @@ var DEFAULT_FILE_ZOHO_ACCOUNTS_ACCESS_TOKEN_CACHE_SERVICE_PATH = '.tmp/zoho-acce
                                 ]);
                                 return [
                                     4,
-                                    writeTokenFile({})
+                                    cache.remove(service)
                                 ];
                             case 1:
                                 _state.sent();
@@ -807,7 +817,155 @@ var DEFAULT_FILE_ZOHO_ACCOUNTS_ACCESS_TOKEN_CACHE_SERVICE_PATH = '.tmp/zoho-acce
                 })();
             }
         };
-        return accessTokenCache;
+    }
+    function readTokenFile() {
+        return _async_to_generator$3(function() {
+            var raw, result, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, key;
+            return _ts_generator$3(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        return [
+                            4,
+                            readJsonFile(filename)
+                        ];
+                    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{
+                            try {
+                                if (!_iteratorNormalCompletion && _iterator.return != null) {
+                                    _iterator.return();
+                                }
+                            } finally{
+                                if (_didIteratorError) {
+                                    throw _iteratorError;
+                                }
+                            }
+                        }
+                        return [
+                            2,
+                            result
+                        ];
+                }
+            });
+        })();
+    }
+    // Route the file-mutation helpers through the same `cache` instance used by
+    // loadZohoAccessTokenCache so the memoized in-memory layer (when useMemoryCache=true) stays
+    // consistent with disk. Direct writeJsonFile / removeFile would otherwise leave the memo
+    // holding stale entries that no future read could refresh.
+    function writeTokenFile(tokens) {
+        return _async_to_generator$3(function() {
+            var _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, _step_value, key, value, err;
+            return _ts_generator$3(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        return [
+                            4,
+                            cache.clear()
+                        ];
+                    case 1:
+                        _state.sent();
+                        _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+                        _state.label = 2;
+                    case 2:
+                        _state.trys.push([
+                            2,
+                            7,
+                            8,
+                            9
+                        ]);
+                        _iterator = Object.entries(tokens)[Symbol.iterator]();
+                        _state.label = 3;
+                    case 3:
+                        if (!!(_iteratorNormalCompletion = (_step = _iterator.next()).done)) return [
+                            3,
+                            6
+                        ];
+                        _step_value = _sliced_to_array(_step.value, 2), key = _step_value[0], value = _step_value[1];
+                        if (!(value != null)) return [
+                            3,
+                            5
+                        ];
+                        return [
+                            4,
+                            cache.set(key, value)
+                        ];
+                    case 4:
+                        _state.sent();
+                        _state.label = 5;
+                    case 5:
+                        _iteratorNormalCompletion = true;
+                        return [
+                            3,
+                            3
+                        ];
+                    case 6:
+                        return [
+                            3,
+                            9
+                        ];
+                    case 7:
+                        err = _state.sent();
+                        _didIteratorError = true;
+                        _iteratorError = err;
+                        return [
+                            3,
+                            9
+                        ];
+                    case 8:
+                        try {
+                            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                                _iterator.return();
+                            }
+                        } finally{
+                            if (_didIteratorError) {
+                                throw _iteratorError;
+                            }
+                        }
+                        return [
+                            7
+                        ];
+                    case 9:
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    }
+    function deleteTokenFile() {
+        return _async_to_generator$3(function() {
+            return _ts_generator$3(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        return [
+                            4,
+                            cache.clear()
+                        ];
+                    case 1:
+                        _state.sent();
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
     }
     return {
         loadZohoAccessTokenCache: loadZohoAccessTokenCache,
@@ -3565,6 +3723,8 @@ function _object_spread_props(target, source) {
             get: // MARK: Ticket Accessors
             /**
      * Configured pass-through for {@link zohoDeskGetTickets}.
+     *
+     * @returns a function that lists Desk tickets matching the supplied filter/pagination input
      */ function get() {
                 return zohoDeskGetTickets(this.deskContext);
             }
@@ -3573,6 +3733,8 @@ function _object_spread_props(target, source) {
             key: "getTicketById",
             get: /**
      * Configured pass-through for {@link zohoDeskGetTicketById}.
+     *
+     * @returns a function that fetches a single Desk ticket by its identifier
      */ function get() {
                 return zohoDeskGetTicketById(this.deskContext);
             }
@@ -3581,6 +3743,8 @@ function _object_spread_props(target, source) {
             key: "searchTickets",
             get: /**
      * Configured pass-through for {@link zohoDeskSearchTickets}.
+     *
+     * @returns a function that runs a Desk ticket search with the provided criteria
      */ function get() {
                 return zohoDeskSearchTickets(this.deskContext);
             }
@@ -3589,6 +3753,8 @@ function _object_spread_props(target, source) {
             key: "getTicketsForContact",
             get: /**
      * Configured pass-through for {@link zohoDeskGetTicketsForContact}.
+     *
+     * @returns a function that lists Desk tickets associated with the given contact id
      */ function get() {
                 return zohoDeskGetTicketsForContact(this.deskContext);
             }
@@ -3597,6 +3763,8 @@ function _object_spread_props(target, source) {
             key: "getTicketsForProduct",
             get: /**
      * Configured pass-through for {@link zohoDeskGetTicketsForProduct}.
+     *
+     * @returns a function that lists Desk tickets associated with the given product id
      */ function get() {
                 return zohoDeskGetTicketsForProduct(this.deskContext);
             }
@@ -3605,6 +3773,8 @@ function _object_spread_props(target, source) {
             key: "getTicketMetrics",
             get: /**
      * Configured pass-through for {@link zohoDeskGetTicketMetrics}.
+     *
+     * @returns a function that fetches aggregated metrics for the requested Desk tickets
      */ function get() {
                 return zohoDeskGetTicketMetrics(this.deskContext);
             }
@@ -3613,6 +3783,8 @@ function _object_spread_props(target, source) {
             key: "getAgentsTicketsCount",
             get: /**
      * Configured pass-through for {@link zohoDeskGetAgentsTicketsCount}.
+     *
+     * @returns a function that returns ticket counts grouped by agent for the requested filter
      */ function get() {
                 return zohoDeskGetAgentsTicketsCount(this.deskContext);
             }
@@ -3621,6 +3793,8 @@ function _object_spread_props(target, source) {
             key: "getTicketsPageFactory",
             get: /**
      * Configured pass-through for {@link zohoDeskGetTicketsPageFactory}.
+     *
+     * @returns a paged result factory for iterating over Desk ticket list responses
      */ function get() {
                 return zohoDeskGetTicketsPageFactory(this.deskContext);
             }
@@ -3629,6 +3803,8 @@ function _object_spread_props(target, source) {
             key: "searchTicketsPageFactory",
             get: /**
      * Configured pass-through for {@link zohoDeskSearchTicketsPageFactory}.
+     *
+     * @returns a paged result factory for iterating over Desk ticket search responses
      */ function get() {
                 return zohoDeskSearchTicketsPageFactory(this.deskContext);
             }
@@ -3638,6 +3814,8 @@ function _object_spread_props(target, source) {
             get: // MARK: Department Accessors
             /**
      * Configured pass-through for {@link zohoDeskGetDepartments}.
+     *
+     * @returns a function that lists Desk departments visible to the authenticated portal
      */ function get() {
                 return zohoDeskGetDepartments(this.deskContext);
             }
@@ -3646,6 +3824,8 @@ function _object_spread_props(target, source) {
             key: "getDepartmentById",
             get: /**
      * Configured pass-through for {@link zohoDeskGetDepartmentById}.
+     *
+     * @returns a function that fetches a single Desk department by its identifier
      */ function get() {
                 return zohoDeskGetDepartmentById(this.deskContext);
             }
@@ -3655,6 +3835,8 @@ function _object_spread_props(target, source) {
             get: // MARK: Contact Accessors
             /**
      * Configured pass-through for {@link zohoDeskGetContacts}.
+     *
+     * @returns a function that lists Desk contacts matching the supplied filter/pagination input
      */ function get() {
                 return zohoDeskGetContacts(this.deskContext);
             }
@@ -3663,6 +3845,8 @@ function _object_spread_props(target, source) {
             key: "getContactById",
             get: /**
      * Configured pass-through for {@link zohoDeskGetContactById}.
+     *
+     * @returns a function that fetches a single Desk contact by its identifier
      */ function get() {
                 return zohoDeskGetContactById(this.deskContext);
             }
@@ -3671,6 +3855,8 @@ function _object_spread_props(target, source) {
             key: "getContactsByIds",
             get: /**
      * Configured pass-through for {@link zohoDeskGetContactsByIds}.
+     *
+     * @returns a function that fetches multiple Desk contacts in a single request by their identifiers
      */ function get() {
                 return zohoDeskGetContactsByIds(this.deskContext);
             }
@@ -3679,6 +3865,8 @@ function _object_spread_props(target, source) {
             key: "getContactsPageFactory",
             get: /**
      * Configured pass-through for {@link zohoDeskGetContactsPageFactory}.
+     *
+     * @returns a paged result factory for iterating over Desk contact list responses
      */ function get() {
                 return zohoDeskGetContactsPageFactory(this.deskContext);
             }
@@ -3688,6 +3876,8 @@ function _object_spread_props(target, source) {
             get: // MARK: Tag Accessors
             /**
      * Configured pass-through for {@link zohoDeskGetTicketTags}.
+     *
+     * @returns a function that lists the tags currently associated with a given Desk ticket
      */ function get() {
                 return zohoDeskGetTicketTags(this.deskContext);
             }
@@ -3696,6 +3886,8 @@ function _object_spread_props(target, source) {
             key: "associateTicketTags",
             get: /**
      * Configured pass-through for {@link zohoDeskAssociateTicketTags}.
+     *
+     * @returns a function that associates one or more tags with a Desk ticket
      */ function get() {
                 return zohoDeskAssociateTicketTags(this.deskContext);
             }
@@ -3704,6 +3896,8 @@ function _object_spread_props(target, source) {
             key: "dissociateTicketTag",
             get: /**
      * Configured pass-through for {@link zohoDeskDissociateTicketTag}.
+     *
+     * @returns a function that removes a single tag association from a Desk ticket
      */ function get() {
                 return zohoDeskDissociateTicketTag(this.deskContext);
             }
@@ -3712,6 +3906,8 @@ function _object_spread_props(target, source) {
             key: "searchTags",
             get: /**
      * Configured pass-through for {@link zohoDeskSearchTags}.
+     *
+     * @returns a function that searches the Desk tag catalog by the supplied criteria
      */ function get() {
                 return zohoDeskSearchTags(this.deskContext);
             }
@@ -3720,6 +3916,8 @@ function _object_spread_props(target, source) {
             key: "getAllTags",
             get: /**
      * Configured pass-through for {@link zohoDeskGetAllTags}.
+     *
+     * @returns a function that lists every tag defined on the Desk portal
      */ function get() {
                 return zohoDeskGetAllTags(this.deskContext);
             }
@@ -3729,6 +3927,8 @@ function _object_spread_props(target, source) {
             get: // MARK: Follower Accessors
             /**
      * Configured pass-through for {@link zohoDeskGetTicketFollowers}.
+     *
+     * @returns a function that lists the agents following a given Desk ticket
      */ function get() {
                 return zohoDeskGetTicketFollowers(this.deskContext);
             }
@@ -3737,6 +3937,8 @@ function _object_spread_props(target, source) {
             key: "addTicketFollowers",
             get: /**
      * Configured pass-through for {@link zohoDeskAddTicketFollowers}.
+     *
+     * @returns a function that adds one or more agents as followers of a Desk ticket
      */ function get() {
                 return zohoDeskAddTicketFollowers(this.deskContext);
             }
@@ -3745,6 +3947,8 @@ function _object_spread_props(target, source) {
             key: "removeTicketFollowers",
             get: /**
      * Configured pass-through for {@link zohoDeskRemoveTicketFollowers}.
+     *
+     * @returns a function that removes one or more agents from a Desk ticket's follower list
      */ function get() {
                 return zohoDeskRemoveTicketFollowers(this.deskContext);
             }
@@ -3754,6 +3958,8 @@ function _object_spread_props(target, source) {
             get: // MARK: Attachment Accessors
             /**
      * Configured pass-through for {@link zohoDeskGetTicketAttachments}.
+     *
+     * @returns a function that lists the file attachments on a given Desk ticket
      */ function get() {
                 return zohoDeskGetTicketAttachments(this.deskContext);
             }
@@ -3762,6 +3968,8 @@ function _object_spread_props(target, source) {
             key: "deleteTicketAttachment",
             get: /**
      * Configured pass-through for {@link zohoDeskDeleteTicketAttachment}.
+     *
+     * @returns a function that deletes a single attachment from a Desk ticket by attachment id
      */ function get() {
                 return zohoDeskDeleteTicketAttachment(this.deskContext);
             }
@@ -3771,6 +3979,8 @@ function _object_spread_props(target, source) {
             get: // MARK: Comment Accessors
             /**
      * Configured pass-through for {@link zohoDeskGetTicketComments}.
+     *
+     * @returns a function that lists the comments on a given Desk ticket
      */ function get() {
                 return zohoDeskGetTicketComments(this.deskContext);
             }
@@ -3779,6 +3989,8 @@ function _object_spread_props(target, source) {
             key: "getTicketCommentById",
             get: /**
      * Configured pass-through for {@link zohoDeskGetTicketCommentById}.
+     *
+     * @returns a function that fetches a single comment on a Desk ticket by comment id
      */ function get() {
                 return zohoDeskGetTicketCommentById(this.deskContext);
             }
@@ -3787,6 +3999,8 @@ function _object_spread_props(target, source) {
             key: "createTicketComment",
             get: /**
      * Configured pass-through for {@link zohoDeskCreateTicketComment}.
+     *
+     * @returns a function that creates a new comment on a Desk ticket from the supplied body
      */ function get() {
                 return zohoDeskCreateTicketComment(this.deskContext);
             }
@@ -3795,6 +4009,8 @@ function _object_spread_props(target, source) {
             key: "deleteTicketComment",
             get: /**
      * Configured pass-through for {@link zohoDeskDeleteTicketComment}.
+     *
+     * @returns a function that deletes a single comment from a Desk ticket by comment id
      */ function get() {
                 return zohoDeskDeleteTicketComment(this.deskContext);
             }
@@ -3804,6 +4020,8 @@ function _object_spread_props(target, source) {
             get: // MARK: Time Tracking Accessors
             /**
      * Configured pass-through for {@link zohoDeskGetTicketTimer}.
+     *
+     * @returns a function that fetches the current timer state for a Desk ticket
      */ function get() {
                 return zohoDeskGetTicketTimer(this.deskContext);
             }
@@ -3812,6 +4030,8 @@ function _object_spread_props(target, source) {
             key: "performTicketTimerAction",
             get: /**
      * Configured pass-through for {@link zohoDeskPerformTicketTimerAction}.
+     *
+     * @returns a function that performs a timer action (start/pause/stop) on a Desk ticket
      */ function get() {
                 return zohoDeskPerformTicketTimerAction(this.deskContext);
             }
@@ -3820,6 +4040,8 @@ function _object_spread_props(target, source) {
             key: "getTicketTimeEntries",
             get: /**
      * Configured pass-through for {@link zohoDeskGetTicketTimeEntries}.
+     *
+     * @returns a function that lists the time entries logged against a Desk ticket
      */ function get() {
                 return zohoDeskGetTicketTimeEntries(this.deskContext);
             }
@@ -3828,6 +4050,8 @@ function _object_spread_props(target, source) {
             key: "getTicketTimeEntryById",
             get: /**
      * Configured pass-through for {@link zohoDeskGetTicketTimeEntryById}.
+     *
+     * @returns a function that fetches a single time entry on a Desk ticket by entry id
      */ function get() {
                 return zohoDeskGetTicketTimeEntryById(this.deskContext);
             }
@@ -3836,6 +4060,8 @@ function _object_spread_props(target, source) {
             key: "getTicketTimeEntrySummation",
             get: /**
      * Configured pass-through for {@link zohoDeskGetTicketTimeEntrySummation}.
+     *
+     * @returns a function that fetches the aggregated time-entry totals for a Desk ticket
      */ function get() {
                 return zohoDeskGetTicketTimeEntrySummation(this.deskContext);
             }
@@ -3845,6 +4071,8 @@ function _object_spread_props(target, source) {
             get: // MARK: Thread Accessors
             /**
      * Configured pass-through for {@link zohoDeskGetTicketThreads}.
+     *
+     * @returns a function that lists the conversation threads on a given Desk ticket
      */ function get() {
                 return zohoDeskGetTicketThreads(this.deskContext);
             }
@@ -3853,6 +4081,8 @@ function _object_spread_props(target, source) {
             key: "getTicketThreadById",
             get: /**
      * Configured pass-through for {@link zohoDeskGetTicketThreadById}.
+     *
+     * @returns a function that fetches a single thread on a Desk ticket by thread id
      */ function get() {
                 return zohoDeskGetTicketThreadById(this.deskContext);
             }
@@ -3861,6 +4091,8 @@ function _object_spread_props(target, source) {
             key: "getTicketThreadsPageFactory",
             get: /**
      * Configured pass-through for {@link zohoDeskGetTicketThreadsPageFactory}.
+     *
+     * @returns a paged result factory for iterating over Desk ticket thread responses
      */ function get() {
                 return zohoDeskGetTicketThreadsPageFactory(this.deskContext);
             }
@@ -3870,6 +4102,8 @@ function _object_spread_props(target, source) {
             get: // MARK: Activity Accessors
             /**
      * Configured pass-through for {@link zohoDeskGetTicketActivities}.
+     *
+     * @returns a function that lists the activity log entries for a given Desk ticket
      */ function get() {
                 return zohoDeskGetTicketActivities(this.deskContext);
             }
@@ -3878,6 +4112,8 @@ function _object_spread_props(target, source) {
             key: "getTicketActivitiesPageFactory",
             get: /**
      * Configured pass-through for {@link zohoDeskGetTicketActivitiesPageFactory}.
+     *
+     * @returns a paged result factory for iterating over Desk ticket activity responses
      */ function get() {
                 return zohoDeskGetTicketActivitiesPageFactory(this.deskContext);
             }
@@ -3887,6 +4123,8 @@ function _object_spread_props(target, source) {
             get: // MARK: Agent Accessors
             /**
      * Configured pass-through for {@link zohoDeskGetAgents}.
+     *
+     * @returns a function that lists Desk agents matching the supplied filter/pagination input
      */ function get() {
                 return zohoDeskGetAgents(this.deskContext);
             }
@@ -3895,6 +4133,8 @@ function _object_spread_props(target, source) {
             key: "getAgentById",
             get: /**
      * Configured pass-through for {@link zohoDeskGetAgentById}.
+     *
+     * @returns a function that fetches a single Desk agent by agent id
      */ function get() {
                 return zohoDeskGetAgentById(this.deskContext);
             }
@@ -3903,6 +4143,8 @@ function _object_spread_props(target, source) {
             key: "getAgentsByIds",
             get: /**
      * Configured pass-through for {@link zohoDeskGetAgentsByIds}.
+     *
+     * @returns a function that fetches multiple Desk agents in a single request by their identifiers
      */ function get() {
                 return zohoDeskGetAgentsByIds(this.deskContext);
             }
@@ -3911,6 +4153,8 @@ function _object_spread_props(target, source) {
             key: "getMyInfo",
             get: /**
      * Configured pass-through for {@link zohoDeskGetMyInfo}.
+     *
+     * @returns a function that fetches the profile information for the currently authenticated agent
      */ function get() {
                 return zohoDeskGetMyInfo(this.deskContext);
             }
@@ -3919,6 +4163,8 @@ function _object_spread_props(target, source) {
             key: "getAgentsPageFactory",
             get: /**
      * Configured pass-through for {@link zohoDeskGetAgentsPageFactory}.
+     *
+     * @returns a paged result factory for iterating over Desk agent list responses
      */ function get() {
                 return zohoDeskGetAgentsPageFactory(this.deskContext);
             }