feat: Remove stale cache keys for flags.

Author: sbansal1999

packages/sdk/src/core/flags/flags-manager.ts

@@ -106,6 +106,14 @@ export class CoreFlagsManager implements FlagsManager {
 		};
 	}
 
+	private removeStaleKeys(validCacheKeys: Set<string>): void {
+		for (const key of this.cache.keys()) {
+			if (!validCacheKeys.has(key)) {
+				this.cache.delete(key);
+			}
+		}
+	}
+
 	private async initialize(): Promise<void> {
 		// Load from persistent storage first (instant hydration)
 		if (!this.config.skipStorage && this.storage) {
@@ -304,6 +312,10 @@ export class CoreFlagsManager implements FlagsManager {
 				cacheEntry: createCacheEntry(result, ttl, staleTime),
 			}));
 
+			this.removeStaleKeys(
+				new Set(flagCacheEntries.map(({ cacheKey }) => cacheKey))
+			);
+
 			for (const { cacheKey, cacheEntry } of flagCacheEntries) {
 				this.cache.set(cacheKey, cacheEntry);
 			}