@adaptic/utils 0.0.1003 → 0.0.1004

package/dist/index.cjs

@@ -14563,17 +14563,17 @@ var hasRequiredBrowser;
 function requireBrowser () {
 	if (hasRequiredBrowser) return browser.exports;
 	hasRequiredBrowser = 1;
-	(function (module, exports) {
+	(function (module, exports$1) {
 		/**
 		 * This is the web browser implementation of `debug()`.
 		 */
 
-		exports.formatArgs = formatArgs;
-		exports.save = save;
-		exports.load = load;
-		exports.useColors = useColors;
-		exports.storage = localstorage();
-		exports.destroy = (() => {
+		exports$1.formatArgs = formatArgs;
+		exports$1.save = save;
+		exports$1.load = load;
+		exports$1.useColors = useColors;
+		exports$1.storage = localstorage();
+		exports$1.destroy = (() => {
 			let warned = false;
 
 			return () => {
@@ -14588,7 +14588,7 @@ function requireBrowser () {
 		 * Colors.
 		 */
 
-		exports.colors = [
+		exports$1.colors = [
 			'#0000CC',
 			'#0000FF',
 			'#0033CC',
@@ -14753,7 +14753,7 @@ function requireBrowser () {
 		 *
 		 * @api public
 		 */
-		exports.log = console.debug || console.log || (() => {});
+		exports$1.log = console.debug || console.log || (() => {});
 
 		/**
 		 * Save `namespaces`.
@@ -14764,9 +14764,9 @@ function requireBrowser () {
 		function save(namespaces) {
 			try {
 				if (namespaces) {
-					exports.storage.setItem('debug', namespaces);
+					exports$1.storage.setItem('debug', namespaces);
 				} else {
-					exports.storage.removeItem('debug');
+					exports$1.storage.removeItem('debug');
 				}
 			} catch (error) {
 				// Swallow
@@ -14783,7 +14783,7 @@ function requireBrowser () {
 		function load() {
 			let r;
 			try {
-				r = exports.storage.getItem('debug') || exports.storage.getItem('DEBUG') ;
+				r = exports$1.storage.getItem('debug') || exports$1.storage.getItem('DEBUG') ;
 			} catch (error) {
 				// Swallow
 				// XXX (@Qix-) should we be logging these?
@@ -14819,7 +14819,7 @@ function requireBrowser () {
 			}
 		}
 
-		module.exports = requireCommon()(exports);
+		module.exports = requireCommon()(exports$1);
 
 		const {formatters} = module.exports;
 
@@ -15008,7 +15008,7 @@ var hasRequiredNode$1;
 function requireNode$1 () {
 	if (hasRequiredNode$1) return node$1.exports;
 	hasRequiredNode$1 = 1;
-	(function (module, exports) {
+	(function (module, exports$1) {
 		const tty = require$$1$1;
 		const util = require$$1$2;
 
@@ -15016,13 +15016,13 @@ function requireNode$1 () {
 		 * This is the Node.js implementation of `debug()`.
 		 */
 
-		exports.init = init;
-		exports.log = log;
-		exports.formatArgs = formatArgs;
-		exports.save = save;
-		exports.load = load;
-		exports.useColors = useColors;
-		exports.destroy = util.deprecate(
+		exports$1.init = init;
+		exports$1.log = log;
+		exports$1.formatArgs = formatArgs;
+		exports$1.save = save;
+		exports$1.load = load;
+		exports$1.useColors = useColors;
+		exports$1.destroy = util.deprecate(
 			() => {},
 			'Instance method `debug.destroy()` is deprecated and no longer does anything. It will be removed in the next major version of `debug`.'
 		);
@@ -15031,7 +15031,7 @@ function requireNode$1 () {
 		 * Colors.
 		 */
 
-		exports.colors = [6, 2, 3, 4, 5, 1];
+		exports$1.colors = [6, 2, 3, 4, 5, 1];
 
 		try {
 			// Optional dependency (as in, doesn't need to be installed, NOT like optionalDependencies in package.json)
@@ -15039,7 +15039,7 @@ function requireNode$1 () {
 			const supportsColor = requireSupportsColor();
 
 			if (supportsColor && (supportsColor.stderr || supportsColor).level >= 2) {
-				exports.colors = [
+				exports$1.colors = [
 					20,
 					21,
 					26,
@@ -15128,7 +15128,7 @@ function requireNode$1 () {
 		 *   $ DEBUG_COLORS=no DEBUG_DEPTH=10 DEBUG_SHOW_HIDDEN=enabled node script.js
 		 */
 
-		exports.inspectOpts = Object.keys(process.env).filter(key => {
+		exports$1.inspectOpts = Object.keys(process.env).filter(key => {
 			return /^debug_/i.test(key);
 		}).reduce((obj, key) => {
 			// Camel-case
@@ -15160,8 +15160,8 @@ function requireNode$1 () {
 		 */
 
 		function useColors() {
-			return 'colors' in exports.inspectOpts ?
-				Boolean(exports.inspectOpts.colors) :
+			return 'colors' in exports$1.inspectOpts ?
+				Boolean(exports$1.inspectOpts.colors) :
 				tty.isatty(process.stderr.fd);
 		}
 
@@ -15187,7 +15187,7 @@ function requireNode$1 () {
 		}
 
 		function getDate() {
-			if (exports.inspectOpts.hideDate) {
+			if (exports$1.inspectOpts.hideDate) {
 				return '';
 			}
 			return new Date().toISOString() + ' ';
@@ -15198,7 +15198,7 @@ function requireNode$1 () {
 		 */
 
 		function log(...args) {
-			return process.stderr.write(util.formatWithOptions(exports.inspectOpts, ...args) + '\n');
+			return process.stderr.write(util.formatWithOptions(exports$1.inspectOpts, ...args) + '\n');
 		}
 
 		/**
@@ -15238,13 +15238,13 @@ function requireNode$1 () {
 		function init(debug) {
 			debug.inspectOpts = {};
 
-			const keys = Object.keys(exports.inspectOpts);
+			const keys = Object.keys(exports$1.inspectOpts);
 			for (let i = 0; i < keys.length; i++) {
-				debug.inspectOpts[keys[i]] = exports.inspectOpts[keys[i]];
+				debug.inspectOpts[keys[i]] = exports$1.inspectOpts[keys[i]];
 			}
 		}
 
-		module.exports = requireCommon()(exports);
+		module.exports = requireCommon()(exports$1);
 
 		const {formatters} = module.exports;
 
@@ -15818,7 +15818,7 @@ function requireFollowRedirects () {
 	// Wraps the key/value object of protocols with redirect functionality
 	function wrap(protocols) {
 	  // Default settings
-	  var exports = {
+	  var exports$1 = {
 	    maxRedirects: 21,
 	    maxBodyLength: 10 * 1024 * 1024,
 	  };
@@ -15828,7 +15828,7 @@ function requireFollowRedirects () {
 	  Object.keys(protocols).forEach(function (scheme) {
 	    var protocol = scheme + ":";
 	    var nativeProtocol = nativeProtocols[protocol] = protocols[scheme];
-	    var wrappedProtocol = exports[scheme] = Object.create(nativeProtocol);
+	    var wrappedProtocol = exports$1[scheme] = Object.create(nativeProtocol);
 
 	    // Executes a request, following redirects
 	    function request(input, options, callback) {
@@ -15851,8 +15851,8 @@ function requireFollowRedirects () {
 
 	      // Set defaults
 	      options = Object.assign({
-	        maxRedirects: exports.maxRedirects,
-	        maxBodyLength: exports.maxBodyLength,
+	        maxRedirects: exports$1.maxRedirects,
+	        maxBodyLength: exports$1.maxBodyLength,
 	      }, input, options);
 	      options.nativeProtocols = nativeProtocols;
 	      if (!isString(options.host) && !isString(options.hostname)) {
@@ -15877,7 +15877,7 @@ function requireFollowRedirects () {
 	      get: { value: get, configurable: true, enumerable: true, writable: true },
 	    });
 	  });
-	  return exports;
+	  return exports$1;
 	}
 
 	function noop() { /* empty */ }
@@ -17483,7 +17483,7 @@ var hasRequiredLodash;
 function requireLodash () {
 	if (hasRequiredLodash) return lodash$1.exports;
 	hasRequiredLodash = 1;
-	(function (module, exports) {
+	(function (module, exports$1) {
 (function() {
 
 		  /** Used as a safe reference for `undefined` in pre-ES5 environments. */
@@ -17914,7 +17914,7 @@ function requireLodash () {
 		  var root = freeGlobal || freeSelf || Function('return this')();
 
 		  /** Detect free variable `exports`. */
-		  var freeExports = exports && !exports.nodeType && exports;
+		  var freeExports = exports$1 && !exports$1.nodeType && exports$1;
 
 		  /** Detect free variable `module`. */
 		  var freeModule = freeExports && 'object' == 'object' && module && !module.nodeType && module;
@@ -35744,12 +35744,12 @@ var hasRequiredIsBuffer;
 function requireIsBuffer () {
 	if (hasRequiredIsBuffer) return isBuffer.exports;
 	hasRequiredIsBuffer = 1;
-	(function (module, exports) {
+	(function (module, exports$1) {
 		var root = require_root(),
 		    stubFalse = requireStubFalse();
 
 		/** Detect free variable `exports`. */
-		var freeExports = exports && !exports.nodeType && exports;
+		var freeExports = exports$1 && !exports$1.nodeType && exports$1;
 
 		/** Detect free variable `module`. */
 		var freeModule = freeExports && 'object' == 'object' && module && !module.nodeType && module;
@@ -35969,11 +35969,11 @@ var hasRequired_nodeUtil;
 function require_nodeUtil () {
 	if (hasRequired_nodeUtil) return _nodeUtil.exports;
 	hasRequired_nodeUtil = 1;
-	(function (module, exports) {
+	(function (module, exports$1) {
 		var freeGlobal = require_freeGlobal();
 
 		/** Detect free variable `exports`. */
-		var freeExports = exports && !exports.nodeType && exports;
+		var freeExports = exports$1 && !exports$1.nodeType && exports$1;
 
 		/** Detect free variable `module`. */
 		var freeModule = freeExports && 'object' == 'object' && module && !module.nodeType && module;
@@ -44895,7 +44895,7 @@ var hasRequiredSafeBuffer;
 function requireSafeBuffer () {
 	if (hasRequiredSafeBuffer) return safeBuffer.exports;
 	hasRequiredSafeBuffer = 1;
-	(function (module, exports) {
+	(function (module, exports$1) {
 		/* eslint-disable node/no-deprecated-api */
 		var buffer = require$$0$5;
 		var Buffer = buffer.Buffer;
@@ -44910,8 +44910,8 @@ function requireSafeBuffer () {
 		  module.exports = buffer;
 		} else {
 		  // Copy properties from require('buffer')
-		  copyProps(buffer, exports);
-		  exports.Buffer = SafeBuffer;
+		  copyProps(buffer, exports$1);
+		  exports$1.Buffer = SafeBuffer;
 		}
 
 		function SafeBuffer (arg, encodingOrOffset, length) {
@@ -48109,22 +48109,22 @@ var hasRequiredReadable;
 function requireReadable () {
 	if (hasRequiredReadable) return readable.exports;
 	hasRequiredReadable = 1;
-	(function (module, exports) {
+	(function (module, exports$1) {
 		var Stream = require$$0$4;
 		if (process.env.READABLE_STREAM === 'disable' && Stream) {
 		  module.exports = Stream.Readable;
 		  Object.assign(module.exports, Stream);
 		  module.exports.Stream = Stream;
 		} else {
-		  exports = module.exports = require_stream_readable();
-		  exports.Stream = Stream || exports;
-		  exports.Readable = exports;
-		  exports.Writable = require_stream_writable();
-		  exports.Duplex = require_stream_duplex();
-		  exports.Transform = require_stream_transform();
-		  exports.PassThrough = require_stream_passthrough();
-		  exports.finished = requireEndOfStream();
-		  exports.pipeline = requirePipeline();
+		  exports$1 = module.exports = require_stream_readable();
+		  exports$1.Stream = Stream || exports$1;
+		  exports$1.Readable = exports$1;
+		  exports$1.Writable = require_stream_writable();
+		  exports$1.Duplex = require_stream_duplex();
+		  exports$1.Transform = require_stream_transform();
+		  exports$1.PassThrough = require_stream_passthrough();
+		  exports$1.finished = requireEndOfStream();
+		  exports$1.pipeline = requirePipeline();
 		} 
 	} (readable, readable.exports));
 	return readable.exports;
@@ -49559,12 +49559,12 @@ var hasRequiredWebsocket;
 function requireWebsocket () {
 	if (hasRequiredWebsocket) return websocket$1;
 	hasRequiredWebsocket = 1;
-	(function (exports) {
+	(function (exports$1) {
 		var __importDefault = (websocket$1 && websocket$1.__importDefault) || function (mod) {
 		    return (mod && mod.__esModule) ? mod : { "default": mod };
 		};
-		Object.defineProperty(exports, "__esModule", { value: true });
-		exports.AlpacaWebsocket = exports.ERROR = exports.CONN_ERROR = exports.EVENT = exports.STATE = void 0;
+		Object.defineProperty(exports$1, "__esModule", { value: true });
+		exports$1.AlpacaWebsocket = exports$1.ERROR = exports$1.CONN_ERROR = exports$1.EVENT = exports$1.STATE = void 0;
 		const events_1 = __importDefault(require$$0$1);
 		const ws_1 = __importDefault(requireWs());
 		const msgpack5_1 = __importDefault(requireMsgpack5());
@@ -49578,7 +49578,7 @@ function requireWebsocket () {
 		    STATE["DISCONNECTED"] = "disconnected";
 		    STATE["WAITING_TO_CONNECT"] = "waiting to connect";
 		    STATE["WAITING_TO_RECONNECT"] = "waiting to reconnect";
-		})(STATE || (exports.STATE = STATE = {}));
+		})(STATE || (exports$1.STATE = STATE = {}));
 		// Client events
 		var EVENT;
 		(function (EVENT) {
@@ -49597,9 +49597,9 @@ function requireWebsocket () {
 		    EVENT["CORRECTIONS"] = "corrections";
 		    EVENT["ORDERBOOKS"] = "orderbooks";
 		    EVENT["NEWS"] = "news";
-		})(EVENT || (exports.EVENT = EVENT = {}));
+		})(EVENT || (exports$1.EVENT = EVENT = {}));
 		// Connection errors by code
-		exports.CONN_ERROR = new Map([
+		exports$1.CONN_ERROR = new Map([
 		    [400, "invalid syntax"],
 		    [401, "not authenticated"],
 		    [402, "auth failed"],
@@ -49618,7 +49618,7 @@ function requireWebsocket () {
 		    ERROR["MISSING_SECERT_KEY"] = "missing secret key";
 		    ERROR["MISSING_API_KEY"] = "missing api key";
 		    ERROR["UNEXPECTED_MESSAGE"] = "unexpected message";
-		})(ERROR || (exports.ERROR = ERROR = {}));
+		})(ERROR || (exports$1.ERROR = ERROR = {}));
 		class AlpacaWebsocket extends events_1.default.EventEmitter {
 		    constructor(options) {
 		        super();
@@ -49775,7 +49775,7 @@ function requireWebsocket () {
 		                this.updateSubscriptions(data[0]);
 		                break;
 		            case "error":
-		                this.emit(EVENT.CLIENT_ERROR, exports.CONN_ERROR.get(data[0].code));
+		                this.emit(EVENT.CLIENT_ERROR, exports$1.CONN_ERROR.get(data[0].code));
 		                break;
 		            default:
 		                this.dataHandler(data);
@@ -49804,7 +49804,7 @@ function requireWebsocket () {
 		        }
 		    }
 		}
-		exports.AlpacaWebsocket = AlpacaWebsocket; 
+		exports$1.AlpacaWebsocket = AlpacaWebsocket; 
 	} (websocket$1));
 	return websocket$1;
 }
@@ -50438,8 +50438,8 @@ var hasRequiredWebsockets;
 function requireWebsockets () {
 	if (hasRequiredWebsockets) return websockets;
 	hasRequiredWebsockets = 1;
-	(function (exports) {
-		Object.defineProperty(exports, "__esModule", { value: true });
+	(function (exports$1) {
+		Object.defineProperty(exports$1, "__esModule", { value: true });
 		const events = require$$0$1;
 		const WebSocket = requireWs();
 		const entity = requireEntity();
@@ -50454,7 +50454,7 @@ function requireWebsockets () {
 		    STATE.DISCONNECTED = "disconnected";
 		    STATE.WAITING_TO_CONNECT = "waiting to connect";
 		    STATE.WAITING_TO_RECONNECT = "waiting to reconnect";
-		})((STATE = exports.STATE || (exports.STATE = {})));
+		})((STATE = exports$1.STATE || (exports$1.STATE = {})));
 		// Client events
 		var EVENT;
 		(function (EVENT) {
@@ -50468,7 +50468,7 @@ function requireWebsockets () {
 		    EVENT.STOCK_QUOTES = "stock_quotes";
 		    EVENT.STOCK_AGG_SEC = "stock_agg_sec";
 		    EVENT.STOCK_AGG_MIN = "stock_agg_min";
-		})((EVENT = exports.EVENT || (exports.EVENT = {})));
+		})((EVENT = exports$1.EVENT || (exports$1.EVENT = {})));
 		// Connection errors Each of these will also emit EVENT.ERROR
 		var ERROR;
 		(function (ERROR) {
@@ -50477,7 +50477,7 @@ function requireWebsockets () {
 		    ERROR.MISSING_API_KEY = "missing api key";
 		    ERROR.MISSING_SECRET_KEY = "missing secret key";
 		    ERROR.UNKNOWN = "unknown error";
-		})((ERROR = exports.ERROR || (exports.ERROR = {})));
+		})((ERROR = exports$1.ERROR || (exports$1.ERROR = {})));
 		/**
 		 * AlpacaStreamClient manages a connection to Alpaca's websocket api
 		 */
@@ -50790,7 +50790,7 @@ function requireWebsockets () {
 		        }
 		    }
 		}
-		exports.AlpacaStreamClient = AlpacaStreamClient; 
+		exports$1.AlpacaStreamClient = AlpacaStreamClient; 
 	} (websockets));
 	return websockets;
 }
@@ -51042,13 +51042,13 @@ var hasRequiredDist;
 function requireDist () {
 	if (hasRequiredDist) return dist$1.exports;
 	hasRequiredDist = 1;
-	(function (module, exports) {
+	(function (module, exports$1) {
 		var __importDefault = (dist && dist.__importDefault) || function (mod) {
 		    return (mod && mod.__esModule) ? mod : { "default": mod };
 		};
-		Object.defineProperty(exports, "__esModule", { value: true });
+		Object.defineProperty(exports$1, "__esModule", { value: true });
 		const alpaca_trade_api_1 = __importDefault(requireAlpacaTradeApi());
-		exports.default = alpaca_trade_api_1.default;
+		exports$1.default = alpaca_trade_api_1.default;
 		module.exports = alpaca_trade_api_1.default; 
 	} (dist$1, dist$1.exports));
 	return dist$1.exports;
@@ -63157,6 +63157,7 @@ class StampedeProtectedCache {
         coalescedRequests: 0,
         backgroundRefreshes: 0,
         refreshErrors: 0,
+        loadTimeouts: 0,
     };
     constructor(options) {
         this.options = {
@@ -63430,6 +63431,7 @@ class StampedeProtectedCache {
             coalescedRequests: this.stats.coalescedRequests,
             backgroundRefreshes: this.stats.backgroundRefreshes,
             refreshErrors: this.stats.refreshErrors,
+            loadTimeouts: this.stats.loadTimeouts,
         };
     }
     /**
@@ -63480,8 +63482,9 @@ class StampedeProtectedCache {
             this.options.logger.debug("Request coalesced", { key });
             return existingPromise;
         }
-        // Create new promise and store it
-        const promise = this.loadAndCache(key, loader, ttl);
+        // Create new promise and store it — bounded by loadTimeoutMs so a
+        // never-settling loader cannot pin the key (see loadWithTimeout).
+        const promise = this.loadWithTimeout(key, loader, ttl);
         this.pendingRefreshes.set(key, promise);
         try {
             const result = await promise;
@@ -63492,6 +63495,51 @@ class StampedeProtectedCache {
             this.pendingRefreshes.delete(key);
         }
     }
+    /**
+     * Race {@link loadAndCache} against the configured load timeout.
+     *
+     * On timeout: rejects with a typed timeout error, evicts the pending
+     * single-flight entry so the NEXT caller retries with a fresh loader
+     * (instead of coalescing onto the hung one), and attaches a settlement
+     * observer to the abandoned loader so its eventual resolution/rejection
+     * is logged rather than surfacing as an unhandled rejection.
+     */
+    async loadWithTimeout(key, loader, ttl) {
+        const timeoutMs = this.options.loadTimeoutMs ?? 30000;
+        const loadPromise = this.loadAndCache(key, loader, ttl);
+        let timeoutHandle;
+        const timeoutPromise = new Promise((_, reject) => {
+            timeoutHandle = setTimeout(() => {
+                this.stats.loadTimeouts++;
+                // Evict the pin so the next caller retries fresh.
+                this.pendingRefreshes.delete(key);
+                this.options.logger.warn("Cache loader timed out — pin evicted", {
+                    key,
+                    timeoutMs,
+                });
+                // Observe the abandoned loader; never let it become unhandled.
+                loadPromise
+                    .then(() => {
+                    this.options.logger.warn("Abandoned cache loader eventually resolved", { key });
+                })
+                    .catch((error) => {
+                    this.options.logger.warn("Abandoned cache loader eventually rejected", {
+                        key,
+                        error: error instanceof Error ? error.message : String(error),
+                    });
+                });
+                reject(new Error(`StampedeProtectedCache loader timed out after ${timeoutMs}ms for key "${key}"`));
+            }, timeoutMs);
+        });
+        try {
+            return await Promise.race([loadPromise, timeoutPromise]);
+        }
+        finally {
+            if (timeoutHandle !== undefined) {
+                clearTimeout(timeoutHandle);
+            }
+        }
+    }
     /**
      * Load data and cache it
      */
@@ -63641,6 +63689,7 @@ const DEFAULT_CACHE_OPTIONS = {
     minJitter: 0.9, // 90%
     maxJitter: 1.1, // 110%
     enableBackgroundRefresh: true,
+    loadTimeoutMs: 30000, // 30s hard loader ceiling (anti-pinning)
 };
 
 /**