@fluojs/cache-manager 1.0.4 → 2.0.0

package/dist/stores/redis-store.js

@@ -28,11 +28,14 @@ function normalizeScanResponse(result) {
     keys
   };
 }
-function normalizePositiveTtlMilliseconds(ttlSeconds) {
-  return Math.max(1, Math.ceil(ttlSeconds * 1000));
+function normalizePositiveTtlMilliseconds(ttlSeconds, maximumTtlMilliseconds) {
+  return Math.min(maximumTtlMilliseconds, Math.max(1, Math.ceil(ttlSeconds * 1000)));
 }
-function normalizeRedisExpirySeconds(ttlSeconds) {
-  return Math.max(1, Math.ceil(ttlSeconds));
+function normalizeRedisExpirySeconds(ttlSeconds, maximumTtlSeconds) {
+  return Math.min(maximumTtlSeconds, Math.max(1, Math.ceil(ttlSeconds)));
+}
+function escapeRedisGlobPattern(value) {
+  return value.replace(/[\\*?[\]]/g, '\\$&');
 }
 
 /**
@@ -72,9 +75,11 @@ export class RedisStore {
       value
     };
     if (ttlSeconds > 0) {
-      const ttlMilliseconds = normalizePositiveTtlMilliseconds(ttlSeconds);
+      const maximumTtlMilliseconds = Number.MAX_SAFE_INTEGER - now;
+      const ttlMilliseconds = normalizePositiveTtlMilliseconds(ttlSeconds, maximumTtlMilliseconds);
       entry.expiresAt = now + ttlMilliseconds;
-      const ttlSecondsRounded = normalizeRedisExpirySeconds(ttlSeconds);
+      const maximumTtlSeconds = Math.floor(maximumTtlMilliseconds / 1000);
+      const ttlSecondsRounded = normalizeRedisExpirySeconds(ttlSeconds, maximumTtlSeconds);
       await this.client.set(redisKey, JSON.stringify(entry), 'EX', ttlSecondsRounded);
       this.trackOwnedKey(redisKey);
       return;
@@ -105,7 +110,7 @@ export class RedisStore {
       return;
     }
     let cursor = '0';
-    const pattern = `${this.keyPrefix}*`;
+    const pattern = `${escapeRedisGlobPattern(this.keyPrefix)}*`;
     do {
       const scanResult = normalizeScanResponse(await this.client.scan(cursor, 'MATCH', pattern, 'COUNT', this.scanCount));
       cursor = scanResult.cursor;

package/dist/ttl-jitter.d.ts

@@ -0,0 +1,19 @@
+import type { CacheTtlJitterOptions, NormalizedCacheTtlJitterOptions } from './types.js';
+/**
+ * Normalize opt-in TTL jitter configuration and reject ratios that cannot produce a usable spread.
+ *
+ * @param options Raw jitter configuration, or `undefined` when jitter stays disabled.
+ * @returns Normalized jitter configuration, or `undefined` when jitter stays disabled.
+ * @throws Error When the supplied value is not an options object or contains an invalid field.
+ */
+export declare function normalizeCacheTtlJitterOptions(options: CacheTtlJitterOptions | undefined): NormalizedCacheTtlJitterOptions | undefined;
+/**
+ * Apply opt-in jitter to an already-resolved positive cache TTL.
+ *
+ * @param ttlSeconds Resolved TTL in seconds, taken from a per-call override or the module default.
+ * @param jitter Normalized jitter configuration, or `undefined` when jitter stays disabled.
+ * @returns The TTL handed to the cache store, preserving `0` as a no-expiry write and returning a positive finite value within the selected directional bounds.
+ * @throws Error When the configured randomness source returns a value outside the finite `[0, 1]` range.
+ */
+export declare function applyCacheTtlJitter(ttlSeconds: number, jitter: NormalizedCacheTtlJitterOptions | undefined): number;
+//# sourceMappingURL=ttl-jitter.d.ts.map

package/dist/ttl-jitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ttl-jitter.d.ts","sourceRoot":"","sources":["../src/ttl-jitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAsB,qBAAqB,EAAE,+BAA+B,EAAE,MAAM,YAAY,CAAC;AAE7G;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,qBAAqB,GAAG,SAAS,GACzC,+BAA+B,GAAG,SAAS,CAgC7C;AA2BD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,+BAA+B,GAAG,SAAS,GAClD,MAAM,CAoBR"}

package/dist/ttl-jitter.js

@@ -0,0 +1,72 @@
+/**
+ * Normalize opt-in TTL jitter configuration and reject ratios that cannot produce a usable spread.
+ *
+ * @param options Raw jitter configuration, or `undefined` when jitter stays disabled.
+ * @returns Normalized jitter configuration, or `undefined` when jitter stays disabled.
+ * @throws Error When the supplied value is not an options object or contains an invalid field.
+ */
+export function normalizeCacheTtlJitterOptions(options) {
+  if (options === undefined) {
+    return undefined;
+  }
+  if (typeof options !== 'object' || options === null || Array.isArray(options)) {
+    throw new Error('@fluojs/cache-manager ttlJitter must be an options object when provided.');
+  }
+  const ratio = options.ratio;
+  const mode = options.mode;
+  const random = options.random;
+  if (!Number.isFinite(ratio) || ratio <= 0 || ratio > 1) {
+    throw new Error('@fluojs/cache-manager ttlJitter.ratio must be a finite number greater than 0 and at most 1.');
+  }
+  const normalizedMode = mode ?? 'symmetric';
+  if (normalizedMode !== 'symmetric' && normalizedMode !== 'shorten' && normalizedMode !== 'lengthen') {
+    throw new Error("@fluojs/cache-manager ttlJitter.mode must be 'symmetric', 'shorten', or 'lengthen'.");
+  }
+  if (random !== undefined && typeof random !== 'function') {
+    throw new Error('@fluojs/cache-manager ttlJitter.random must be a function when provided.');
+  }
+  return {
+    mode: normalizedMode,
+    random,
+    ratio
+  };
+}
+function readUnitSample(random) {
+  const sample = (random ?? Math.random)();
+  if (!Number.isFinite(sample) || sample < 0 || sample > 1) {
+    throw new Error('@fluojs/cache-manager ttlJitter.random must return a finite number from 0 through 1.');
+  }
+  return sample;
+}
+function resolveJitterOffsetSeconds(mode, magnitudeSeconds, sample) {
+  switch (mode) {
+    case 'symmetric':
+      return magnitudeSeconds * (sample * 2 - 1);
+    case 'shorten':
+      return -magnitudeSeconds * sample;
+    case 'lengthen':
+      return magnitudeSeconds * sample;
+  }
+}
+
+/**
+ * Apply opt-in jitter to an already-resolved positive cache TTL.
+ *
+ * @param ttlSeconds Resolved TTL in seconds, taken from a per-call override or the module default.
+ * @param jitter Normalized jitter configuration, or `undefined` when jitter stays disabled.
+ * @returns The TTL handed to the cache store, preserving `0` as a no-expiry write and returning a positive finite value within the selected directional bounds.
+ * @throws Error When the configured randomness source returns a value outside the finite `[0, 1]` range.
+ */
+export function applyCacheTtlJitter(ttlSeconds, jitter) {
+  if (!jitter || ttlSeconds <= 0) {
+    return ttlSeconds;
+  }
+  const offsetSeconds = resolveJitterOffsetSeconds(jitter.mode, ttlSeconds * jitter.ratio, readUnitSample(jitter.random));
+  if (offsetSeconds <= -ttlSeconds) {
+    return Number.MIN_VALUE;
+  }
+  if (offsetSeconds > Number.MAX_VALUE - ttlSeconds) {
+    return Number.MAX_VALUE;
+  }
+  return ttlSeconds + offsetSeconds;
+}

package/dist/types.d.ts

@@ -1,3 +1,4 @@
+import type { AsyncModuleOptions } from '@fluojs/core';
 import type { InterceptorContext } from '@fluojs/http';
 type Awaitable<T> = T | Promise<T>;
 /**
@@ -42,6 +43,59 @@ interface CacheModuleInternalOptions {
  * Resolves the principal-scope suffix appended by built-in HTTP cache-key strategies.
  */
 export type PrincipalScopeResolver = (context: InterceptorContext) => string | undefined;
+/**
+ * Direction applied to a positive cache TTL when opt-in jitter is configured.
+ *
+ * @remarks
+ * `'symmetric'` spreads a TTL within `[ttl - ttl * ratio, ttl + ttl * ratio]`,
+ * `'shorten'` only reduces the TTL, and `'lengthen'` only extends it.
+ */
+export type CacheTtlJitterMode = 'symmetric' | 'shorten' | 'lengthen';
+/**
+ * Opt-in configuration that spreads positive cache TTL values so keys written together stop expiring together.
+ *
+ * @remarks
+ * Jitter is applied once by `CacheService` before store handoff, so memory, Redis, and custom stores
+ * observe the same already-jittered TTL. It only spreads expiry times: it is not distributed locking,
+ * refresh-ahead caching, or cross-instance stampede coordination. `ttl: 0` (no expiry) and invalid TTL
+ * values keep their existing meanings and are never jittered.
+ */
+export interface CacheTtlJitterOptions {
+    /** Maximum fraction of the resolved TTL used as jitter. Must be greater than `0` and at most `1`. */
+    ratio: number;
+    /** Direction of the applied jitter. Defaults to `'symmetric'`. */
+    mode?: CacheTtlJitterMode;
+    /** Randomness source that must return a finite value in `[0, 1]`. Defaults to `Math.random`; invalid samples reject the write. */
+    random?: () => number;
+}
+/**
+ * Privacy-safe observation payload emitted once per completed cache operation.
+ *
+ * @remarks
+ * The discriminated union couples read operations to `hit`, `miss`, or `error`
+ * and write, invalidation, and lifecycle operations to `success` or `error`.
+ * Observations intentionally exclude cache keys, cached values, loader results,
+ * and error objects so operational instrumentation cannot leak application data.
+ */
+export type CacheObservation = {
+    readonly durationMs: number;
+    readonly operation: 'get' | 'remember';
+    readonly outcome: 'hit' | 'miss' | 'error';
+} | {
+    readonly durationMs: number;
+    readonly operation: 'set' | 'del' | 'reset' | 'close';
+    readonly outcome: 'success' | 'error';
+};
+/**
+ * Opt-in observation hook for cache hit rate, latency, and error instrumentation.
+ *
+ * @remarks
+ * Observer failures are contained: a thrown error or rejected promise is
+ * swallowed and never changes the cache result the caller receives.
+ */
+export interface CacheObserver {
+    onCacheOperation(observation: CacheObservation): Awaitable<void>;
+}
 /**
  * Public configuration options for `CacheModule.forRoot(...)`.
  */
@@ -50,8 +104,12 @@ export interface CacheModuleOptions extends CacheModuleInternalOptions {
     global?: boolean;
     store?: 'memory' | 'redis' | CacheStore;
     ttl?: number;
+    /** Opt-in positive-TTL jitter applied before store handoff. Only omission or `undefined` disables jitter. */
+    ttlJitter?: CacheTtlJitterOptions;
     httpKeyStrategy?: CacheKeyStrategy;
     principalScopeResolver?: PrincipalScopeResolver;
+    /** Opt-in privacy-safe observer notified after each cache operation completes. */
+    observer?: CacheObserver;
 }
 /**
  * Compatibility-only public type for normalized cache-module configuration after defaults are applied.
@@ -67,8 +125,34 @@ export interface NormalizedCacheModuleOptions {
     redis?: RedisCacheOptions;
     store: 'memory' | 'redis' | CacheStore;
     ttl: number;
+    ttlJitter?: NormalizedCacheTtlJitterOptions;
     httpKeyStrategy: CacheKeyStrategy;
     principalScopeResolver: PrincipalScopeResolver | undefined;
+    /** Opt-in privacy-safe observer notified after each cache operation completes. */
+    observer?: CacheObserver;
+}
+/**
+ * Public configuration options for `CacheModule.forRootAsync(...)`.
+ *
+ * @remarks
+ * `useFactory` returns `CacheModuleOptions`, so applications can reuse prepared cache
+ * configuration values. `global` stays on the registration call because module visibility
+ * is decided when the module is defined, before the injected factory runs. A `global` value
+ * returned by `useFactory` is ignored.
+ */
+export type CacheAsyncModuleOptions = Omit<AsyncModuleOptions<CacheModuleOptions>, 'useFactory'> & Pick<CacheModuleOptions, 'global'> & {
+    useFactory: (...dependencies: never[]) => Awaitable<CacheModuleOptions>;
+};
+/**
+ * Normalized TTL jitter configuration after defaults are applied.
+ *
+ * @remarks
+ * Application configuration should use `CacheTtlJitterOptions` with `CacheModule.forRoot(...)`.
+ */
+export interface NormalizedCacheTtlJitterOptions {
+    mode: CacheTtlJitterMode;
+    random: (() => number) | undefined;
+    ratio: number;
 }
 /**
  * Computes a cache key from the active interceptor context.

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -10,7 +10,7 @@
     "memory-store",
     "decorator"
   ],
-  "version": "1.0.4",
+  "version": "2.0.0",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -19,7 +19,7 @@
     "directory": "packages/cache-manager"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=24.0.0 <27"
   },
   "publishConfig": {
     "access": "public"
@@ -37,14 +37,14 @@
     "dist"
   ],
   "dependencies": {
-    "@fluojs/core": "^1.0.3",
-    "@fluojs/di": "^1.1.0",
-    "@fluojs/http": "^1.1.2",
-    "@fluojs/runtime": "^1.1.8"
+    "@fluojs/core": "^2.0.0",
+    "@fluojs/di": "^3.0.0",
+    "@fluojs/http": "^3.0.0",
+    "@fluojs/runtime": "^3.0.0"
   },
   "peerDependencies": {
     "ioredis": "^5.0.0",
-    "@fluojs/redis": "^1.0.2"
+    "@fluojs/redis": "^2.0.0"
   },
   "peerDependenciesMeta": {
     "@fluojs/redis": {
@@ -55,7 +55,7 @@
     }
   },
   "devDependencies": {
-    "vitest": "^3.2.4"
+    "vitest": "^4.1.11"
   },
   "scripts": {
     "prebuild": "node ../../tooling/scripts/clean-dist.mjs",