From 239cc3de6d5bf8a46966792549071ec53782259d Mon Sep 17 00:00:00 2001
From: Hazelnoot <acomputerdog@gmail.com>
Date: Wed, 1 Oct 2025 11:26:01 -0400
Subject: [PATCH] implement CacheManagementService to provided centralized
 management of cache instances

---
 .../src/core/CacheManagementService.ts        | 109 ++++++++++++++++++
 1 file changed, 109 insertions(+)
 create mode 100644 packages/backend/src/core/CacheManagementService.ts

diff --git a/packages/backend/src/core/CacheManagementService.ts b/packages/backend/src/core/CacheManagementService.ts
new file mode 100644
index 0000000000..180572e300
--- /dev/null
+++ b/packages/backend/src/core/CacheManagementService.ts
@@ -0,0 +1,109 @@
+/*
+ * SPDX-FileCopyrightText: hazelnoot and other Sharkey contributors
+ * SPDX-License-Identifier: AGPL-3.0-only
+ */
+
+import { Inject, Injectable, OnApplicationShutdown } from '@nestjs/common';
+import * as Redis from 'ioredis';
+import {
+	MemoryKVCache,
+	MemorySingleCache,
+	RedisKVCache,
+	RedisSingleCache,
+	type RedisKVCacheOpts,
+	type RedisSingleCacheOpts,
+} from '@/misc/cache.js';
+import { QuantumKVCache, type QuantumKVOpts } from '@/misc/QuantumKVCache.js';
+import { bindThis } from '@/decorators.js';
+import { DI } from '@/di-symbols.js';
+import { TimeService } from '@/core/TimeService.js';
+import { InternalEventService } from '@/core/InternalEventService.js';
+
+export type ManagedMemoryKVCache<T> = Managed<MemoryKVCache<T>>;
+export type ManagedMemorySingleCache<T> = Managed<MemorySingleCache<T>>;
+export type ManagedRedisKVCache<T> = Managed<RedisKVCache<T>>;
+export type ManagedRedisSingleCache<T> = Managed<RedisSingleCache<T>>;
+export type ManagedQuantumKVCache<T> = Managed<QuantumKVCache<T>>;
+
+export type Managed<T> = Omit<T, 'dispose' | 'onApplicationShutdown'>;
+export type Manager = { dispose(): void, clear(): void };
+
+/**
+ * Creates and "manages" instances of any standard cache type.
+ * Instances produced by this class are automatically tracked for disposal when the application shuts down.
+ */
+@Injectable()
+export class CacheManagementService implements OnApplicationShutdown {
+	private readonly managedCaches = new Set<Manager>();
+
+	constructor(
+		@Inject(DI.redis)
+		private readonly redisClient: Redis.Redis,
+
+		private readonly timeService: TimeService,
+		private readonly internalEventService: InternalEventService,
+	) {}
+
+	private get cacheServices() {
+		return {
+			internalEventService: this.internalEventService,
+			redisClient: this.redisClient,
+			timeService: this.timeService,
+		};
+	}
+
+	@bindThis
+	public createMemoryKVCache<T>(lifetime: number): ManagedMemoryKVCache<T> {
+		const cache = new MemoryKVCache<T>(lifetime, this.cacheServices);
+		return this.manageCache(cache);
+	}
+
+	@bindThis
+	public createMemorySingleCache<T>(lifetime: number): ManagedMemorySingleCache<T> {
+		const cache = new MemorySingleCache<T>(lifetime, this.cacheServices);
+		return this.manageCache(cache);
+	}
+
+	@bindThis
+	public createRedisKVCache<T>(name: string, opts: RedisKVCacheOpts<T>): ManagedRedisKVCache<T> {
+		const cache = new RedisKVCache<T>(name, this.cacheServices, opts);
+		return this.manageCache(cache);
+	}
+
+	@bindThis
+	public createRedisSingleCache<T>(name: string, opts: RedisSingleCacheOpts<T>): ManagedRedisSingleCache<T> {
+		const cache = new RedisSingleCache<T>(name, this.cacheServices, opts);
+		return this.manageCache(cache);
+	}
+
+	@bindThis
+	public createQuantumKVCache<T>(name: string, opts: QuantumKVOpts<T>): ManagedQuantumKVCache<T> {
+		const cache = new QuantumKVCache<T>(name, this.cacheServices, opts);
+		return this.manageCache(cache);
+	}
+
+	protected manageCache<T extends Manager>(cache: T): Managed<T> {
+		this.managedCaches.add(cache);
+		return cache;
+	}
+
+	@bindThis
+	public clear(): void {
+		for (const manager of this.managedCaches) {
+			manager.clear();
+		}
+	}
+
+	@bindThis
+	public async dispose(): Promise<void> {
+		for (const manager of this.managedCaches) {
+			manager.dispose();
+		}
+		this.managedCaches.clear();
+	}
+
+	@bindThis
+	public async onApplicationShutdown(): Promise<void> {
+		await this.dispose();
+	}
+}