@vinext/cloudflare 0.1.0 → 0.1.1

package/README.md

@@ -7,16 +7,13 @@ ISR and the `"use cache"` data cache when deploying to Cloudflare Workers:
 
 - **`kvDataAdapter()`** (`@vinext/cloudflare/cache/kv-data-adapter`) — backs the
   data cache (`fetch`, `"use cache"`, `unstable_cache`) with a Workers KV
-  namespace.
-- **`cdnAdapter()`** (`@vinext/cloudflare/cache/cdn-adapter`) — backs
-  full-route, edge-managed page-level ISR with the Workers Cache API.
+  namespace. Also used for ISR in the absence of a cdn adapter.
 
 ## Usage
 
 Declare the adapters on the `vinext()` plugin in your Vite config:
 
 ```ts
-import { cdnAdapter } from "@vinext/cloudflare/cache/cdn-adapter";
 import { kvDataAdapter } from "@vinext/cloudflare/cache/kv-data-adapter";
 
 export default defineConfig({
@@ -24,7 +21,6 @@ export default defineConfig({
     vinext({
       cache: {
         data: kvDataAdapter(), // KV-backed data cache (binding: VINEXT_KV_CACHE)
-        cdn: cdnAdapter(), // optional: edge-managed page-level ISR
       },
     }),
     cloudflare(),

package/dist/cache/cdn-adapter.d.ts

@@ -1,8 +1,21 @@
 //#region src/cache/cdn-adapter.d.ts
 /**
- * Config-time builder: returns a serializable descriptor whose `adapter` is the
- * absolute path to the runtime factory. Safe to call from vite.config — it
- * never instantiates the adapter.
+ * Cloudflare CDN cache adapter - edge-managed page-level ISR backed by the
+ * Cloudflare Workers Cache.
+ *
+ * Unlike the data adapter (which stores cache entries in a durable store and
+ * serves HIT/STALE itself), this adapter delegates serving to Cloudflare's
+ * edge cache.
+ *
+ * Workers Cache must be enabled in your Wrangler config for this to work.
+ * ```jsonc
+ * // wrangler.jsonc
+ * {
+ *   "cache": {
+ *     "enabled": true,
+ *   },
+ * }
+ * ```
  */
 declare function cdnAdapter(options?: Record<string, never>): {
   adapter: string;

package/dist/cache/cdn-adapter.js

@@ -1,9 +1,22 @@
 import { fileURLToPath } from "node:url";
 //#region src/cache/cdn-adapter.ts
 /**
-* Config-time builder: returns a serializable descriptor whose `adapter` is the
-* absolute path to the runtime factory. Safe to call from vite.config — it
-* never instantiates the adapter.
+* Cloudflare CDN cache adapter - edge-managed page-level ISR backed by the
+* Cloudflare Workers Cache.
+*
+* Unlike the data adapter (which stores cache entries in a durable store and
+* serves HIT/STALE itself), this adapter delegates serving to Cloudflare's
+* edge cache.
+*
+* Workers Cache must be enabled in your Wrangler config for this to work.
+* ```jsonc
+* // wrangler.jsonc
+* {
+*   "cache": {
+*     "enabled": true,
+*   },
+* }
+* ```
 */
 function cdnAdapter(options) {
 	return {

package/dist/cache/kv-data-adapter.d.ts

@@ -7,9 +7,17 @@ type KvDataAdapterOptions = {
   tagCacheTtlMs?: number;
 };
 /**
- * Config-time builder: returns a serializable descriptor whose `adapter` is the
- * absolute path to the runtime factory. Safe to call from vite.config — it
- * never instantiates the KV handler or reads a binding.
+ * Cloudflare KV data cache.
+ *
+ * A KV namespace must be configured in your Wrangler config for this to work.
+ * ```jsonc
+ * // wrangler.jsonc
+ * {
+ *   "kv_namespaces": [
+ *     { "binding": "VINEXT_KV_CACHE", "id": "<your-kv-namespace-id>" }
+ *   ]
+ * }
+ * ```
  */
 declare function kvDataAdapter(options?: KvDataAdapterOptions): {
   adapter: string;

package/dist/cache/kv-data-adapter.js

@@ -1,9 +1,17 @@
 import { fileURLToPath } from "node:url";
 //#region src/cache/kv-data-adapter.ts
 /**
-* Config-time builder: returns a serializable descriptor whose `adapter` is the
-* absolute path to the runtime factory. Safe to call from vite.config — it
-* never instantiates the KV handler or reads a binding.
+* Cloudflare KV data cache.
+*
+* A KV namespace must be configured in your Wrangler config for this to work.
+* ```jsonc
+* // wrangler.jsonc
+* {
+*   "kv_namespaces": [
+*     { "binding": "VINEXT_KV_CACHE", "id": "<your-kv-namespace-id>" }
+*   ]
+* }
+* ```
 */
 function kvDataAdapter(options) {
 	if (options?.binding !== void 0 && typeof options.binding !== "string") throw new TypeError("[vinext] kvDataAdapter({ binding }) must be a string KV binding name.");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vinext/cloudflare",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Cloudflare cache adapters for vinext (KV data cache + edge CDN cache).",
   "license": "MIT",
   "repository": {
@@ -21,7 +21,7 @@
   "devDependencies": {
     "@types/node": "^25.9.2",
     "vite-plus": "0.1.24",
-    "vinext": "0.1.0"
+    "vinext": "0.1.2"
   },
   "peerDependencies": {
     "vinext": ">=0.0.0"