@serwist/precaching 8.4.0 → 8.4.2

package/dist/PrecacheRoute.d.ts

@@ -1,6 +1,6 @@
 import { Route } from "@serwist/routing";
-import type { PrecacheRouteOptions } from "./_types.js";
 import type { PrecacheController } from "./PrecacheController.js";
+import type { PrecacheRouteOptions } from "./_types.js";
 /**
  * A subclass of `@serwist/routing.Route` that takes a
  * `@serwist/precaching.PrecacheController`

package/dist/index.cjs

@@ -60,12 +60,12 @@ var routing = require('@serwist/routing');
         return await this._handleFetch(request, handler);
     }
     async _handleFetch(request, handler) {
-        let response;
+        let response = undefined;
         const params = handler.params || {};
         // Fallback to the network if we're configured to do so.
         if (this._fallbackToNetwork) {
             if (process.env.NODE_ENV !== "production") {
-                internal.logger.warn(`The precached response for ` + `${internal.getFriendlyURL(request.url)} in ${this.cacheName} was not ` + `found. Falling back to the network.`);
+                internal.logger.warn(`The precached response for ${internal.getFriendlyURL(request.url)} in ${this.cacheName} was not found. Falling back to the network.`);
             }
             const integrityInManifest = params.integrity;
             const integrityInRequest = request.integrity;
@@ -87,7 +87,7 @@ var routing = require('@serwist/routing');
                 const wasCached = await handler.cachePut(request, response.clone());
                 if (process.env.NODE_ENV !== "production") {
                     if (wasCached) {
-                        internal.logger.log(`A response for ${internal.getFriendlyURL(request.url)} ` + `was used to "repair" the precache.`);
+                        internal.logger.log(`A response for ${internal.getFriendlyURL(request.url)} was used to "repair" the precache.`);
                     }
                 }
             }
@@ -103,12 +103,12 @@ var routing = require('@serwist/routing');
             const cacheKey = params.cacheKey || await handler.getCacheKey(request, "read");
             // Serwist is going to handle the route.
             // print the routing details to the console.
-            internal.logger.groupCollapsed(`Precaching is responding to: ` + internal.getFriendlyURL(request.url));
+            internal.logger.groupCollapsed(`Precaching is responding to: ${internal.getFriendlyURL(request.url)}`);
             internal.logger.log(`Serving the precached url: ${internal.getFriendlyURL(cacheKey instanceof Request ? cacheKey.url : cacheKey)}`);
-            internal.logger.groupCollapsed(`View request details here.`);
+            internal.logger.groupCollapsed("View request details here.");
             internal.logger.log(request);
             internal.logger.groupEnd();
-            internal.logger.groupCollapsed(`View response details here.`);
+            internal.logger.groupCollapsed("View response details here.");
             internal.logger.log(response);
             internal.logger.groupEnd();
             internal.logger.groupEnd();
@@ -183,56 +183,6 @@ var routing = require('@serwist/routing');
     }
 }
 
-// Name of the search parameter used to store revision info.
-const REVISION_SEARCH_PARAM = "__WB_REVISION__";
-/**
- * Converts a manifest entry into a versioned URL suitable for precaching.
- *
- * @param entry
- * @returns A URL with versioning info.
- *
- * @private
- */ function createCacheKey(entry) {
-    if (!entry) {
-        throw new internal.SerwistError("add-to-cache-list-unexpected-type", {
-            entry
-        });
-    }
-    // If a precache manifest entry is a string, it's assumed to be a versioned
-    // URL, like '/app.abcd1234.js'. Return as-is.
-    if (typeof entry === "string") {
-        const urlObject = new URL(entry, location.href);
-        return {
-            cacheKey: urlObject.href,
-            url: urlObject.href
-        };
-    }
-    const { revision, url } = entry;
-    if (!url) {
-        throw new internal.SerwistError("add-to-cache-list-unexpected-type", {
-            entry
-        });
-    }
-    // If there's just a URL and no revision, then it's also assumed to be a
-    // versioned URL.
-    if (!revision) {
-        const urlObject = new URL(url, location.href);
-        return {
-            cacheKey: urlObject.href,
-            url: urlObject.href
-        };
-    }
-    // Otherwise, construct a properly versioned URL using the custom Serwist
-    // search parameter along with the revision info.
-    const cacheKeyURL = new URL(url, location.href);
-    const originalURL = new URL(url, location.href);
-    cacheKeyURL.searchParams.set(REVISION_SEARCH_PARAM, revision);
-    return {
-        cacheKey: cacheKeyURL.href,
-        url: originalURL.href
-    };
-}
-
 /*
   Copyright 2020 Google LLC
 
@@ -280,7 +230,7 @@ const REVISION_SEARCH_PARAM = "__WB_REVISION__";
     };
     cachedResponseWillBeUsed = async ({ event, state, cachedResponse })=>{
         if (event.type === "install") {
-            if (state && state.originalRequest && state.originalRequest instanceof Request) {
+            if (state?.originalRequest && state.originalRequest instanceof Request) {
                 // TODO: `state` should never be undefined...
                 const url = state.originalRequest.url;
                 if (cachedResponse) {
@@ -294,6 +244,56 @@ const REVISION_SEARCH_PARAM = "__WB_REVISION__";
     };
 }
 
+// Name of the search parameter used to store revision info.
+const REVISION_SEARCH_PARAM = "__WB_REVISION__";
+/**
+ * Converts a manifest entry into a versioned URL suitable for precaching.
+ *
+ * @param entry
+ * @returns A URL with versioning info.
+ *
+ * @private
+ */ function createCacheKey(entry) {
+    if (!entry) {
+        throw new internal.SerwistError("add-to-cache-list-unexpected-type", {
+            entry
+        });
+    }
+    // If a precache manifest entry is a string, it's assumed to be a versioned
+    // URL, like '/app.abcd1234.js'. Return as-is.
+    if (typeof entry === "string") {
+        const urlObject = new URL(entry, location.href);
+        return {
+            cacheKey: urlObject.href,
+            url: urlObject.href
+        };
+    }
+    const { revision, url } = entry;
+    if (!url) {
+        throw new internal.SerwistError("add-to-cache-list-unexpected-type", {
+            entry
+        });
+    }
+    // If there's just a URL and no revision, then it's also assumed to be a
+    // versioned URL.
+    if (!revision) {
+        const urlObject = new URL(url, location.href);
+        return {
+            cacheKey: urlObject.href,
+            url: urlObject.href
+        };
+    }
+    // Otherwise, construct a properly versioned URL using the custom Serwist
+    // search parameter along with the revision info.
+    const cacheKeyURL = new URL(url, location.href);
+    const originalURL = new URL(url, location.href);
+    cacheKeyURL.searchParams.set(REVISION_SEARCH_PARAM, revision);
+    return {
+        cacheKey: cacheKeyURL.href,
+        url: originalURL.href
+    };
+}
+
 /**
  * @param groupTitle
  * @param deletedURLs
@@ -312,7 +312,7 @@ const REVISION_SEARCH_PARAM = "__WB_REVISION__";
  */ function printCleanupDetails(deletedURLs) {
     const deletionCount = deletedURLs.length;
     if (deletionCount > 0) {
-        internal.logger.groupCollapsed(`During precaching cleanup, ` + `${deletionCount} cached ` + `request${deletionCount === 1 ? " was" : "s were"} deleted.`);
+        internal.logger.groupCollapsed(`During precaching cleanup, ${deletionCount} cached request${deletionCount === 1 ? " was" : "s were"} deleted.`);
         logGroup("Deleted Cache Requests", deletedURLs);
         internal.logger.groupEnd();
     }
@@ -346,8 +346,8 @@ const REVISION_SEARCH_PARAM = "__WB_REVISION__";
             message += ` ${alreadyPrecachedCount} ` + `file${alreadyPrecachedCount === 1 ? " is" : "s are"} already cached.`;
         }
         internal.logger.groupCollapsed(message);
