✨ Add helper methods (#1995)

Author: KATO-Hiro

src/lib/clients/cache_strategy.ts

@@ -1,11 +1,23 @@
 import { Cache } from '$lib/clients/cache';
 
+import type { ContestsForImport } from '$lib/types/contest';
+import type { TasksForImport } from '$lib/types/task';
+
 /**
- * Utility class for managing cached data for contest tasks.
- * Provides a mechanism to either retrieve data from cache if available
- * or fetch it using the provided function.
+ * A strategy for caching contest and task data.
+ * Separates the caching logic from the data fetching concerns.
  */
 export class ContestTaskCache {
+  /**
+   * Constructs a cache strategy with the specified contest and task caches.
+   * @param contestCache - Cache for storing contest import data
+   * @param taskCache - Cache for storing task import data
+   */
+  constructor(
+    private readonly contestCache: Cache<ContestsForImport>,
+    private readonly taskCache: Cache<TasksForImport>,
+  ) {}
+
   /**
    * Retrieves data from cache if available, otherwise fetches it using the provided function.
    *
@@ -34,6 +46,8 @@ export class ContestTaskCache {
       return cachedData;
     }
 
+    console.log(`Cache miss for ${key}, fetching...`);
+
     try {
       const contestTasks = await fetchFunction();
       cache.set(key, contestTasks);
@@ -44,4 +58,24 @@ export class ContestTaskCache {
       return [] as unknown as T;
     }
   }
+
+  /**
+   * Gets contests from cache or fetches them.
+   */
+  async getCachedOrFetchContests(
+    key: string,
+    fetchFunction: () => Promise<ContestsForImport>,
+  ): Promise<ContestsForImport> {
+    return this.getCachedOrFetch(key, fetchFunction, this.contestCache);
+  }
+
+  /**
+   * Gets tasks from cache or fetches them.
+   */
+  async getCachedOrFetchTasks(
+    key: string,
+    fetchFunction: () => Promise<TasksForImport>,
+  ): Promise<TasksForImport> {
+    return this.getCachedOrFetch(key, fetchFunction, this.taskCache);
+  }
 }