@dereekb/nestjs 13.10.9 → 13.11.0

package/index.esm.js

@@ -1,15 +1,17 @@
 import { assetLoaderFromGetFn, fetchAssetLoader, delegatedAssetLoader, AssetLoader } from '@dereekb/rxjs';
 import { readFile } from 'fs/promises';
-import { resolve } from 'node:path';
+import { resolve, dirname } from 'node:path';
 import { createParamDecorator, Logger, BadRequestException, InternalServerErrorException, Injectable, RequestMethod, Module, Inject } from '@nestjs/common';
 import rawbody from 'raw-body';
 import { parse } from 'querystring';
 import bodyParser from 'body-parser';
-import { asArray, mergeArrays, isHex, getValueFromGetter, PDF_ENCRYPT_MARKER } from '@dereekb/util';
+import { asArray, mergeArrays, memoizeAsyncKeyedValueCache, memoizeAsyncValueCache, isHex, getValueFromGetter, PDF_ENCRYPT_MARKER } from '@dereekb/util';
 import { ConfigService, ConfigModule } from '@nestjs/config';
+import { readFile as readFile$1, mkdirSync, writeFile, chmod } from 'node:fs';
+import { rm } from 'node:fs/promises';
 import { createDecipheriv, randomBytes, createCipheriv, createHash } from 'node:crypto';
 