-        _nestedGroup(`View newly precached URLs.`, urlsToPrecache);
-        _nestedGroup(`View previously precached URLs.`, urlsAlreadyPrecached);
+        _nestedGroup("View newly precached URLs.", urlsToPrecache);
+        _nestedGroup("View previously precached URLs.", urlsAlreadyPrecached);
         internal.logger.groupEnd();
     }
 }
@@ -442,7 +442,7 @@ const REVISION_SEARCH_PARAM = "__WB_REVISION__";
             this._urlsToCacheKeys.set(url, cacheKey);
             this._urlsToCacheModes.set(url, cacheMode);
             if (urlsToWarnAbout.length > 0) {
-                const warningMessage = `Serwist is precaching URLs without revision ` + `info: ${urlsToWarnAbout.join(", ")}\nThis is generally NOT safe. ` + `Learn more at https://bit.ly/wb-precache`;
+                const warningMessage = `Serwist is precaching URLs without revision info: ${urlsToWarnAbout.join(", ")}\nThis is generally NOT safe. Learn more at https://bit.ly/wb-precache`;
                 if (process.env.NODE_ENV === "production") {
                     // Use console directly to display this warning without bloating
                     // bundle sizes by pulling in all of the logger codebase in prod.
@@ -626,12 +626,31 @@ let precacheController;
 };
 
 /**
- * Adds plugins to the precaching strategy.
+ * `PrecacheFallbackPlugin` allows you to specify an "offline fallback"
+ * response to be used when a given strategy is unable to generate a response.
  *
- * @param plugins
- */ function addPlugins(plugins) {
-    const precacheController = getOrCreatePrecacheController();
-    precacheController.strategy.plugins.push(...plugins);
+ * It does this by intercepting the `handlerDidError` plugin callback
+ * and returning a precached response, taking the expected revision parameter
+ * into account automatically.
+ *
+ * Unless you explicitly pass in a `PrecacheController` instance to the
+ * constructor, the default instance will be used. Generally speaking, most
+ * developers will end up using the default.
+ */ class PrecacheFallbackPlugin {
+    _fallbackURL;
+    _precacheController;
+    /**
+   * Constructs a new PrecacheFallbackPlugin with the associated fallbackURL.
+   *
+   * @param config
+   */ constructor({ fallbackURL, precacheController }){
+        this._fallbackURL = fallbackURL;
+        this._precacheController = precacheController || getOrCreatePrecacheController();
+    }
+    /**
+   * @returns The precache response for the fallback URL.
+   * @private
+   */ handlerDidError = ()=>this._precacheController.matchPrecache(this._fallbackURL);
 }
 
 /*
@@ -724,7 +743,7 @@ let precacheController;
                 }
             }
             if (process.env.NODE_ENV !== "production") {
-                internal.logger.debug(`Precaching did not find a match for ` + internal.getFriendlyURL(request.url));
+                internal.logger.debug(`Precaching did not find a match for ${internal.getFriendlyURL(request.url)}`);
             }
             return;
         };
@@ -732,6 +751,15 @@ let precacheController;
     }
 }
 
+/**
+ * Adds plugins to the precaching strategy.
+ *
+ * @param plugins
+ */ function addPlugins(plugins) {
+    const precacheController = getOrCreatePrecacheController();
+    precacheController.strategy.plugins.push(...plugins);
+}
+
 /**
  * Add a `fetch` listener to the service worker that will
  * respond to
@@ -791,7 +819,7 @@ const SUBSTRING_TO_FIND = "-precache-";
         event.waitUntil(deleteOutdatedCaches(cacheName).then((cachesDeleted)=>{
             if (process.env.NODE_ENV !== "production") {
                 if (cachesDeleted.length > 0) {
-                    internal.logger.log(`The following out-of-date precaches were cleaned up ` + `automatically:`, cachesDeleted);
+                    internal.logger.log("The following out-of-date precaches were cleaned up " + "automatically:", cachesDeleted);
                 }
             }
         }));
@@ -888,34 +916,6 @@ const SUBSTRING_TO_FIND = "-precache-";
     addRoute(options);
 }
 
-/**
- * `PrecacheFallbackPlugin` allows you to specify an "offline fallback"
- * response to be used when a given strategy is unable to generate a response.
- *
- * It does this by intercepting the `handlerDidError` plugin callback
- * and returning a precached response, taking the expected revision parameter
- * into account automatically.
- *
- * Unless you explicitly pass in a `PrecacheController` instance to the
- * constructor, the default instance will be used. Generally speaking, most
- * developers will end up using the default.
- */ class PrecacheFallbackPlugin {
-    _fallbackURL;
-    _precacheController;
-    /**
-   * Constructs a new PrecacheFallbackPlugin with the associated fallbackURL.
-   *
-   * @param config
-   */ constructor({ fallbackURL, precacheController }){
-        this._fallbackURL = fallbackURL;
-        this._precacheController = precacheController || getOrCreatePrecacheController();
-    }
-    /**
-   * @returns The precache response for the fallback URL.
-   * @private
-   */ handlerDidError = ()=>this._precacheController.matchPrecache(this._fallbackURL);
-}
-
 exports.PrecacheController = PrecacheController;
 exports.PrecacheFallbackPlugin = PrecacheFallbackPlugin;
 exports.PrecacheRoute = PrecacheRoute;

package/dist/index.d.cts

@@ -1,3 +1,7 @@
+import { PrecacheController } from "./PrecacheController.js";
+import { PrecacheFallbackPlugin } from "./PrecacheFallbackPlugin.js";
+import { PrecacheRoute } from "./PrecacheRoute.js";
+import { PrecacheStrategy } from "./PrecacheStrategy.js";
 import { addPlugins } from "./addPlugins.js";
 import { addRoute } from "./addRoute.js";
 import { cleanupOutdatedCaches } from "./cleanupOutdatedCaches.js";
@@ -6,10 +10,6 @@ import { getCacheKeyForURL } from "./getCacheKeyForURL.js";
 import { matchPrecache } from "./matchPrecache.js";
 import { precache } from "./precache.js";
 import { precacheAndRoute } from "./precacheAndRoute.js";
-import { PrecacheController } from "./PrecacheController.js";
-import { PrecacheFallbackPlugin } from "./PrecacheFallbackPlugin.js";
-import { PrecacheRoute } from "./PrecacheRoute.js";
-import { PrecacheStrategy } from "./PrecacheStrategy.js";
 /**
  * Most consumers of this module will want to use the
  * `@serwist/precaching.precacheAndRoute`

package/dist/index.d.ts

@@ -1,3 +1,7 @@
+import { PrecacheController } from "./PrecacheController.js";
+import { PrecacheFallbackPlugin } from "./PrecacheFallbackPlugin.js";
+import { PrecacheRoute } from "./PrecacheRoute.js";
+import { PrecacheStrategy } from "./PrecacheStrategy.js";
 import { addPlugins } from "./addPlugins.js";
 import { addRoute } from "./addRoute.js";
 import { cleanupOutdatedCaches } from "./cleanupOutdatedCaches.js";
@@ -6,10 +10,6 @@ import { getCacheKeyForURL } from "./getCacheKeyForURL.js";
 import { matchPrecache } from "./matchPrecache.js";
 import { precache } from "./precache.js";
 import { precacheAndRoute } from "./precacheAndRoute.js";
-import { PrecacheController } from "./PrecacheController.js";
-import { PrecacheFallbackPlugin } from "./PrecacheFallbackPlugin.js";
-import { PrecacheRoute } from "./PrecacheRoute.js";
-import { PrecacheStrategy } from "./PrecacheStrategy.js";
 /**
  * Most consumers of this module will want to use the
  * `@serwist/precaching.precacheAndRoute`

package/dist/index.js

@@ -58,12 +58,12 @@ import { Route, registerRoute } from '@serwist/routing';
         return await this._handleFetch(request, handler);
     }
     async _handleFetch(request, handler) {
-        let response;
+        let response = undefined;
         const params = handler.params || {};
         // Fallback to the network if we're configured to do so.
         if (this._fallbackToNetwork) {
             if (process.env.NODE_ENV !== "production") {
-                logger.warn(`The precached response for ` + `${getFriendlyURL(request.url)} in ${this.cacheName} was not ` + `found. Falling back to the network.`);
+                logger.warn(`The precached response for ${getFriendlyURL(request.url)} in ${this.cacheName} was not found. Falling back to the network.`);
             }
             const integrityInManifest = params.integrity;
             const integrityInRequest = request.integrity;
@@ -85,7 +85,7 @@ import { Route, registerRoute } from '@serwist/routing';
                 const wasCached = await handler.cachePut(request, response.clone());
                 if (process.env.NODE_ENV !== "production") {
                     if (wasCached) {
-                        logger.log(`A response for ${getFriendlyURL(request.url)} ` + `was used to "repair" the precache.`);
+                        logger.log(`A response for ${getFriendlyURL(request.url)} was used to "repair" the precache.`);
                     }
                 }
             }
@@ -101,12 +101,12 @@ import { Route, registerRoute } from '@serwist/routing';
             const cacheKey = params.cacheKey || await handler.getCacheKey(request, "read");
             // Serwist is going to handle the route.
             // print the routing details to the console.
-            logger.groupCollapsed(`Precaching is responding to: ` + getFriendlyURL(request.url));
+            logger.groupCollapsed(`Precaching is responding to: ${getFriendlyURL(request.url)}`);
             logger.log(`Serving the precached url: ${getFriendlyURL(cacheKey instanceof Request ? cacheKey.url : cacheKey)}`);
-            logger.groupCollapsed(`View request details here.`);
+            logger.groupCollapsed("View request details here.");
             logger.log(request);
             logger.groupEnd();
-            logger.groupCollapsed(`View response details here.`);
+            logger.groupCollapsed("View response details here.");
             logger.log(response);
             logger.groupEnd();
             logger.groupEnd();
@@ -181,56 +181,6 @@ import { Route, registerRoute } from '@serwist/routing';
     }
 }
 
-// Name of the search parameter used to store revision info.
-const REVISION_SEARCH_PARAM = "__WB_REVISION__";
-/**
- * Converts a manifest entry into a versioned URL suitable for precaching.
- *
- * @param entry
- * @returns A URL with versioning info.
- *
- * @private
- */ function createCacheKey(entry) {
-    if (!entry) {
-        throw new SerwistError("add-to-cache-list-unexpected-type", {
-            entry
-        });
-    }
-    // If a precache manifest entry is a string, it's assumed to be a versioned
-    // URL, like '/app.abcd1234.js'. Return as-is.
-    if (typeof entry === "string") {
-        const urlObject = new URL(entry, location.href);
-        return {
-            cacheKey: urlObject.href,
-            url: urlObject.href
-        };
-    }
-    const { revision, url } = entry;
-    if (!url) {
-        throw new SerwistError("add-to-cache-list-unexpected-type", {
-            entry
-        });
-    }
-    // If there's just a URL and no revision, then it's also assumed to be a
-    // versioned URL.
-    if (!revision) {
-        const urlObject = new URL(url, location.href);
-        return {
-            cacheKey: urlObject.href,
-            url: urlObject.href
-        };
-    }
-    // Otherwise, construct a properly versioned URL using the custom Serwist
-    // search parameter along with the revision info.
-    const cacheKeyURL = new URL(url, location.href);
-    const originalURL = new URL(url, location.href);
-    cacheKeyURL.searchParams.set(REVISION_SEARCH_PARAM, revision);
-    return {
-        cacheKey: cacheKeyURL.href,
-        url: originalURL.href
-    };
-}
-
 /*
   Copyright 2020 Google LLC
 
@@ -278,7 +228,7 @@ const REVISION_SEARCH_PARAM = "__WB_REVISION__";
     };
     cachedResponseWillBeUsed = async ({ event, state, cachedResponse })=>{
         if (event.type === "install") {
-            if (state && state.originalRequest && state.originalRequest instanceof Request) {
+            if (state?.originalRequest && state.originalRequest instanceof Request) {
                 // TODO: `state` should never be undefined...
                 const url = state.originalRequest.url;
                 if (cachedResponse) {
@@ -292,6 +242,56 @@ const REVISION_SEARCH_PARAM = "__WB_REVISION__";
     };
 }
 
+// Name of the search parameter used to store revision info.
+const REVISION_SEARCH_PARAM = "__WB_REVISION__";
+/**
+ * Converts a manifest entry into a versioned URL suitable for precaching.
+ *
+ * @param entry
+ * @returns A URL with versioning info.
+ *
+ * @private
+ */ function createCacheKey(entry) {
+    if (!entry) {
+        throw new SerwistError("add-to-cache-list-unexpected-type", {
+            entry
+        });
+    }
+    // If a precache manifest entry is a string, it's assumed to be a versioned
+    // URL, like '/app.abcd1234.js'. Return as-is.
+    if (typeof entry === "string") {
+        const urlObject = new URL(entry, location.href);
+        return {
+            cacheKey: urlObject.href,
+            url: urlObject.href
+        };
+    }
+    const { revision, url } = entry;
+    if (!url) {
+        throw new SerwistError("add-to-cache-list-unexpected-type", {
+            entry
+        });
+    }
+    // If there's just a URL and no revision, then it's also assumed to be a
+    // versioned URL.
+    if (!revision) {
+        const urlObject = new URL(url, location.href);
+        return {
+            cacheKey: urlObject.href,
+            url: urlObject.href
+        };
+    }
+    // Otherwise, construct a properly versioned URL using the custom Serwist
+    // search parameter along with the revision info.
+    const cacheKeyURL = new URL(url, location.href);
+    const originalURL = new URL(url, location.href);
+    cacheKeyURL.searchParams.set(REVISION_SEARCH_PARAM, revision);
+    return {
+        cacheKey: cacheKeyURL.href,
+        url: originalURL.href
+    };
+}
+
 /**
  * @param groupTitle
  * @param deletedURLs
@@ -310,7 +310,7 @@ const REVISION_SEARCH_PARAM = "__WB_REVISION__";
  */ function printCleanupDetails(deletedURLs) {
     const deletionCount = deletedURLs.length;
     if (deletionCount > 0) {
-        logger.groupCollapsed(`During precaching cleanup, ` + `${deletionCount} cached ` + `request${deletionCount === 1 ? " was" : "s were"} deleted.`);
+        logger.groupCollapsed(`During precaching cleanup, ${deletionCount} cached request${deletionCount === 1 ? " was" : "s were"} deleted.`);
         logGroup("Deleted Cache Requests", deletedURLs);
         logger.groupEnd();
     }
@@ -344,8 +344,8 @@ const REVISION_SEARCH_PARAM = "__WB_REVISION__";
             message += ` ${alreadyPrecachedCount} ` + `file${alreadyPrecachedCount === 1 ? " is" : "s are"} already cached.`;
         }
         logger.groupCollapsed(message);
-        _nestedGroup(`View newly precached URLs.`, urlsToPrecache);
-        _nestedGroup(`View previously precached URLs.`, urlsAlreadyPrecached);
+        _nestedGroup("View newly precached URLs.", urlsToPrecache);
+        _nestedGroup("View previously precached URLs.", urlsAlreadyPrecached);
         logger.groupEnd();
     }
 }
