@serwist/precaching 9.0.0-preview.17 → 9.0.0-preview.18

package/dist/utils/deleteOutdatedCaches.d.ts

@@ -1,18 +0,0 @@
-/**
- * Cleans up incompatible precaches that were created by older versions of
- * Serwist, by a service worker registered under the current scope.
- *
- * This is meant to be called as part of the `activate` event.
- *
- * This should be safe to use as long as you don't include `substringToFind`
- * (defaulting to `-precache-`) in your non-precache cache names.
- *
- * @param currentPrecacheName The cache name currently in use for
- * precaching. This cache won't be deleted.
- * @param substringToFind Cache names which include this
- * substring will be deleted (excluding `currentPrecacheName`).
- * @returns A list of all the cache names that were deleted.
- * @private
- */
-export declare const deleteOutdatedCaches: (currentPrecacheName: string, substringToFind?: string) => Promise<string[]>;
-//# sourceMappingURL=deleteOutdatedCaches.d.ts.map

package/dist/utils/deleteOutdatedCaches.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"deleteOutdatedCaches.d.ts","sourceRoot":"","sources":["../../src/utils/deleteOutdatedCaches.ts"],"names":[],"mappings":"AAaA;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,oBAAoB,wBAA+B,MAAM,oBAAmB,MAAM,KAAuB,QAAQ,MAAM,EAAE,CAUrI,CAAC"}

package/dist/utils/generateURLVariations.d.ts

@@ -1,12 +0,0 @@
-import type { PrecacheRouteOptions } from "../_types.js";
-/**
- * Generator function that yields possible variations on the original URL to
- * check, one at a time.
- *
- * @param url
- * @param options
- *
- * @private
- */
-export declare function generateURLVariations(url: string, { ignoreURLParametersMatching, directoryIndex, cleanURLs, urlManipulation, }?: PrecacheRouteOptions): Generator<string, void, unknown>;
-//# sourceMappingURL=generateURLVariations.d.ts.map

package/dist/utils/generateURLVariations.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"generateURLVariations.d.ts","sourceRoot":"","sources":["../../src/utils/generateURLVariations.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGzD;;;;;;;;GAQG;AACH,wBAAiB,qBAAqB,CACpC,GAAG,EAAE,MAAM,EACX,EACE,2BAAmD,EACnD,cAA6B,EAC7B,SAAgB,EAChB,eAAe,GAChB,GAAE,oBAAyB,GAC3B,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CA0BlC"}

package/dist/utils/getCacheKeyForURL.d.ts

@@ -1,14 +0,0 @@
-import type { PrecacheRouteOptions } from "../_types.js";
-/**
- * This function will take the request URL and manipulate it based on the
- * configuration options.
- *
- * @param url
- * @param options
- * @returns Returns the URL in the cache that matches the request,
- * if possible.
- *
- * @private
- */
-export declare const getCacheKeyForURL: (url: string, options: PrecacheRouteOptions) => string | undefined;
-//# sourceMappingURL=getCacheKeyForURL.d.ts.map

package/dist/utils/getCacheKeyForURL.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"getCacheKeyForURL.d.ts","sourceRoot":"","sources":["../../src/utils/getCacheKeyForURL.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAIzD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,QAAS,MAAM,WAAW,oBAAoB,KAAG,MAAM,GAAG,SAYvF,CAAC"}

package/dist/utils/getOrCreatePrecacheController.d.ts

@@ -1,7 +0,0 @@
-import { PrecacheController } from "../PrecacheController.js";
-/**
- * @returns
- * @private
- */
-export declare const getOrCreatePrecacheController: () => PrecacheController;
-//# sourceMappingURL=getOrCreatePrecacheController.d.ts.map

package/dist/utils/getOrCreatePrecacheController.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"getOrCreatePrecacheController.d.ts","sourceRoot":"","sources":["../../src/utils/getOrCreatePrecacheController.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAI9D;;;GAGG;AACH,eAAO,MAAM,6BAA6B,QAAO,kBAKhD,CAAC"}

package/dist/utils/printCleanupDetails.d.ts

@@ -1,6 +0,0 @@
-/**
- * @param deletedURLs
- * @private
- */
-export declare function printCleanupDetails(deletedURLs: string[]): void;
-//# sourceMappingURL=printCleanupDetails.d.ts.map

package/dist/utils/printCleanupDetails.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"printCleanupDetails.d.ts","sourceRoot":"","sources":["../../src/utils/printCleanupDetails.ts"],"names":[],"mappings":"AA0BA;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI,CAO/D"}

package/dist/utils/printInstallDetails.d.ts

