@amazon/vinyl-cache-manager 1.0.0

package/dist/index.cjs

@@ -0,0 +1,271 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  CacheManager: () => CacheManager,
+  DEFAULT_CACHE_NAME: () => DEFAULT_CACHE_NAME,
+  DEFAULT_PURGE_AFTER_STALE: () => DEFAULT_PURGE_AFTER_STALE,
+  NOT_CACHED_ERROR: () => NOT_CACHED_ERROR,
+  parseCacheControl: () => parseCacheControl
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/cacheManager/CacheControl.ts
+var knownDirectives = {
+  "max-age": "maxAge",
+  "no-cache": "noCache",
+  "no-store": "noStore",
+  "must-revalidate": "mustRevalidate",
+  public: "public",
+  private: "private",
+  immutable: "immutable",
+  "stale-while-revalidate": "staleWhileRevalidate",
+  "stale-if-error": "staleIfError",
+  "only-if-cached": "onlyIfCached"
+};
+function parseCacheControl(str) {
+  if (!str) return {};
+  const directives = {};
+  str.split(",").forEach((part) => {
+    const [key, value] = part.trim().split("=");
+    const directiveKey = key.trim().toLowerCase();
+    const typedKey = knownDirectives[directiveKey];
+    if (typedKey) {
+      if (value === void 0) {
+        directives[typedKey] = true;
+      } else {
+        const numericValue = parseInt(value, 10);
+        directives[typedKey] = isNaN(numericValue) ? value : numericValue;
+      }
+    }
+  });
+  return directives;
+}
+
+// src/cacheManager/CacheManager.ts
+var DEFAULT_CACHE_NAME = "offlineCache";
+var DEFAULT_PURGE_AFTER_STALE = 7 * 24 * 60 * 60;
+var NOT_CACHED_ERROR = "Not cached";
+var CACHE_KEY_PREFIX = "https://cache/";
+var CACHED_TIMESTAMP_HEADER = "X-Cached-Timestamp";
+var CacheManager = class {
+  constructor(options, deps) {
+    __publicField(this, "name");
+    __publicField(this, "caches");
+    __publicField(this, "cache");
+    __publicField(this, "fetch");
+    /**
+     * If set, when asynchronous caching has failed, this callback will be invoked.
+     * This is not invoked when a promise rejects during an operation.
+     */
+    __publicField(this, "onError");
+    __publicField(this, "errorHandler", (error) => {
+      var _a;
+      (_a = this.onError) == null ? void 0 : _a.call(this, error);
+    });
+    var _a, _b, _c;
+    this.caches = (_a = deps == null ? void 0 : deps.caches) != null ? _a : caches;
+    this.name = (_b = options == null ? void 0 : options.name) != null ? _b : DEFAULT_CACHE_NAME;
+    this.cache = this.caches.open(this.name);
+    this.fetch = (_c = options == null ? void 0 : options.requestFromNetwork) != null ? _c : ((request) => fetch(request));
+  }
+  /**
+   * Caches a response with added expiry headers.
+   */
+  async put(cacheId, response) {
+    if (response.bodyUsed)
+      throw new Error(`cannot cache request, body already used`);
+    const clonedResponse = response.clone();
+    const headers = new Headers(clonedResponse.headers);
+    headers.append(CACHED_TIMESTAMP_HEADER, Date.now().toString());
+    const responseWithHeader = new Response(clonedResponse.body, {
+      status: clonedResponse.status,
+      statusText: clonedResponse.statusText,
+      headers
+    });
+    const cache = await this.cache;
+    await cache.put(cacheId, responseWithHeader);
+    return response;
+  }
+  /**
+   * Deletes the request from this cache.
+   *
+   * @param cacheId The request or cache id used as the cache key.
+   */
+  async delete(cacheId) {
+    const cache = await this.cache;
+    return await cache.delete(cacheId);
+  }
+  /**
+   * Resolves to true if the request is cached.
+   *
+   * @param cacheId
+   */
+  async has(cacheId) {
+    return await this.getCached(cacheId) != null;
+  }
+  async get(request, options) {
+    var _a;
+    const cache = await this.cache;
+    const cacheId = (options == null ? void 0 : options.cacheKey) ? CACHE_KEY_PREFIX + options.cacheKey : request;
+    let cached;
+    if ((_a = options == null ? void 0 : options.cacheControlOverrides) == null ? void 0 : _a.noStore) {
+      this.delete(cacheId).catch(this.errorHandler);
+      cached = void 0;
+    } else {
+      cached = await cache.match(cacheId);
+    }
+    const cacheControlOptions = {
+      defaults: options == null ? void 0 : options.cacheControlDefaults,
+      overrides: options == null ? void 0 : options.cacheControlOverrides
+    };
+    const responseIsValid = async (response) => {
+      return response.ok && ((options == null ? void 0 : options.responseIsValid) == null || await options.responseIsValid(response.clone()));
+    };
+    const fetchAndMaybeCache = async () => {
+      return this.fetch(request).then(async (response) => {
+        const cacheControl2 = calculateCacheControl(
+          response,
+          cacheControlOptions
+        );
+        if (!cacheControl2.noStore && isCacheableRequestKey(cacheId) && await responseIsValid(response)) {
+          this.put(cacheId, response).catch(this.errorHandler);
+        }
+        return response;
+      });
+    };
+    const cacheControl = calculateCacheControl(cached, cacheControlOptions);
+    const cacheBehavior = calculateCacheBehavior(
+      cacheControl,
+      getCachedTimestamp(cached)
+    );
+    if (cacheBehavior.preferCache) {
+      if (cacheBehavior.reevaluate) {
+        fetchAndMaybeCache().catch(this.errorHandler);
+      }
+      return cached;
+    } else {
+      if (!cacheBehavior.allowNetwork && !cached) {
+        throw new Error(NOT_CACHED_ERROR);
+      }
+      const response = await fetchAndMaybeCache().catch((error) => {
+        if (!cacheBehavior.allowCache || !cached) throw error;
+        else return cached;
+      });
+      const ok = await responseIsValid(response);
+      return !ok ? cached != null ? cached : response : response;
+    }
+  }
+  /**
+   * Returns a Response if it exists in cache.
+   *
+   * @param request
+   */
+  async getCached(request) {
+    const cache = await this.cache;
+    return await cache.match(request);
+  }
+  /**
+   * @returns a promise that resolves to true if the Cache object is found and deleted, and false otherwise.
+   */
+  async clear() {
+    const deleted = await this.caches.delete(this.name);
+    this.cache = this.caches.open(this.name);
+    return deleted;
+  }
+  /**
+   * Cleans stale items from the cache.
+   */
+  async clean(options) {
+    var _a;
+    const cache = await this.cache;
+    const cacheControlOptions = {
+      defaults: {
+        // Unless the cached entry has a stale-while-revalidate directive, use this default.
+        staleWhileRevalidate: (_a = options == null ? void 0 : options.purgeAfterStale) != null ? _a : DEFAULT_PURGE_AFTER_STALE
+      },
+      overrides: {
+        noStore: false
+      }
+    };
+    for (const key of await cache.keys()) {
+      const cached = await cache.match(key);
+      const cacheControl = calculateCacheControl(
+        cached,
+        cacheControlOptions
+      );
+      const { preferCache } = calculateCacheBehavior(
+        cacheControl,
+        getCachedTimestamp(cached)
+      );
+      if (!preferCache) {
+        await cache.delete(key);
+      }
+    }
+  }
+};
+function calculateCacheControl(cached, options) {
+  const cacheControl = cached ? parseCacheControl(cached.headers.get("Cache-Control")) : {};
+  return __spreadValues(__spreadValues(__spreadValues({}, options.defaults), cacheControl), options.overrides);
+}
+function calculateCacheBehavior(cacheControl, cachedTimestamp) {
+  var _a, _b, _c, _d;
+  const allowCache = !((_a = cacheControl.noStore) != null ? _a : false);
+  const maxAge = (_b = cacheControl.maxAge) != null ? _b : 0;
+  const staleAt = maxAge * 1e3 + (cachedTimestamp != null ? cachedTimestamp : Number.NEGATIVE_INFINITY);
+  const now = Date.now();
+  const isFresh = staleAt > now;
+  const immutable = (_c = cacheControl.immutable) != null ? _c : false;
+  const allowNetwork = !cacheControl.onlyIfCached;
+  const reevaluate = allowNetwork && !immutable && (cacheControl.mustRevalidate || !isFresh);
+  const staleWhileRevalidate = (_d = cacheControl.staleWhileRevalidate) != null ? _d : 0;
+  const preferCache = allowCache && (isFresh || staleAt + staleWhileRevalidate * 1e3 > now || immutable);
+  return {
+    preferCache,
+    reevaluate,
+    allowCache,
+    allowNetwork
+  };
+}
+function isCacheableRequestKey(request) {
+  return typeof request === "string" || request.method === "GET";
+}
+function getCachedTimestamp(cached) {
+  const timestampHeader = cached == null ? void 0 : cached.headers.get(CACHED_TIMESTAMP_HEADER);
+  if (!timestampHeader) return void 0;
+  return parseInt(timestampHeader, 10);
+}
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts", "../src/cacheManager/CacheControl.ts", "../src/cacheManager/CacheManager.ts"],
+  "sourcesContent": ["/** Auto-generated from build scripts */\nexport * from './cacheManager/CacheManager'\nexport * from './cacheManager/CacheControl'\n", "/*\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\n\n/**\n * Represents all known Cache-Control directives.\n *\n * https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Cache-Control\n */\nexport type CacheControl = {\n    /**\n     * The maximum amount of time (in seconds) a resource is considered fresh.\n     * Example: `max-age=3600` (1 hour)\n     */\n    readonly maxAge?: number\n\n    /**\n     * Requires the resource to be revalidated with the origin server before serving it from the cache.\n     * Example: `no-cache`\n     */\n    readonly noCache?: boolean\n\n    /**\n     * Prevents the resource from being cached by any mechanism.\n     * Example: `no-store`\n     */\n    readonly noStore?: boolean\n\n    /**\n     * Ensures that stale responses cannot be used without successful revalidation with the origin server.\n     * Example: `must-revalidate`\n     */\n    readonly mustRevalidate?: boolean\n\n    /**\n     * Indicates the resource is cacheable by both shared and private caches.\n     * Example: `public`\n     */\n    readonly public?: boolean\n\n    /**\n     * Indicates the resource is cacheable only by the user's browser or private caches, not shared caches.\n     * Example: `private`\n     */\n    readonly private?: boolean\n\n    /**\n     * Indicates that the resource will not change, so it does not need to be revalidated.\n     * Example: `immutable`\n     */\n    readonly immutable?: boolean\n\n    /**\n     * Allows serving stale responses for the specified duration (in seconds) while asynchronously revalidating the\n     * cache.\n     * Example: `stale-while-revalidate=60`\n     */\n    readonly staleWhileRevalidate?: number\n\n    /**\n     * Allows serving stale responses (in seconds) if the origin server is unavailable or returns an error.\n     * Example: `stale-if-error=86400` (1 day)\n     */\n    readonly staleIfError?: number\n\n    /**\n     * Indicates the client only wants a response from the cache and will not make a network request.\n     * Example: `only-if-cached`\n     */\n    readonly onlyIfCached?: boolean\n}\n\n// Map for known directive names to their typed keys\nconst knownDirectives: Record<string, keyof CacheControl | undefined> = {\n    'max-age': 'maxAge',\n    'no-cache': 'noCache',\n    'no-store': 'noStore',\n    'must-revalidate': 'mustRevalidate',\n    public: 'public',\n    private: 'private',\n    immutable: 'immutable',\n    'stale-while-revalidate': 'staleWhileRevalidate',\n    'stale-if-error': 'staleIfError',\n    'only-if-cached': 'onlyIfCached',\n} as const\n\n/**\n * Parses a Cache-Control header string into a structured object.\n * Handles known directives with optional numeric values.\n *\n * @param str - The Cache-Control header string to parse.\n * @returns A CacheControl object representing the parsed directives.\n */\nexport function parseCacheControl(\n    str: string | null | undefined\n): CacheControl {\n    if (!str) return {}\n    const directives: any = {}\n    str.split(',').forEach((part) => {\n        const [key, value] = part.trim().split('=') as [string, string?]\n        const directiveKey = key.trim().toLowerCase() // Ensure case-insensitivity\n\n        const typedKey = knownDirectives[directiveKey]\n        if (typedKey) {\n            // Parse the value or set to true for boolean directives\n            if (value === undefined) {\n                directives[typedKey] = true\n            } else {\n                const numericValue = parseInt(value, 10)\n                directives[typedKey] = isNaN(numericValue)\n                    ? value\n                    : numericValue\n            }\n        }\n    })\n    return directives\n}\n", "/*\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\n\n/*\n * Offline utility that can be shared between the service worker and application.\n * Note - this should not use any dependencies; the bundled service worker must\n * be lightweight.\n */\n\nimport { type CacheControl, parseCacheControl } from './CacheControl'\n\nexport const DEFAULT_CACHE_NAME = 'offlineCache'\nexport const DEFAULT_PURGE_AFTER_STALE = 7 * 24 * 60 * 60\n\n/**\n * If the cache control options set the onlyIfCached directive and the request is not cached, an error will be thrown.\n */\nexport const NOT_CACHED_ERROR = 'Not cached'\n\nexport type CacheManagerOptions = {\n    /**\n     * The name of the cache key.\n     */\n    readonly name?: string\n\n    /**\n     * The Fetch from network method. Defaults to window.fetch.\n     */\n    readonly requestFromNetwork?: Fetch\n}\n\ntype Fetch = (request: RequestInfo) => Promise<Response>\n\n/**\n * A prefix for cache keys in order to guarantee they can be used as cache keys.\n * WebKit browsers only allow http/https cache keys.\n */\nconst CACHE_KEY_PREFIX = 'https://cache/'\n\n/**\n * A custom header for storing the timestamp at which the entry was cached.\n */\nconst CACHED_TIMESTAMP_HEADER = 'X-Cached-Timestamp'\n\nexport type CacheEntryOptions = {\n    /**\n     * If set, the response will be cached under this identifier, not based on the request.\n     * This is required for caching POST requests.\n     */\n    readonly cacheKey?: string | null | undefined\n\n    /**\n     * Cache control directive defaults.\n     * These will be used unless overridden by the response headers or the cache control overrides.\n     *\n     * CacheControl directives will be overwritten in the order:\n     * - cacheControlDefaults\n     * - response headers\n     * - cacheControlOverrides\n     */\n    readonly cacheControlDefaults?: CacheControl\n\n    /**\n     * Allows the client to set cache control overrides. This object is merged with the actual cache control header.\n     *\n     * For example, to allow cached items to be used 1 day after they are stale while asynchronously revalidating\n     * the cache, set `{ staleWhileRevalidate: 24 * 60 * 60 }`\n     *\n     * These overrides do not change the header cached, only how the cached header is read.\n     * If noStore is true, the entry will not be cached.\n     */\n    readonly cacheControlOverrides?: CacheControl\n\n    /**\n     * If set, checks the response if it should be used. This affects whether to cache and whether to use the\n     * cached fallback.\n     */\n    readonly responseIsValid?: (response: Response) => Promise<boolean>\n}\n\nexport type CacheCleanOptions = {\n    /**\n     * The number of seconds after an entry becomes stale before it should be removed from the cache.\n     * Default: 7 * 24 * 60 * 60 (7 days).\n     * If the cached entry has a stale-while-revalidate cache control directive, this will be ignored.\n     */\n    readonly purgeAfterStale?: number\n}\n\nexport interface CacheManagerDeps {\n    /**\n     * The cache storages api.\n     * Default: window.caches\n     */\n    readonly caches?: CacheStorage\n\n    /**\n     * Creates a Headers object\n     */\n    readonly headersFactory?: (headersInit?: HeadersInit) => Headers\n\n    /**\n     * Creates a Response object\n     */\n    readonly responseFactory?: (\n        body?: BodyInit | null,\n        init?: ResponseInit\n    ) => Response\n}\n\nexport class CacheManager {\n    readonly name: string\n\n    private readonly caches: CacheStorage\n    private cache: Promise<Cache>\n    private readonly fetch: Fetch\n\n    /**\n     * If set, when asynchronous caching has failed, this callback will be invoked.\n     * This is not invoked when a promise rejects during an operation.\n     */\n    onError?: (error: Error) => void\n\n    constructor(options?: CacheManagerOptions, deps?: CacheManagerDeps) {\n        this.caches = deps?.caches ?? caches\n        this.name = options?.name ?? DEFAULT_CACHE_NAME\n        this.cache = this.caches.open(this.name)\n        this.fetch =\n            options?.requestFromNetwork ?? ((request) => fetch(request))\n    }\n\n    private readonly errorHandler = (error: Error) => {\n        this.onError?.(error)\n    }\n\n    /**\n     * Caches a response with added expiry headers.\n     */\n    async put(cacheId: RequestInfo, response: Response): Promise<Response> {\n        if (response.bodyUsed)\n            throw new Error(`cannot cache request, body already used`)\n\n        const clonedResponse = response.clone()\n\n        // Add a timestamp header\n        const headers = new Headers(clonedResponse.headers)\n        headers.append(CACHED_TIMESTAMP_HEADER, Date.now().toString())\n\n        const responseWithHeader = new Response(clonedResponse.body, {\n            status: clonedResponse.status,\n            statusText: clonedResponse.statusText,\n            headers,\n        })\n\n        const cache = await this.cache\n        await cache.put(cacheId, responseWithHeader)\n        return response\n    }\n\n    /**\n     * Deletes the request from this cache.\n     *\n     * @param cacheId The request or cache id used as the cache key.\n     */\n    async delete(cacheId: RequestInfo): Promise<boolean> {\n        const cache = await this.cache\n        return await cache.delete(cacheId)\n    }\n\n    /**\n     * Resolves to true if the request is cached.\n     *\n     * @param cacheId\n     */\n    async has(cacheId: RequestInfo): Promise<boolean> {\n        return (await this.getCached(cacheId)) != null\n    }\n\n    async get(\n        request: RequestInfo,\n        options?: CacheEntryOptions\n    ): Promise<Response> {\n        const cache = await this.cache\n\n        const cacheId = options?.cacheKey\n            ? CACHE_KEY_PREFIX + options.cacheKey\n            : request\n\n        let cached: Response | undefined\n        if (options?.cacheControlOverrides?.noStore) {\n            this.delete(cacheId).catch(this.errorHandler)\n            cached = undefined\n        } else {\n            cached = await cache.match(cacheId)\n        }\n\n        const cacheControlOptions: CacheControlOptions = {\n            defaults: options?.cacheControlDefaults,\n            overrides: options?.cacheControlOverrides,\n        }\n\n        const responseIsValid = async (\n            response: Response\n        ): Promise<boolean> => {\n            return (\n                response.ok &&\n                (options?.responseIsValid == null ||\n                    (await options.responseIsValid(response.clone())))\n            )\n        }\n\n        const fetchAndMaybeCache = async (): Promise<Response> => {\n            return this.fetch(request).then(async (response) => {\n                const cacheControl = calculateCacheControl(\n                    response,\n                    cacheControlOptions\n                )\n                if (\n                    !cacheControl.noStore &&\n                    isCacheableRequestKey(cacheId) &&\n                    (await responseIsValid(response))\n                ) {\n                    this.put(cacheId, response).catch(this.errorHandler)\n                }\n                return response\n            })\n        }\n        const cacheControl = calculateCacheControl(cached, cacheControlOptions)\n        const cacheBehavior = calculateCacheBehavior(\n            cacheControl,\n            getCachedTimestamp(cached)\n        )\n        if (cacheBehavior.preferCache) {\n            if (cacheBehavior.reevaluate) {\n                fetchAndMaybeCache().catch(this.errorHandler)\n            }\n            return cached!\n        } else {\n            if (!cacheBehavior.allowNetwork && !cached) {\n                throw new Error(NOT_CACHED_ERROR)\n            }\n            // Prefer a network response. If the network response isn't valid, return the cached value.\n            const response = await fetchAndMaybeCache().catch((error) => {\n                if (!cacheBehavior.allowCache || !cached) throw error\n                else return cached\n            })\n            const ok = await responseIsValid(response)\n            return !ok ? (cached ?? response) : response\n        }\n    }\n\n    /**\n     * Returns a Response if it exists in cache.\n     *\n     * @param request\n     */\n    private async getCached(\n        request: RequestInfo\n    ): Promise<Response | undefined> {\n        const cache = await this.cache\n        return await cache.match(request)\n    }\n\n    /**\n     * @returns a promise that resolves to true if the Cache object is found and deleted, and false otherwise.\n     */\n    async clear(): Promise<boolean> {\n        const deleted = await this.caches.delete(this.name)\n        this.cache = this.caches.open(this.name)\n        return deleted\n    }\n\n    /**\n     * Cleans stale items from the cache.\n     */\n    async clean(options?: CacheCleanOptions) {\n        const cache = await this.cache\n        const cacheControlOptions: CacheControlOptions = {\n            defaults: {\n                // Unless the cached entry has a stale-while-revalidate directive, use this default.\n                staleWhileRevalidate:\n                    options?.purgeAfterStale ?? DEFAULT_PURGE_AFTER_STALE,\n            },\n            overrides: {\n                noStore: false,\n            },\n        }\n        for (const key of await cache.keys()) {\n            const cached = await cache.match(key)\n            const cacheControl = calculateCacheControl(\n                cached,\n                cacheControlOptions\n            )\n            const { preferCache } = calculateCacheBehavior(\n                cacheControl,\n                getCachedTimestamp(cached)\n            )\n            if (!preferCache) {\n                await cache.delete(key)\n            }\n        }\n    }\n}\n\ntype CacheControlOptions = {\n    readonly defaults?: CacheControl | undefined\n    readonly overrides?: CacheControl | undefined\n}\n\nfunction calculateCacheControl(\n    cached: Response | undefined,\n    options: CacheControlOptions\n): CacheControl {\n    const cacheControl = cached\n        ? parseCacheControl(cached.headers.get('Cache-Control'))\n        : {}\n    return {\n        ...options.defaults,\n        ...cacheControl,\n        ...options.overrides,\n    }\n}\n\ntype CacheBehavior = {\n    /**\n     * If false, do not use the cached entry. If it exists, delete it.\n     */\n    readonly allowCache: boolean\n\n    /**\n     * Prefer the cached result.\n     * If false, the cache may be used if `allowCache` is true and the request fails.\n     */\n    readonly preferCache: boolean\n\n    /**\n     * If false, do not request from network, even if there is not a cached resource.\n     */\n    readonly allowNetwork: boolean\n\n    /**\n     * Load the resource from the network.\n     * If preferCache is true, the cached response will be used and a new request will be made asynchronously.\n     */\n    readonly reevaluate: boolean\n}\n\nfunction calculateCacheBehavior(\n    cacheControl: CacheControl,\n    cachedTimestamp: number | undefined\n): CacheBehavior {\n    const allowCache = !(cacheControl.noStore ?? false)\n    const maxAge = cacheControl.maxAge ?? 0\n    const staleAt =\n        maxAge * 1000 + (cachedTimestamp ?? Number.NEGATIVE_INFINITY)\n\n    const now = Date.now()\n    const isFresh = staleAt > now\n    const immutable = cacheControl.immutable ?? false\n    const allowNetwork = !cacheControl.onlyIfCached\n    const reevaluate =\n        allowNetwork && !immutable && (cacheControl.mustRevalidate || !isFresh)\n    // If the entry is past its max age and there is staleWhileRevalidate set, allow the cached entry to be used\n    // staleWhileRevalidate seconds after maxAge.\n    const staleWhileRevalidate = cacheControl.staleWhileRevalidate ?? 0\n    const preferCache =\n        allowCache &&\n        (isFresh || staleAt + staleWhileRevalidate * 1000 > now || immutable)\n    return {\n        preferCache,\n        reevaluate,\n        allowCache,\n        allowNetwork,\n    }\n}\n\n/**\n * Returns true if the request can be used as a Cache key.\n */\nfunction isCacheableRequestKey(request: RequestInfo): boolean {\n    return typeof request === 'string' || request.method === 'GET'\n}\n\nfunction getCachedTimestamp(cached: Response | undefined): number | undefined {\n    const timestampHeader = cached?.headers.get(CACHED_TIMESTAMP_HEADER)\n    if (!timestampHeader) return undefined\n    return parseInt(timestampHeader, 10)\n}\n"],
+  "mappings": "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",
+  "names": ["cacheControl"]
+}