@@ -440,7 +440,7 @@ const REVISION_SEARCH_PARAM = "__WB_REVISION__";
             this._urlsToCacheKeys.set(url, cacheKey);
             this._urlsToCacheModes.set(url, cacheMode);
             if (urlsToWarnAbout.length > 0) {
-                const warningMessage = `Serwist is precaching URLs without revision ` + `info: ${urlsToWarnAbout.join(", ")}\nThis is generally NOT safe. ` + `Learn more at https://bit.ly/wb-precache`;
+                const warningMessage = `Serwist is precaching URLs without revision info: ${urlsToWarnAbout.join(", ")}\nThis is generally NOT safe. Learn more at https://bit.ly/wb-precache`;
                 if (process.env.NODE_ENV === "production") {
                     // Use console directly to display this warning without bloating
                     // bundle sizes by pulling in all of the logger codebase in prod.
@@ -624,12 +624,31 @@ let precacheController;
 };
 
 /**
- * Adds plugins to the precaching strategy.
+ * `PrecacheFallbackPlugin` allows you to specify an "offline fallback"
+ * response to be used when a given strategy is unable to generate a response.
  *
- * @param plugins
- */ function addPlugins(plugins) {
-    const precacheController = getOrCreatePrecacheController();
-    precacheController.strategy.plugins.push(...plugins);
+ * It does this by intercepting the `handlerDidError` plugin callback
+ * and returning a precached response, taking the expected revision parameter
+ * into account automatically.
+ *
+ * Unless you explicitly pass in a `PrecacheController` instance to the
+ * constructor, the default instance will be used. Generally speaking, most
+ * developers will end up using the default.
+ */ class PrecacheFallbackPlugin {
+    _fallbackURL;
+    _precacheController;
+    /**
+   * Constructs a new PrecacheFallbackPlugin with the associated fallbackURL.
+   *
+   * @param config
+   */ constructor({ fallbackURL, precacheController }){
+        this._fallbackURL = fallbackURL;
+        this._precacheController = precacheController || getOrCreatePrecacheController();
+    }
+    /**
+   * @returns The precache response for the fallback URL.
+   * @private
+   */ handlerDidError = ()=>this._precacheController.matchPrecache(this._fallbackURL);
 }
 
 /*
@@ -722,7 +741,7 @@ let precacheController;
                 }
             }
             if (process.env.NODE_ENV !== "production") {
-                logger.debug(`Precaching did not find a match for ` + getFriendlyURL(request.url));
+                logger.debug(`Precaching did not find a match for ${getFriendlyURL(request.url)}`);
             }
             return;
         };
@@ -730,6 +749,15 @@ let precacheController;
     }
 }
 
+/**
+ * Adds plugins to the precaching strategy.
+ *
+ * @param plugins
+ */ function addPlugins(plugins) {
+    const precacheController = getOrCreatePrecacheController();
+    precacheController.strategy.plugins.push(...plugins);
+}
+
 /**
  * Add a `fetch` listener to the service worker that will
  * respond to
@@ -789,7 +817,7 @@ const SUBSTRING_TO_FIND = "-precache-";
         event.waitUntil(deleteOutdatedCaches(cacheName).then((cachesDeleted)=>{
             if (process.env.NODE_ENV !== "production") {
                 if (cachesDeleted.length > 0) {
-                    logger.log(`The following out-of-date precaches were cleaned up ` + `automatically:`, cachesDeleted);
+                    logger.log("The following out-of-date precaches were cleaned up " + "automatically:", cachesDeleted);
                 }
             }
         }));
@@ -886,32 +914,4 @@ const SUBSTRING_TO_FIND = "-precache-";
     addRoute(options);
 }
 
-/**
- * `PrecacheFallbackPlugin` allows you to specify an "offline fallback"
- * response to be used when a given strategy is unable to generate a response.
- *
- * It does this by intercepting the `handlerDidError` plugin callback
- * and returning a precached response, taking the expected revision parameter
- * into account automatically.
- *
- * Unless you explicitly pass in a `PrecacheController` instance to the
- * constructor, the default instance will be used. Generally speaking, most
- * developers will end up using the default.
- */ class PrecacheFallbackPlugin {
-    _fallbackURL;
-    _precacheController;
-    /**
-   * Constructs a new PrecacheFallbackPlugin with the associated fallbackURL.
-   *
-   * @param config
-   */ constructor({ fallbackURL, precacheController }){
-        this._fallbackURL = fallbackURL;
-        this._precacheController = precacheController || getOrCreatePrecacheController();
-    }
-    /**
-   * @returns The precache response for the fallback URL.
-   * @private
-   */ handlerDidError = ()=>this._precacheController.matchPrecache(this._fallbackURL);
-}
-
 export { PrecacheController, PrecacheFallbackPlugin, PrecacheRoute, PrecacheStrategy, addPlugins, addRoute, cleanupOutdatedCaches, createHandlerBoundToURL, getCacheKeyForURL, matchPrecache, precache, precacheAndRoute };

package/dist/utils/generateURLVariations.d.ts

@@ -8,4 +8,4 @@ import type { PrecacheRouteOptions } from "../_types.js";
  *
  * @private
  */
-export declare function generateURLVariations(url: string, { ignoreURLParametersMatching, directoryIndex, cleanURLs, urlManipulation }?: PrecacheRouteOptions): Generator<string, void, unknown>;
+export declare function generateURLVariations(url: string, { ignoreURLParametersMatching, directoryIndex, cleanURLs, urlManipulation, }?: PrecacheRouteOptions): Generator<string, void, unknown>;

package/dist/utils/getCacheKeyForURL.d.ts

@@ -10,4 +10,4 @@ import type { PrecacheRouteOptions } from "../_types.js";
  *
  * @private
  */
-export declare const getCacheKeyForURL: (url: string, options: PrecacheRouteOptions) => string | void;
+export declare const getCacheKeyForURL: (url: string, options: PrecacheRouteOptions) => string | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serwist/precaching",
-  "version": "8.4.0",
+  "version": "8.4.2",
   "type": "module",
   "description": "This module efficiently precaches assets.",
   "files": [
@@ -35,18 +35,18 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@serwist/core": "8.4.0",
-    "@serwist/routing": "8.4.0",
-    "@serwist/strategies": "8.4.0"
+    "@serwist/core": "8.4.2",
+    "@serwist/routing": "8.4.2",
+    "@serwist/strategies": "8.4.2"
   },
   "devDependencies": {
     "rollup": "4.9.1",
-    "@serwist/constants": "8.4.0"
+    "@serwist/constants": "8.4.2"
   },
   "scripts": {
     "build": "rimraf dist && cross-env NODE_ENV=production rollup --config rollup.config.js",
     "dev": "rollup --config rollup.config.js --watch",
-    "lint": "eslint src --ext ts,tsx,js,jsx,cjs,mjs",
+    "lint": "biome lint ./src",
     "typecheck": "tsc"
   }
 }