docstr

Will-ShaoHua · Will-ShaoHua · commit 42c345110dd2 · 2025-04-24T18:38:37.000-07:00
diff --git a/packages/core/src/shared/utilities/resourceCache.ts b/packages/core/src/shared/utilities/resourceCache.ts
@@ -79,6 +79,12 @@ export abstract class CachedResource<V> {
             }
         }
 
+        /**
+         * Possible paths here
+         *  1. cache doesn't exist.
+         *  2. cache exists but expired.
+         *  3. lock is held by other process and the waiting time is greater than the specified waiting time
+         */
         logger.info(`cache miss, invoking service API to pull the latest response`)
         try {
             // Make the real network call / FS read to pull the resource

Original file line number	Diff line number	Diff line change
`@@ -79,6 +79,12 @@ export abstract class CachedResource<V> {`
`79`	`79`	`}`
`80`	`80`	`}`
`81`	`81`
	`82`	`+ /**`
	`83`	`+ * Possible paths here`
	`84`	`+ * 1. cache doesn't exist.`
	`85`	`+ * 2. cache exists but expired.`
	`86`	`+ * 3. lock is held by other process and the waiting time is greater than the specified waiting time`
	`87`	`+ */`
`82`	`88`	logger.info(`cache miss, invoking service API to pull the latest response`)
`83`	`89`	`try {`
`84`	`90`	`// Make the real network call / FS read to pull the resource`