feat(middleware-cache): improve caching strategies & cache behavior

packages/3-extensions/middleware-cache/package.json

@@ -16,7 +16,8 @@
     "clean": "rm -rf dist dist-tsc dist-tsc-prod coverage .tmp-output"
   },
   "dependencies": {
-    "@prisma-next/framework-components": "workspace:0.14.0"
+    "@prisma-next/framework-components": "workspace:0.14.0",
+    "@prisma-next/utils": "workspace:0.14.0"
   },
   "devDependencies": {
     "@prisma-next/contract": "workspace:0.14.0",

packages/3-extensions/middleware-cache/src/cache-annotation.ts

@@ -17,11 +17,24 @@ import { defineAnnotation } from '@prisma-next/framework-components/runtime';
  *   **not** rehash it, so the caller is responsible for ensuring the
  *   string is bounded in size and free of sensitive data they do not
  *   want flowing into logs / Redis `KEYS` / persistence dumps.
+ * - `dedupe` — Per-query toggle for in-process miss deduplication
+ *   (single-flight). When `true`, concurrent identical misses for the
+ *   same effective key in the same process share one leader execution;
+ *   followers wait for the leader's result. When `false`, each miss
+ *   executes independently.
+ * - `tags` — Optional list of cache tags to associate with this entry.
+ *   Tags enable bulk cache invalidation: uncache by tag(s) will clear
+ *   all entries that have those tags, regardless of key pattern.
  */
 export interface CachePayload {
+  readonly enabled?: boolean;
   readonly ttl?: number;
   readonly skip?: boolean;
   readonly key?: string;
+  readonly namespace?: string;
+  readonly dedupe?: boolean;
+  readonly tags?: readonly string[];
+  readonly store?: string;
 }
 
 /**