vinext 0.2.1 → 1.0.0-beta.0

package/dist/shims/cdn-cache.js

@@ -1,6 +1,4 @@
-import { getRequestExecutionContext } from "./request-context.js";
 import { getDataCacheHandler } from "./cache-handler.js";
-import { CloudflareCdnCacheAdapter } from "../packages/cloudflare/src/cache/cdn-adapter.runtime.js";
 //#region src/shims/cdn-cache.ts
 /**
 * CDN cache adapter — owns the *page-level ISR serving strategy*.
@@ -78,22 +76,12 @@ function setCdnCacheAdapter(adapter) {
 	_gCdn[_CDN_KEY] = adapter;
 }
 /**
-* Get the active CDN cache adapter. See the precedence note above:
-* explicit (or an already-resolved auto-detected edge adapter) → origin-managed
-* {@link DefaultCdnCacheAdapter}.
-*
-* Auto-detection of the Cloudflare Workers Cache (`ctx.cache`) only runs when
-* `VINEXT_CDN_CACHE_AUTO_DETECT === "1"`; otherwise the default adapter is used
-* unless an adapter was set explicitly.
+* Get the active CDN cache adapter. An explicitly configured adapter wins;
+* otherwise the origin-managed {@link DefaultCdnCacheAdapter} is used.
 */
 function getCdnCacheAdapter() {
 	const active = _gCdn[_CDN_KEY];
 	if (active) return active;
-	if (process.env.VINEXT_CDN_CACHE_AUTO_DETECT === "1" && getRequestExecutionContext()?.cache) {
-		const edge = new CloudflareCdnCacheAdapter();
-		_gCdn[_CDN_KEY] = edge;
-		return edge;
-	}
 	return _defaultAdapter ??= new DefaultCdnCacheAdapter();
 }
 //#endregion

package/dist/shims/form.d.ts

@@ -16,6 +16,6 @@ declare const Form: import("react").ForwardRefExoticComponent<{
    * In pages dir, prefetch is not supported and the prop has no effect.
    */
   prefetch?: false | null;
-} & Omit<FormHTMLAttributes<HTMLFormElement>, "target" | "method" | "encType"> & import("react").RefAttributes<HTMLFormElement>>;
+} & Omit<FormHTMLAttributes<HTMLFormElement>, "method" | "encType" | "target"> & import("react").RefAttributes<HTMLFormElement>>;
 //#endregion
 export { createFormSubmitDestinationUrl, Form as default, useActionState };

package/dist/shims/navigation.react-server.js

@@ -1,8 +1,8 @@
 import { GLOBAL_ACCESSORS_KEY, ServerInsertedHTMLContext, _registerStateAccessors, clearServerInsertedHTML, flushServerInsertedHTML, getLayoutSegmentContext, getNavigationContext, renderServerInsertedHTML, setNavigationContext } from "./navigation-context-state.js";
 import { BailoutToCSRError, DynamicServerError, HTTP_ERROR_FALLBACK_ERROR_CODE, RedirectType, forbidden, getAccessFallbackHTTPStatus, isBailoutToCSRError, isDynamicServerError, isHTTPAccessFallbackError, isNextRouterError, isRedirectError, notFound, permanentRedirect, redirect, unauthorized, unstable_rethrow } from "./navigation-errors.js";
 import "./navigation-server.js";
-import { throwClientHookError } from "./client-hook-error.js";
 import { ReadonlyURLSearchParams } from "./readonly-url-search-params.js";
