@warlock.js/cache 4.1.15 → 4.2.1

package/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog — @warlock.js/cache
+
+All notable changes to `@warlock.js/cache` are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). `@warlock.js/*` packages are released in lockstep — every package shares the same version number, so a version below may list only the changes that affected this package.
+
+## [Unreleased]
+
+## 4.2.0
+
+### Changed
+
+- Redis driver now logs a failed initial `connect()` at `log.fatal` (was `log.error`). Boot-time cache connection failures are unrecoverable in practice — `fatal` makes "page on fatal only" alerting clean, aligned with the cascade drivers and the herald connector.
+
+## 4.1.15
+
+- Baseline — per-package changelog tracking starts at this version.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Hassan Zohdy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/cjs/index.cjs

@@ -34,7 +34,7 @@ let _warlock_js_fs = require("@warlock.js/fs");
 let path = require("path");
 path = __toESM(path, 1);
 
-//#region ../../@warlock.js/cache/src/metrics.ts
+//#region ../@warlock.js/cache/src/metrics.ts
 /**
 * Default size of the circular latency-sample buffer. 1000 samples covers
 * "tell me the current p95" for every realistic workload while keeping the
@@ -229,7 +229,7 @@ var CacheMetricsCollector = class {
 };
 
 //#endregion
-//#region ../../@warlock.js/cache/src/types.ts
+//#region ../@warlock.js/cache/src/types.ts
 /**
 * Base error class for cache-related errors
 */
@@ -289,7 +289,7 @@ var CacheConcurrencyError = class extends CacheError {
 };
 
 //#endregion
-//#region ../../@warlock.js/cache/src/utils.ts
+//#region ../@warlock.js/cache/src/utils.ts
 /**
 * Make a proper key for the cache
 */
@@ -505,7 +505,7 @@ let CACHE_FOR = /* @__PURE__ */ function(CACHE_FOR) {
 }({});
 
 //#endregion
