refactor: reorganize cache TTL constants (#4550)

* refactor: reorganize cache TTL constants

* Update tests/wakatime.test.js

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Alexandr <qwerty541zxc@gmail.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

src/common/cache.js

@@ -1,6 +1,64 @@
 // @ts-check
 
-import { clampValue, CONSTANTS } from "./utils.js";
+import { clampValue } from "./utils.js";
+
+const MIN = 60;
+const HOUR = 60 * MIN;
+const DAY = 24 * HOUR;
+
+/**
+ * Common durations in seconds.
+ */
+const DURATIONS = {
+  ONE_MINUTE: MIN,
+  FIVE_MINUTES: 5 * MIN,
+  TEN_MINUTES: 10 * MIN,
+  FIFTEEN_MINUTES: 15 * MIN,
+  THIRTY_MINUTES: 30 * MIN,
+
+  TWO_HOURS: 2 * HOUR,
+  FOUR_HOURS: 4 * HOUR,
+  SIX_HOURS: 6 * HOUR,
+  EIGHT_HOURS: 8 * HOUR,
+  TWELVE_HOURS: 12 * HOUR,
+
+  ONE_DAY: DAY,
+  TWO_DAY: 2 * DAY,
+  SIX_DAY: 6 * DAY,
+  TEN_DAY: 10 * DAY,
+};
+
+/**
+ * Common cache TTL values in seconds.
+ */
+const CACHE_TTL = {
+  STATS_CARD: {
+    DEFAULT: DURATIONS.ONE_DAY,
+    MIN: DURATIONS.TWELVE_HOURS,
+    MAX: DURATIONS.TWO_DAY,
+  },
+  TOP_LANGS_CARD: {
+    DEFAULT: DURATIONS.SIX_DAY,
+    MIN: DURATIONS.TWO_DAY,
+    MAX: DURATIONS.TEN_DAY,
+  },
+  PIN_CARD: {
+    DEFAULT: DURATIONS.TEN_DAY,
+    MIN: DURATIONS.ONE_DAY,
+    MAX: DURATIONS.TEN_DAY,
+  },
+  GIST_CARD: {
+    DEFAULT: DURATIONS.TWO_DAY,
+    MIN: DURATIONS.ONE_DAY,
+    MAX: DURATIONS.TEN_DAY,
+  },
+  WAKATIME_CARD: {
+    DEFAULT: DURATIONS.ONE_DAY,
+    MIN: DURATIONS.TWELVE_HOURS,
+    MAX: DURATIONS.TWO_DAY,
+  },
+  ERROR: DURATIONS.TEN_MINUTES,
+};
 
 /**
  * Resolves the cache seconds based on the requested, default, min, and max values.
@@ -56,7 +114,7 @@ const setCacheHeaders = (res, cacheSeconds) => {
     "Cache-Control",
     `max-age=${cacheSeconds}, ` +
       `s-maxage=${cacheSeconds}, ` +
-      `stale-while-revalidate=${CONSTANTS.ONE_DAY}`,
+      `stale-while-revalidate=${DURATIONS.ONE_DAY}`,
   );
 };
 
@@ -80,10 +138,16 @@ const setErrorCacheHeaders = (res) => {
   // Use lower cache period for errors.
   res.setHeader(
     "Cache-Control",
-    `max-age=${CONSTANTS.ERROR_CACHE_SECONDS}, ` +
-      `s-maxage=${CONSTANTS.ERROR_CACHE_SECONDS}, ` +
-      `stale-while-revalidate=${CONSTANTS.ONE_DAY}`,
+    `max-age=${CACHE_TTL.ERROR}, ` +
+      `s-maxage=${CACHE_TTL.ERROR}, ` +
+      `stale-while-revalidate=${DURATIONS.ONE_DAY}`,
   );
 };
 
-export { resolveCacheSeconds, setCacheHeaders, setErrorCacheHeaders };
+export {
+  resolveCacheSeconds,
+  setCacheHeaders,
+  setErrorCacheHeaders,
+  DURATIONS,
+  CACHE_TTL,
+};

src/common/index.js

@@ -1,3 +1,5 @@
+// @ts-check
+
 export { blacklist } from "./blacklist.js";
 export { Card } from "./Card.js";
 export { createProgressNode } from "./createProgressNode.js";
@@ -20,7 +22,6 @@ export {
   getCardColors,
   wrapTextMultiline,
   logger,
-  CONSTANTS,
   CustomError,
   MissingParamError,
   measureText,

src/common/utils.js

@@ -452,34 +452,6 @@ const noop = () => {};
 const logger =
   process.env.NODE_ENV === "test" ? { log: noop, error: noop } : console;
 
-const MIN = 60;
-const HOUR = 60 * MIN;
-const DAY = 24 * HOUR;
-
-const CONSTANTS = {
-  ONE_MINUTE: MIN,
-  FIVE_MINUTES: 5 * MIN,
-  TEN_MINUTES: 10 * MIN,
-  FIFTEEN_MINUTES: 15 * MIN,
-  THIRTY_MINUTES: 30 * MIN,
-
-  TWO_HOURS: 2 * HOUR,
-  FOUR_HOURS: 4 * HOUR,
-  SIX_HOURS: 6 * HOUR,
-  EIGHT_HOURS: 8 * HOUR,
-  TWELVE_HOURS: 12 * HOUR,
-
-  ONE_DAY: DAY,
-  TWO_DAY: 2 * DAY,
-  SIX_DAY: 6 * DAY,
-  TEN_DAY: 10 * DAY,
-
-  CARD_CACHE_SECONDS: DAY,
-  TOP_LANGS_CACHE_SECONDS: 6 * DAY,
-  PIN_CARD_CACHE_SECONDS: 10 * DAY,
-  ERROR_CACHE_SECONDS: 10 * MIN,
-};
-
 /**
  * Missing query parameter class.
  */
@@ -648,7 +620,6 @@ export {
   getCardColors,
   wrapTextMultiline,
   logger,
-  CONSTANTS,
   CustomError,
   MissingParamError,
   measureText,