shared-http-cache 1.0.0 → 1.0.2

package/index.js

@@ -51,8 +51,7 @@ class SharedHttpCache {
                 const { url, options = {}, integrity, callback } = request;
                 if (!options.method) options.method = 'GET';
                 if (!options.headers) options.headers = {};
-                Object.keys(options.headers).some((key) => key.toLowerCase() === 'cache-control' && (options.headers['cache-control'] = options.headers[key]));
-                Object.keys(options.headers).some((key) => key.toLowerCase() === 'authorization' && (options.headers['authorization'] = options.headers[key]));
+                Object.keys(options.headers).forEach((key) => /\p{Lu}/u.test(key) && ((options.headers[key.toLowerCase()] = options.headers[key]), delete options.headers[key]));
                 // prettier-ignore
                 let response, buffer, headers, fromCache = true;
                 try {
@@ -96,8 +95,9 @@ class SharedHttpCache {
                     if (!fromCache || response?.status === 304) {
                         const responseCacheControl = parseHeader(headers['cache-control']);
                         if (options.method !== 'GET') return;
+                        if (headers['vary'] || headers['content-range'] || headers['set-cookie']) return;
                         if (responseCacheControl['no-store'] || responseCacheControl['private']) return;
-                        if (requestCacheControl['no-store'] || requestCacheControl['authorization']) return;
+                        if (requestCacheControl['no-store'] || options.headers['authorization']) return;
                         const store = async () => {
                             await this.store.rm.entry(this.cacheDir, url, { removeFully: true });
                             await this.store.put(this.cacheDir, url, buffer, integrity ? { metadata: { headers }, integrity } : { metadata: { headers } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shared-http-cache",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Node.Js Utility for fetching multiple HTTP resources with browser-like cache management.",
   "keywords": [
     "http-cache",

package/readme.md

@@ -1,9 +1,7 @@
 ---
-
 title: Shared HTTP Cache
 
 description: Node.Js Utility for fetching multiple HTTP resources with browser-like cache management.
-
 ---
 
 ## Overview
@@ -16,7 +14,10 @@ This implementation models a shared HTTP cache that follows the semantics define
 
 The cache is shared (not private) and applies shared-cache rules.
 
-- Privacy factors are considered while storing responses (`safe method` constraints, request `authorization`, response `cache-control="private"`).
+- Request `methods` other than `GET` are not stored.
+- Private responses are excluded from storage (request `Authorization` header, response `Cache-Control="private"` and `Set-Cookie` headers).
+- Variant responses are excluded from storage (response header `Vary` present).
+- Partial content is not stored (response `Content-Range` header).
 - No heuristic freshness is used.
 - Time calculations rely exclusively on locally recorded timestamps, not on server-provided `Date`.
 - Storage and eviction are deterministic; no background or implicit cleanup is assumed.
@@ -30,9 +31,9 @@ If no cached entry exists:
 - If the request requires `only-if-cached`, the cache returns a `504 HTTP status`.
 - Otherwise, the request is sent to the origin server.
 
-### Cache-control exclusions
+### Cache-Control exclusions
 
-Two cache-control directives may short-circuit normal cache usage:
+Two `Cache-Control` directives may short-circuit normal cache usage:
 
 - `no-cache` (request or response): cached data cannot be used without revalidation.
 - `no-store` (request or response): the response must not be stored.
@@ -53,7 +54,7 @@ Current age is derived from local metadata:
 currentAge = now − storedTime + incomingAge
 ```
 
-The `incomingAge` is taken from the stored response `age` header, if present.
+The `incomingAge` is taken from the stored response `Age` header, if present.
 
 Remaining freshness:
 
@@ -61,6 +62,12 @@ Remaining freshness:
 remainingFreshness = freshnessLifetime − currentAge
 ```
 
+If request includes `min-fresh` its value is deducted from the `remainingFreshness`:
+
+```excel-formula
+remainingFreshness = remainingFreshness − minimumFreshness
+```
+
 If `remainingFreshness ≥ 0`, the response is served as fresh.
 
 ### Stale handling
@@ -116,7 +123,7 @@ The accompanying state diagram represents the full decision flow:
 Legend
 
 1. `no-cache` may appear on request or response and always requires revalidation.
-2. `no-store` may appear on request or response; [privacy factors](#scope-and-assumptions) are considered.
+2. `no-store` may appear on request or response; See [scope and assumptions](#scope-and-assumptions) to understand other storage limitations.
 3. [Freshness evaluation](#freshness-evaluation) excludes `max-stale` that is evaluated only after strict freshness fails.
 4. `410 Gone` [cleanup](#cleanup-behavior) is an explicit design choice to keep the cache coherent; no heuristic eviction is used.
 
@@ -166,6 +173,7 @@ sharedHttpCache.fetch(requests) -> Promise<this | Error[]>
 ```
 
 **Syntax:**
+
 ```ts
 fetch([{ url: string, integrity?: string, options?: RequestInit, callback?: function }]) -> Promise<this | Error[]>
 ```
@@ -187,7 +195,7 @@ await sharedHttpCache.fetch([
 
 Errors encountered during fetches are collected, and the returned `promise` either `resolves` with the instance itself for successful fetches or `rejects` with a list of `errors` for failed requests.
 
-The response is converted into a [Buffer](https://nodejs.org/api/buffer.html) served to `callback`, then stored in the `cache` along with the `response headers`. For any other status code, unless `stale-if-error` is present, an `error` is thrown.
+The response is converted into a [Buffer](https://nodejs.org/api/buffer.html) served to `callback`, then stored in the `cache` along with the `response headers`.
 
 ```ts
 callback({ buffer: Buffer, headers: Headers, fromCache: boolean }) -> void
@@ -214,6 +222,24 @@ await sharedHttpCache
     });
 ```
 
+### Fetch multiple files
+
+```js
+const urls = ['https://example.com/file1', 'https://example.com/file2'];
+const parser = ({ url, buffer, headers, fromCache }) => {
+    console.log(url);
+    console.log(headers);
+    console.log(fromCache);
+    console.log(buffer.toString());
+};
+
+const requests = urls.map((url) => ({ url, callback: (response) => parser({ ...response, url }) }));
+
+sharedHttpCache.fetch(requests).catch((errors) => {
+    errors.forEach((entry) => console.error(entry.url, entry.error));
+});
+```
+
 ### Fetch with integrity
 
 ```js