spooder 5.1.11 → 5.1.12

package/README.md

@@ -1784,6 +1784,10 @@ server.route('/', cache.file('./index.html'));
 
 // Use with server routes for dynamic content
 server.route('/dynamic', async (req) => cache.request(req, 'dynamic-page', () => 'Dynamic Content'));
+
+// Disable caching (useful for development mode)
+const devCache = cache_http({ enabled: process.env.SPOODER_ENV !== 'dev' });
+server.route('/no-cache', devCache.file('./index.html')); // Always reads from disk
 ```
 
 The `cache_http()` function returns an object with two methods:
@@ -1827,7 +1831,8 @@ server.route('/api/stats', async (req) => {
 | `max_size` | `number` | `5242880` (5 MB) | Maximum total size of all cached files in bytes |
 | `use_etags` | `boolean` | `true` | Generate and use ETag headers for cache validation |
 | `headers` | `Record<string, string>` | `{}` | Additional HTTP headers to include in responses |
-| `use_canary_reporting` | `boolean` | `false` | Reports faults to canary (see below).
+| `use_canary_reporting` | `boolean` | `false` | Reports faults to canary (see below) |
+| `enabled` | `boolean` | `true` | When false, content is generated but not stored
 
 #### Canary Reporting
 

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "spooder",
 	"type": "module",
-	"version": "5.1.11",
+	"version": "5.1.12",
 	"module": "./src/api.ts",
 	"bin": {
 		"spooder": "./src/cli.ts"

package/src/api.ts

@@ -128,6 +128,7 @@ type CacheOptions = {
 	use_etags?: boolean;
 	headers?: Record<string, string>,
 	use_canary_reporting?: boolean;
+	enabled?: boolean;
 };
 
 type CacheEntry = {
@@ -154,6 +155,7 @@ export function cache_http(options?: CacheOptions) {
 	const use_etags = options?.use_etags ?? true;
 	const cache_headers = options?.headers ?? {};
 	const canary_report = options?.use_canary_reporting ?? false;
+	const enabled = options?.enabled ?? true;
 	
 	const entries = new Map<string, CacheEntry>();
 	let total_cache_size = 0;
@@ -267,7 +269,8 @@ export function cache_http(options?: CacheOptions) {
 						cached_ts: now_ts
 					};
 					
-					store_cache_entry(file_path, entry, now_ts);
+					if (enabled)
+						store_cache_entry(file_path, entry, now_ts);
 				}
 				
 				return build_response(entry, req, 200);
@@ -290,7 +293,8 @@ export function cache_http(options?: CacheOptions) {
 					cached_ts: now_ts
 				};
 				
-				store_cache_entry(cache_key, entry, now_ts);
+				if (enabled)
+					store_cache_entry(cache_key, entry, now_ts);
 			}
 			
 			return build_response(entry, req, status_code);