-//#region ../../@warlock.js/cache/src/tagged-scoped-cache.ts
+//#region ../@warlock.js/cache/src/tagged-scoped-cache.ts
 /**
 * One-shot tagged write handle on top of a {@link ScopedCache}.
 *
@@ -643,7 +643,7 @@ var TaggedScopedCache = class {
 };
 
 //#endregion
-//#region ../../@warlock.js/cache/src/scoped-cache.ts
+//#region ../@warlock.js/cache/src/scoped-cache.ts
 /**
 * Scoped view over a cache source. Returned by `cache.namespace(prefix, options?)`.
 *
@@ -912,7 +912,7 @@ var ScopedCache = class ScopedCache {
 };
 
 //#endregion
-//#region ../../@warlock.js/cache/src/cache-manager.ts
+//#region ../@warlock.js/cache/src/cache-manager.ts
 var CacheManager = class {
 	constructor() {
 		this.loadedDrivers = {};
@@ -1392,7 +1392,7 @@ var CacheManager = class {
 const cache = new CacheManager();
 
 //#endregion
-//#region ../../@warlock.js/cache/src/cached/auto-key.ts
+//#region ../@warlock.js/cache/src/cached/auto-key.ts
 /**
 * Derive a cache key from a prefix and a set of function arguments.
 *
@@ -1443,7 +1443,7 @@ function serializePrimitive(value) {
 }
 
 //#endregion
-//#region ../../@warlock.js/cache/src/cached/normalize-args.ts
+//#region ../@warlock.js/cache/src/cached/normalize-args.ts
 /**
 * Resolve the positional-or-options arguments of `cached()` into a single
 * normalized config. Keeps the wrapper body free of shape-checks.
@@ -1465,7 +1465,7 @@ function normalizeCachedArgs(prefixOrOptions, maybeTtl) {
 }
 
 //#endregion
-//#region ../../@warlock.js/cache/src/cached/cached.ts
+//#region ../@warlock.js/cache/src/cached/cached.ts
 function cached(fn, prefixOrOptions, maybeTtl) {
 	const config = normalizeCachedArgs(prefixOrOptions, maybeTtl);
 	const buildRememberOptions = () => ({
@@ -1485,7 +1485,7 @@ function cached(fn, prefixOrOptions, maybeTtl) {
 }
 
 //#endregion
-//#region ../../@warlock.js/cache/src/list/memory-cache-list.ts
+//#region ../@warlock.js/cache/src/list/memory-cache-list.ts
 /**
 * Generic array-backed {@link CacheListAccessor}.
 *
@@ -1602,7 +1602,7 @@ var MemoryCacheList = class {
 };
 
 //#endregion
-//#region ../../@warlock.js/cache/src/tagged-cache.ts
+//#region ../@warlock.js/cache/src/tagged-cache.ts
 /**
 * Tagged Cache Wrapper
 * Wraps a cache driver to automatically manage tag relationships
@@ -1747,7 +1747,7 @@ var TaggedCache = class {
 };
 
 //#endregion
-//#region ../../@warlock.js/cache/src/drivers/base-cache-driver.ts
+//#region ../@warlock.js/cache/src/drivers/base-cache-driver.ts
 const messages = {
 	clearing: "Clearing namespace",
 	cleared: "Namespace cleared",
@@ -1765,6 +1765,7 @@ const messages = {
 	connected: "Connected to the cache engine.",
 	disconnecting: "Disconnecting from the cache engine.",
 	disconnected: "Disconnected from the cache engine.",
+	connectionFailed: "Failed to connect to the cache engine.",
 	error: "Error occurred"
 };
 var BaseCacheDriver = class {
@@ -2079,7 +2080,8 @@ var BaseCacheDriver = class {
 	*/
 	log(operation, key) {
 		if (!this.shouldLog) return;
-		if (key) key = key.replaceAll("/", ".");
+		if (typeof key === "string") key = key.replace(/\//g, ".");
+		if (operation === "connectionFailed") _warlock_js_logger.log.fatal(`cache.${this.name}`, operation, key);
 		if (operation == "notFound" || operation == "expired") return _warlock_js_logger.log.warn("cache." + this.name, operation, (key ? key + " " : "") + messages[operation]);
 		if (operation.endsWith("ed")) return _warlock_js_logger.log.success("cache." + this.name, operation, (key ? key + " " : "") + messages[operation]);
 		_warlock_js_logger.log.info("cache." + this.name, operation, (key ? key + " " : "") + messages[operation]);
@@ -2261,7 +2263,7 @@ var BaseCacheDriver = class {
 };
 
 //#endregion
-//#region ../../@warlock.js/cache/src/drivers/file-cache-driver.ts
+//#region ../@warlock.js/cache/src/drivers/file-cache-driver.ts
 var FileCacheDriver = class extends BaseCacheDriver {
 	constructor(..._args) {
 		super(..._args);
@@ -2428,7 +2430,7 @@ var FileCacheDriver = class extends BaseCacheDriver {
 };
 
 //#endregion
-//#region ../../@warlock.js/cache/src/drivers/lru-memory-cache-driver.ts
+//#region ../@warlock.js/cache/src/drivers/lru-memory-cache-driver.ts
 var CacheNode = class {
 	constructor(key, value, ttl) {
 		this.key = key;
@@ -2740,7 +2742,7 @@ var LRUMemoryCacheDriver = class extends BaseCacheDriver {
 };
 
 //#endregion
-//#region ../../@warlock.js/cache/src/drivers/memory-cache-driver.ts
+//#region ../@warlock.js/cache/src/drivers/memory-cache-driver.ts
 var MemoryCacheDriver = class extends BaseCacheDriver {
 	/**
 	* {@inheritdoc}
@@ -2975,7 +2977,7 @@ var MemoryCacheDriver = class extends BaseCacheDriver {
 };
 
 //#endregion
-//#region ../../@warlock.js/cache/src/drivers/memory-extended-cache-driver.ts
+//#region ../@warlock.js/cache/src/drivers/memory-extended-cache-driver.ts
 var MemoryExtendedCacheDriver = class extends MemoryCacheDriver {
 	constructor(..._args) {
 		super(..._args);
@@ -3003,7 +3005,7 @@ var MemoryExtendedCacheDriver = class extends MemoryCacheDriver {
 };
 
 //#endregion
-//#region ../../@warlock.js/cache/src/drivers/mock-cache-driver.ts
+//#region ../@warlock.js/cache/src/drivers/mock-cache-driver.ts
 /**
 * In-memory cache driver with introspection helpers, intended for use as a
 * test double in downstream packages.
@@ -3225,7 +3227,7 @@ var MockCacheDriver = class extends BaseCacheDriver {
 };
 
 //#endregion
-//#region ../../@warlock.js/cache/src/drivers/null-cache-driver.ts
+//#region ../@warlock.js/cache/src/drivers/null-cache-driver.ts
 var NullCacheDriver = class extends BaseCacheDriver {
 	/**
 	* {@inheritdoc}
@@ -3312,7 +3314,7 @@ var NullCacheDriver = class extends BaseCacheDriver {
 };
 
 //#endregion
-//#region ../../@warlock.js/cache/src/drivers/pg-cache-driver.ts
+//#region ../@warlock.js/cache/src/drivers/pg-cache-driver.ts
 /**
 * Allowed characters in a Postgres identifier (table name). We accept the
 * conservative ASCII subset and reject anything else — interpolating an
@@ -3744,7 +3746,7 @@ var PgCacheDriver = class extends BaseCacheDriver {
 };
 
 //#endregion
-//#region ../../@warlock.js/cache/src/drivers/redis-cache-driver.ts
+//#region ../@warlock.js/cache/src/drivers/redis-cache-driver.ts
 /**
 * Cached Redis module (loaded once, reused)
 */
@@ -3960,18 +3962,20 @@ var RedisCacheDriver = class extends BaseCacheDriver {
 			...options,
 			...this.options.clientOptions || {}
 		};
-		this.log("connecting");
-		const { createClient } = RedisClient;
-		this.client = createClient(clientOptions);
-		this.client.on("error", (error) => {
-			this.log("error", error.message);
-		});
 		try {
+			this.log("connecting");
+			const { createClient } = RedisClient;
+			this.client = createClient(clientOptions);
+			this.client.on("error", (error) => {
+				if (error.code === "ECONNREFUSED") this.log("connectionFailed", error);
+				else this.log("error", error.message);
+			});
 			await this.client.connect();
 			this.log("connected");
 			await this.emit("connected");
 		} catch (error) {
-			_warlock_js_logger.log.error("cache", "redis", error);
+			console.log("Err", error);
+			_warlock_js_logger.log.fatal("cache", "redis", error);
 			await this.emit("error", { error });
 		}
 	}