add bypassTagCacheOnCacheHit option

Author: dario-piotrowicz

.changeset/lovely-gifts-cough.md

@@ -0,0 +1,26 @@
+---
+"@opennextjs/cloudflare": minor
+---
+
+Add option for regional cache to skip tagCache on cache hits
+
+When the tag regional cache finds a value in the incremental cache, checking such value in the tagCache can be skipped, this helps reducing response times at the tradeoff that the user needs to either use the automatic cache purging or manually purge the cache when appropriate. For this the `bypassTagCacheOnCacheHit` option is being added to the `RegionalCache` class.
+
+Example:
+
+```js
+import { defineCloudflareConfig } from "@opennextjs/cloudflare";
+import d1NextTagCache from "@opennextjs/cloudflare/overrides/tag-cache/d1-next-tag-cache";
+import memoryQueue from "@opennextjs/cloudflare/overrides/queue/memory-queue";
+import r2IncrementalCache from "@opennextjs/cloudflare/overrides/incremental-cache/r2-incremental-cache";
+import { withRegionalCache } from "@opennextjs/cloudflare/overrides/incremental-cache/regional-cache";
+
+export default defineCloudflareConfig({
+	incrementalCache: withRegionalCache(r2IncrementalCache, {
+		mode: "long-lived",
+		bypassTagCacheOnCacheHit: true,
+	}),
+	tagCache: d1NextTagCache,
+	queue: memoryQueue,
+});
+```

packages/cloudflare/src/api/overrides/incremental-cache/regional-cache.ts

@@ -38,6 +38,15 @@ type Options = {
 	 * @default `false` for the `short-lived` mode, and `true` for the `long-lived` mode.
 	 */
 	shouldLazilyUpdateOnCacheHit?: boolean;
+
+	/**
+	 * Whether on cache hits the tagCache should be skipped or not. Skipping the tagCache allows requests to be
+	 * handled faster, the downside of this is that you need to make sure that the cache gets correctly purged
+	 * either by enabling the auto cache purging feature or doing that manually.
+	 *
+	 * @default `true` is the auto cache purging is enabled, `false` otherwise.
+	 */
+	bypassTagCacheOnCacheHit?: boolean;
 };
 
 interface PutToCacheInput {
@@ -63,6 +72,7 @@ class RegionalCache implements IncrementalCache {
 		}
 		this.name = this.store.name;
 		this.opts.shouldLazilyUpdateOnCacheHit ??= this.opts.mode === "long-lived";
+		this.opts.bypassTagCacheOnCacheHit ??= getCloudflareContext().env.NEXT_CACHE_DO_PURGE ? true : false;
 	}
 
 	async get<CacheType extends CacheEntryType = "cache">(
@@ -103,7 +113,7 @@ class RegionalCache implements IncrementalCache {
 				this.putToCache({ key, cacheType, entry: { value, lastModified } })
 			);
 
-			return { value, lastModified, shouldBypassTagCache: true };
+			return { value, lastModified, shouldBypassTagCache: this.opts.bypassTagCacheOnCacheHit };
 		} catch (e) {
 			error("Failed to get from regional cache", e);
 			return null;