@dereekb/nestjs 13.10.8 → 13.11.0

package/index.cjs.js

@@ -9,9 +9,11 @@ var querystring = require('querystring');
 var bodyParser = require('body-parser');
 var util = require('@dereekb/util');
 var config = require('@nestjs/config');
+var node_fs = require('node:fs');
+var promises$1 = require('node:fs/promises');
 var node_crypto = require('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;
@@ -25,22 +27,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() {
@@ -159,9 +161,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;
@@ -240,7 +242,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;
@@ -254,22 +256,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() {
@@ -382,9 +384,9 @@ function _ts_generator(thisArg, body) {
  * ```
  */ var rawBodyLogger = new common.Logger('RawBody');
 var ParseRawBody = common.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();
@@ -419,9 +421,9 @@ var ParseRawBody = common.createParamDecorator(function(_, context) {
  * handleWebhook(@RawBody() body: RawBodyBuffer) { ... }
  * ```
  */ var RawBody = common.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)) {
@@ -445,9 +447,9 @@ var ParseRawBody = common.createParamDecorator(function(_, context) {
  * handleForm(@ParsedQueryRawBody() body: ParsedUrlQuery) { ... }
  * ```
  */ var ParsedQueryRawBody = common.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 [
@@ -631,7 +633,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,
@@ -739,7 +741,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 common.Logger('ConfigureWebhookMiddlewareModule'));
+        _this = _call_super(this, ConfigureWebhookMiddlewareModule, arguments), _define_property$4(_this, "logger", new common.Logger('ConfigureWebhookMiddlewareModule'));
         return _this;
     }
     _create_class$3(ConfigureWebhookMiddlewareModule, [
@@ -836,7 +838,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,
@@ -856,7 +858,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, [
         {
@@ -895,7 +897,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,
@@ -913,7 +915,7 @@ function _define_property$1(obj, key, value) {
  */ exports.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, [
@@ -1052,7 +1054,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,
@@ -1068,7 +1070,7 @@ function _define_property(obj, key, value) {
 exports.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, [
@@ -1116,6 +1118,639 @@ exports.ServerEnvironmentService = __decorate([
     __param(0, common.Inject(SERVER_ENV_TOKEN))
 ], exports.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) {
+        node_fs.readFile(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) {
+    node_fs.mkdirSync(input.dirPath, {
+        recursive: true
+    });
+    return new Promise(function(resolve, reject) {
+        node_fs.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;
+            }
+            node_fs.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 promises$1.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: node_path.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 util.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: node_path.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 util.memoizeAsyncKeyedValueCache(createJsonFileAsyncKeyedValueCache(input));
+}
+
 // MARK: Constants
 /**
  * AES-256-GCM encryption constants.
@@ -1307,10 +1942,799 @@ var ENCRYPTED_FIELD_KEY_LENGTH = 32;
     return result;
 }
 
+function _array_like_to_array(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(arr) {
+    if (Array.isArray(arr)) return arr;
+}
+function _iterable_to_array_limit(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() {
+    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 _sliced_to_array(arr, i) {
+    return _array_with_holes(arr) || _iterable_to_array_limit(arr, i) || _unsupported_iterable_to_array(arr, i) || _non_iterable_rest();
+}
+function _unsupported_iterable_to_array(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array(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(o, minLen);
+}
+/**
+ * 32-byte password padding string defined by ISO 32000 §7.6.3.3 (Algorithm 2).
+ * Used to pad short or empty user/owner passwords for the standard security handler.
+ */ var PDF_PASSWORD_PADDING = Buffer.from([
+    0x28,
+    0xbf,
+    0x4e,
+    0x5e,
+    0x4e,
+    0x75,
+    0x8a,
+    0x41,
+    0x64,
+    0x00,
+    0x4e,
+    0x56,
+    0xff,
+    0xfa,
+    0x01,
+    0x08,
+    0x2e,
+    0x2e,
+    0x00,
+    0xb6,
+    0xd0,
+    0x68,
+    0x3e,
+    0x80,
+    0x2f,
+    0x0c,
+    0xa9,
+    0xfe,
+    0x64,
+    0x53,
+    0x69,
+    0x7a
+]);
+/**
+ * Detects whether a PDF is unencrypted, write-protected (openable without a password
+ * but restricted from editing/printing), or fully encrypted (requires a password to open).
+ *
+ * Implements the user-password validation algorithms from ISO 32000-1 §7.6.3 (R≤4) and
+ * ISO 32000-2 §7.6.4.4 (R=5/6) using only the empty password. If the empty password
+ * validates successfully, the PDF is openable by anyone and only its modify/print/copy
+ * permissions are restricted; otherwise a non-empty user password is required.
+ *
+ * Supported security handlers:
+ * - Standard security handler, R=2,3,4 (RC4-40, RC4-128, AES-128 with crypt filters).
+ * - Standard security handler, R=5 (AES-256, deprecated Adobe extension).
+ * - Standard security handler, R=6 (AES-256, ISO 32000-2 / PDF 2.0).
+ *
+ * Unrecognised security handlers (e.g. PubSec, custom handlers) return
+ * `unknown_encrypted` so callers can choose whether to treat them as fully encrypted.
+ *
+ * Lives in `@dereekb/nestjs` (rather than `@dereekb/util`) because it uses Node's
+ * built-in `node:crypto` module, which isn't available in the browser.
+ *
+ * @example
+ * ```ts
+ * const status = detectPdfEncryption(buffer);
+ *
+ * if (status === 'fully_encrypted') {
+ *   throw new Error('PDF requires a password to open.');
+ * }
+ * if (status === 'write_protected_only') {
+ *   // Safe to read, but not to mutate without the owner password.
+ * }
+ * ```
+ *
+ * @param buffer - PDF file contents.
+ * @returns The encryption status of the PDF.
+ */ function detectPdfEncryption(buffer) {
+    var result = 'unknown_encrypted';
+    var encryptIndex = findEncryptKeywordIndex(buffer);
+    if (encryptIndex < 0) {
+        result = 'none';
+    } else {
+        var dict = extractEncryptionDictionary(buffer, encryptIndex);
+        var info = dict ? parseEncryptionInfo(dict) : null;
+        if ((info === null || info === void 0 ? void 0 : info.filter) === 'Standard') {
+            var opensWithEmptyPassword = checkStandardHandlerEmptyPassword(info, buffer);
+            if (opensWithEmptyPassword !== null) {
+                result = opensWithEmptyPassword ? 'write_protected_only' : 'fully_encrypted';
+            }
+        }
+    }
+    return result;
+}
+function checkStandardHandlerEmptyPassword(info, buffer) {
+    var result = null;
+    if (info.R >= 2 && info.R <= 4) {
+        var fileId = extractFirstFileId(buffer);
+        if (fileId && info.O.length >= 32 && info.U.length >= 32) {
+            result = validateEmptyPasswordR2to4(info, fileId);
+        }
+    } else if (info.R === 5 && info.U.length >= 48) {
+        result = validateEmptyPasswordR5(info);
+    } else if (info.R === 6 && info.U.length >= 48) {
+        result = validateEmptyPasswordR6(info);
+    }
+    return result;
+}
+function isPdfWhitespaceByte(b) {
+    return b === 0x00 || b === 0x09 || b === 0x0a || b === 0x0c || b === 0x0d || b === 0x20;
+}
+function isPdfDelimiterByte(b) {
+    return b === 0x28 || b === 0x29 || b === 0x3c || b === 0x3e || b === 0x5b || b === 0x5d || b === 0x7b || b === 0x7d || b === 0x2f || b === 0x25;
+}
+function isPdfWhitespaceOrDelimiter(b) {
+    return isPdfWhitespaceByte(b) || isPdfDelimiterByte(b);
+}
+function skipPdfWhitespaceAndComments(buffer, start) {
+    var i = start;
+    while(i < buffer.length){
+        var b = buffer[i];
+        if (isPdfWhitespaceByte(b)) {
+            i++;
+        } else if (b === 0x25 /* % */ ) {
+            while(i < buffer.length && buffer[i] !== 0x0a && buffer[i] !== 0x0d)i++;
+        } else {
+            break;
+        }
+    }
+    return i;
+}
+function skipPdfLiteralString(buffer, start) {
+    var depth = 1;
+    var i = start + 1;
+    while(i < buffer.length && depth > 0){
+        var b = buffer[i];
+        if (b === 0x5c /* \ */ ) {
+            i += 2;
+        } else if (b === 0x28 /* ( */ ) {
+            depth++;
+            i++;
+        } else if (b === 0x29 /* ) */ ) {
+            depth--;
+            i++;
+        } else {
+            i++;
+        }
+    }
+    return i;
+}
+function skipPdfHexString(buffer, start) {
+    var i = start + 1;
+    while(i < buffer.length && buffer[i] !== 0x3e /* > */ )i++;
+    return i < buffer.length ? i + 1 : i;
+}
+function findDictEnd(buffer, start) {
+    var depth = 1;
+    var i = start;
+    var endIndex = -1;
+    while(i < buffer.length && endIndex < 0){
+        var b = buffer[i];
+        if (b === 0x3c && buffer[i + 1] === 0x3c) {
+            depth++;
+            i += 2;
+        } else if (b === 0x3e && buffer[i + 1] === 0x3e) {
+            depth--;
+            if (depth === 0) {
+                endIndex = i;
+            } else {
+                i += 2;
+            }
+        } else if (b === 0x28) {
+            i = skipPdfLiteralString(buffer, i);
+        } else if (b === 0x3c) {
+            i = skipPdfHexString(buffer, i);
+        } else if (b === 0x25) {
+            while(i < buffer.length && buffer[i] !== 0x0a && buffer[i] !== 0x0d)i++;
+        } else {
+            i++;
+        }
+    }
+    return endIndex >= 0 ? endIndex : i;
+}
+function decodePdfLiteralString(content) {
+    var out = [];
+    var i = 0;
+    while(i < content.length){
+        var b = content[i];
+        if (b !== 0x5c /* \ */ ) {
+            out.push(b);
+            i++;
+            continue;
+        }
+        i++;
+        if (i >= content.length) break;
+        var c = content[i];
+        if (c >= 0x30 && c <= 0x37) {
+            var oct = c - 0x30;
+            i++;
+            if (i < content.length && content[i] >= 0x30 && content[i] <= 0x37) {
+                oct = oct * 8 + (content[i] - 0x30);
+                i++;
+                if (i < content.length && content[i] >= 0x30 && content[i] <= 0x37) {
+                    oct = oct * 8 + (content[i] - 0x30);
+                    i++;
+                }
+            }
+            out.push(oct & 0xff);
+        } else if (c === 0x6e /* n */ ) {
+            out.push(0x0a);
+            i++;
+        } else if (c === 0x72 /* r */ ) {
+            out.push(0x0d);
+            i++;
+        } else if (c === 0x74 /* t */ ) {
+            out.push(0x09);
+            i++;
+        } else if (c === 0x62 /* b */ ) {
+            out.push(0x08);
+            i++;
+        } else if (c === 0x66 /* f */ ) {
+            out.push(0x0c);
+            i++;
+        } else if (c === 0x0a) {
+            i++;
+        } else if (c === 0x0d) {
+            i++;
+            if (i < content.length && content[i] === 0x0a) i++;
+        } else {
+            out.push(c);
+            i++;
+        }
+    }
+    return Buffer.from(out);
+}
+function decodePdfHexString(content) {
+    var hex = [];
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = content[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var b = _step.value;
+            if (isPdfWhitespaceByte(b)) continue;
+            if (b >= 0x30 && b <= 0x39 || b >= 0x41 && b <= 0x46 || b >= 0x61 && b <= 0x66) hex.push(b);
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    if (hex.length % 2 === 1) hex.push(0x30);
+    var out = Buffer.alloc(hex.length / 2);
+    for(var i = 0; i < out.length; i++){
+        out[i] = parseInt(String.fromCharCode(hex[i * 2], hex[i * 2 + 1]), 16);
+    }
+    return out;
+}
+function readPdfNumber(buffer, start) {
+    var i = start;
+    while(i < buffer.length && !isPdfWhitespaceOrDelimiter(buffer[i]))i++;
+    var result = null;
+    if (i > start) {
+        var text = buffer.toString('latin1', start, i);
+        var value = Number(text);
+        if (!Number.isNaN(value)) {
+            result = {
+                value: value,
+                end: i
+            };
+        }
+    }
+    return result;
+}
+function parsePdfDict(buffer, dictStart) {
+    // dictStart is the byte after `<<`.
+    var entries = new Map();
+    var i = skipPdfWhitespaceAndComments(buffer, dictStart);
+    var result = null;
+    var aborted = false;
+    while(i < buffer.length && !aborted && result === null){
+        if (buffer[i] === 0x3e && buffer[i + 1] === 0x3e) {
+            result = {
+                entries: entries,
+                end: i + 2
+            };
+        } else if (buffer[i] !== 0x2f /* / */ ) {
+            aborted = true;
+        } else {
+            var nameStart = i + 1;
+            var nameEnd = nameStart;
+            while(nameEnd < buffer.length && !isPdfWhitespaceOrDelimiter(buffer[nameEnd]))nameEnd++;
+            var name = buffer.toString('latin1', nameStart, nameEnd);
+            i = skipPdfWhitespaceAndComments(buffer, nameEnd);
+            if (i >= buffer.length) {
+                aborted = true;
+            } else {
+                var valueResult = readPdfValue(buffer, i);
+                if (!valueResult) {
+                    aborted = true;
+                } else {
+                    entries.set(name, valueResult.entry);
+                    i = skipPdfWhitespaceAndComments(buffer, valueResult.end);
+                }
+            }
+        }
+    }
+    return result;
+}
+function readPdfValue(buffer, start) {
+    var b = buffer[start];
+    var result;
+    if (b === 0x3c && buffer[start + 1] === 0x3c) {
+        result = readPdfDictValue(buffer, start);
+    } else if (b === 0x3c) {
+        result = readPdfHexStringValue(buffer, start);
+    } else if (b === 0x28) {
+        result = readPdfLiteralStringValue(buffer, start);
+    } else if (b === 0x5b /* [ */ ) {
+        result = readPdfArrayValue(buffer, start);
+    } else if (b === 0x2f /* / */ ) {
+        result = readPdfNameValue(buffer, start);
+    } else {
+        result = readPdfTokenOrRefValue(buffer, start);
+    }
+    return result;
+}
+function readPdfDictValue(buffer, start) {
+    var dictEnd = findDictEnd(buffer, start + 2);
+    var end = dictEnd < buffer.length && buffer[dictEnd] === 0x3e && buffer[dictEnd + 1] === 0x3e ? dictEnd + 2 : dictEnd;
+    return {
+        entry: {
+            type: 'dict',
+            raw: buffer.subarray(start, end)
+        },
+        end: end
+    };
+}
+function readPdfHexStringValue(buffer, start) {
+    var end = skipPdfHexString(buffer, start);
+    return {
+        entry: {
+            type: 'string',
+            raw: decodePdfHexString(buffer.subarray(start + 1, end - 1))
+        },
+        end: end
+    };
+}
+function readPdfLiteralStringValue(buffer, start) {
+    var end = skipPdfLiteralString(buffer, start);
+    return {
+        entry: {
+            type: 'string',
+            raw: decodePdfLiteralString(buffer.subarray(start + 1, end - 1))
+        },
+        end: end
+    };
+}
+function readPdfArrayValue(buffer, start) {
+    var depth = 1;
+    var i = start + 1;
+    while(i < buffer.length && depth > 0){
+        var c = buffer[i];
+        if (c === 0x5b) {
+            depth++;
+            i++;
+        } else if (c === 0x5d) {
+            depth--;
+            i++;
+        } else if (c === 0x28) {
+            i = skipPdfLiteralString(buffer, i);
+        } else if (c === 0x3c && buffer[i + 1] === 0x3c) {
+            var e = findDictEnd(buffer, i + 2);
+            i = e < buffer.length && buffer[e] === 0x3e && buffer[e + 1] === 0x3e ? e + 2 : e;
+        } else if (c === 0x3c) {
+            i = skipPdfHexString(buffer, i);
+        } else if (c === 0x25) {
+            while(i < buffer.length && buffer[i] !== 0x0a && buffer[i] !== 0x0d)i++;
+        } else {
+            i++;
+        }
+    }
+    return {
+        entry: {
+            type: 'array',
+            raw: buffer.subarray(start, i)
+        },
+        end: i
+    };
+}
+function readPdfNameValue(buffer, start) {
+    var i = start + 1;
+    while(i < buffer.length && !isPdfWhitespaceOrDelimiter(buffer[i]))i++;
+    return {
+        entry: {
+            type: 'name',
+            raw: buffer.subarray(start + 1, i)
+        },
+        end: i
+    };
+}
+function readPdfTokenOrRefValue(buffer, start) {
+    // Number, boolean, null, or indirect reference like `12 0 R`.
+    var i = start;
+    while(i < buffer.length && !isPdfWhitespaceOrDelimiter(buffer[i]))i++;
+    var tokenEnd = i;
+    var token = buffer.toString('latin1', start, tokenEnd);
+    var referenceEnd = readIndirectReferenceEnd(buffer, tokenEnd);
+    var result;
+    if (referenceEnd !== null) {
+        result = {
+            entry: {
+                type: 'ref',
+                raw: buffer.subarray(start, referenceEnd)
+            },
+            end: referenceEnd
+        };
+    } else if (token === 'true' || token === 'false') {
+        result = {
+            entry: {
+                type: 'boolean',
+                raw: buffer.subarray(start, tokenEnd)
+            },
+            end: tokenEnd
+        };
+    } else if (token === 'null') {
+        result = {
+            entry: {
+                type: 'null',
+                raw: buffer.subarray(start, tokenEnd)
+            },
+            end: tokenEnd
+        };
+    } else {
+        result = {
+            entry: {
+                type: 'number',
+                raw: buffer.subarray(start, tokenEnd)
+            },
+            end: tokenEnd
+        };
+    }
+    return result;
+}
+function readIndirectReferenceEnd(buffer, tokenEnd) {
+    // Probe ahead for `GEN R` after a leading object number to detect `N G R`.
+    var result = null;
+    var probe = skipPdfWhitespaceAndComments(buffer, tokenEnd);
+    if (probe < buffer.length) {
+        var c = buffer[probe];
+        if (c >= 0x30 && c <= 0x39) {
+            var secondEnd = probe;
+            while(secondEnd < buffer.length && !isPdfWhitespaceOrDelimiter(buffer[secondEnd]))secondEnd++;
+            var probe2 = skipPdfWhitespaceAndComments(buffer, secondEnd);
+            if (probe2 < buffer.length && buffer[probe2] === 0x52 /* R */  && (probe2 + 1 === buffer.length || isPdfWhitespaceOrDelimiter(buffer[probe2 + 1]))) {
+                result = probe2 + 1;
+            }
+        }
+    }
+    return result;
+}
+function findEncryptKeywordIndex(buffer) {
+    var marker = util.PDF_ENCRYPT_MARKER;
+    var last = -1;
+    var pos = 0;
+    while(true){
+        var found = buffer.indexOf(marker, pos);
+        if (found < 0) break;
+        var next = buffer[found + marker.length];
+        // Avoid matching `/EncryptMetadata` (a different name).
+        var isAlpha = next >= 0x41 && next <= 0x5a || next >= 0x61 && next <= 0x7a;
+        if (!isAlpha) last = found;
+        pos = found + marker.length;
+    }
+    return last;
+}
+function extractEncryptionDictionary(buffer, encryptIndex) {
+    var result = null;
+    var i = encryptIndex + util.PDF_ENCRYPT_MARKER.length;
+    i = skipPdfWhitespaceAndComments(buffer, i);
+    if (i < buffer.length) {
+        if (buffer[i] === 0x3c && buffer[i + 1] === 0x3c) {
+            // Inline dictionary.
+            var dictEnd = findDictEnd(buffer, i + 2);
+            result = buffer.subarray(i, dictEnd + 2);
+        } else {
+            // Indirect reference: `N G R`.
+            result = resolveIndirectEncryptionDictionary(buffer, i);
+        }
+    }
+    return result;
+}
+function resolveIndirectEncryptionDictionary(buffer, start) {
+    var result = null;
+    var numResult = readPdfNumber(buffer, start);
+    if (numResult) {
+        var afterFirst = skipPdfWhitespaceAndComments(buffer, numResult.end);
+        var genResult = readPdfNumber(buffer, afterFirst);
+        if (genResult) {
+            var afterSecond = skipPdfWhitespaceAndComments(buffer, genResult.end);
+            if (buffer[afterSecond] === 0x52 /* R */ ) {
+                var objStart = findIndirectObjectStart(buffer, numResult.value, genResult.value);
+                if (objStart >= 0) {
+                    var dictStart = buffer.indexOf('<<', objStart);
+                    if (dictStart >= 0) {
+                        var dictEnd = findDictEnd(buffer, dictStart + 2);
+                        result = buffer.subarray(dictStart, dictEnd + 2);
+                    }
+                }
+            }
+        }
+    }
+    return result;
+}
+function findIndirectObjectStart(buffer, objNum, objGen) {
+    var text = buffer.toString('latin1');
+    var re = new RegExp("(?:^|[\\r\\n\\s])".concat(objNum, "\\s+").concat(objGen, "\\s+obj\\b"));
+    var match = re.exec(text);
+    return match ? match.index + match[0].length : -1;
+}
+function parseEncryptionInfo(dictBuffer) {
+    // `dictBuffer` is the full `<< ... >>`; pass the body to parsePdfDict.
+    var result = null;
+    var isDict = dictBuffer.length >= 4 && dictBuffer[0] === 0x3c && dictBuffer[1] === 0x3c;
+    var parsed = isDict ? parsePdfDict(dictBuffer, 2) : null;
+    if (parsed) {
+        var _readNameValue, _readNumberValue, _readNumberValue1, _readNumberValue2, _readStringValue, _readStringValue1, _readNumberValue3, _readBooleanValue;
+        var entries = parsed.entries;
+        var filter = (_readNameValue = readNameValue(entries.get('Filter'))) !== null && _readNameValue !== void 0 ? _readNameValue : '';
+        var V = (_readNumberValue = readNumberValue(entries.get('V'))) !== null && _readNumberValue !== void 0 ? _readNumberValue : 0;
+        var R = (_readNumberValue1 = readNumberValue(entries.get('R'))) !== null && _readNumberValue1 !== void 0 ? _readNumberValue1 : 0;
+        var Length = (_readNumberValue2 = readNumberValue(entries.get('Length'))) !== null && _readNumberValue2 !== void 0 ? _readNumberValue2 : V >= 5 ? 256 : 40;
+        var O = (_readStringValue = readStringValue(entries.get('O'))) !== null && _readStringValue !== void 0 ? _readStringValue : Buffer.alloc(0);
+        var U = (_readStringValue1 = readStringValue(entries.get('U'))) !== null && _readStringValue1 !== void 0 ? _readStringValue1 : Buffer.alloc(0);
+        var P = (_readNumberValue3 = readNumberValue(entries.get('P'))) !== null && _readNumberValue3 !== void 0 ? _readNumberValue3 : 0;
+        var encryptMetadataEntry = entries.get('EncryptMetadata');
+        var encryptMetadata = encryptMetadataEntry ? (_readBooleanValue = readBooleanValue(encryptMetadataEntry)) !== null && _readBooleanValue !== void 0 ? _readBooleanValue : true : true;
+        if (R !== 0 && V !== 0) {
+            result = {
+                filter: filter,
+                V: V,
+                R: R,
+                Length: Length,
+                O: O,
+                U: U,
+                P: P,
+                encryptMetadata: encryptMetadata
+            };
+        }
+    }
+    return result;
+}
+function readNumberValue(entry) {
+    var result = null;
+    if ((entry === null || entry === void 0 ? void 0 : entry.type) === 'number') {
+        var value = Number(entry.raw.toString('latin1'));
+        if (!Number.isNaN(value)) {
+            result = value;
+        }
+    }
+    return result;
+}
+function readNameValue(entry) {
+    return (entry === null || entry === void 0 ? void 0 : entry.type) === 'name' ? entry.raw.toString('latin1') : null;
+}
+function readStringValue(entry) {
+    return (entry === null || entry === void 0 ? void 0 : entry.type) === 'string' ? entry.raw : null;
+}
+function readBooleanValue(entry) {
+    return entry.type === 'boolean' ? entry.raw.toString('latin1') === 'true' : null;
+}
+function extractFirstFileId(buffer) {
+    // The /ID array lives in the trailer or the cross-reference stream dictionary.
+    // Walk the buffer right-to-left to find the most recent /ID array.
+    var result = null;
+    var pos = buffer.length;
+    var done = false;
+    while(pos > 0 && !done){
+        var found = buffer.lastIndexOf('/ID', pos);
+        if (found < 0) {
+            done = true;
+        } else {
+            var after = found + 3;
+            var isExactName = after >= buffer.length || isPdfWhitespaceOrDelimiter(buffer[after]);
+            if (isExactName) {
+                var i = skipPdfWhitespaceAndComments(buffer, after);
+                if (buffer[i] === 0x5b /* [ */ ) {
+                    i = skipPdfWhitespaceAndComments(buffer, i + 1);
+                    var valueResult = readPdfValue(buffer, i);
+                    if ((valueResult === null || valueResult === void 0 ? void 0 : valueResult.entry.type) === 'string') {
+                        result = valueResult.entry.raw;
+                        done = true;
+                    }
+                }
+            }
+            if (!done) {
+                pos = found - 1;
+            }
+        }
+    }
+    return result;
+}
+// MARK: Standard security handler — empty-password validation
+function rc4(key, data) {
+    var S = new Uint8Array(256);
+    for(var i = 0; i < 256; i++)S[i] = i;
+    var j = 0;
+    for(var i1 = 0; i1 < 256; i1++){
+        j = j + S[i1] + key[i1 % key.length] & 0xff;
+        var t = S[i1];
+        S[i1] = S[j];
+        S[j] = t;
+    }
+    var out = Buffer.alloc(data.length);
+    var ii = 0;
+    var jj = 0;
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = data.entries()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var _step_value = _sliced_to_array(_step.value, 2), n = _step_value[0], byte = _step_value[1];
+            ii = ii + 1 & 0xff;
+            jj = jj + S[ii] & 0xff;
+            var t1 = S[ii];
+            S[ii] = S[jj];
+            S[jj] = t1;
+            out[n] = byte ^ S[S[ii] + S[jj] & 0xff];
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    return out;
+}
+function computeFileEncryptionKeyR2to4(info, password, fileId) {
+    var padded = Buffer.alloc(32);
+    password.copy(padded, 0, 0, Math.min(password.length, 32));
+    if (password.length < 32) PDF_PASSWORD_PADDING.copy(padded, password.length, 0, 32 - password.length);
+    var md5 = node_crypto.createHash('md5');
+    md5.update(padded);
+    md5.update(info.O);
+    var pBytes = Buffer.alloc(4);
+    pBytes.writeInt32LE(info.P | 0, 0);
+    md5.update(pBytes);
+    md5.update(fileId);
+    if (info.R >= 4 && !info.encryptMetadata) md5.update(Buffer.from([
+        0xff,
+        0xff,
+        0xff,
+        0xff
+    ]));
+    var key = md5.digest();
+    var keyBytes = Math.min(Math.floor(info.Length / 8), key.length);
+    if (info.R >= 3) {
+        for(var i = 0; i < 50; i++){
+            key = node_crypto.createHash('md5').update(key.subarray(0, keyBytes)).digest();
+        }
+    }
+    return key.subarray(0, keyBytes);
+}
+function validateEmptyPasswordR2to4(info, fileId) {
+    var password = Buffer.alloc(0);
+    var key = computeFileEncryptionKeyR2to4(info, password, fileId);
+    var matches;
+    if (info.R === 2) {
+        var expected = rc4(key, PDF_PASSWORD_PADDING);
+        matches = constantTimeEquals(expected, info.U.subarray(0, 32));
+    } else {
+        var computed = node_crypto.createHash('md5').update(PDF_PASSWORD_PADDING).update(fileId).digest();
+        computed = rc4(key, computed);
+        for(var i = 1; i <= 19; i++){
+            var xorKey = Buffer.alloc(key.length);
+            for(var j = 0; j < key.length; j++)xorKey[j] = key[j] ^ i;
+            computed = rc4(xorKey, computed);
+        }
+        matches = constantTimeEquals(computed, info.U.subarray(0, 16));
+    }
+    return matches;
+}
+function validateEmptyPasswordR5(info) {
+    var validationSalt = info.U.subarray(32, 40);
+    var computed = node_crypto.createHash('sha256').update(validationSalt).digest();
+    return constantTimeEquals(computed, info.U.subarray(0, 32));
+}
+function validateEmptyPasswordR6(info) {
+    var validationSalt = info.U.subarray(32, 40);
+    var password = Buffer.alloc(0);
+    var computed = pdfAlgorithm2B(Buffer.concat([
+        password,
+        validationSalt
+    ]), password, Buffer.alloc(0));
+    return constantTimeEquals(computed, info.U.subarray(0, 32));
+}
+function pdfAlgorithm2B(input, password, userKey) {
+    var K = node_crypto.createHash('sha256').update(input).digest();
+    var round = 0;
+    var lastE = Buffer.alloc(0);
+    while(true){
+        var part = Buffer.concat([
+            password,
+            K,
+            userKey
+        ]);
+        var K1 = Buffer.alloc(part.length * 64);
+        for(var i = 0; i < 64; i++)part.copy(K1, i * part.length);
+        var cipher = node_crypto.createCipheriv('aes-128-cbc', K.subarray(0, 16), K.subarray(16, 32));
+        cipher.setAutoPadding(false);
+        var E = Buffer.concat([
+            cipher.update(K1),
+            cipher.final()
+        ]);
+        lastE = E;
+        var n = 0;
+        for(var i1 = 0; i1 < 16; i1++)n = (n * 256 + E[i1]) % 3;
+        if (n === 0) K = node_crypto.createHash('sha256').update(E).digest();
+        else if (n === 1) K = node_crypto.createHash('sha384').update(E).digest();
+        else K = node_crypto.createHash('sha512').update(E).digest();
+        round++;
+        if (round >= 64 && lastE[lastE.length - 1] <= round - 32) break;
+    }
+    return K.subarray(0, 32);
+}
+function constantTimeEquals(a, b) {
+    var result = false;
+    if (a.length === b.length) {
+        var diff = 0;
+        for(var i = 0; i < a.length; i++)diff |= a[i] ^ b[i];
+        result = diff === 0;
+    }
+    return result;
+}
+
 exports.AppModuleWithWebhooksEnabled = AppModuleWithWebhooksEnabled;
 exports.CLIENT_WEB_APP_URL_ENV_VAR = CLIENT_WEB_APP_URL_ENV_VAR;
 exports.ClientAppServiceConfig = ClientAppServiceConfig;
 exports.DEFAULT_BASE_WEBHOOK_PATH = DEFAULT_BASE_WEBHOOK_PATH;
+exports.DEFAULT_JSON_FILE_CACHE_MODE = DEFAULT_JSON_FILE_CACHE_MODE;
 exports.DEFAULT_WEBHOOK_MIDDLEWARE_ROUTE_INFO = DEFAULT_WEBHOOK_MIDDLEWARE_ROUTE_INFO;
 exports.IsRequestFromLocalHost = IsRequestFromLocalHost;
 exports.ParseRawBody = ParseRawBody;
@@ -1326,7 +2750,12 @@ exports.clientAppConfigFactory = clientAppConfigFactory;
 exports.consumeWebhooksWithRawBodyMiddleware = consumeWebhooksWithRawBodyMiddleware;
 exports.createAES256GCMEncryption = createAES256GCMEncryption;
 exports.createAesStringEncryptionProvider = createAesStringEncryptionProvider;
+exports.createJsonFileAsyncKeyedValueCache = createJsonFileAsyncKeyedValueCache;
+exports.createJsonFileAsyncValueCache = createJsonFileAsyncValueCache;
+exports.createMemoizedJsonFileAsyncKeyedValueCache = createMemoizedJsonFileAsyncKeyedValueCache;
+exports.createMemoizedJsonFileAsyncValueCache = createMemoizedJsonFileAsyncValueCache;
 exports.decryptValue = decryptValue;
+exports.detectPdfEncryption = detectPdfEncryption;
 exports.encryptValue = encryptValue;
 exports.injectionTokensFromProviders = injectionTokensFromProviders;
 exports.isLocalhost = isLocalhost;
@@ -1334,5 +2763,8 @@ exports.isTestNodeEnv = isTestNodeEnv;
 exports.isValidAES256GCMEncryptionSecret = isValidAES256GCMEncryptionSecret;
 exports.mergeModuleMetadata = mergeModuleMetadata;
 exports.nodeJsLocalAssetLoader = nodeJsLocalAssetLoader;
+exports.readJsonFile = readJsonFile;
+exports.removeFile = removeFile;
 exports.resolveEncryptionKey = resolveEncryptionKey;
 exports.serverEnvTokenProvider = serverEnvTokenProvider;
+exports.writeJsonFile = writeJsonFile;