+import { throwClientHookError } from "./client-hook-error.js";
 //#region src/shims/navigation.react-server.ts
 function usePathname() {
 	throwClientHookError("usePathname()");

package/dist/shims/request-state-types.d.ts

@@ -1,7 +1,7 @@
-import { CacheLifeConfig, CacheState } from "./cache-request-state.js";
-import { ExecutionContextLike } from "./request-context.js";
 import { NavigationContext } from "./navigation-context-state.js";
 import { RootParamsState } from "./root-params.js";
+import { CacheLifeConfig, CacheState } from "./cache-request-state.js";
+import { ExecutionContextLike } from "./request-context.js";
 import { FetchCacheState } from "./fetch-cache.js";
 import { HeadersAccessPhase, HeadersContext, VinextHeadersShimState } from "./headers.js";
 import { RouterState, SSRContext } from "./router-state.js";

package/dist/shims/unified-request-context.d.ts

@@ -1,6 +1,6 @@
+import { RootParamsState } from "./root-params.js";
 import { CacheState } from "./cache-request-state.js";
 import { ExecutionContextLike } from "./request-context.js";
-import { RootParamsState } from "./root-params.js";
 import { FetchCacheState } from "./fetch-cache.js";
 import { VinextHeadersShimState } from "./headers.js";
 import { RouterState } from "./router-state.js";

package/dist/utils/project.d.ts

@@ -123,4 +123,4 @@ declare function findDir(root: string, ...candidates: string[]): string | null;
  */
 declare function hasAppDir(root: string): boolean;
 //#endregion
-export { ProjectInfo, detectPackageManager, detectPackageManagerName, detectProject, ensureESModule, ensureViteConfigCompatibility, findDir, findInNodeModules, findViteConfigPath, formatMissingCloudflarePluginError, getMissingDeps, hasAppDir, hasViteConfig, hasWranglerConfig, isPackageResolvable, renameCJSConfigs };
+export { PackageManagerName, ProjectInfo, detectPackageManager, detectPackageManagerName, detectProject, ensureESModule, ensureViteConfigCompatibility, findDir, findInNodeModules, findViteConfigPath, formatMissingCloudflarePluginError, getMissingDeps, hasAppDir, hasViteConfig, hasWranglerConfig, isPackageResolvable, renameCJSConfigs };

package/dist/utils/vite-version.d.ts

@@ -1,23 +1,13 @@
 //#region src/utils/vite-version.d.ts
 declare function serializeViteDefine(value: unknown): string;
-declare function getDepOptimizeNodeEnvOptions(viteMajorVersion: number, nodeEnvDefine: string): {
+declare function getDepOptimizeNodeEnvOptions(nodeEnvDefine: string): {
   rolldownOptions?: {
     transform: {
       define: Record<string, string>;
     };
     moduleTypes?: Record<string, "jsx">;
   };
-  esbuildOptions?: {
-    define: Record<string, string>;
-    loader?: Record<string, "jsx">;
-  };
 };
-/**
- * Detect Vite major version at runtime by resolving from cwd.
- * The plugin may be installed in a workspace root with Vite 7 but used
- * by a project that has Vite 8 — so we resolve from cwd, not from
- * the plugin's own location.
- */
-declare function getViteMajorVersion(): number;
+declare function assertSupportedViteVersion(): number;
 //#endregion
-export { getDepOptimizeNodeEnvOptions, getViteMajorVersion, serializeViteDefine };
+export { assertSupportedViteVersion, getDepOptimizeNodeEnvOptions, serializeViteDefine };

package/dist/utils/vite-version.js

@@ -4,49 +4,57 @@ import path from "node:path";
 /**
 * Vite major-version detection.
 *
-* Several vinext behaviors depend on whether the host project is running Vite 8
-* (Rolldown-based, with native `resolve.tsconfigPaths`, `oxc` transforms, and
-* `rolldownOptions`) or Vite 7 (Rollup/esbuild). This helper centralizes the
-* detection so the Vite-major gate is computed the same way everywhere.
+* vinext requires Vite 8 or newer so it can rely on Rolldown-based build
+* options, native `resolve.tsconfigPaths`, and OXC transforms.
 */
 function serializeViteDefine(value) {
 	if (typeof value === "string") return value;
 	return JSON.stringify(value) ?? "undefined";
 }
-function getDepOptimizeNodeEnvOptions(viteMajorVersion, nodeEnvDefine) {
-	const define = { "process.env.NODE_ENV": nodeEnvDefine };
-	const jsxModuleTypes = {
-		".js": "jsx",
-		".mjs": "jsx"
-	};
-	return viteMajorVersion >= 8 ? { rolldownOptions: {
-		transform: { define },
-		moduleTypes: jsxModuleTypes
-	} } : { esbuildOptions: {
-		define,
-		loader: jsxModuleTypes
+function getDepOptimizeNodeEnvOptions(nodeEnvDefine) {
+	return { rolldownOptions: {
+		transform: { define: { "process.env.NODE_ENV": nodeEnvDefine } },
+		moduleTypes: {
+			".js": "jsx",
+			".mjs": "jsx"
+		}
 	} };
 }
 /**
-* Detect Vite major version at runtime by resolving from cwd.
-* The plugin may be installed in a workspace root with Vite 7 but used
-* by a project that has Vite 8 — so we resolve from cwd, not from
-* the plugin's own location.
+* Detect Vite major version at runtime. Prefer the project cwd, then fall back
+* to vinext's own dependency graph for tests and linked source checkouts.
 */
 function getViteMajorVersion() {
 	try {
-		const vitePkg = createRequire(path.join(process.cwd(), "package.json"))("vite/package.json");
-		const viteMajor = parseInt(vitePkg?.version, 10);
-		if (vitePkg?.name === "vite" && Number.isFinite(viteMajor)) return viteMajor;
-		const bundledViteMajor = parseInt(vitePkg?.bundledVersions?.vite, 10);
-		if (Number.isFinite(bundledViteMajor)) return bundledViteMajor;
-		console.warn(`[vinext] Could not determine Vite major version from ${vitePkg?.name ?? "vite/package.json"}; assuming Vite 7`);
-		return 7;
+		return getViteMajorVersionFromRequire(createRequire(path.join(process.cwd(), "package.json")));
+	} catch (error) {
+		if (!isModuleNotFoundError(error)) {
+			const message = error instanceof Error ? error.message : String(error);
+			throw new Error(`[vinext] Vite 8 or newer is required, but ${message}`);
+		}
+	}
+	try {
+		return getViteMajorVersionFromRequire(createRequire(import.meta.url));
 	} catch (error) {
 		const message = error instanceof Error ? error.message : String(error);
-		console.warn(`[vinext] Failed to resolve vite/package.json (${message}); assuming Vite 7`);
-		return 7;
+		throw new Error(`[vinext] Vite 8 or newer is required, but vinext could not resolve vite/package.json (${message})`);
 	}
 }
+function getViteMajorVersionFromRequire(require) {
+	const vitePkg = require("vite/package.json");
+	const viteMajor = parseInt(vitePkg?.version, 10);
+	if (vitePkg?.name === "vite" && Number.isFinite(viteMajor)) return viteMajor;
+	const bundledViteMajor = parseInt(vitePkg?.bundledVersions?.vite, 10);
+	if (Number.isFinite(bundledViteMajor)) return bundledViteMajor;
+	throw new Error(`could not determine Vite version from ${vitePkg?.name ?? "vite/package.json"}`);
+}
+function isModuleNotFoundError(error) {
+	return !!error && typeof error === "object" && "code" in error && error.code === "MODULE_NOT_FOUND";
+}
+function assertSupportedViteVersion() {
+	const viteMajorVersion = getViteMajorVersion();
+	if (viteMajorVersion < 8) throw new Error(`[vinext] Vite 8 or newer is required. Detected Vite ${viteMajorVersion}.`);
+	return viteMajorVersion;
+}
 //#endregion
-export { getDepOptimizeNodeEnvOptions, getViteMajorVersion, serializeViteDefine };
+export { assertSupportedViteVersion, getDepOptimizeNodeEnvOptions, serializeViteDefine };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vinext",
-  "version": "0.2.1",
+  "version": "1.0.0-beta.0",
   "description": "Run Next.js apps on Vite. Drop-in replacement for the next CLI.",
   "license": "MIT",
   "repository": {
@@ -37,10 +37,6 @@
       "types": "./dist/server/pages-i18n.d.ts",
       "import": "./dist/server/pages-i18n.js"
     },
-    "./cloudflare": {
-      "types": "./dist/cloudflare/index.d.ts",
-      "import": "./dist/cloudflare/index.js"
-    },
     "./server/image-optimization": {
       "types": "./dist/server/image-optimization.d.ts",
       "import": "./dist/server/image-optimization.js"
@@ -81,10 +77,34 @@
       "types": "./dist/server/app-page-cache.d.ts",
       "import": "./dist/server/app-page-cache.js"
     },
+    "./internal/server/prerender-manifest": {
+      "types": "./dist/server/prerender-manifest.d.ts",
+      "import": "./dist/server/prerender-manifest.js"
+    },
+    "./internal/server/pregenerated-concrete-paths": {
+      "types": "./dist/server/pregenerated-concrete-paths.d.ts",
+      "import": "./dist/server/pregenerated-concrete-paths.js"
+    },
     "./internal/build/run-prerender": {
       "types": "./dist/build/run-prerender.d.ts",
       "import": "./dist/build/run-prerender.js"
     },
+    "./internal/build/prerender-paths": {
+      "types": "./dist/build/prerender-paths.d.ts",
+      "import": "./dist/build/prerender-paths.js"
+    },
+    "./internal/cache-adapters": {
+      "types": "./dist/cache/cache-adapters-virtual.d.ts",
+      "import": "./dist/cache/cache-adapters-virtual.js"
+    },
+    "./internal/init": {
+      "types": "./dist/init.d.ts",
+      "import": "./dist/init.js"
+    },
+    "./internal/init-platform": {
+      "types": "./dist/init-platform.d.ts",
+      "import": "./dist/init-platform.js"
+    },
     "./internal/config/dotenv": {
       "types": "./dist/config/dotenv.d.ts",
       "import": "./dist/config/dotenv.js"
@@ -128,6 +148,10 @@
     "./internal/utils/project": {
       "types": "./dist/utils/project.d.ts",
       "import": "./dist/utils/project.js"
+    },
+    "./internal/utils/prerender-output-paths": {
+      "types": "./dist/utils/prerender-output-paths.d.ts",
+      "import": "./dist/utils/prerender-output-paths.js"
     }
   },
   "dependencies": {
@@ -148,9 +172,7 @@
     "am-i-vibing": "^0.5.0",
     "react-server-dom-webpack": "^19.2.7",
     "vite": "npm:@voidzero-dev/vite-plus-core@0.2.1",
-    "vite-plus": "0.2.1",
-    "vite-tsconfig-paths": "^6.1.1",
-    "@vinext/cloudflare": "0.2.1"
+    "vite-plus": "0.2.1"
   },
   "peerDependencies": {
     "@mdx-js/rollup": "^3.0.0",
@@ -159,8 +181,7 @@
     "react": "^19.2.6",
     "react-dom": "^19.2.6",
     "react-server-dom-webpack": "^19.2.6",
-    "vite": "^7.0.0 || ^8.0.0",
-    "vite-tsconfig-paths": "^6.1.1"
+    "vite": "^8.0.0"
   },
   "peerDependenciesMeta": {
     "@mdx-js/rollup": {
@@ -171,9 +192,6 @@
     },
     "react-server-dom-webpack": {
       "optional": true
-    },
-    "vite-tsconfig-paths": {
-      "optional": true
     }
   },
   "engines": {

package/dist/cloudflare/index.d.ts

@@ -1,3 +0,0 @@
-import { KVCacheHandler } from "../packages/cloudflare/src/cache/kv-data-adapter.runtime.js";
-import { TPROptions, TPRResult, runTPR } from "../packages/cloudflare/src/tpr.js";
-export { KVCacheHandler, type TPROptions, type TPRResult, runTPR };

package/dist/cloudflare/index.js

@@ -1,3 +0,0 @@
-import { KVCacheHandler } from "../packages/cloudflare/src/cache/kv-data-adapter.runtime.js";
-import { runTPR } from "../packages/cloudflare/src/tpr.js";
-export { KVCacheHandler, runTPR };

package/dist/packages/cloudflare/src/cache/cdn-adapter.runtime.js

@@ -1,102 +0,0 @@
-import { getRequestExecutionContext } from "../../../../shims/request-context.js";
-//#region ../cloudflare/src/cache/cdn-adapter.runtime.ts
-function getWorkersCache() {
-	const cache = getRequestExecutionContext()?.cache;
-	if (cache && typeof cache.purge === "function") return cache;
-	return null;
-}
-/** Non-cacheable responses: nobody (edge or browser) stores them. */
-const NO_STORE = "no-store";
-/**
-* Browser-facing policy for cacheable responses. `public` allows shared caches
-* to participate, but `max-age=0, must-revalidate` forces every reuse to
-* revalidate (against the edge) rather than serving a stored copy — so the user
-* always sees edge-fresh content while still permitting conditional 304s.
-*/
-const BROWSER_REVALIDATE = "public, max-age=0, must-revalidate";
-/**
-* A concrete stale window (1 year) substituted for a value-less
-* `stale-while-revalidate`. The framework emits a bare `stale-while-revalidate`
-* (no `=seconds`) to mean an unbounded stale window — a Vercel CDN extension.
-* Cloudflare follows RFC 5861, which requires `stale-while-revalidate=<seconds>`,
-* and treats the value-less form as a zero-width window (no stale serving →
-* hard expiry at `max-age`, so the next request is a MISS instead of UPDATING).
-* Stamping a large finite value preserves the "serve stale ~indefinitely while
-* revalidating" intent in a form the edge honors.
-*/
-const UNBOUNDED_SWR_SECONDS = 31536e3;
-/**
-* Convert the framework's shared-cache policy into a CDN-scoped one:
-* `s-maxage=…` → `max-age=…` (the edge honors `max-age` inside
-* `CDN-Cache-Control`), give a value-less `stale-while-revalidate` an explicit
-* seconds value (Cloudflare ignores the bare directive), and ensure a leading
-* `public`.
-*/
-function toEdgeCacheControl(cacheControl) {
-	const withMaxAge = cacheControl.replace(/\bs-maxage=/g, "max-age=").replace(/\bstale-while-revalidate\b(?!=)/g, `stale-while-revalidate=${UNBOUNDED_SWR_SECONDS}`);
-	return /\bpublic\b/.test(withMaxAge) ? withMaxAge : `public, ${withMaxAge}`;
-}
-/**
-* Cloudflare's `Cache-Tag` header budget is 16 KB total with each tag capped at
-* 1024 bytes. Keep a conservative ceiling so a page with a large tag set never
-* produces an oversized (silently-dropped) header.
-*/
-const MAX_CACHE_TAG_BYTES = 8 * 1024;
-const MAX_SINGLE_TAG_BYTES = 1024;
-/**
-* Build a `Cache-Tag` header value from canonicalised tags. Tags containing a
-* comma (the header separator) or exceeding the per-tag size are skipped, and
-* the whole value is bounded to stay within Cloudflare's limit.
-*/
-function formatCacheTag(tags) {
-	const parts = [];
-	let total = 0;
-	for (const tag of tags) {
-		if (!tag || tag.includes(",") || tag.length > MAX_SINGLE_TAG_BYTES) continue;
-		const next = total + tag.length + (parts.length > 0 ? 1 : 0);
-		if (next > MAX_CACHE_TAG_BYTES) break;
-		parts.push(tag);
-		total = next;
-	}
-	return parts.length > 0 ? parts.join(",") : null;
-}
-var CloudflareCdnCacheAdapter = class {
-	ownsBackgroundRevalidation = false;
-	/**
-	* The origin keeps no page store — return null so the request renders fresh.
-	* The edge serves cached HIT/STALE responses without reaching the origin.
-	*/
-	async get() {
-		return null;
-	}
-	/** No-op: the platform caches the response via its headers, not an origin store. */
-	async set(_key, _data, _ctx) {}
-	buildResponseHeaders(input) {
-		if (!input.cacheControl) return { "Cache-Control": NO_STORE };
-		if (/\b(?:no-store|no-cache|private)\b/.test(input.cacheControl)) return {
-			"Cache-Control": input.cacheControl,
-			"CDN-Cache-Control": null,
-			"Cloudflare-CDN-Cache-Control": null,
-			"Cache-Tag": null
-		};
-		const headers = {
-			"Cache-Control": BROWSER_REVALIDATE,
-			"CDN-Cache-Control": toEdgeCacheControl(input.cacheControl)
-		};
-		if (input.tags && input.tags.length > 0) {
-			const cacheTag = formatCacheTag(input.tags);
-			if (cacheTag) headers["Cache-Tag"] = cacheTag;
-		}
-		return headers;
-	}
-	/** Purge edge-cached responses by tag via the request context's `cache.purge`. */
-	async revalidateTag(tags, _durations) {
-		const cache = getWorkersCache();
-		if (!cache) return;
-		const tagList = (Array.isArray(tags) ? tags : [tags]).filter((t) => typeof t === "string" && t.length > 0);
-		if (tagList.length === 0) return;
-		await cache.purge({ tags: tagList });
-	}
-};
-//#endregion
-export { CloudflareCdnCacheAdapter };

package/dist/packages/cloudflare/src/cache/kv-data-adapter.runtime.d.ts

@@ -1,126 +0,0 @@
-import { CacheHandler, CacheHandlerValue, IncrementalCacheValue } from "../../../../shims/cache-handler.js";
-import { ExecutionContextLike } from "../../../../shims/request-context.js";
-
-//#region ../cloudflare/src/cache/kv-data-adapter.runtime.d.ts
-type KVNamespace = {
-  get(key: string, options?: {
-    type?: string;
-  }): Promise<string | null>;
-  get(key: string, options: {
-    type: "arrayBuffer";
-  }): Promise<ArrayBuffer | null>;
-  put(key: string, value: string | ArrayBuffer | ReadableStream, options?: {
-    expirationTtl?: number;
-    metadata?: Record<string, unknown>;
-  }): Promise<void>;
-  delete(key: string): Promise<void>;
-  list(options?: {
-    prefix?: string;
-    limit?: number;
-    cursor?: string;
-  }): Promise<{
-    keys: Array<{
-      name: string;
-      metadata?: Record<string, unknown>;
-    }>;
-    list_complete: boolean;
-    cursor?: string;
-  }>;
-};
-/** Key prefix for cache entries. */
-/**
- * Cloudflare KV data cache handler.
- *
- * @deprecated Consumers should not instantiate or register this handler by
- * hand. Configure it declaratively via the `cache.data` option on the
- * `vinext()` plugin, using the {@link kvDataAdapter} builder:
- *
- * ```ts
- * import { vinext } from "vinext";
- * import { kvDataAdapter } from "@vinext/cloudflare/cache/kv-data-adapter";
- *
- * export default defineConfig({
- *   plugins: [vinext({ cache: { data: kvDataAdapter({ binding: "VINEXT_KV_CACHE" }) } })],
- * });
- * ```
- *
- * `kvDataAdapter()` is safe to call from `vite.config.ts` — it never touches
- * the Workers runtime — and the plugin defers instantiation of this handler to
- * the first request. This class stays exported for the runtime factory and for
- * backwards compatibility, but is not the recommended consumer API.
- */
-declare class KVCacheHandler implements CacheHandler {
-  private kv;
-  private prefix;
-  private ctx;
-  private ttlSeconds;
-  /** Local in-memory cache for tag invalidation timestamps. Avoids redundant KV reads. */
-  private _tagCache;
-  /** TTL (ms) for local tag cache entries. After this, re-fetch from KV. */
-  private _tagCacheTtl;
-  constructor(kvNamespace: KVNamespace, options?: {
-    appPrefix?: string;
-    ctx?: ExecutionContextLike;
-    ttlSeconds?: number; /** TTL in milliseconds for the local tag cache. Defaults to 5000ms. */
-    tagCacheTtlMs?: number;
-  });
-  get(key: string, _ctx?: Record<string, unknown>): Promise<CacheHandlerValue | null>;
-  /**
-   * Check tag invalidation markers for stored tags or read-time soft tags.
-   * Uses a local in-memory cache to avoid redundant KV reads for recently-seen tags.
-   */
-  private _hasRevalidatedTag;
-  set(key: string, data: IncrementalCacheValue | null, ctx?: Record<string, unknown>): Promise<void>;
-  revalidateTag(tags: string | string[], _durations?: {
-    expire?: number;
-  }): Promise<void>;
-  /**
-   * Invalidate all cache entries whose path tags fall under `pathPrefix`.
-   *
-   * Uses KV list metadata to discover tags without fetching entry values —
-   * entries written by `set()` store their tags in KV metadata, so
-   * `kv.list()` returns them inline with each key. This makes prefix
-   * invalidation O(list_pages) instead of O(entries × get).
-   *
-   * Entries written before metadata was added (no metadata.tags) are
-   * gracefully skipped — they'll be picked up on next `set()` which
-   * writes metadata.
-   *
-   * When present, this method fully replaces the `revalidateTag` call
-   * path in `revalidatePath()` — implementors own all path-based tag
-   * handling.
-   */
-  revalidateByPathPrefix(pathPrefix: string): Promise<void>;
-  /**
-   * Clear the in-memory tag cache for this KVCacheHandler instance.
-   *
-   * Note: KVCacheHandler instances are typically reused across multiple
-   * requests in a Cloudflare Worker. The `_tagCache` is intentionally
-   * cross-request — it reduces redundant KV reads for recently-seen tags
-   * across all requests hitting the same isolate, bounded by `tagCacheTtlMs`
-   * (default 5s). vinext does NOT call this method per request.
-   *
-   * This is an opt-in escape hatch for callers that need stricter isolation
-   * (e.g., tests, or environments with custom lifecycle management).
-   * Callers that require per-request isolation should either construct a
-   * fresh KVCacheHandler per request or invoke this method explicitly.
-   */
-  resetRequestCache(): void;
-  /**
-   * Fire a KV delete in the background.
-   * Prefers the per-request ExecutionContext from ALS (set by
-   * runWithExecutionContext in the worker entry) so that background KV
-   * operations are registered with the correct request's waitUntil().
-   * Falls back to the constructor-provided ctx for callers that set it
-   * explicitly, and to fire-and-forget when neither is available (Node.js dev).
-   */
-  private _deleteInBackground;
-  /**
-   * Execute a KV put and return the promise so callers can await completion.
-   * Also registers with ctx.waitUntil() so the Workers runtime keeps the
-   * isolate alive even if the caller does not await the returned promise.
-   */
-  private _put;
-}
-//#endregion
-export { KVCacheHandler };