vinext 0.0.54 → 0.0.55

package/dist/server/skip-cache-proof.js

@@ -1,15 +1,7 @@
-import { evaluateArtifactCompatibility } from "./artifact-compatibility.js";
+import { ARTIFACT_COMPATIBILITY_PROOF_FIELDS, evaluateArtifactCompatibility } from "./artifact-compatibility.js";
 import { createClientReusePayloadHash } from "./client-reuse-manifest.js";
+import { createStaticLayoutClientReuseArtifactCompatibility, createStaticLayoutClientReusePayloadHash, createStaticLayoutClientReuseRouteId } from "./static-layout-client-reuse-proof.js";
 //#region src/server/skip-cache-proof.ts
-const ARTIFACT_COMPATIBILITY_PROOF_FIELDS = [
-	"schemaVersion",
-	"graphVersion",
-	"deploymentVersion",
-	"appElementsSchemaVersion",
-	"rscPayloadSchemaVersion",
-	"rootBoundaryId",
-	"renderEpoch"
-];
 function createDisabledSkipDisposition() {
 	return {
 		code: "SKIP_MODEL_DISABLED",
@@ -17,6 +9,14 @@ function createDisabledSkipDisposition() {
 		mode: "renderAndSend"
 	};
 }
+function createStaticLayoutSkipDisposition(skippedEntryIds) {
+	return {
+		code: "SKIP_STATIC_LAYOUT_VERIFIED",
+		enabled: true,
+		mode: "skipStaticLayout",
+		skippedEntryIds: [...skippedEntryIds]
+	};
+}
 function rejectSkipCacheCrossCheck(entry, code, fields = {}) {
 	return {
 		kind: "rejected",
@@ -33,9 +33,31 @@ function collectArtifactCompatibilityProofMismatches(artifactCompatibility, proo
 	for (const field of ARTIFACT_COMPATIBILITY_PROOF_FIELDS) if (artifactCompatibility[field] !== proofCompatibility[field]) mismatchedFields.push(field);
 	return mismatchedFields;
 }
+function isExactArtifactCompatibility(artifactCompatibility, entryCompatibility) {
+	return collectArtifactCompatibilityProofMismatches(artifactCompatibility, entryCompatibility).length === 0;
+}
 function assertNever(value) {
 	throw new Error(`Unhandled skip/cache proof state: ${String(value)}`);
 }
+function createRenderAndSendPlan(options) {
+	return {
+		kind: "renderAndSend",
+		entryRejections: options.entryRejections ?? [],
+		...options.manifestRejection ? { manifestRejection: options.manifestRejection } : {},
+		skipDisposition: createDisabledSkipDisposition(),
+		skipIneligibleEntryIds: options.skipIneligibleEntryIds ?? [],
+		skippedEntryIds: []
+	};
+}
+function createVerificationBudgetExceededRejection(totalWireEntries, maxWireEntriesToVerify) {
+	return {
+		code: "SKIP_VERIFICATION_BUDGET_EXCEEDED",
+		fields: {
+			totalWireEntries,
+			maxWireEntriesToVerify
+		}
+	};
+}
 function crossCheckInvalidationProof(entry, invalidation) {
 	switch (invalidation.kind) {
 		case "valid": return null;
@@ -83,6 +105,7 @@ function crossCheckClientReuseManifestEntryWithCache(input) {
 	});
 	const invalidationRejection = crossCheckInvalidationProof(entry, input.artifact.invalidation);
 	if (invalidationRejection) return invalidationRejection;
+	const skipDisposition = isExactArtifactCompatibility(input.artifact.compatibility, entry.artifactCompatibility) ? createStaticLayoutSkipDisposition([entry.id]) : createDisabledSkipDisposition();
 	return {
 		kind: "verified",
 		code: "SKIP_CACHE_CROSS_CHECK_PASSED",
@@ -92,10 +115,56 @@ function crossCheckClientReuseManifestEntryWithCache(input) {
 			reuseClass: proof.reuseClass,
 			variantCacheKeyHash: createClientReusePayloadHash(proof.variant.cacheKey)
 		},
-		skipDisposition: createDisabledSkipDisposition()
+		skipDisposition
+	};
+}
+function createClientReuseSkipTransportPlan(input) {
+	const { manifest } = input;
+	if (manifest.kind === "absent") return createRenderAndSendPlan({});
+	if (manifest.kind === "rejected") return createRenderAndSendPlan({ manifestRejection: manifest.rejection });
+	const maxWireEntriesToVerify = input.maxWireEntriesToVerify ?? 8;
+	if (!Number.isSafeInteger(maxWireEntriesToVerify) || maxWireEntriesToVerify < 0) throw new RangeError("maxWireEntriesToVerify must be a non-negative safe integer");
+	const totalWireEntries = manifest.manifest.entries.length + manifest.entryRejections.length;
+	if (totalWireEntries > maxWireEntriesToVerify) return createRenderAndSendPlan({
+		entryRejections: manifest.entryRejections,
+		manifestRejection: createVerificationBudgetExceededRejection(totalWireEntries, maxWireEntriesToVerify)
+	});
+	const skippedEntryIds = [];
+	const skipIneligibleEntryIds = [];
+	const entryRejections = [...manifest.entryRejections];
+	for (const entry of manifest.manifest.entries) {
+		const verification = input.verifyEntry(entry);
+		if (verification.kind === "rejected") {
+			entryRejections.push(verification.rejection);
+			continue;
+		}
+		if (verification.entryId !== entry.id) {
+			entryRejections.push({
+				code: "SKIP_CACHE_ENTRY_ID_MISMATCH",
+				entryId: entry.id,
+				fields: {
+					verifierEntryId: verification.entryId,
+					manifestEntryId: entry.id
+				}
+			});
+			continue;
+		}
+		if (verification.skipDisposition.enabled) skippedEntryIds.push(entry.id);
+		else skipIneligibleEntryIds.push(entry.id);
+	}
+	if (skippedEntryIds.length === 0) return createRenderAndSendPlan({
+		entryRejections,
+		skipIneligibleEntryIds
+	});
+	return {
+		kind: "skip",
+		entryRejections,
+		skipDisposition: createStaticLayoutSkipDisposition(skippedEntryIds),
+		skipIneligibleEntryIds,
+		skippedEntryIds
 	};
 }
 //#endregion
-export { crossCheckClientReuseManifestEntryWithCache };
+export { createClientReuseSkipTransportPlan, createStaticLayoutClientReuseArtifactCompatibility, createStaticLayoutClientReusePayloadHash, createStaticLayoutClientReuseRouteId, crossCheckClientReuseManifestEntryWithCache };
 
 //# sourceMappingURL=skip-cache-proof.js.map

package/dist/server/skip-cache-proof.js.map

@@ -1 +1 @@
-{"version":3,"file":"skip-cache-proof.js","names":[],"sources":["../../src/server/skip-cache-proof.ts"],"sourcesContent":["import {\n  evaluateArtifactCompatibility,\n  type ArtifactCompatibilityEnvelope,\n  type ArtifactCompatibilityEvaluationOptions,\n} from \"./artifact-compatibility.js\";\nimport type { StaticLayoutArtifactReuseDecision } from \"./cache-proof.js\";\nimport {\n  createClientReusePayloadHash,\n  type ClientReuseManifestEntry,\n  type ClientReuseManifestEntryRejection,\n  type ClientReuseManifestSkipDisposition,\n  type ClientReuseManifestTraceFields,\n} from \"./client-reuse-manifest.js\";\n\nexport type SkipCacheInvalidationProof =\n  | Readonly<{ kind: \"invalidated\"; invalidationEpoch: string | null }>\n  | Readonly<{ kind: \"unknown\" }>\n  | Readonly<{ kind: \"valid\" }>;\n\ntype SkipCacheArtifactProof = Readonly<{\n  compatibility: ArtifactCompatibilityEnvelope;\n  invalidation: SkipCacheInvalidationProof;\n  payloadHash: string | null;\n}>;\n\ntype SkipCacheCrossCheckAcceptanceCode = \"SKIP_CACHE_CROSS_CHECK_PASSED\";\n\ntype SkipCacheCrossCheckVerified = Readonly<{\n  code: SkipCacheCrossCheckAcceptanceCode;\n  entryId: string;\n  fields: ClientReuseManifestTraceFields;\n  kind: \"verified\";\n  skipDisposition: ClientReuseManifestSkipDisposition;\n}>;\n\ntype SkipCacheCrossCheckRejected = Readonly<{\n  kind: \"rejected\";\n  rejection: ClientReuseManifestEntryRejection;\n  skipDisposition: ClientReuseManifestSkipDisposition;\n}>;\n\ntype SkipCacheCrossCheckResult = SkipCacheCrossCheckRejected | SkipCacheCrossCheckVerified;\n\ntype CrossCheckClientReuseManifestEntryWithCacheInput = Readonly<{\n  artifact: SkipCacheArtifactProof;\n  cacheDecision: StaticLayoutArtifactReuseDecision | null;\n  entry: ClientReuseManifestEntry;\n}> &\n  ArtifactCompatibilityEvaluationOptions;\n\nconst ARTIFACT_COMPATIBILITY_PROOF_FIELDS: readonly (keyof ArtifactCompatibilityEnvelope)[] = [\n  \"schemaVersion\",\n  \"graphVersion\",\n  \"deploymentVersion\",\n  \"appElementsSchemaVersion\",\n  \"rscPayloadSchemaVersion\",\n  \"rootBoundaryId\",\n  \"renderEpoch\",\n];\n\nfunction createDisabledSkipDisposition(): ClientReuseManifestSkipDisposition {\n  return {\n    code: \"SKIP_MODEL_DISABLED\",\n    enabled: false,\n    mode: \"renderAndSend\",\n  };\n}\n\nfunction rejectSkipCacheCrossCheck(\n  entry: ClientReuseManifestEntry,\n  code: ClientReuseManifestEntryRejection[\"code\"],\n  fields: ClientReuseManifestTraceFields = {},\n): SkipCacheCrossCheckRejected {\n  return {\n    kind: \"rejected\",\n    rejection: {\n      code,\n      entryId: entry.id,\n      fields,\n    },\n    skipDisposition: createDisabledSkipDisposition(),\n  };\n}\n\nfunction collectArtifactCompatibilityProofMismatches(\n  artifactCompatibility: ArtifactCompatibilityEnvelope,\n  proofCompatibility: ArtifactCompatibilityEnvelope,\n): readonly string[] {\n  const mismatchedFields: string[] = [];\n  for (const field of ARTIFACT_COMPATIBILITY_PROOF_FIELDS) {\n    if (artifactCompatibility[field] !== proofCompatibility[field]) {\n      mismatchedFields.push(field);\n    }\n  }\n  return mismatchedFields;\n}\n\nfunction assertNever(value: never): never {\n  throw new Error(`Unhandled skip/cache proof state: ${String(value)}`);\n}\n\nfunction crossCheckInvalidationProof(\n  entry: ClientReuseManifestEntry,\n  invalidation: SkipCacheInvalidationProof,\n): SkipCacheCrossCheckRejected | null {\n  switch (invalidation.kind) {\n    case \"valid\":\n      return null;\n    case \"unknown\":\n      return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_INVALIDATION_UNKNOWN\");\n    case \"invalidated\":\n      return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_INVALIDATED\", {\n        invalidationEpoch: invalidation.invalidationEpoch,\n      });\n    default:\n      return assertNever(invalidation);\n  }\n}\n\nexport function crossCheckClientReuseManifestEntryWithCache(\n  input: CrossCheckClientReuseManifestEntryWithCacheInput,\n): SkipCacheCrossCheckResult {\n  const { cacheDecision, entry } = input;\n  if (cacheDecision === null) {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_PROOF_MISSING\");\n  }\n  if (cacheDecision.kind === \"fallback\") {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_PROOF_REJECTED\", {\n      cacheProofCode: cacheDecision.fallback.code,\n      cacheProofMode: cacheDecision.fallback.mode,\n      cacheProofScope: cacheDecision.fallback.scope,\n    });\n  }\n\n  const { proof } = cacheDecision;\n  if (entry.kind !== \"layout\" || proof.reuseClass !== \"static-layout\") {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_REUSE_CLASS_UNSUPPORTED\", {\n      entryKind: entry.kind,\n      reuseClass: proof.reuseClass,\n    });\n  }\n\n  if (entry.id !== proof.candidateOutput.layoutId) {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_ENTRY_ID_MISMATCH\", {\n      cacheEntryId: proof.candidateOutput.layoutId,\n      manifestEntryId: entry.id,\n    });\n  }\n\n  const artifactProofMismatches = collectArtifactCompatibilityProofMismatches(\n    input.artifact.compatibility,\n    proof.candidateArtifactCompatibility,\n  );\n  if (artifactProofMismatches.length > 0) {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_ARTIFACT_PROOF_MISMATCH\", {\n      mismatchedFields: artifactProofMismatches,\n    });\n  }\n\n  const artifactCompatibility = evaluateArtifactCompatibility(\n    input.artifact.compatibility,\n    entry.artifactCompatibility,\n    { compatibilityMap: input.compatibilityMap },\n  );\n  if (artifactCompatibility.kind === \"unknown\") {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_ARTIFACT_COMPATIBILITY_UNKNOWN\", {\n      compatibilityFallback: artifactCompatibility.fallback,\n      reason: artifactCompatibility.reason,\n    });\n  }\n  if (artifactCompatibility.kind === \"incompatible\") {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_ARTIFACT_COMPATIBILITY_INCOMPATIBLE\", {\n      compatibilityFallback: artifactCompatibility.fallback,\n      reason: artifactCompatibility.reason,\n    });\n  }\n\n  if (entry.variantCacheKey !== proof.variant.cacheKey) {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_VARIANT_MISMATCH\", {\n      cacheVariantCacheKeyHash: createClientReusePayloadHash(proof.variant.cacheKey),\n      entryVariantCacheKeyHash: createClientReusePayloadHash(entry.variantCacheKey),\n    });\n  }\n\n  if (input.artifact.payloadHash === null) {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_PAYLOAD_HASH_MISSING\");\n  }\n\n  if (entry.payloadHash !== input.artifact.payloadHash) {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_PAYLOAD_HASH_MISMATCH\", {\n      cachePayloadHash: input.artifact.payloadHash,\n      entryPayloadHash: entry.payloadHash,\n    });\n  }\n\n  const invalidationRejection = crossCheckInvalidationProof(entry, input.artifact.invalidation);\n  if (invalidationRejection) return invalidationRejection;\n\n  return {\n    kind: \"verified\",\n    code: \"SKIP_CACHE_CROSS_CHECK_PASSED\",\n    entryId: entry.id,\n    fields: {\n      entryKind: entry.kind,\n      reuseClass: proof.reuseClass,\n      variantCacheKeyHash: createClientReusePayloadHash(proof.variant.cacheKey),\n    },\n    skipDisposition: createDisabledSkipDisposition(),\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"skip-cache-proof.js","names":[],"sources":["../../src/server/skip-cache-proof.ts"],"sourcesContent":["import {\n  evaluateArtifactCompatibility,\n  ARTIFACT_COMPATIBILITY_PROOF_FIELDS,\n  type ArtifactCompatibilityEnvelope,\n  type ArtifactCompatibilityEvaluationOptions,\n} from \"./artifact-compatibility.js\";\nimport type { StaticLayoutArtifactReuseDecision } from \"./cache-proof.js\";\nimport {\n  CLIENT_REUSE_MANIFEST_SKIP_VERIFICATION_ENTRY_BUDGET,\n  createClientReusePayloadHash,\n  type ClientReuseManifestEntry,\n  type ClientReuseManifestEntryRejection,\n  type ClientReuseManifestParseResult,\n  type ClientReuseManifestRejection,\n  type ClientReuseManifestSkipDisposition,\n  type ClientReuseManifestTraceFields,\n} from \"./client-reuse-manifest.js\";\nexport {\n  createStaticLayoutClientReuseArtifactCompatibility,\n  createStaticLayoutClientReusePayloadHash,\n  createStaticLayoutClientReuseRouteId,\n} from \"./static-layout-client-reuse-proof.js\";\n\nexport type SkipCacheInvalidationProof =\n  | Readonly<{ kind: \"invalidated\"; invalidationEpoch: string | null }>\n  | Readonly<{ kind: \"unknown\" }>\n  | Readonly<{ kind: \"valid\" }>;\n\ntype SkipCacheArtifactProof = Readonly<{\n  compatibility: ArtifactCompatibilityEnvelope;\n  invalidation: SkipCacheInvalidationProof;\n  payloadHash: string | null;\n}>;\n\ntype SkipCacheCrossCheckAcceptanceCode = \"SKIP_CACHE_CROSS_CHECK_PASSED\";\n\ntype SkipCacheCrossCheckVerified = Readonly<{\n  code: SkipCacheCrossCheckAcceptanceCode;\n  entryId: string;\n  fields: ClientReuseManifestTraceFields;\n  kind: \"verified\";\n  skipDisposition: ClientReuseManifestSkipDisposition;\n}>;\n\ntype SkipCacheCrossCheckRejected = Readonly<{\n  kind: \"rejected\";\n  rejection: ClientReuseManifestEntryRejection;\n  skipDisposition: ClientReuseManifestSkipDisposition;\n}>;\n\ntype SkipCacheCrossCheckResult = SkipCacheCrossCheckRejected | SkipCacheCrossCheckVerified;\n\ntype CrossCheckClientReuseManifestEntryWithCacheInput = Readonly<{\n  artifact: SkipCacheArtifactProof;\n  cacheDecision: StaticLayoutArtifactReuseDecision | null;\n  entry: ClientReuseManifestEntry;\n}> &\n  ArtifactCompatibilityEvaluationOptions;\n\ntype ClientReuseSkipTransportPlan =\n  | Readonly<{\n      entryRejections: readonly ClientReuseManifestEntryRejection[];\n      kind: \"renderAndSend\";\n      manifestRejection?: ClientReuseManifestRejection;\n      skipDisposition: ClientReuseManifestSkipDisposition;\n      skipIneligibleEntryIds: readonly string[];\n      skippedEntryIds: readonly string[];\n    }>\n  | Readonly<{\n      entryRejections: readonly ClientReuseManifestEntryRejection[];\n      kind: \"skip\";\n      skipDisposition: ClientReuseManifestSkipDisposition;\n      skipIneligibleEntryIds: readonly string[];\n      skippedEntryIds: readonly string[];\n    }>;\n\ntype CreateClientReuseSkipTransportPlanInput = Readonly<{\n  manifest: ClientReuseManifestParseResult;\n  maxWireEntriesToVerify?: number;\n  verifyEntry: (entry: ClientReuseManifestEntry) => SkipCacheCrossCheckResult;\n}>;\n\nfunction createDisabledSkipDisposition(): ClientReuseManifestSkipDisposition {\n  return {\n    code: \"SKIP_MODEL_DISABLED\",\n    enabled: false,\n    mode: \"renderAndSend\",\n  };\n}\n\nfunction createStaticLayoutSkipDisposition(\n  skippedEntryIds: readonly string[],\n): ClientReuseManifestSkipDisposition {\n  return {\n    code: \"SKIP_STATIC_LAYOUT_VERIFIED\",\n    enabled: true,\n    mode: \"skipStaticLayout\",\n    skippedEntryIds: [...skippedEntryIds],\n  };\n}\n\nfunction rejectSkipCacheCrossCheck(\n  entry: ClientReuseManifestEntry,\n  code: ClientReuseManifestEntryRejection[\"code\"],\n  fields: ClientReuseManifestTraceFields = {},\n): SkipCacheCrossCheckRejected {\n  return {\n    kind: \"rejected\",\n    rejection: {\n      code,\n      entryId: entry.id,\n      fields,\n    },\n    skipDisposition: createDisabledSkipDisposition(),\n  };\n}\n\nfunction collectArtifactCompatibilityProofMismatches(\n  artifactCompatibility: ArtifactCompatibilityEnvelope,\n  proofCompatibility: ArtifactCompatibilityEnvelope,\n): readonly string[] {\n  const mismatchedFields: string[] = [];\n  for (const field of ARTIFACT_COMPATIBILITY_PROOF_FIELDS) {\n    if (artifactCompatibility[field] !== proofCompatibility[field]) {\n      mismatchedFields.push(field);\n    }\n  }\n  return mismatchedFields;\n}\n\nfunction isExactArtifactCompatibility(\n  artifactCompatibility: ArtifactCompatibilityEnvelope,\n  entryCompatibility: ArtifactCompatibilityEnvelope,\n): boolean {\n  return (\n    collectArtifactCompatibilityProofMismatches(artifactCompatibility, entryCompatibility)\n      .length === 0\n  );\n}\n\nfunction assertNever(value: never): never {\n  throw new Error(`Unhandled skip/cache proof state: ${String(value)}`);\n}\n\nfunction createRenderAndSendPlan(options: {\n  entryRejections?: readonly ClientReuseManifestEntryRejection[];\n  manifestRejection?: ClientReuseManifestRejection;\n  skipIneligibleEntryIds?: readonly string[];\n}): ClientReuseSkipTransportPlan {\n  return {\n    kind: \"renderAndSend\",\n    entryRejections: options.entryRejections ?? [],\n    ...(options.manifestRejection ? { manifestRejection: options.manifestRejection } : {}),\n    skipDisposition: createDisabledSkipDisposition(),\n    skipIneligibleEntryIds: options.skipIneligibleEntryIds ?? [],\n    skippedEntryIds: [],\n  };\n}\n\nfunction createVerificationBudgetExceededRejection(\n  totalWireEntries: number,\n  maxWireEntriesToVerify: number,\n): ClientReuseManifestRejection {\n  return {\n    code: \"SKIP_VERIFICATION_BUDGET_EXCEEDED\",\n    fields: { totalWireEntries, maxWireEntriesToVerify },\n  };\n}\n\nfunction crossCheckInvalidationProof(\n  entry: ClientReuseManifestEntry,\n  invalidation: SkipCacheInvalidationProof,\n): SkipCacheCrossCheckRejected | null {\n  switch (invalidation.kind) {\n    case \"valid\":\n      return null;\n    case \"unknown\":\n      return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_INVALIDATION_UNKNOWN\");\n    case \"invalidated\":\n      return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_INVALIDATED\", {\n        invalidationEpoch: invalidation.invalidationEpoch,\n      });\n    default:\n      return assertNever(invalidation);\n  }\n}\n\nexport function crossCheckClientReuseManifestEntryWithCache(\n  input: CrossCheckClientReuseManifestEntryWithCacheInput,\n): SkipCacheCrossCheckResult {\n  const { cacheDecision, entry } = input;\n  if (cacheDecision === null) {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_PROOF_MISSING\");\n  }\n  if (cacheDecision.kind === \"fallback\") {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_PROOF_REJECTED\", {\n      cacheProofCode: cacheDecision.fallback.code,\n      cacheProofMode: cacheDecision.fallback.mode,\n      cacheProofScope: cacheDecision.fallback.scope,\n    });\n  }\n\n  const { proof } = cacheDecision;\n  if (entry.kind !== \"layout\" || proof.reuseClass !== \"static-layout\") {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_REUSE_CLASS_UNSUPPORTED\", {\n      entryKind: entry.kind,\n      reuseClass: proof.reuseClass,\n    });\n  }\n\n  if (entry.id !== proof.candidateOutput.layoutId) {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_ENTRY_ID_MISMATCH\", {\n      cacheEntryId: proof.candidateOutput.layoutId,\n      manifestEntryId: entry.id,\n    });\n  }\n\n  const artifactProofMismatches = collectArtifactCompatibilityProofMismatches(\n    input.artifact.compatibility,\n    proof.candidateArtifactCompatibility,\n  );\n  if (artifactProofMismatches.length > 0) {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_ARTIFACT_PROOF_MISMATCH\", {\n      mismatchedFields: artifactProofMismatches,\n    });\n  }\n\n  const artifactCompatibility = evaluateArtifactCompatibility(\n    input.artifact.compatibility,\n    entry.artifactCompatibility,\n    { compatibilityMap: input.compatibilityMap },\n  );\n  if (artifactCompatibility.kind === \"unknown\") {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_ARTIFACT_COMPATIBILITY_UNKNOWN\", {\n      compatibilityFallback: artifactCompatibility.fallback,\n      reason: artifactCompatibility.reason,\n    });\n  }\n  if (artifactCompatibility.kind === \"incompatible\") {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_ARTIFACT_COMPATIBILITY_INCOMPATIBLE\", {\n      compatibilityFallback: artifactCompatibility.fallback,\n      reason: artifactCompatibility.reason,\n    });\n  }\n\n  if (entry.variantCacheKey !== proof.variant.cacheKey) {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_VARIANT_MISMATCH\", {\n      cacheVariantCacheKeyHash: createClientReusePayloadHash(proof.variant.cacheKey),\n      entryVariantCacheKeyHash: createClientReusePayloadHash(entry.variantCacheKey),\n    });\n  }\n\n  if (input.artifact.payloadHash === null) {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_PAYLOAD_HASH_MISSING\");\n  }\n\n  if (entry.payloadHash !== input.artifact.payloadHash) {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_PAYLOAD_HASH_MISMATCH\", {\n      cachePayloadHash: input.artifact.payloadHash,\n      entryPayloadHash: entry.payloadHash,\n    });\n  }\n\n  const invalidationRejection = crossCheckInvalidationProof(entry, input.artifact.invalidation);\n  if (invalidationRejection) return invalidationRejection;\n\n  // Skip transport requires exact artifact field equality — not just\n  // compatibility-map-based equivalence.  evaluateArtifactCompatibility (above)\n  // returns \"compatible\" when a declared set bridges differing fields (canary →\n  // rollback), but the skip planner must not elide a fresh render when the two\n  // payloads were built from observably different artifact environments.\n  // isExactArtifactCompatibility performs a distinct field-level walk that\n  // ignores the compatibility map, guaranteeing only bit-identical artifact\n  // envelopes are eligible for transport skip.\n  const skipDisposition = isExactArtifactCompatibility(\n    input.artifact.compatibility,\n    entry.artifactCompatibility,\n  )\n    ? createStaticLayoutSkipDisposition([entry.id])\n    : createDisabledSkipDisposition();\n\n  return {\n    kind: \"verified\",\n    code: \"SKIP_CACHE_CROSS_CHECK_PASSED\",\n    entryId: entry.id,\n    fields: {\n      entryKind: entry.kind,\n      reuseClass: proof.reuseClass,\n      variantCacheKeyHash: createClientReusePayloadHash(proof.variant.cacheKey),\n    },\n    skipDisposition,\n  };\n}\n\nexport function createClientReuseSkipTransportPlan(\n  input: CreateClientReuseSkipTransportPlanInput,\n): ClientReuseSkipTransportPlan {\n  const { manifest } = input;\n  if (manifest.kind === \"absent\") {\n    return createRenderAndSendPlan({});\n  }\n  if (manifest.kind === \"rejected\") {\n    return createRenderAndSendPlan({ manifestRejection: manifest.rejection });\n  }\n\n  const maxWireEntriesToVerify =\n    input.maxWireEntriesToVerify ?? CLIENT_REUSE_MANIFEST_SKIP_VERIFICATION_ENTRY_BUDGET;\n  if (!Number.isSafeInteger(maxWireEntriesToVerify) || maxWireEntriesToVerify < 0) {\n    throw new RangeError(\"maxWireEntriesToVerify must be a non-negative safe integer\");\n  }\n\n  const totalWireEntries = manifest.manifest.entries.length + manifest.entryRejections.length;\n  if (totalWireEntries > maxWireEntriesToVerify) {\n    return createRenderAndSendPlan({\n      entryRejections: manifest.entryRejections,\n      manifestRejection: createVerificationBudgetExceededRejection(\n        totalWireEntries,\n        maxWireEntriesToVerify,\n      ),\n    });\n  }\n\n  const skippedEntryIds: string[] = [];\n  const skipIneligibleEntryIds: string[] = [];\n  const entryRejections: ClientReuseManifestEntryRejection[] = [...manifest.entryRejections];\n  for (const entry of manifest.manifest.entries) {\n    const verification = input.verifyEntry(entry);\n    if (verification.kind === \"rejected\") {\n      entryRejections.push(verification.rejection);\n      continue;\n    }\n\n    // The planner must not trust a verifier that returns a verified result\n    // for a different entry than the one it was given.  This is an internal\n    // invariant, not a hostile-client defence.\n    if (verification.entryId !== entry.id) {\n      entryRejections.push({\n        code: \"SKIP_CACHE_ENTRY_ID_MISMATCH\",\n        entryId: entry.id,\n        fields: {\n          verifierEntryId: verification.entryId,\n          manifestEntryId: entry.id,\n        },\n      });\n      continue;\n    }\n\n    if (verification.skipDisposition.enabled) {\n      skippedEntryIds.push(entry.id);\n    } else {\n      skipIneligibleEntryIds.push(entry.id);\n    }\n  }\n\n  if (skippedEntryIds.length === 0) {\n    return createRenderAndSendPlan({ entryRejections, skipIneligibleEntryIds });\n  }\n\n  return {\n    kind: \"skip\",\n    entryRejections,\n    skipDisposition: createStaticLayoutSkipDisposition(skippedEntryIds),\n    skipIneligibleEntryIds,\n    skippedEntryIds,\n  };\n}\n"],"mappings":"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"}

package/dist/server/static-layout-client-reuse-proof.d.ts

@@ -0,0 +1,16 @@
+import { ArtifactCompatibilityEnvelope } from "./artifact-compatibility.js";
+
+//#region src/server/static-layout-client-reuse-proof.d.ts
+type StaticLayoutClientReuseProofInput = Readonly<{
+  artifactCompatibility: ArtifactCompatibilityEnvelope;
+  layoutId: string;
+  rootBoundaryId: string | null;
+  routeId: string;
+  variantCacheKey: string;
+}>;
+declare function createStaticLayoutClientReuseRouteId(layoutId: string): string;
+declare function createStaticLayoutClientReusePayloadHash(input: StaticLayoutClientReuseProofInput): string;
+declare function createStaticLayoutClientReuseArtifactCompatibility(input: StaticLayoutClientReuseProofInput): ArtifactCompatibilityEnvelope;
+//#endregion
+export { createStaticLayoutClientReuseArtifactCompatibility, createStaticLayoutClientReusePayloadHash, createStaticLayoutClientReuseRouteId };
+//# sourceMappingURL=static-layout-client-reuse-proof.d.ts.map

package/dist/server/static-layout-client-reuse-proof.js

@@ -0,0 +1,35 @@
+import { ARTIFACT_COMPATIBILITY_PROOF_FIELDS } from "./artifact-compatibility.js";
+import { createClientReusePayloadHash } from "./client-reuse-manifest.js";
+//#region src/server/static-layout-client-reuse-proof.ts
+function createStaticLayoutClientReuseRouteId(layoutId) {
+	return `static-layout:${createClientReusePayloadHash(layoutId)}`;
+}
+function createCanonicalProofPairs(input) {
+	return ARTIFACT_COMPATIBILITY_PROOF_FIELDS.map((field) => [field, input.artifactCompatibility[field]]);
+}
+function createStaticLayoutClientReusePayloadHash(input) {
+	return createClientReusePayloadHash(JSON.stringify({
+		artifactCompatibilityPairs: createCanonicalProofPairs(input),
+		layoutId: input.layoutId,
+		rootBoundaryId: input.rootBoundaryId,
+		variantCacheKey: input.variantCacheKey
+	}));
+}
+function createStaticLayoutClientReuseArtifactCompatibility(input) {
+	return {
+		...input.artifactCompatibility,
+		graphVersion: `static-layout-graph:${createClientReusePayloadHash(JSON.stringify({
+			layoutId: input.layoutId,
+			rootBoundaryId: input.rootBoundaryId
+		}))}`,
+		renderEpoch: `static-layout:${createClientReusePayloadHash(JSON.stringify({
+			layoutId: input.layoutId,
+			rootBoundaryId: input.rootBoundaryId,
+			variantCacheKey: input.variantCacheKey
+		}))}`
+	};
+}
+//#endregion
+export { createStaticLayoutClientReuseArtifactCompatibility, createStaticLayoutClientReusePayloadHash, createStaticLayoutClientReuseRouteId };
+
+//# sourceMappingURL=static-layout-client-reuse-proof.js.map

package/dist/server/static-layout-client-reuse-proof.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-layout-client-reuse-proof.js","names":[],"sources":["../../src/server/static-layout-client-reuse-proof.ts"],"sourcesContent":["import {\n  type ArtifactCompatibilityEnvelope,\n  ARTIFACT_COMPATIBILITY_PROOF_FIELDS,\n} from \"./artifact-compatibility.js\";\nimport { createClientReusePayloadHash } from \"./client-reuse-manifest.js\";\n\ntype StaticLayoutClientReuseProofInput = Readonly<{\n  artifactCompatibility: ArtifactCompatibilityEnvelope;\n  layoutId: string;\n  rootBoundaryId: string | null;\n  routeId: string;\n  variantCacheKey: string;\n}>;\n\ntype ProofFieldPair = readonly [string, string | number | null];\n\nexport function createStaticLayoutClientReuseRouteId(layoutId: string): string {\n  return `static-layout:${createClientReusePayloadHash(layoutId)}`;\n}\n\nfunction createCanonicalProofPairs(\n  input: StaticLayoutClientReuseProofInput,\n): readonly ProofFieldPair[] {\n  return ARTIFACT_COMPATIBILITY_PROOF_FIELDS.map((field) => [\n    field,\n    input.artifactCompatibility[field],\n  ]);\n}\n\nexport function createStaticLayoutClientReusePayloadHash(\n  input: StaticLayoutClientReuseProofInput,\n): string {\n  // ARTIFACT_COMPATIBILITY_PROOF_FIELDS order is load-bearing for hash\n  // determinism.  The artifact compatibility section is serialized as an\n  // array of [field, value] pairs in declaration order — no object key-order\n  // dependency — so the hash is invariant across runtimes.  Reordering the\n  // field list silently changes every hash.\n  //\n  // routeId is intentionally excluded.  This is a layout-scoped hash —\n  // sibling routes under the same layout must produce identical payload\n  // hashes, otherwise the cross-check rejects on payload hash mismatch\n  // before reaching the exact-equality gate.\n  // If the field list must change, bump the hash algorithm or namespace to\n  // avoid silent cross-deployment hash drift.\n  return createClientReusePayloadHash(\n    JSON.stringify({\n      artifactCompatibilityPairs: createCanonicalProofPairs(input),\n      layoutId: input.layoutId,\n      rootBoundaryId: input.rootBoundaryId,\n      variantCacheKey: input.variantCacheKey,\n    }),\n  );\n}\n\n// The app-route payload envelope is route-scoped and may not carry a render epoch\n// during this wave. Static-layout skip needs layout-scoped compatibility so\n// sibling-route navigation can reuse a retained static layout without treating\n// the source route id as part of the retained artifact identity.\n//\n// renderEpoch is scoped to layout identity (layoutId, rootBoundaryId) and the\n// rendering variant (variantCacheKey).  The leaf routeId is intentionally\n// excluded — sibling routes under the same layout must produce the same\n// renderEpoch, otherwise exact-equality skip gating would silently disable\n// skip transport for the primary use case (navigating between sibling pages).\nexport function createStaticLayoutClientReuseArtifactCompatibility(\n  input: StaticLayoutClientReuseProofInput,\n): ArtifactCompatibilityEnvelope {\n  return {\n    ...input.artifactCompatibility,\n    graphVersion: `static-layout-graph:${createClientReusePayloadHash(\n      JSON.stringify({\n        layoutId: input.layoutId,\n        rootBoundaryId: input.rootBoundaryId,\n      }),\n    )}`,\n    renderEpoch: `static-layout:${createClientReusePayloadHash(\n      JSON.stringify({\n        layoutId: input.layoutId,\n        rootBoundaryId: input.rootBoundaryId,\n        variantCacheKey: input.variantCacheKey,\n      }),\n    )}`,\n  };\n}\n"],"mappings":";;;AAgBA,SAAgB,qCAAqC,UAA0B;CAC7E,OAAO,iBAAiB,6BAA6B,SAAS;;AAGhE,SAAS,0BACP,OAC2B;CAC3B,OAAO,oCAAoC,KAAK,UAAU,CACxD,OACA,MAAM,sBAAsB,OAC7B,CAAC;;AAGJ,SAAgB,yCACd,OACQ;CAaR,OAAO,6BACL,KAAK,UAAU;EACb,4BAA4B,0BAA0B,MAAM;EAC5D,UAAU,MAAM;EAChB,gBAAgB,MAAM;EACtB,iBAAiB,MAAM;EACxB,CAAC,CACH;;AAaH,SAAgB,mDACd,OAC+B;CAC/B,OAAO;EACL,GAAG,MAAM;EACT,cAAc,uBAAuB,6BACnC,KAAK,UAAU;GACb,UAAU,MAAM;GAChB,gBAAgB,MAAM;GACvB,CAAC,CACH;EACD,aAAa,iBAAiB,6BAC5B,KAAK,UAAU;GACb,UAAU,MAAM;GAChB,gBAAgB,MAAM;GACtB,iBAAiB,MAAM;GACxB,CAAC,CACH;EACF"}

package/dist/shims/cache.d.ts

@@ -94,9 +94,19 @@ declare class NoOpCacheHandler implements CacheHandler {
     expire?: number;
   }): Promise<void>;
 }