@@ -1,7 +0,0 @@
-/**
- * @param urlsToPrecache
- * @param  urlsAlreadyPrecached
- * @private
- */
-export declare function printInstallDetails(urlsToPrecache: string[], urlsAlreadyPrecached: string[]): void;
-//# sourceMappingURL=printInstallDetails.d.ts.map

package/dist/utils/printInstallDetails.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"printInstallDetails.d.ts","sourceRoot":"","sources":["../../src/utils/printInstallDetails.ts"],"names":[],"mappings":"AA8BA;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,oBAAoB,EAAE,MAAM,EAAE,GAAG,IAAI,CAiBlG"}

package/dist/utils/removeIgnoredSearchParams.d.ts

@@ -1,12 +0,0 @@
-/**
- * Removes any URL search parameters that should be ignored.
- *
- * @param urlObject The original URL.
- * @param ignoreURLParametersMatching RegExps to test against
- * each search parameter name. Matches mean that the search parameter should be
- * ignored.
- * @returns The URL with any ignored search parameters removed.
- * @private
- */
-export declare function removeIgnoredSearchParams(urlObject: URL, ignoreURLParametersMatching?: RegExp[]): URL;
-//# sourceMappingURL=removeIgnoredSearchParams.d.ts.map

package/dist/utils/removeIgnoredSearchParams.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"removeIgnoredSearchParams.d.ts","sourceRoot":"","sources":["../../src/utils/removeIgnoredSearchParams.ts"],"names":[],"mappings":"AAQA;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,GAAG,EAAE,2BAA2B,GAAE,MAAM,EAAO,GAAG,GAAG,CAUzG"}

package/src/PrecacheController.ts