package/dist/index.js

@@ -0,0 +1,251 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/cacheManager/CacheControl.ts
+var knownDirectives = {
+  "max-age": "maxAge",
+  "no-cache": "noCache",
+  "no-store": "noStore",
+  "must-revalidate": "mustRevalidate",
+  public: "public",
+  private: "private",
+  immutable: "immutable",
+  "stale-while-revalidate": "staleWhileRevalidate",
+  "stale-if-error": "staleIfError",
+  "only-if-cached": "onlyIfCached"
+};
+function parseCacheControl(str) {
+  if (!str) return {};
+  const directives = {};
+  str.split(",").forEach((part) => {
+    const [key, value] = part.trim().split("=");
+    const directiveKey = key.trim().toLowerCase();
+    const typedKey = knownDirectives[directiveKey];
+    if (typedKey) {
+      if (value === void 0) {
+        directives[typedKey] = true;
+      } else {
+        const numericValue = parseInt(value, 10);
+        directives[typedKey] = isNaN(numericValue) ? value : numericValue;
+      }
+    }
+  });
+  return directives;
+}
+
+// src/cacheManager/CacheManager.ts
+var DEFAULT_CACHE_NAME = "offlineCache";
+var DEFAULT_PURGE_AFTER_STALE = 7 * 24 * 60 * 60;
+var NOT_CACHED_ERROR = "Not cached";
+var CACHE_KEY_PREFIX = "https://cache/";
+var CACHED_TIMESTAMP_HEADER = "X-Cached-Timestamp";
+var CacheManager = class {
+  constructor(options, deps) {
+    __publicField(this, "name");
+    __publicField(this, "caches");
+    __publicField(this, "cache");
+    __publicField(this, "fetch");
+    /**
+     * If set, when asynchronous caching has failed, this callback will be invoked.
+     * This is not invoked when a promise rejects during an operation.
+     */
+    __publicField(this, "onError");
+    __publicField(this, "errorHandler", (error) => {
+      var _a;
+      (_a = this.onError) == null ? void 0 : _a.call(this, error);
+    });
+    var _a, _b, _c;
+    this.caches = (_a = deps == null ? void 0 : deps.caches) != null ? _a : caches;
+    this.name = (_b = options == null ? void 0 : options.name) != null ? _b : DEFAULT_CACHE_NAME;
+    this.cache = this.caches.open(this.name);
+    this.fetch = (_c = options == null ? void 0 : options.requestFromNetwork) != null ? _c : ((request) => fetch(request));
+  }
+  /**
+   * Caches a response with added expiry headers.
+   */
+  async put(cacheId, response) {
+    if (response.bodyUsed)
+      throw new Error(`cannot cache request, body already used`);
+    const clonedResponse = response.clone();
+    const headers = new Headers(clonedResponse.headers);
+    headers.append(CACHED_TIMESTAMP_HEADER, Date.now().toString());
+    const responseWithHeader = new Response(clonedResponse.body, {
+      status: clonedResponse.status,
+      statusText: clonedResponse.statusText,
+      headers
+    });
+    const cache = await this.cache;
+    await cache.put(cacheId, responseWithHeader);
+    return response;
+  }
+  /**
+   * Deletes the request from this cache.
+   *
+   * @param cacheId The request or cache id used as the cache key.
+   */
+  async delete(cacheId) {
+    const cache = await this.cache;
+    return await cache.delete(cacheId);
+  }
+  /**
+   * Resolves to true if the request is cached.
+   *
+   * @param cacheId
+   */
+  async has(cacheId) {
+    return await this.getCached(cacheId) != null;
+  }
+  async get(request, options) {
+    var _a;
+    const cache = await this.cache;
+    const cacheId = (options == null ? void 0 : options.cacheKey) ? CACHE_KEY_PREFIX + options.cacheKey : request;
+    let cached;
+    if ((_a = options == null ? void 0 : options.cacheControlOverrides) == null ? void 0 : _a.noStore) {
+      this.delete(cacheId).catch(this.errorHandler);
+      cached = void 0;
+    } else {
+      cached = await cache.match(cacheId);
+    }
+    const cacheControlOptions = {
+      defaults: options == null ? void 0 : options.cacheControlDefaults,
+      overrides: options == null ? void 0 : options.cacheControlOverrides
+    };
+    const responseIsValid = async (response) => {
+      return response.ok && ((options == null ? void 0 : options.responseIsValid) == null || await options.responseIsValid(response.clone()));
+    };
+    const fetchAndMaybeCache = async () => {
+      return this.fetch(request).then(async (response) => {
+        const cacheControl2 = calculateCacheControl(
+          response,
+          cacheControlOptions
+        );
+        if (!cacheControl2.noStore && isCacheableRequestKey(cacheId) && await responseIsValid(response)) {
+          this.put(cacheId, response).catch(this.errorHandler);
+        }
+        return response;
+      });
+    };
+    const cacheControl = calculateCacheControl(cached, cacheControlOptions);
+    const cacheBehavior = calculateCacheBehavior(
+      cacheControl,
+      getCachedTimestamp(cached)
+    );
+    if (cacheBehavior.preferCache) {
+      if (cacheBehavior.reevaluate) {
+        fetchAndMaybeCache().catch(this.errorHandler);
+      }
+      return cached;
+    } else {
+      if (!cacheBehavior.allowNetwork && !cached) {
+        throw new Error(NOT_CACHED_ERROR);
+      }
+      const response = await fetchAndMaybeCache().catch((error) => {
+        if (!cacheBehavior.allowCache || !cached) throw error;
+        else return cached;
+      });
+      const ok = await responseIsValid(response);
+      return !ok ? cached != null ? cached : response : response;
+    }
+  }
+  /**
+   * Returns a Response if it exists in cache.
+   *
+   * @param request
+   */
+  async getCached(request) {
+    const cache = await this.cache;
+    return await cache.match(request);
+  }
+  /**
+   * @returns a promise that resolves to true if the Cache object is found and deleted, and false otherwise.
+   */
+  async clear() {
+    const deleted = await this.caches.delete(this.name);
+    this.cache = this.caches.open(this.name);
+    return deleted;
+  }
+  /**
+   * Cleans stale items from the cache.
+   */
+  async clean(options) {
+    var _a;
+    const cache = await this.cache;
+    const cacheControlOptions = {
+      defaults: {
+        // Unless the cached entry has a stale-while-revalidate directive, use this default.
+        staleWhileRevalidate: (_a = options == null ? void 0 : options.purgeAfterStale) != null ? _a : DEFAULT_PURGE_AFTER_STALE
+      },
+      overrides: {
+        noStore: false
+      }
+    };
+    for (const key of await cache.keys()) {
+      const cached = await cache.match(key);
+      const cacheControl = calculateCacheControl(
+        cached,
+        cacheControlOptions
+      );
+      const { preferCache } = calculateCacheBehavior(
+        cacheControl,
+        getCachedTimestamp(cached)
+      );
+      if (!preferCache) {
+        await cache.delete(key);
+      }
+    }
+  }
+};
+function calculateCacheControl(cached, options) {
+  const cacheControl = cached ? parseCacheControl(cached.headers.get("Cache-Control")) : {};
+  return __spreadValues(__spreadValues(__spreadValues({}, options.defaults), cacheControl), options.overrides);
+}
+function calculateCacheBehavior(cacheControl, cachedTimestamp) {
+  var _a, _b, _c, _d;
+  const allowCache = !((_a = cacheControl.noStore) != null ? _a : false);
+  const maxAge = (_b = cacheControl.maxAge) != null ? _b : 0;
+  const staleAt = maxAge * 1e3 + (cachedTimestamp != null ? cachedTimestamp : Number.NEGATIVE_INFINITY);
+  const now = Date.now();
+  const isFresh = staleAt > now;
+  const immutable = (_c = cacheControl.immutable) != null ? _c : false;
+  const allowNetwork = !cacheControl.onlyIfCached;
+  const reevaluate = allowNetwork && !immutable && (cacheControl.mustRevalidate || !isFresh);
+  const staleWhileRevalidate = (_d = cacheControl.staleWhileRevalidate) != null ? _d : 0;
+  const preferCache = allowCache && (isFresh || staleAt + staleWhileRevalidate * 1e3 > now || immutable);
+  return {
+    preferCache,
+    reevaluate,
+    allowCache,
+    allowNetwork
+  };
+}
+function isCacheableRequestKey(request) {
+  return typeof request === "string" || request.method === "GET";
+}
+function getCachedTimestamp(cached) {
+  const timestampHeader = cached == null ? void 0 : cached.headers.get(CACHED_TIMESTAMP_HEADER);
+  if (!timestampHeader) return void 0;
+  return parseInt(timestampHeader, 10);
+}
+export {
+  CacheManager,
+  DEFAULT_CACHE_NAME,
+  DEFAULT_PURGE_AFTER_STALE,
+  NOT_CACHED_ERROR,
+  parseCacheControl
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/cacheManager/CacheControl.ts", "../src/cacheManager/CacheManager.ts"],
+  "sourcesContent": ["/*\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\n\n/**\n * Represents all known Cache-Control directives.\n *\n * https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Cache-Control\n */\nexport type CacheControl = {\n    /**\n     * The maximum amount of time (in seconds) a resource is considered fresh.\n     * Example: `max-age=3600` (1 hour)\n     */\n    readonly maxAge?: number\n\n    /**\n     * Requires the resource to be revalidated with the origin server before serving it from the cache.\n     * Example: `no-cache`\n     */\n    readonly noCache?: boolean\n\n    /**\n     * Prevents the resource from being cached by any mechanism.\n     * Example: `no-store`\n     */\n    readonly noStore?: boolean\n\n    /**\n     * Ensures that stale responses cannot be used without successful revalidation with the origin server.\n     * Example: `must-revalidate`\n     */\n    readonly mustRevalidate?: boolean\n\n    /**\n     * Indicates the resource is cacheable by both shared and private caches.\n     * Example: `public`\n     */\n    readonly public?: boolean\n\n    /**\n     * Indicates the resource is cacheable only by the user's browser or private caches, not shared caches.\n     * Example: `private`\n     */\n    readonly private?: boolean\n\n    /**\n     * Indicates that the resource will not change, so it does not need to be revalidated.\n     * Example: `immutable`\n     */\n    readonly immutable?: boolean\n\n    /**\n     * Allows serving stale responses for the specified duration (in seconds) while asynchronously revalidating the\n     * cache.\n     * Example: `stale-while-revalidate=60`\n     */\n    readonly staleWhileRevalidate?: number\n\n    /**\n     * Allows serving stale responses (in seconds) if the origin server is unavailable or returns an error.\n     * Example: `stale-if-error=86400` (1 day)\n     */\n    readonly staleIfError?: number\n\n    /**\n     * Indicates the client only wants a response from the cache and will not make a network request.\n     * Example: `only-if-cached`\n     */\n    readonly onlyIfCached?: boolean\n}\n\n// Map for known directive names to their typed keys\nconst knownDirectives: Record<string, keyof CacheControl | undefined> = {\n    'max-age': 'maxAge',\n    'no-cache': 'noCache',\n    'no-store': 'noStore',\n    'must-revalidate': 'mustRevalidate',\n    public: 'public',\n    private: 'private',\n    immutable: 'immutable',\n    'stale-while-revalidate': 'staleWhileRevalidate',\n    'stale-if-error': 'staleIfError',\n    'only-if-cached': 'onlyIfCached',\n} as const\n\n/**\n * Parses a Cache-Control header string into a structured object.\n * Handles known directives with optional numeric values.\n *\n * @param str - The Cache-Control header string to parse.\n * @returns A CacheControl object representing the parsed directives.\n */\nexport function parseCacheControl(\n    str: string | null | undefined\n): CacheControl {\n    if (!str) return {}\n    const directives: any = {}\n    str.split(',').forEach((part) => {\n        const [key, value] = part.trim().split('=') as [string, string?]\n        const directiveKey = key.trim().toLowerCase() // Ensure case-insensitivity\n\n        const typedKey = knownDirectives[directiveKey]\n        if (typedKey) {\n            // Parse the value or set to true for boolean directives\n            if (value === undefined) {\n                directives[typedKey] = true\n            } else {\n                const numericValue = parseInt(value, 10)\n                directives[typedKey] = isNaN(numericValue)\n                    ? value\n                    : numericValue\n            }\n        }\n    })\n    return directives\n}\n", "/*\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\n\n/*\n * Offline utility that can be shared between the service worker and application.\n * Note - this should not use any dependencies; the bundled service worker must\n * be lightweight.\n */\n\nimport { type CacheControl, parseCacheControl } from './CacheControl'\n\nexport const DEFAULT_CACHE_NAME = 'offlineCache'\nexport const DEFAULT_PURGE_AFTER_STALE = 7 * 24 * 60 * 60\n\n/**\n * If the cache control options set the onlyIfCached directive and the request is not cached, an error will be thrown.\n */\nexport const NOT_CACHED_ERROR = 'Not cached'\n\nexport type CacheManagerOptions = {\n    /**\n     * The name of the cache key.\n     */\n    readonly name?: string\n\n    /**\n     * The Fetch from network method. Defaults to window.fetch.\n     */\n    readonly requestFromNetwork?: Fetch\n}\n\ntype Fetch = (request: RequestInfo) => Promise<Response>\n\n/**\n * A prefix for cache keys in order to guarantee they can be used as cache keys.\n * WebKit browsers only allow http/https cache keys.\n */\nconst CACHE_KEY_PREFIX = 'https://cache/'\n\n/**\n * A custom header for storing the timestamp at which the entry was cached.\n */\nconst CACHED_TIMESTAMP_HEADER = 'X-Cached-Timestamp'\n\nexport type CacheEntryOptions = {\n    /**\n     * If set, the response will be cached under this identifier, not based on the request.\n     * This is required for caching POST requests.\n     */\n    readonly cacheKey?: string | null | undefined\n\n    /**\n     * Cache control directive defaults.\n     * These will be used unless overridden by the response headers or the cache control overrides.\n     *\n     * CacheControl directives will be overwritten in the order:\n     * - cacheControlDefaults\n     * - response headers\n     * - cacheControlOverrides\n     */\n    readonly cacheControlDefaults?: CacheControl\n\n    /**\n     * Allows the client to set cache control overrides. This object is merged with the actual cache control header.\n     *\n     * For example, to allow cached items to be used 1 day after they are stale while asynchronously revalidating\n     * the cache, set `{ staleWhileRevalidate: 24 * 60 * 60 }`\n     *\n     * These overrides do not change the header cached, only how the cached header is read.\n     * If noStore is true, the entry will not be cached.\n     */\n    readonly cacheControlOverrides?: CacheControl\n\n    /**\n     * If set, checks the response if it should be used. This affects whether to cache and whether to use the\n     * cached fallback.\n     */\n    readonly responseIsValid?: (response: Response) => Promise<boolean>\n}\n\nexport type CacheCleanOptions = {\n    /**\n     * The number of seconds after an entry becomes stale before it should be removed from the cache.\n     * Default: 7 * 24 * 60 * 60 (7 days).\n     * If the cached entry has a stale-while-revalidate cache control directive, this will be ignored.\n     */\n    readonly purgeAfterStale?: number\n}\n\nexport interface CacheManagerDeps {\n    /**\n     * The cache storages api.\n     * Default: window.caches\n     */\n    readonly caches?: CacheStorage\n\n    /**\n     * Creates a Headers object\n     */\n    readonly headersFactory?: (headersInit?: HeadersInit) => Headers\n\n    /**\n     * Creates a Response object\n     */\n    readonly responseFactory?: (\n        body?: BodyInit | null,\n        init?: ResponseInit\n    ) => Response\n}\n\nexport class CacheManager {\n    readonly name: string\n\n    private readonly caches: CacheStorage\n    private cache: Promise<Cache>\n    private readonly fetch: Fetch\n\n    /**\n     * If set, when asynchronous caching has failed, this callback will be invoked.\n     * This is not invoked when a promise rejects during an operation.\n     */\n    onError?: (error: Error) => void\n\n    constructor(options?: CacheManagerOptions, deps?: CacheManagerDeps) {\n        this.caches = deps?.caches ?? caches\n        this.name = options?.name ?? DEFAULT_CACHE_NAME\n        this.cache = this.caches.open(this.name)\n        this.fetch =\n            options?.requestFromNetwork ?? ((request) => fetch(request))\n    }\n\n    private readonly errorHandler = (error: Error) => {\n        this.onError?.(error)\n    }\n\n    /**\n     * Caches a response with added expiry headers.\n     */\n    async put(cacheId: RequestInfo, response: Response): Promise<Response> {\n        if (response.bodyUsed)\n            throw new Error(`cannot cache request, body already used`)\n\n        const clonedResponse = response.clone()\n\n        // Add a timestamp header\n        const headers = new Headers(clonedResponse.headers)\n        headers.append(CACHED_TIMESTAMP_HEADER, Date.now().toString())\n\n        const responseWithHeader = new Response(clonedResponse.body, {\n            status: clonedResponse.status,\n            statusText: clonedResponse.statusText,\n            headers,\n        })\n\n        const cache = await this.cache\n        await cache.put(cacheId, responseWithHeader)\n        return response\n    }\n\n    /**\n     * Deletes the request from this cache.\n     *\n     * @param cacheId The request or cache id used as the cache key.\n     */\n    async delete(cacheId: RequestInfo): Promise<boolean> {\n        const cache = await this.cache\n        return await cache.delete(cacheId)\n    }\n\n    /**\n     * Resolves to true if the request is cached.\n     *\n     * @param cacheId\n     */\n    async has(cacheId: RequestInfo): Promise<boolean> {\n        return (await this.getCached(cacheId)) != null\n    }\n\n    async get(\n        request: RequestInfo,\n        options?: CacheEntryOptions\n    ): Promise<Response> {\n        const cache = await this.cache\n\n        const cacheId = options?.cacheKey\n            ? CACHE_KEY_PREFIX + options.cacheKey\n            : request\n\n        let cached: Response | undefined\n        if (options?.cacheControlOverrides?.noStore) {\n            this.delete(cacheId).catch(this.errorHandler)\n            cached = undefined\n        } else {\n            cached = await cache.match(cacheId)\n        }\n\n        const cacheControlOptions: CacheControlOptions = {\n            defaults: options?.cacheControlDefaults,\n            overrides: options?.cacheControlOverrides,\n        }\n\n        const responseIsValid = async (\n            response: Response\n        ): Promise<boolean> => {\n            return (\n                response.ok &&\n                (options?.responseIsValid == null ||\n                    (await options.responseIsValid(response.clone())))\n            )\n        }\n\n        const fetchAndMaybeCache = async (): Promise<Response> => {\n            return this.fetch(request).then(async (response) => {\n                const cacheControl = calculateCacheControl(\n                    response,\n                    cacheControlOptions\n                )\n                if (\n                    !cacheControl.noStore &&\n                    isCacheableRequestKey(cacheId) &&\n                    (await responseIsValid(response))\n                ) {\n                    this.put(cacheId, response).catch(this.errorHandler)\n                }\n                return response\n            })\n        }\n        const cacheControl = calculateCacheControl(cached, cacheControlOptions)\n        const cacheBehavior = calculateCacheBehavior(\n            cacheControl,\n            getCachedTimestamp(cached)\n        )\n        if (cacheBehavior.preferCache) {\n            if (cacheBehavior.reevaluate) {\n                fetchAndMaybeCache().catch(this.errorHandler)\n            }\n            return cached!\n        } else {\n            if (!cacheBehavior.allowNetwork && !cached) {\n                throw new Error(NOT_CACHED_ERROR)\n            }\n            // Prefer a network response. If the network response isn't valid, return the cached value.\n            const response = await fetchAndMaybeCache().catch((error) => {\n                if (!cacheBehavior.allowCache || !cached) throw error\n                else return cached\n            })\n            const ok = await responseIsValid(response)\n            return !ok ? (cached ?? response) : response\n        }\n    }\n\n    /**\n     * Returns a Response if it exists in cache.\n     *\n     * @param request\n     */\n    private async getCached(\n        request: RequestInfo\n    ): Promise<Response | undefined> {\n        const cache = await this.cache\n        return await cache.match(request)\n    }\n\n    /**\n     * @returns a promise that resolves to true if the Cache object is found and deleted, and false otherwise.\n     */\n    async clear(): Promise<boolean> {\n        const deleted = await this.caches.delete(this.name)\n        this.cache = this.caches.open(this.name)\n        return deleted\n    }\n\n    /**\n     * Cleans stale items from the cache.\n     */\n    async clean(options?: CacheCleanOptions) {\n        const cache = await this.cache\n        const cacheControlOptions: CacheControlOptions = {\n            defaults: {\n                // Unless the cached entry has a stale-while-revalidate directive, use this default.\n                staleWhileRevalidate:\n                    options?.purgeAfterStale ?? DEFAULT_PURGE_AFTER_STALE,\n            },\n            overrides: {\n                noStore: false,\n            },\n        }\n        for (const key of await cache.keys()) {\n            const cached = await cache.match(key)\n            const cacheControl = calculateCacheControl(\n                cached,\n                cacheControlOptions\n            )\n            const { preferCache } = calculateCacheBehavior(\n                cacheControl,\n                getCachedTimestamp(cached)\n            )\n            if (!preferCache) {\n                await cache.delete(key)\n            }\n        }\n    }\n}\n\ntype CacheControlOptions = {\n    readonly defaults?: CacheControl | undefined\n    readonly overrides?: CacheControl | undefined\n}\n\nfunction calculateCacheControl(\n    cached: Response | undefined,\n    options: CacheControlOptions\n): CacheControl {\n    const cacheControl = cached\n        ? parseCacheControl(cached.headers.get('Cache-Control'))\n        : {}\n    return {\n        ...options.defaults,\n        ...cacheControl,\n        ...options.overrides,\n    }\n}\n\ntype CacheBehavior = {\n    /**\n     * If false, do not use the cached entry. If it exists, delete it.\n     */\n    readonly allowCache: boolean\n\n    /**\n     * Prefer the cached result.\n     * If false, the cache may be used if `allowCache` is true and the request fails.\n     */\n    readonly preferCache: boolean\n\n    /**\n     * If false, do not request from network, even if there is not a cached resource.\n     */\n    readonly allowNetwork: boolean\n\n    /**\n     * Load the resource from the network.\n     * If preferCache is true, the cached response will be used and a new request will be made asynchronously.\n     */\n    readonly reevaluate: boolean\n}\n\nfunction calculateCacheBehavior(\n    cacheControl: CacheControl,\n    cachedTimestamp: number | undefined\n): CacheBehavior {\n    const allowCache = !(cacheControl.noStore ?? false)\n    const maxAge = cacheControl.maxAge ?? 0\n    const staleAt =\n        maxAge * 1000 + (cachedTimestamp ?? Number.NEGATIVE_INFINITY)\n\n    const now = Date.now()\n    const isFresh = staleAt > now\n    const immutable = cacheControl.immutable ?? false\n    const allowNetwork = !cacheControl.onlyIfCached\n    const reevaluate =\n        allowNetwork && !immutable && (cacheControl.mustRevalidate || !isFresh)\n    // If the entry is past its max age and there is staleWhileRevalidate set, allow the cached entry to be used\n    // staleWhileRevalidate seconds after maxAge.\n    const staleWhileRevalidate = cacheControl.staleWhileRevalidate ?? 0\n    const preferCache =\n        allowCache &&\n        (isFresh || staleAt + staleWhileRevalidate * 1000 > now || immutable)\n    return {\n        preferCache,\n        reevaluate,\n        allowCache,\n        allowNetwork,\n    }\n}\n\n/**\n * Returns true if the request can be used as a Cache key.\n */\nfunction isCacheableRequestKey(request: RequestInfo): boolean {\n    return typeof request === 'string' || request.method === 'GET'\n}\n\nfunction getCachedTimestamp(cached: Response | undefined): number | undefined {\n    const timestampHeader = cached?.headers.get(CACHED_TIMESTAMP_HEADER)\n    if (!timestampHeader) return undefined\n    return parseInt(timestampHeader, 10)\n}\n"],
+  "mappings": "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",
+  "names": ["cacheControl"]
+}