+type MemoryCacheHandlerOptions = Pick<CacheHandlerContext, "maxMemoryCacheSize"> & {
+  cacheMaxMemorySize?: number;
+};
 declare class MemoryCacheHandler implements CacheHandler {
   private store;
   private tagRevalidatedAt;
+  private readonly maxMemoryCacheSize;
+  private currentMemoryCacheSize;
+  constructor(options?: number | MemoryCacheHandlerOptions);
+  private estimateEntrySize;
+  private deleteEntry;
+  private touchEntry;
+  private evictLeastRecentlyUsed;
   get(key: string, _ctx?: Record<string, unknown>): Promise<CacheHandlerValue | null>;
   set(key: string, data: IncrementalCacheValue | null, ctx?: Record<string, unknown>): Promise<void>;
   revalidateTag(tags: string | string[], _durations?: {
@@ -104,6 +114,7 @@ declare class MemoryCacheHandler implements CacheHandler {
   }): Promise<void>;
   resetRequestCache(): void;
 }
+declare function configureMemoryCacheHandler(options?: MemoryCacheHandlerOptions): void;
 /**
  * Set a custom CacheHandler. Call this during server startup to
  * plug in Cloudflare KV, Redis, DynamoDB, or any other backend.
@@ -212,9 +223,17 @@ declare function io(): Promise<void>;
 declare function unstable_io(): Promise<void>;
 type UnstableCacheRevalidationMode = "foreground" | "background";
 type ActionRevalidationKind = 0 | 1 | 2;
+type UnstableCacheObservation = Readonly<{
+  kind: "unstable_cache";
+  keyHash: string;
+  revalidate: number | false | null;
+  tagCount: number;
+  tagHash: string | null;
+}>;
 type CacheState = {
   actionRevalidationKind: ActionRevalidationKind;
   requestScopedCacheLife: CacheLifeConfig | null;
+  unstableCacheObservations: Map<string, UnstableCacheObservation>;
   unstableCacheRevalidation: UnstableCacheRevalidationMode;
 };
 /**
@@ -250,6 +269,7 @@ declare function _peekRequestScopedCacheLife(): CacheLifeConfig | null;
  * @internal
  */
 declare function _consumeRequestScopedCacheLife(): CacheLifeConfig | null;
+declare function _peekUnstableCacheObservations(): UnstableCacheObservation[];
 /**
  * Cache life configuration. Controls stale-while-revalidate behavior.
  */
@@ -307,5 +327,5 @@ type UnstableCacheOptions = {
  */
 declare function unstable_cache<T extends (...args: any[]) => Promise<any>>(fn: T, keyParts?: string[], options?: UnstableCacheOptions): T;
 //#endregion
-export { ActionRevalidationKind, CacheControlMetadata, CacheHandler, CacheHandlerContext, CacheHandlerValue, CacheLifeConfig, CacheState, CachedAppPageValue, CachedFetchValue, CachedImageValue, CachedPagesValue, CachedRedirectValue, CachedRouteValue, type ExecutionContextLike, IncrementalCacheValue, MemoryCacheHandler, NoOpCacheHandler, UnstableCacheRevalidationMode, _consumeRequestScopedCacheLife, _initRequestScopedCacheState, _peekRequestScopedCacheLife, _registerCacheContextAccessor, _runWithCacheState, _setRequestScopedCacheLife, cacheLife, cacheLifeProfiles, cacheTag, getAndClearActionRevalidationKind, getCacheHandler, getRequestExecutionContext, io, isInsideUnstableCacheScope, unstable_noStore as noStore, unstable_noStore, refresh, revalidatePath, revalidateTag, runWithExecutionContext, setCacheHandler, unstable_cache, unstable_cacheLife, unstable_cacheTag, unstable_io, updateTag };
+export { ActionRevalidationKind, CacheControlMetadata, CacheHandler, CacheHandlerContext, CacheHandlerValue, CacheLifeConfig, CacheState, CachedAppPageValue, CachedFetchValue, CachedImageValue, CachedPagesValue, CachedRedirectValue, CachedRouteValue, type ExecutionContextLike, IncrementalCacheValue, MemoryCacheHandler, NoOpCacheHandler, UnstableCacheObservation, UnstableCacheRevalidationMode, _consumeRequestScopedCacheLife, _initRequestScopedCacheState, _peekRequestScopedCacheLife, _peekUnstableCacheObservations, _registerCacheContextAccessor, _runWithCacheState, _setRequestScopedCacheLife, cacheLife, cacheLifeProfiles, cacheTag, configureMemoryCacheHandler, getAndClearActionRevalidationKind, getCacheHandler, getRequestExecutionContext, io, isInsideUnstableCacheScope, unstable_noStore as noStore, unstable_noStore, refresh, revalidatePath, revalidateTag, runWithExecutionContext, setCacheHandler, unstable_cache, unstable_cacheLife, unstable_cacheTag, unstable_io, updateTag };
 //# sourceMappingURL=cache.d.ts.map

package/dist/shims/cache.js

@@ -42,6 +42,36 @@ var NoOpCacheHandler = class {
 	async set(_key, _data, _ctx) {}
 	async revalidateTag(_tags, _durations) {}
 };
+const DEFAULT_MEMORY_CACHE_MAX_SIZE = 50 * 1024 * 1024;
+const MAX_REVALIDATED_TAG_ENTRIES = 1e4;
+function estimateStringMapSize(map) {
+	if (!map) return 0;
+	let size = 0;
+	for (const [key, value] of Object.entries(map)) {
+		size += key.length;
+		if (Array.isArray(value)) for (const item of value) size += item.length;
+		else size += value.length;
+	}
+	return size;
+}
+function estimateIncrementalCacheValueSize(value) {
+	if (value === null) return 25;
+	switch (value.kind) {
+		case "FETCH": return JSON.stringify(value.data ?? "").length;
+		case "PAGES": return value.html.length + JSON.stringify(value.pageData ?? {}).length + estimateStringMapSize(value.headers);
+		case "APP_PAGE": return value.html.length + (value.rscData?.byteLength ?? 0) + (value.postponed?.length ?? 0) + estimateStringMapSize(value.headers);
+		case "APP_ROUTE": return value.body.byteLength + estimateStringMapSize(value.headers);
+		case "REDIRECT": return JSON.stringify(value.props ?? {}).length;
+		case "IMAGE": return value.buffer.byteLength + value.extension.length + value.etag.length;
+		default: return JSON.stringify(value).length;
+	}
+}
+function resolveMemoryCacheMaxSize(options) {
+	if (typeof options === "number") return options;
+	if (typeof options?.cacheMaxMemorySize === "number") return options.cacheMaxMemorySize;
+	if (typeof options?.maxMemoryCacheSize === "number") return options.maxMemoryCacheSize;
+	return DEFAULT_MEMORY_CACHE_MAX_SIZE;
+}
 function readStringArrayField(ctx, field) {
 	const value = ctx?.[field];
 	if (!Array.isArray(value)) return [];
@@ -50,13 +80,38 @@ function readStringArrayField(ctx, field) {
 var MemoryCacheHandler = class {
 	store = /* @__PURE__ */ new Map();
 	tagRevalidatedAt = /* @__PURE__ */ new Map();
+	maxMemoryCacheSize;
+	currentMemoryCacheSize = 0;
+	constructor(options) {
+		this.maxMemoryCacheSize = resolveMemoryCacheMaxSize(options);
+	}
+	estimateEntrySize(entry) {
+		return estimateIncrementalCacheValueSize(entry.value) + entry.tags.reduce((sum, tag) => sum + tag.length, 0) + 64;
+	}
+	deleteEntry(key) {
+		const existing = this.store.get(key);
+		if (!existing) return;
+		this.currentMemoryCacheSize -= this.estimateEntrySize(existing);
+		this.store.delete(key);
+	}
+	touchEntry(key, entry) {
+		this.store.delete(key);
+		this.store.set(key, entry);
+	}
+	evictLeastRecentlyUsed() {
+		while (this.maxMemoryCacheSize > 0 && this.currentMemoryCacheSize > this.maxMemoryCacheSize) {
+			const oldestKey = this.store.keys().next().value;
+			if (oldestKey === void 0) return;
+			this.deleteEntry(oldestKey);
+		}
+	}
 	async get(key, _ctx) {
 		const entry = this.store.get(key);
 		if (!entry) return null;
 		for (const tag of entry.tags) {
 			const revalidatedAt = this.tagRevalidatedAt.get(tag);
 			if (revalidatedAt && revalidatedAt >= entry.lastModified) {
-				this.store.delete(key);
+				this.deleteEntry(key);
 				return null;
 			}
 		}
@@ -65,9 +120,10 @@ var MemoryCacheHandler = class {
 			if (revalidatedAt && revalidatedAt >= entry.lastModified) return null;
 		}
 		if (entry.expireAt !== null && Date.now() > entry.expireAt) {
-			this.store.delete(key);
+			this.deleteEntry(key);
 			return null;
 		}
+		this.touchEntry(key, entry);
 		if (entry.revalidateAt !== null && Date.now() > entry.revalidateAt) return {
 			lastModified: entry.lastModified,
 			value: entry.value,
@@ -98,19 +154,36 @@ var MemoryCacheHandler = class {
 			revalidate: effectiveRevalidate,
 			expire: effectiveExpire
 		} : void 0;
-		this.store.set(key, {
+		if (this.maxMemoryCacheSize === 0) return;
+		const entry = {
 			value: data,
 			tags,
 			lastModified: now,
 			revalidateAt,
 			expireAt,
 			cacheControl
-		});
+		};
+		const entrySize = this.estimateEntrySize(entry);
+		if (entrySize > this.maxMemoryCacheSize) {
+			this.deleteEntry(key);
+			return;
+		}
+		this.deleteEntry(key);
+		this.store.set(key, entry);
+		this.currentMemoryCacheSize += entrySize;
+		this.evictLeastRecentlyUsed();
 	}
 	async revalidateTag(tags, _durations) {
 		const tagList = Array.isArray(tags) ? tags : [tags];
 		const now = Date.now();
-		for (const tag of tagList) this.tagRevalidatedAt.set(tag, now);
+		for (const tag of tagList) {
+			this.tagRevalidatedAt.set(tag, now);
+			while (this.tagRevalidatedAt.size > MAX_REVALIDATED_TAG_ENTRIES) {
+				const oldest = this.tagRevalidatedAt.keys().next().value;
+				if (oldest === void 0) break;
+				this.tagRevalidatedAt.delete(oldest);
+			}
+		}
 	}
 	resetRequestCache() {}
 };
@@ -119,6 +192,11 @@ const _gHandler = globalThis;
 function _getActiveHandler() {
 	return _gHandler[_HANDLER_KEY] ?? (_gHandler[_HANDLER_KEY] = new MemoryCacheHandler());
 }
+function configureMemoryCacheHandler(options) {
+	const current = _gHandler[_HANDLER_KEY];
+	if (current && !(current instanceof MemoryCacheHandler)) return;
+	_gHandler[_HANDLER_KEY] = new MemoryCacheHandler(options);
+}
 /**
 * Set a custom CacheHandler. Call this during server startup to
 * plug in Cloudflare KV, Redis, DynamoDB, or any other backend.
@@ -286,6 +364,7 @@ const _cacheAls = getOrCreateAls("vinext.cache.als");
 const _cacheFallbackState = _g[_FALLBACK_KEY] ??= {
 	actionRevalidationKind: 0,
 	requestScopedCacheLife: null,
+	unstableCacheObservations: /* @__PURE__ */ new Map(),
 	unstableCacheRevalidation: "foreground"
 };
 const ACTION_DID_NOT_REVALIDATE = 0;
@@ -299,11 +378,13 @@ function _runWithCacheState(fn) {
 	if (isInsideUnifiedScope()) return runWithUnifiedStateMutation((uCtx) => {
 		uCtx.actionRevalidationKind = ACTION_DID_NOT_REVALIDATE;
 		uCtx.requestScopedCacheLife = null;
+		uCtx.unstableCacheObservations = /* @__PURE__ */ new Map();
 		uCtx.unstableCacheRevalidation = "foreground";
 	}, fn);
 	const state = {
 		actionRevalidationKind: ACTION_DID_NOT_REVALIDATE,
 		requestScopedCacheLife: null,
+		unstableCacheObservations: /* @__PURE__ */ new Map(),
 		unstableCacheRevalidation: "foreground"
 	};
 	return _cacheAls.run(state, fn);
@@ -317,6 +398,7 @@ function _initRequestScopedCacheState() {
 	const state = _getCacheState();
 	state.actionRevalidationKind = ACTION_DID_NOT_REVALIDATE;
 	state.requestScopedCacheLife = null;
+	state.unstableCacheObservations = /* @__PURE__ */ new Map();
 }
 function markActionRevalidation(kind) {
 	if (getHeadersAccessPhase() !== "action") return;
@@ -363,6 +445,12 @@ function _consumeRequestScopedCacheLife() {
 	state.requestScopedCacheLife = null;
 	return config;
 }
+function recordUnstableCacheObservation(observation) {
+	_getCacheState().unstableCacheObservations.set(observation.keyHash, observation);
+}
+function _peekUnstableCacheObservations() {
+	return [..._getCacheState().unstableCacheObservations.values()].sort((a, b) => a.keyHash.localeCompare(b.keyHash));
+}
 /**
 * Built-in cache life profiles matching Next.js 16.
 */
@@ -590,6 +678,13 @@ function unstable_cache(fn, keyParts, options) {
 	const revalidateSeconds = options?.revalidate;
 	const cachedFn = async (...args) => {
 		const cacheKey = `unstable_cache:${baseKey}:${JSON.stringify(args)}`;
+		recordUnstableCacheObservation({
+			kind: "unstable_cache",
+			keyHash: fnv1a64(cacheKey),
+			revalidate: typeof revalidateSeconds === "number" ? revalidateSeconds : revalidateSeconds === false ? false : null,
+			tagCount: tags.length,
+			tagHash: tags.length > 0 ? fnv1a64(JSON.stringify(tags)) : null
+		});
 		const existing = await _getActiveHandler().get(cacheKey, {
 			kind: "FETCH",
 			tags
@@ -608,6 +703,6 @@ function unstable_cache(fn, keyParts, options) {
 	return cachedFn;
 }
 //#endregion
-export { MemoryCacheHandler, NoOpCacheHandler, _consumeRequestScopedCacheLife, _initRequestScopedCacheState, _peekRequestScopedCacheLife, _registerCacheContextAccessor, _runWithCacheState, _setRequestScopedCacheLife, cacheLife, cacheLifeProfiles, cacheTag, getAndClearActionRevalidationKind, getCacheHandler, getRequestExecutionContext, io, isInsideUnstableCacheScope, unstable_noStore as noStore, unstable_noStore, refresh, revalidatePath, revalidateTag, runWithExecutionContext, setCacheHandler, unstable_cache, unstable_cacheLife, unstable_cacheTag, unstable_io, updateTag };
+export { MemoryCacheHandler, NoOpCacheHandler, _consumeRequestScopedCacheLife, _initRequestScopedCacheState, _peekRequestScopedCacheLife, _peekUnstableCacheObservations, _registerCacheContextAccessor, _runWithCacheState, _setRequestScopedCacheLife, cacheLife, cacheLifeProfiles, cacheTag, configureMemoryCacheHandler, getAndClearActionRevalidationKind, getCacheHandler, getRequestExecutionContext, io, isInsideUnstableCacheScope, unstable_noStore as noStore, unstable_noStore, refresh, revalidatePath, revalidateTag, runWithExecutionContext, setCacheHandler, unstable_cache, unstable_cacheLife, unstable_cacheTag, unstable_io, updateTag };
 
 //# sourceMappingURL=cache.js.map