@@ -1,344 +0,0 @@
-/*
-  Copyright 2019 Google LLC
-
-  Use of this source code is governed by an MIT-style
-  license that can be found in the LICENSE file or at
-  https://opensource.org/licenses/MIT.
-*/
-
-import type { RouteHandlerCallback, SerwistPlugin } from "@serwist/core";
-import { assert, SerwistError, logger, privateCacheNames, waitUntil } from "@serwist/core/internal";
-import type { Strategy } from "@serwist/strategies";
-import { parallel } from "@serwist/utils";
-
-import { PrecacheStrategy } from "./PrecacheStrategy.js";
-import type { CleanupResult, InstallResult, PrecacheEntry } from "./_types.js";
-import { PrecacheCacheKeyPlugin } from "./utils/PrecacheCacheKeyPlugin.js";
-import { PrecacheInstallReportPlugin } from "./utils/PrecacheInstallReportPlugin.js";
-import { createCacheKey } from "./utils/createCacheKey.js";
-import { printCleanupDetails } from "./utils/printCleanupDetails.js";
-import { printInstallDetails } from "./utils/printInstallDetails.js";
-
-// Give TypeScript the correct global.
-declare const self: ServiceWorkerGlobalScope;
-
-interface PrecacheControllerOptions {
-  /**
-   * The cache to use for precaching.
-   */
-  cacheName?: string;
-  /**
-   * Plugins to use when precaching as well as responding to fetch
-   * events for precached assets.
-   */
-  plugins?: SerwistPlugin[];
-  /**
-   * Whether to attempt to get the response from the network if there's
-   * a precache miss.
-   */
-  fallbackToNetwork?: boolean;
-  /**
-   * A number of how many precache requests should be made concurrently.
-   * By default, this value is set to 1, but this can be overriden by
-   * setting this option or `self.__WB_CONCURRENT_PRECACHING`. The former takes
-   * precedence over the latter.
-   */
-  concurrentPrecaching?: number;
-}
-
-/**
- * Performs efficient precaching of assets.
- */
-export class PrecacheController {
-  private _installAndActiveListenersAdded?: boolean;
-  private _concurrentPrecaching: number | undefined;
-  private readonly _strategy: Strategy;
-  private readonly _urlsToCacheKeys: Map<string, string> = new Map();
-  private readonly _urlsToCacheModes: Map<string, "reload" | "default" | "no-store" | "no-cache" | "force-cache" | "only-if-cached"> = new Map();
-  private readonly _cacheKeysToIntegrities: Map<string, string> = new Map();
-
-  /**
-   * Create a new PrecacheController.
-   *
-   * @param options
-   */
-  constructor({ cacheName, plugins = [], fallbackToNetwork = true, concurrentPrecaching }: PrecacheControllerOptions = {}) {
-    this._strategy = new PrecacheStrategy({
-      cacheName: privateCacheNames.getPrecacheName(cacheName),
-      plugins: [...plugins, new PrecacheCacheKeyPlugin({ precacheController: this })],
-      fallbackToNetwork,
-    });
-    this._concurrentPrecaching = concurrentPrecaching;
-
-    // Bind the install and activate methods to the instance.
-    this.install = this.install.bind(this);
-    this.activate = this.activate.bind(this);
-  }
-
-  /**
-   * The strategy created by this controller and
-   * used to cache assets and respond to fetch events.
-   */
-  get strategy(): Strategy {
-    return this._strategy;
-  }
-
-  /**
-   * Adds items to the precache list, removing any duplicates and
-   * stores the files in the precache cache when the service
-   * worker installs.
-   *
-   * This method can be called multiple times.
-   *
-   * @param entries Array of entries to precache.
-   */
-  precache(entries: (PrecacheEntry | string)[]): void {
-    this.addToCacheList(entries);
-
-    if (!this._installAndActiveListenersAdded) {
-      self.addEventListener("install", this.install);
-      self.addEventListener("activate", this.activate);
-      this._installAndActiveListenersAdded = true;
-    }
-  }
-
-  /**
-   * This method will add items to the precache list, removing duplicates
-   * and ensuring the information is valid.
-   *
-   * @param entries Array of entries to precache.
-   */
-  addToCacheList(entries: (PrecacheEntry | string)[]): void {
-    if (process.env.NODE_ENV !== "production") {
-      assert!.isArray(entries, {
-        moduleName: "@serwist/precaching",
-        className: "PrecacheController",
-        funcName: "addToCacheList",
-        paramName: "entries",
-      });
-    }
-
-    const urlsToWarnAbout: string[] = [];
-    for (const entry of entries) {
-      // See https://github.com/GoogleChrome/workbox/issues/2259
-      if (typeof entry === "string") {
-        urlsToWarnAbout.push(entry);
-      } else if (entry && !entry.integrity && entry.revision === undefined) {
-        urlsToWarnAbout.push(entry.url);
-      }
-
-      const { cacheKey, url } = createCacheKey(entry);
-      const cacheMode = typeof entry !== "string" && entry.revision ? "reload" : "default";
-
-      if (this._urlsToCacheKeys.has(url) && this._urlsToCacheKeys.get(url) !== cacheKey) {
-        throw new SerwistError("add-to-cache-list-conflicting-entries", {
-          firstEntry: this._urlsToCacheKeys.get(url),
-          secondEntry: cacheKey,
-        });
-      }
-
-      if (typeof entry !== "string" && entry.integrity) {
-        if (this._cacheKeysToIntegrities.has(cacheKey) && this._cacheKeysToIntegrities.get(cacheKey) !== entry.integrity) {
-          throw new SerwistError("add-to-cache-list-conflicting-integrities", {
-            url,
-          });
-        }
-        this._cacheKeysToIntegrities.set(cacheKey, entry.integrity);
-      }
-
-      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`;
-        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.
-          console.warn(warningMessage);
-        } else {
-          logger.warn(warningMessage);
-        }
-      }
-    }
-  }
-
-  /**
-   * Precaches new and updated assets. Call this method from the service worker
-   * install event.
-   *
-   * Note: this method calls `event.waitUntil()` for you, so you do not need
-   * to call it yourself in your event handlers.
-   *
-   * @param event
-   * @returns
-   */
-  install(event: ExtendableEvent): Promise<InstallResult> {
-    return waitUntil<InstallResult>(event, async () => {
-      const installReportPlugin = new PrecacheInstallReportPlugin();
-      this.strategy.plugins.push(installReportPlugin);
-
-      let concurrents = this._concurrentPrecaching;
-
-      if (concurrents === undefined) {
-        if (!("__WB_CONCURRENT_PRECACHING" in globalThis)) {
-          self.__WB_CONCURRENT_PRECACHING = 1;
-        }
-        concurrents = self.__WB_CONCURRENT_PRECACHING;
-      }
-
-      await parallel(concurrents, Array.from(this._urlsToCacheKeys.entries()), async ([url, cacheKey]): Promise<void> => {
-        const integrity = this._cacheKeysToIntegrities.get(cacheKey);
-        const cacheMode = this._urlsToCacheModes.get(url);
-
-        const request = new Request(url, {
-          integrity,
-          cache: cacheMode,
-          credentials: "same-origin",
-        });
-
-        await Promise.all(
-          this.strategy.handleAll({
-            event,
-            request,
-            url: new URL(request.url),
-            params: { cacheKey },
-          }),
-        );
-      });
-
-      const { updatedURLs, notUpdatedURLs } = installReportPlugin;
-
-      if (process.env.NODE_ENV !== "production") {
-        printInstallDetails(updatedURLs, notUpdatedURLs);
-      }
-
-      return { updatedURLs, notUpdatedURLs };
-    });
-  }
-
-  /**
-   * Deletes assets that are no longer present in the current precache manifest.
-   * Call this method from the service worker activate event.
-   *
-   * Note: this method calls `event.waitUntil()` for you, so you do not need
-   * to call it yourself in your event handlers.
-   *
-   * @param event
-   * @returns
-   */
-  activate(event: ExtendableEvent): Promise<CleanupResult> {
-    return waitUntil<CleanupResult>(event, async () => {
-      const cache = await self.caches.open(this.strategy.cacheName);
-      const currentlyCachedRequests = await cache.keys();
-      const expectedCacheKeys = new Set(this._urlsToCacheKeys.values());
-
-      const deletedCacheRequests: string[] = [];
-
-      for (const request of currentlyCachedRequests) {
-        if (!expectedCacheKeys.has(request.url)) {
-          await cache.delete(request);
-          deletedCacheRequests.push(request.url);
-        }
-      }
-
-      if (process.env.NODE_ENV !== "production") {
-        printCleanupDetails(deletedCacheRequests);
-      }
-
-      return { deletedCacheRequests };
-    });
-  }
-
-  /**
-   * Returns a mapping of a precached URL to the corresponding cache key, taking
-   * into account the revision information for the URL.
-   *
-   * @returns A URL to cache key mapping.
-   */
-  getURLsToCacheKeys(): Map<string, string> {
-    return this._urlsToCacheKeys;
-  }
-
-  /**
-   * Returns a list of all the URLs that have been precached by the current
-   * service worker.
-   *
-   * @returns The precached URLs.
-   */
-  getCachedURLs(): string[] {
-    return [...this._urlsToCacheKeys.keys()];
-  }
-
-  /**
-   * Returns the cache key used for storing a given URL. If that URL is
-   * unversioned, like `/index.html', then the cache key will be the original
-   * URL with a search parameter appended to it.
-   *
-   * @param url A URL whose cache key you want to look up.
-   * @returns The versioned URL that corresponds to a cache key
-   * for the original URL, or undefined if that URL isn't precached.
-   */
-  getCacheKeyForURL(url: string): string | undefined {
-    const urlObject = new URL(url, location.href);
-    return this._urlsToCacheKeys.get(urlObject.href);
-  }
-
-  /**
-   * @param url A cache key whose SRI you want to look up.
-   * @returns The subresource integrity associated with the cache key,
-   * or undefined if it's not set.
-   */
-  getIntegrityForCacheKey(cacheKey: string): string | undefined {
-    return this._cacheKeysToIntegrities.get(cacheKey);
-  }
-
-  /**
-   * This acts as a drop-in replacement for
-   * [`cache.match()`](https://developer.mozilla.org/en-US/docs/Web/API/Cache/match)
-   * with the following differences:
-   *
-   * - It knows what the name of the precache is, and only checks in that cache.
-   * - It allows you to pass in an "original" URL without versioning parameters,
-   * and it will automatically look up the correct cache key for the currently
-   * active revision of that URL.
-   *
-   * E.g., `matchPrecache('index.html')` will find the correct precached
-   * response for the currently active service worker, even if the actual cache
-   * key is `'/index.html?__WB_REVISION__=1234abcd'`.
-   *
-   * @param request The key (without revisioning parameters)
-   * to look up in the precache.
-   * @returns
-   */
-  async matchPrecache(request: string | Request): Promise<Response | undefined> {
-    const url = request instanceof Request ? request.url : request;
-    const cacheKey = this.getCacheKeyForURL(url);
-    if (cacheKey) {
-      const cache = await self.caches.open(this.strategy.cacheName);
-      return cache.match(cacheKey);
-    }
-    return undefined;
-  }
-
-  /**
-   * Returns a function that looks up `url` in the precache (taking into
-   * account revision information), and returns the corresponding `Response`.
-   *
-   * @param url The precached URL which will be used to lookup the response.
-   * @return
-   */
-  createHandlerBoundToURL(url: string): RouteHandlerCallback {
-    const cacheKey = this.getCacheKeyForURL(url);
-    if (!cacheKey) {
-      throw new SerwistError("non-precached-url", { url });
-    }
-    return (options) => {
-      options.request = new Request(url);
-      options.params = { cacheKey, ...options.params };
-
-      return this.strategy.handle(options);
-    };
-  }
-}

package/src/PrecacheFallbackPlugin.ts

@@ -1,86 +0,0 @@
-/*
-  Copyright 2020 Google LLC
-
-  Use of this source code is governed by an MIT-style
-  license that can be found in the LICENSE file or at
-  https://opensource.org/licenses/MIT.
-*/
-
-import type { HandlerDidErrorCallbackParam, SerwistPlugin } from "@serwist/core";
-
-import type { PrecacheController } from "./PrecacheController.js";
-import { getOrCreatePrecacheController } from "./utils/getOrCreatePrecacheController.js";
-
-export interface PrecacheFallbackEntry {
-  /**
-   * A function that checks whether the fallback entry can be used
-   * for a request.
-   */
-  matcher: (param: HandlerDidErrorCallbackParam) => boolean;
-  /**
-   * A precached URL to be used as a fallback.
-   */
-  url: string;
-}
-
-export interface PrecacheFallbackPluginOptions {
-  /**
-   * Precached URLs to use as the fallback
-   * if the associated strategy can't generate a response.
-   */
-  fallbackUrls: (string | PrecacheFallbackEntry)[];
-  /**
-   * An optional `PrecacheController` instance. If not provided, the default
-   * `PrecacheController` will be used.
-   */
-  precacheController?: PrecacheController;
-}
-
-/**
- * `PrecacheFallbackPlugin` allows you to specify offline fallbacks
- * 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.
- */
-export class PrecacheFallbackPlugin implements SerwistPlugin {
-  private readonly _fallbackUrls: (string | PrecacheFallbackEntry)[];
-  private readonly _precacheController: PrecacheController;
-
-  /**
-   * Constructs a new `PrecacheFallbackPlugin` with the associated `fallbackUrls`.
-   *
-   * @param config
-   */
-  constructor({ fallbackUrls, precacheController }: PrecacheFallbackPluginOptions) {
-    this._fallbackUrls = fallbackUrls;
-    this._precacheController = precacheController || getOrCreatePrecacheController();
-  }
-
-  /**
-   * @returns The precache response for one of the fallback URLs, or `undefined` if
-   * nothing satisfies the conditions.
-   * @private
-   */
-  async handlerDidError(param: HandlerDidErrorCallbackParam) {
-    for (const fallback of this._fallbackUrls) {
-      if (typeof fallback === "string") {
-        const fallbackResponse = await this._precacheController.matchPrecache(fallback);
-        if (fallbackResponse !== undefined) {
-          return fallbackResponse;
-        }
-      } else if (fallback.matcher(param)) {
-        const fallbackResponse = await this._precacheController.matchPrecache(fallback.url);
-        if (fallbackResponse !== undefined) {
-          return fallbackResponse;
-        }
-      }
-    }
-    return undefined;
-  }
-}

package/src/PrecacheRoute.ts

@@ -1,50 +0,0 @@
-/*
-  Copyright 2020 Google LLC
-
-  Use of this source code is governed by an MIT-style
-  license that can be found in the LICENSE file or at
-  https://opensource.org/licenses/MIT.
-*/
-
-import type { RouteMatchCallback, RouteMatchCallbackOptions } from "@serwist/core";
-import { getFriendlyURL, logger } from "@serwist/core/internal";
-import { Route } from "@serwist/routing";
-
-import type { PrecacheController } from "./PrecacheController.js";
-import type { PrecacheRouteOptions } from "./_types.js";
-import { generateURLVariations } from "./utils/generateURLVariations.js";
-
-/**
- * A subclass of `@serwist/routing.Route` that takes a
- * `@serwist/precaching.PrecacheController`
- * instance and uses it to match incoming requests and handle fetching
- * responses from the precache.
- */
-class PrecacheRoute extends Route {
-  /**
-   * @param precacheController A `PrecacheController`
-   * instance used to both match requests and respond to fetch events.
-   * @param options Options to control how requests are matched
-   * against the list of precached URLs.
-   */
-  constructor(precacheController: PrecacheController, options?: PrecacheRouteOptions) {
-    const match: RouteMatchCallback = ({ request }: RouteMatchCallbackOptions) => {
-      const urlsToCacheKeys = precacheController.getURLsToCacheKeys();
-      for (const possibleURL of generateURLVariations(request.url, options)) {
-        const cacheKey = urlsToCacheKeys.get(possibleURL);
-        if (cacheKey) {
-          const integrity = precacheController.getIntegrityForCacheKey(cacheKey);
-          return { cacheKey, integrity };
-        }
-      }
-      if (process.env.NODE_ENV !== "production") {
-        logger.debug(`Precaching did not find a match for ${getFriendlyURL(request.url)}`);
-      }
-      return;
-    };
-
-    super(match, precacheController.strategy);
-  }
-}
-
-export { PrecacheRoute };