-function asyncGeneratorStep$1(gen, resolve, reject, _next, _throw, key, arg) {
+function asyncGeneratorStep$2(gen, resolve, reject, _next, _throw, key, arg) {
     try {
         var info = gen[key](arg);
         var value = info.value;
@@ -23,22 +25,22 @@ function asyncGeneratorStep$1(gen, resolve, reject, _next, _throw, key, arg) {
         Promise.resolve(value).then(_next, _throw);
     }
 }
-function _async_to_generator$1(fn) {
+function _async_to_generator$2(fn) {
     return function() {
         var self = this, args = arguments;
         return new Promise(function(resolve, reject) {
             var gen = fn.apply(self, args);
             function _next(value) {
-                asyncGeneratorStep$1(gen, resolve, reject, _next, _throw, "next", value);
+                asyncGeneratorStep$2(gen, resolve, reject, _next, _throw, "next", value);
             }
             function _throw(err) {
-                asyncGeneratorStep$1(gen, resolve, reject, _next, _throw, "throw", err);
+                asyncGeneratorStep$2(gen, resolve, reject, _next, _throw, "throw", err);
             }
             _next(undefined);
         });
     };
 }
-function _ts_generator$1(thisArg, body) {
+function _ts_generator$2(thisArg, body) {
     var f, y, t, _ = {
         label: 0,
         sent: function() {
@@ -157,9 +159,9 @@ function _ts_generator$1(thisArg, body) {
  */ function nodeJsLocalAssetLoader(config) {
     var basePath = config.basePath;
     var getFn = function getFn(ref) {
-        return _async_to_generator$1(function() {
+        return _async_to_generator$2(function() {
             var localRef, fullPath, buffer;
-            return _ts_generator$1(this, function(_state) {
+            return _ts_generator$2(this, function(_state) {
                 switch(_state.label){
                     case 0:
                         localRef = ref;
@@ -238,7 +240,7 @@ function _ts_generator$1(thisArg, body) {
     return origin.startsWith('http://localhost') || origin.startsWith('https://localhost');
 }
 
-function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+function asyncGeneratorStep$1(gen, resolve, reject, _next, _throw, key, arg) {
     try {
         var info = gen[key](arg);
         var value = info.value;
@@ -252,22 +254,22 @@ function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
         Promise.resolve(value).then(_next, _throw);
     }
 }
-function _async_to_generator(fn) {
+function _async_to_generator$1(fn) {
     return function() {
         var self = this, args = arguments;
         return new Promise(function(resolve, reject) {
             var gen = fn.apply(self, args);
             function _next(value) {
-                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+                asyncGeneratorStep$1(gen, resolve, reject, _next, _throw, "next", value);
             }
             function _throw(err) {
-                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+                asyncGeneratorStep$1(gen, resolve, reject, _next, _throw, "throw", err);
             }
             _next(undefined);
         });
     };
 }
-function _ts_generator(thisArg, body) {
+function _ts_generator$1(thisArg, body) {
     var f, y, t, _ = {
         label: 0,
         sent: function() {
@@ -380,9 +382,9 @@ function _ts_generator(thisArg, body) {
  * ```
  */ var rawBodyLogger = new Logger('RawBody');
 var ParseRawBody = createParamDecorator(function(_, context) {
-    return _async_to_generator(function() {
+    return _async_to_generator$1(function() {
         var req, body;
-        return _ts_generator(this, function(_state) {
+        return _ts_generator$1(this, function(_state) {
             switch(_state.label){
                 case 0:
                     req = context.switchToHttp().getRequest();
@@ -417,9 +419,9 @@ var ParseRawBody = createParamDecorator(function(_, context) {
  * handleWebhook(@RawBody() body: RawBodyBuffer) { ... }
  * ```
  */ var RawBody = createParamDecorator(function(_, context) {
-    return _async_to_generator(function() {
+    return _async_to_generator$1(function() {
         var req, body;
-        return _ts_generator(this, function(_state) {
+        return _ts_generator$1(this, function(_state) {
             req = context.switchToHttp().getRequest();
             body = req.body;
             if (!Buffer.isBuffer(body)) {
@@ -443,9 +445,9 @@ var ParseRawBody = createParamDecorator(function(_, context) {
  * handleForm(@ParsedQueryRawBody() body: ParsedUrlQuery) { ... }
  * ```
  */ var ParsedQueryRawBody = createParamDecorator(function(_, context) {
-    return _async_to_generator(function() {
+    return _async_to_generator$1(function() {
         var req;
-        return _ts_generator(this, function(_state) {
+        return _ts_generator$1(this, function(_state) {
             req = context.switchToHttp().getRequest();
             req.body = RawBodyToParsedQueryString(req.body);
             return [
@@ -629,7 +631,7 @@ function _create_class$3(Constructor, protoProps, staticProps) {
     if (protoProps) _defineProperties$3(Constructor.prototype, protoProps);
     return Constructor;
 }
-function _define_property$3(obj, key, value) {
+function _define_property$4(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
             value: value,
@@ -737,7 +739,7 @@ var DEFAULT_WEBHOOK_MIDDLEWARE_ROUTE_INFO = {
     function ConfigureWebhookMiddlewareModule() {
         _class_call_check$5(this, ConfigureWebhookMiddlewareModule);
         var _this;
-        _this = _call_super(this, ConfigureWebhookMiddlewareModule, arguments), _define_property$3(_this, "logger", new Logger('ConfigureWebhookMiddlewareModule'));
+        _this = _call_super(this, ConfigureWebhookMiddlewareModule, arguments), _define_property$4(_this, "logger", new Logger('ConfigureWebhookMiddlewareModule'));
         return _this;
     }
     _create_class$3(ConfigureWebhookMiddlewareModule, [
@@ -834,7 +836,7 @@ function _create_class$2(Constructor, protoProps, staticProps) {
     if (staticProps) _defineProperties$2(Constructor, staticProps);
     return Constructor;
 }
-function _define_property$2(obj, key, value) {
+function _define_property$3(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
             value: value,
@@ -854,7 +856,7 @@ function _define_property$2(obj, key, value) {
  */ var ClientAppServiceConfig = /*#__PURE__*/ function() {
     function ClientAppServiceConfig() {
         _class_call_check$4(this, ClientAppServiceConfig);
-        _define_property$2(this, "client", void 0);
+        _define_property$3(this, "client", void 0);
     }
     _create_class$2(ClientAppServiceConfig, null, [
         {
@@ -893,7 +895,7 @@ function _create_class$1(Constructor, protoProps, staticProps) {
     if (protoProps) _defineProperties$1(Constructor.prototype, protoProps);
     return Constructor;
 }
-function _define_property$1(obj, key, value) {
+function _define_property$2(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
             value: value,
@@ -911,7 +913,7 @@ function _define_property$1(obj, key, value) {
  */ var ClientAppService = /*#__PURE__*/ function() {
     function ClientAppService(config) {
         _class_call_check$3(this, ClientAppService);
-        _define_property$1(this, "_config", void 0);
+        _define_property$2(this, "_config", void 0);
         this._config = config;
     }
     _create_class$1(ClientAppService, [
@@ -1050,7 +1052,7 @@ function _create_class(Constructor, protoProps, staticProps) {
     if (protoProps) _defineProperties(Constructor.prototype, protoProps);
     return Constructor;
 }
-function _define_property(obj, key, value) {
+function _define_property$1(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
             value: value,
@@ -1066,7 +1068,7 @@ function _define_property(obj, key, value) {
 var ServerEnvironmentService = /*#__PURE__*/ function() {
     function ServerEnvironmentService(env) {
         _class_call_check(this, ServerEnvironmentService);
-        _define_property(this, "env", void 0);
+        _define_property$1(this, "env", void 0);
         this.env = env;
     }
     _create_class(ServerEnvironmentService, [
@@ -1114,6 +1116,639 @@ ServerEnvironmentService = __decorate([
     __param(0, Inject(SERVER_ENV_TOKEN))
 ], ServerEnvironmentService);
 
+/**
+ * Reads JSON from disk, resolving `undefined` when the file is missing (ENOENT) or its
+ * contents fail to parse as JSON. Other I/O errors (permission denied, busy handles) are
+ * forwarded to the caller — silently swallowing them masks real failures.
+ *
+ * @param filePath - Absolute path to the JSON file to read.
+ * @returns The parsed JSON cast to `T`, or `undefined` when the file does not exist or its contents are not valid JSON.
+ */ function readJsonFile(filePath) {
+    return new Promise(function(resolve, reject) {
+        readFile$1(filePath, {
+            encoding: 'utf-8'
+        }, function(err, data) {
+            if (err) {
+                if (err.code === 'ENOENT') {
+                    resolve(undefined);
+                } else {
+                    reject(err);
+                }
+                return;
+            }
+            try {
+                resolve(JSON.parse(data));
+            } catch (unused) {
+                resolve(undefined);
+            }
+        });
+    });
+}
+/**
+ * Writes a value to disk as JSON. Creates the parent directory if it does not exist.
+ *
+ * The `mode` option is enforced via an explicit `chmod` after the write — `writeFile`'s `mode`
+ * parameter is ignored when the file already exists, which would otherwise leave a
+ * pre-existing file at its original (potentially world-readable) permissions.
+ *
+ * @param input - Configuration describing the destination, payload, and optional file mode.
+ * @param input.filePath - Absolute path to the file to write.
+ * @param input.dirPath - Absolute path to the parent directory; created (recursively) when missing.
+ * @param input.data - Value to serialize as JSON (pretty-printed with two-space indentation).
+ * @param input.mode - Optional numeric file mode (e.g. `0o600`) applied via `chmod` after the write.
+ * @returns A promise that resolves once the JSON has been written and the optional `chmod` has completed.
+ */ function writeJsonFile(input) {
+    mkdirSync(input.dirPath, {
+        recursive: true
+    });
+    return new Promise(function(resolve, reject) {
+        writeFile(input.filePath, JSON.stringify(input.data, null, 2), {
+            mode: input.mode
+        }, function(err) {
+            if (err) {
+                reject(err);
+                return;
+            }
+            if (input.mode == null) {
+                resolve();
+                return;
+            }
+            chmod(input.filePath, input.mode, function(chmodErr) {
+                if (chmodErr) reject(chmodErr);
+                else resolve();
+            });
+        });
+    });
+}
+/**
+ * Removes the file at the given path.
+ *
+ * Resolves silently when the file does not exist (`force: true`); other errors
+ * (permission denied, busy file handles) are forwarded to the caller — silently
+ * swallowing them masks real failures and makes operations appear to have succeeded.
+ *
+ * @param filePath - Absolute path to the file to remove.
+ * @returns A promise that resolves once the file is removed (or was already absent).
+ */ function removeFile(filePath) {
+    return rm(filePath, {
+        force: true
+    });
+}
+
+function _array_like_to_array$1(arr, len) {
+    if (len == null || len > arr.length) len = arr.length;
+    for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
+    return arr2;
+}
+function _array_with_holes$1(arr) {
+    if (Array.isArray(arr)) return arr;
+}
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+    try {
+        var info = gen[key](arg);
+        var value = info.value;
+    } catch (error) {
+        reject(error);
+        return;
+    }
+    if (info.done) {
+        resolve(value);
+    } else {
+        Promise.resolve(value).then(_next, _throw);
+    }
+}
+function _async_to_generator(fn) {
+    return function() {
+        var self = this, args = arguments;
+        return new Promise(function(resolve, reject) {
+            var gen = fn.apply(self, args);
+            function _next(value) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+            }
+            function _throw(err) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+            }
+            _next(undefined);
+        });
+    };
+}
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function _iterable_to_array_limit$1(arr, i) {
+    var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
+    if (_i == null) return;
+    var _arr = [];
+    var _n = true;
+    var _d = false;
+    var _s, _e;
+    try {
+        for(_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true){
+            _arr.push(_s.value);
+            if (i && _arr.length === i) break;
+        }
+    } catch (err) {
+        _d = true;
+        _e = err;
+    } finally{
+        try {
+            if (!_n && _i["return"] != null) _i["return"]();
+        } finally{
+            if (_d) throw _e;
+        }
+    }
+    return _arr;
+}
+function _non_iterable_rest$1() {
+    throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _object_spread(target) {
+    for(var i = 1; i < arguments.length; i++){
+        var source = arguments[i] != null ? arguments[i] : {};
+        var ownKeys = Object.keys(source);
+        if (typeof Object.getOwnPropertySymbols === "function") {
+            ownKeys = ownKeys.concat(Object.getOwnPropertySymbols(source).filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(source, sym).enumerable;
+            }));
+        }
+        ownKeys.forEach(function(key) {
+            _define_property(target, key, source[key]);
+        });
+    }
+    return target;
+}
+function ownKeys(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(target, source) {
+    source = source != null ? source : {};
+    if (Object.getOwnPropertyDescriptors) {
+        Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
+    } else {
+        ownKeys(Object(source)).forEach(function(key) {
+            Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
+        });
+    }
+    return target;
+}
+function _sliced_to_array$1(arr, i) {
+    return _array_with_holes$1(arr) || _iterable_to_array_limit$1(arr, i) || _unsupported_iterable_to_array$1(arr, i) || _non_iterable_rest$1();
+}
+function _unsupported_iterable_to_array$1(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array$1(o, minLen);
+    var n = Object.prototype.toString.call(o).slice(8, -1);
+    if (n === "Object" && o.constructor) n = o.constructor.name;
+    if (n === "Map" || n === "Set") return Array.from(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$1(o, minLen);
+}
+function _ts_generator(thisArg, body) {
+    var f, y, t, _ = {
+        label: 0,
+        sent: function() {
+            if (t[0] & 1) throw t[1];
+            return t[1];
+        },
+        trys: [],
+        ops: []
+    }, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype), d = Object.defineProperty;
+    return d(g, "next", {
+        value: verb(0)
+    }), d(g, "throw", {
+        value: verb(1)
+    }), d(g, "return", {
+        value: verb(2)
+    }), typeof Symbol === "function" && d(g, Symbol.iterator, {
+        value: function() {
+            return this;
+        }
+    }), g;
+    function verb(n) {
+        return function(v) {
+            return step([
+                n,
+                v
+            ]);
+        };
+    }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while(g && (g = 0, op[0] && (_ = 0)), _)try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [
+                op[0] & 2,
+                t.value
+            ];
+            switch(op[0]){
+                case 0:
+                case 1:
+                    t = op;
+                    break;
+                case 4:
+                    _.label++;
+                    return {
+                        value: op[1],
+                        done: false
+                    };
+                case 5:
+                    _.label++;
+                    y = op[1];
+                    op = [
+                        0
+                    ];
+                    continue;
+                case 7:
+                    op = _.ops.pop();
+                    _.trys.pop();
+                    continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
+                        _ = 0;
+                        continue;
+                    }
+                    if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
+                        _.label = op[1];
+                        break;
+                    }
+                    if (op[0] === 6 && _.label < t[1]) {
+                        _.label = t[1];
+                        t = op;
+                        break;
+                    }
+                    if (t && _.label < t[2]) {
+                        _.label = t[2];
+                        _.ops.push(op);
+                        break;
+                    }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop();
+                    continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) {
+            op = [
+                6,
+                e
+            ];
+            y = 0;
+        } finally{
+            f = t = 0;
+        }
+        if (op[0] & 5) throw op[1];
+        return {
+            value: op[0] ? op[1] : void 0,
+            done: true
+        };
+    }
+}
+/**
+ * Default file mode used by the JSON-file caches when none is provided.
+ *
+ * 0o600 restricts the file to read/write for the owning user only — appropriate for
+ * secrets like cached access/refresh tokens.
+ */ var DEFAULT_JSON_FILE_CACHE_MODE = 384;
+/**
+ * Creates an {@link AsyncValueCache} backed by a single JSON file on disk.
+ *
+ * Reads always touch disk; wrap with {@link memoizeAsyncValueCache} (or use
+ * {@link createMemoizedJsonFileAsyncValueCache}) to add per-process memoization.
+ *
+ * Multi-process invalidation is not provided. Two processes writing to the same file
+ * will last-writer-wins; once memoized, a long-running process will not observe writes
+ * from another process.
+ *
+ * @param input - Configuration bag describing the backing file and optional JSON revive/replace hooks.
+ * @param input.filePath - Absolute path to the JSON file that backs the cache.
+ * @param input.mode - Optional file mode applied on write; defaults to {@link DEFAULT_JSON_FILE_CACHE_MODE} (0o600).
+ * @param input.reviver - Optional transform applied to the raw JSON-parsed payload before it is returned from `load()` (e.g. revive `Date` fields).
+ * @param input.replacer - Optional transform applied to the value before it is stringified to JSON on `update()`.
+ * @returns An {@link AsyncValueCache} that persists the value to the configured JSON file.
+ */ function createJsonFileAsyncValueCache(input) {
+    var filePath = input.filePath, mode = input.mode, reviver = input.reviver, replacer = input.replacer;
+    var fileMode = mode !== null && mode !== void 0 ? mode : DEFAULT_JSON_FILE_CACHE_MODE;
+    return {
+        load: function load() {
+            return _async_to_generator(function() {
+                var raw;
+                return _ts_generator(this, function(_state) {
+                    switch(_state.label){
+                        case 0:
+                            return [
+                                4,
+                                readJsonFile(filePath)
+                            ];
+                        case 1:
+                            raw = _state.sent();
+                            if (raw == null) {
+                                return [
+                                    2,
+                                    undefined
+                                ];
+                            }
+                            return [
+                                2,
+                                reviver == null ? raw : reviver(raw)
+                            ];
+                    }
+                });
+            })();
+        },
+        update: function update(value) {
+            return _async_to_generator(function() {
+                var data;
+                return _ts_generator(this, function(_state) {
+                    switch(_state.label){
+                        case 0:
+                            data = replacer == null ? value : replacer(value);
+                            return [
+                                4,
+                                writeJsonFile({
+                                    filePath: filePath,
+                                    dirPath: dirname(filePath),
+                                    data: data,
+                                    mode: fileMode
+                                })
+                            ];
+                        case 1:
+                            _state.sent();
+                            return [
+                                2
+                            ];
+                    }
+                });
+            })();
+        },
+        clear: function clear() {
+            return _async_to_generator(function() {
+                return _ts_generator(this, function(_state) {
+                    switch(_state.label){
+                        case 0:
+                            return [
+                                4,
+                                removeFile(filePath)
+                            ];
+                        case 1:
+                            _state.sent();
+                            return [
+                                2
+                            ];
+                    }
+                });
+            })();
+        }
+    };
+}
+/**
+ * Convenience wrapper around {@link createJsonFileAsyncValueCache} composed with
+ * {@link memoizeAsyncValueCache}.
+ *
+ * @param input - Same configuration accepted by {@link createJsonFileAsyncValueCache}; see {@link CreateJsonFileAsyncValueCacheInput}.
+ * @returns An {@link AsyncValueCache} backed by the JSON file with a per-process single-load memoization layer in front.
+ */ function createMemoizedJsonFileAsyncValueCache(input) {
+    return memoizeAsyncValueCache(createJsonFileAsyncValueCache(input));
+}
+/**
+ * Creates an {@link AsyncKeyedValueCache} backed by a single JSON file holding a `Record<string, T>`.
+ *
+ * Reads/writes always touch disk; wrap with {@link memoizeAsyncKeyedValueCache} (or use
+ * {@link createMemoizedJsonFileAsyncKeyedValueCache}) to add per-process memoization of the
+ * entire record.
+ *
+ * Multi-process invalidation is not provided; see {@link createJsonFileAsyncValueCache} for caveats.
+ *
+ * Concurrent `set`/`remove`/`clear` calls are serialized through a per-instance promise chain so
+ * the read-modify-write of the entire record file does not race within the same process.
+ *
+ * @param input - Configuration bag describing the backing file and optional per-entry revive/replace hooks.
+ * @param input.filePath - Absolute path to the JSON file that holds the entire `Record<string, T>`.
+ * @param input.mode - Optional file mode applied on write; defaults to {@link DEFAULT_JSON_FILE_CACHE_MODE} (0o600).
+ * @param input.reviver - Optional transform applied to each entry after it is JSON-parsed on `load()`/`get()`. Returning null/undefined drops the entry.
+ * @param input.replacer - Optional transform applied to each entry before it is stringified on `set()`.
+ * @returns An {@link AsyncKeyedValueCache} that persists all entries in the configured JSON file.
+ */ function createJsonFileAsyncKeyedValueCache(input) {
+    var filePath = input.filePath, mode = input.mode, reviver = input.reviver, replacer = input.replacer;
+    var fileMode = mode !== null && mode !== void 0 ? mode : DEFAULT_JSON_FILE_CACHE_MODE;
+    function readEntries() {
+        return _async_to_generator(function() {
+            var raw, result, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, key, revived;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        return [
+                            4,
+                            readJsonFile(filePath)
+                        ];
+                    case 1:
+                        raw = _state.sent();
+                        if (raw == null) {
+                            return [
+                                2,
+                                {}
+                            ];
+                        }
+                        if (reviver == null) {
+                            return [
+                                2,
+                                raw
+                            ];
+                        }
+                        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;
+                                revived = reviver(raw[key]);
+                                if (revived != null) {
+                                    result[key] = revived;
+                                }
+                            }
+                        } catch (err) {
+                            _didIteratorError = true;
+                            _iteratorError = err;
+                        } finally{
+                            try {
+                                if (!_iteratorNormalCompletion && _iterator.return != null) {
+                                    _iterator.return();
+                                }
+                            } finally{
+                                if (_didIteratorError) {
+                                    throw _iteratorError;
+                                }
+                            }
+                        }
+                        return [
+                            2,
+                            result
+                        ];
+                }
+            });
+        })();
+    }
+    function writeEntries(entries) {
+        return _async_to_generator(function() {
+            var data;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        data = replacer == null ? entries : Object.fromEntries(Object.entries(entries).map(function(param) {
+                            var _param = _sliced_to_array$1(param, 2), key = _param[0], value = _param[1];
+                            return [
+                                key,
+                                replacer(value)
+                            ];
+                        }));
+                        return [
+                            4,
+                            writeJsonFile({
+                                filePath: filePath,
+                                dirPath: dirname(filePath),
+                                data: data,
+                                mode: fileMode
+                            })
+                        ];
+                    case 1:
+                        _state.sent();
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    }
+    // Serialize set/remove through a per-instance promise chain. Without this, two concurrent
+    // mutations would race on the read-modify-write of the entire record file and the second
+    // writer's snapshot of the entries would clobber the first.
+    var mutationQueue = Promise.resolve();
+    function enqueueMutation(fn) {
+        var next = mutationQueue.then(fn, fn);
+        mutationQueue = next.catch(function() {
+            return undefined;
+        });
+        return next;
+    }
+    return {
+        load: readEntries,
+        get: function get(key) {
+            return _async_to_generator(function() {
+                return _ts_generator(this, function(_state) {
+                    switch(_state.label){
+                        case 0:
+                            return [
+                                4,
+                                readEntries()
+                            ];
+                        case 1:
+                            return [
+                                2,
+                                _state.sent()[key]
+                            ];
+                    }
+                });
+            })();
+        },
+        set: function set(key, value) {
+            return enqueueMutation(function() {
+                return _async_to_generator(function() {
+                    var current;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                return [
+                                    4,
+                                    readEntries()
+                                ];
+                            case 1:
+                                current = _state.sent();
+                                return [
+                                    4,
+                                    writeEntries(_object_spread_props(_object_spread({}, current), _define_property({}, key, value)))
+                                ];
+                            case 2:
+                                _state.sent();
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                })();
+            });
+        },
+        remove: function remove(key) {
+            return enqueueMutation(function() {
+                return _async_to_generator(function() {
+                    var current, next;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                return [
+                                    4,
+                                    readEntries()
+                                ];
+                            case 1:
+                                current = _state.sent();
+                                next = _object_spread({}, current);
+                                delete next[key];
+                                return [
+                                    4,
+                                    writeEntries(next)
+                                ];
+                            case 2:
+                                _state.sent();
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                })();
+            });
+        },
+        clear: function clear() {
+            return enqueueMutation(function() {
+                return _async_to_generator(function() {
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                return [
+                                    4,
+                                    removeFile(filePath)
+                                ];
+                            case 1:
+                                _state.sent();
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                })();
+            });
+        }
+    };
+}
+/**
+ * Convenience wrapper around {@link createJsonFileAsyncKeyedValueCache} composed with
+ * {@link memoizeAsyncKeyedValueCache}.
+ *
+ * @param input - Same configuration accepted by {@link createJsonFileAsyncKeyedValueCache}; see {@link CreateJsonFileAsyncKeyedValueCacheInput}.
+ * @returns An {@link AsyncKeyedValueCache} backed by the JSON file with a per-process record-level memoization layer in front.
+ */ function createMemoizedJsonFileAsyncKeyedValueCache(input) {
+    return memoizeAsyncKeyedValueCache(createJsonFileAsyncKeyedValueCache(input));
+}
+
 // MARK: Constants
 /**
  * AES-256-GCM encryption constants.
@@ -2093,4 +2728,4 @@ function constantTimeEquals(a, b) {
     return result;
 }
 
-export { AppModuleWithWebhooksEnabled, CLIENT_WEB_APP_URL_ENV_VAR, ClientAppModule, ClientAppService, ClientAppServiceConfig, ConfigureWebhookMiddlewareModule, DEFAULT_BASE_WEBHOOK_PATH, DEFAULT_WEBHOOK_MIDDLEWARE_ROUTE_INFO, IsRequestFromLocalHost, JsonBodyMiddleware, ParseRawBody, ParsedQueryRawBody, RawBody, RawBodyMiddleware, RawBodyToJson, RawBodyToParsedQueryString, RawBodyToString, SERVER_ENV_TOKEN, ServerEnvironmentConfig, ServerEnvironmentService, appAssetLoaderModuleMetadata, clientAppConfigFactory, consumeWebhooksWithRawBodyMiddleware, createAES256GCMEncryption, createAesStringEncryptionProvider, decryptValue, detectPdfEncryption, encryptValue, injectionTokensFromProviders, isLocalhost, isTestNodeEnv, isValidAES256GCMEncryptionSecret, mergeModuleMetadata, nodeJsLocalAssetLoader, resolveEncryptionKey, serverEnvTokenProvider };
+export { AppModuleWithWebhooksEnabled, CLIENT_WEB_APP_URL_ENV_VAR, ClientAppModule, ClientAppService, ClientAppServiceConfig, ConfigureWebhookMiddlewareModule, DEFAULT_BASE_WEBHOOK_PATH, DEFAULT_JSON_FILE_CACHE_MODE, DEFAULT_WEBHOOK_MIDDLEWARE_ROUTE_INFO, IsRequestFromLocalHost, JsonBodyMiddleware, ParseRawBody, ParsedQueryRawBody, RawBody, RawBodyMiddleware, RawBodyToJson, RawBodyToParsedQueryString, RawBodyToString, SERVER_ENV_TOKEN, ServerEnvironmentConfig, ServerEnvironmentService, appAssetLoaderModuleMetadata, clientAppConfigFactory, consumeWebhooksWithRawBodyMiddleware, createAES256GCMEncryption, createAesStringEncryptionProvider, createJsonFileAsyncKeyedValueCache, createJsonFileAsyncValueCache, createMemoizedJsonFileAsyncKeyedValueCache, createMemoizedJsonFileAsyncValueCache, decryptValue, detectPdfEncryption, encryptValue, injectionTokensFromProviders, isLocalhost, isTestNodeEnv, isValidAES256GCMEncryptionSecret, mergeModuleMetadata, nodeJsLocalAssetLoader, readJsonFile, removeFile, resolveEncryptionKey, serverEnvTokenProvider, writeJsonFile };