@serwist/core 9.0.0-preview.0 → 9.0.0-preview.10

package/dist/_private/SerwistError.d.ts

@@ -1,3 +1,4 @@
+import type { MessageKey } from "../models/messages/messages.js";
 import type { MapLikeObject } from "../types.js";
 /**
  * Serwist errors should be thrown with this class.
@@ -18,7 +19,7 @@ declare class SerwistError extends Error {
      * that will help developers identify issues should
      * be added as a key on the context object.
      */
-    constructor(errorCode: string, details?: MapLikeObject);
+    constructor(errorCode: MessageKey, details?: MapLikeObject);
 }
 export { SerwistError };
 //# sourceMappingURL=SerwistError.d.ts.map

package/dist/_private/SerwistError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SerwistError.d.ts","sourceRoot":"","sources":["../../src/_private/SerwistError.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;;;;GAQG;AACH,cAAM,YAAa,SAAQ,KAAK;IAC9B,OAAO,CAAC,EAAE,aAAa,CAAC;IAExB;;;;;;;OAOG;gBACS,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa;CAQvD;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"SerwistError.d.ts","sourceRoot":"","sources":["../../src/_private/SerwistError.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;;;;GAQG;AACH,cAAM,YAAa,SAAQ,KAAK;IAC9B,OAAO,CAAC,EAAE,aAAa,CAAC;IAExB;;;;;;;OAOG;gBACS,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,aAAa;CAQ3D;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/_private/logger.d.ts

@@ -6,6 +6,19 @@ declare global {
         __WB_DISABLE_DEV_LOGS: boolean;
     }
 }
-declare const logger: Console;
-export { logger };
+/**
+ * The logger used by Serwist inside of both service workers and the window global scope.
+ *
+ * Note: This is forcibly `null` in production mode to reduce bundle size. Do check whether
+ * you are currently in development mode (by using `process.env.NODE_ENV !== "production"`)
+ * before using it.
+ */
+export declare const logger: {
+    error: (...args: any[]) => void;
+    debug: (...args: any[]) => void;
+    log: (...args: any[]) => void;
+    warn: (...args: any[]) => void;
+    groupCollapsed: (...args: any[]) => void;
+    groupEnd: (...args: any[]) => void;
+};
 //# sourceMappingURL=logger.d.ts.map

package/dist/_private/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/_private/logger.ts"],"names":[],"mappings":"AAQA,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,iBAAiB;QACzB,qBAAqB,EAAE,OAAO,CAAC;KAChC;IAED,UAAU,MAAM;QACd,qBAAqB,EAAE,OAAO,CAAC;KAChC;CACF;AAID,QAAA,MAAM,MAAM,SAqEA,CAAC;AAEb,OAAO,EAAE,MAAM,EAAE,CAAC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/_private/logger.ts"],"names":[],"mappings":"AAQA,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,iBAAiB;QACzB,qBAAqB,EAAE,OAAO,CAAC;KAChC;IAED,UAAU,MAAM;QACd,qBAAqB,EAAE,OAAO,CAAC;KAChC;CACF;AAED;;;;;;GAMG;AACH,eAAO,MAAM,MAAM;qBAmEoC,GAAG,EAAE,KAAK,IAAI;qBAAd,GAAG,EAAE,KAAK,IAAI;mBAAd,GAAG,EAAE,KAAK,IAAI;oBAAd,GAAG,EAAE,KAAK,IAAI;8BAAd,GAAG,EAAE,KAAK,IAAI;wBAAd,GAAG,EAAE,KAAK,IAAI;CAE3D,CAAC"}

package/dist/_private/waitUntil.d.ts

@@ -7,6 +7,5 @@
  * @returns
  * @private
  */
-declare function waitUntil(event: ExtendableEvent, asyncFn: () => Promise<any>): Promise<any>;
-export { waitUntil };
+export declare const waitUntil: <T = any>(event: ExtendableEvent, asyncFn: () => Promise<T>) => Promise<T>;
 //# sourceMappingURL=waitUntil.d.ts.map

package/dist/_private/waitUntil.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"waitUntil.d.ts","sourceRoot":"","sources":["../../src/_private/waitUntil.ts"],"names":[],"mappings":"AAOA;;;;;;;;GAQG;AACH,iBAAS,SAAS,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAIpF;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"waitUntil.d.ts","sourceRoot":"","sources":["../../src/_private/waitUntil.ts"],"names":[],"mappings":"AAOA;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,mBAAoB,eAAe,0CAIxD,CAAC"}

package/dist/chunks/quotaErrorCallbacks.js

@@ -1,10 +1,4 @@
-/*
-  Copyright 2018 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.
-*/ const _cacheNameDetails = {
+const _cacheNameDetails = {
     googleAnalytics: "googleAnalytics",
     precache: "precache-v2",
     prefix: "serwist",
@@ -49,13 +43,7 @@ const cacheNames = {
     }
 };
 
-/*
-  Copyright 2018 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.
-*/ const messages = {
+const messages = {
     "invalid-value": ({ paramName, validValueDescription, value })=>{
         if (!paramName || !validValueDescription) {
             throw new Error(`Unexpected input to 'invalid-value' error.`);
@@ -104,7 +92,7 @@ const cacheNames = {
         if (!thrownErrorMessage) {
             throw new Error("Unexpected input to " + `'plugin-error-request-will-fetch', error.`);
         }
-        return `An error was thrown by a plugins 'requestWillFetch()' method. The thrown error message was: '${thrownErrorMessage}'.`;
+        return `An error was thrown by a plugin's 'requestWillFetch()' method. The thrown error message was: '${thrownErrorMessage}'.`;
     },
     "invalid-cache-name": ({ cacheNameId, value })=>{
         if (!cacheNameId) {
@@ -234,24 +222,9 @@ const generatorFunction = (code, details = {})=>{
 };
 const messageGenerator = process.env.NODE_ENV === "production" ? fallback : generatorFunction;
 
-/**
- * Serwist errors should be thrown with this class.
- * This allows use to ensure the type easily in tests,
- * helps developers identify errors from Serwist
- * easily and allows use to optimise error
- * messages correctly.
- *
- * @private
- */ class SerwistError extends Error {
+class SerwistError extends Error {
     details;
-    /**
-   *
-   * @param errorCode The error code that
-   * identifies this particular error.
-   * @param details Any relevant arguments
-   * that will help developers identify issues should
-   * be added as a key on the context object.
-   */ constructor(errorCode, details){
+    constructor(errorCode, details){
         const message = messageGenerator(errorCode, details);
         super(message);
         this.name = errorCode;
@@ -259,21 +232,8 @@ const messageGenerator = process.env.NODE_ENV === "production" ? fallback : gene
     }
 }
 
-/*
-  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.
-*/ let supportStatus;
-/**
- * A utility function that determines whether the current browser supports
- * constructing a new `Response` from a `response.body` stream.
- *
- * @returns `true`, if the current browser can successfully construct
- * a `Response` from a `response.body` stream, `false` otherwise.
- * @private
- */ function canConstructResponseFromBodyStream() {
+let supportStatus;
+function canConstructResponseFromBodyStream() {
     if (supportStatus === undefined) {
         const testResponse = new Response("");
         if ("body" in testResponse) {
@@ -289,12 +249,7 @@ const messageGenerator = process.env.NODE_ENV === "production" ? fallback : gene
     return supportStatus;
 }
 
-/*
- * This method throws if the supplied value is not an array.
- * The destructed values are required to produce a meaningful error for users.
- * The destructed and restructured object is so it's clear what is
- * needed.
- */ const isArray = (value, details)=>{
+const isArray = (value, details)=>{
     if (!Array.isArray(value)) {
         throw new SerwistError("not-an-array", details);
     }
@@ -307,14 +262,12 @@ const hasMethod = (object, expectedMethod, details)=>{
     }
 };
 const isType = (object, expectedType, details)=>{
-    // biome-ignore lint/suspicious/useValidTypeof: Know to not make a mistake...
     if (typeof object !== expectedType) {
         details.expectedType = expectedType;
         throw new SerwistError("incorrect-type", details);
     }
 };
-const isInstance = (object, // biome-ignore lint/complexity/noBannedTypes: Need the general type to do the check later.
-expectedClass, details)=>{
+const isInstance = (object, expectedClass, details)=>{
     if (!(object instanceof expectedClass)) {
         details.expectedClassName = expectedClass.name;
         throw new SerwistError("incorrect-class", details);
@@ -326,8 +279,7 @@ const isOneOf = (value, validValues, details)=>{
         throw new SerwistError("invalid-value", details);
     }
 };
-const isArrayOfClass = (value, // biome-ignore lint/complexity/noBannedTypes: Need general type to do check later.
-expectedClass, details)=>{
+const isArrayOfClass = (value, expectedClass, details)=>{
     const error = new SerwistError("not-array-of-class", details);
     if (!Array.isArray(value)) {
         throw error;
@@ -347,15 +299,7 @@ const finalAssertExports = process.env.NODE_ENV === "production" ? null : {
     isArrayOfClass
 };
 
-/*
-  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.
-*/ // logger is used inside of both service workers and the window global scope.
 const logger = process.env.NODE_ENV === "production" ? null : (()=>{
-    // Don't overwrite this value if it's already set.
-    // See https://github.com/GoogleChrome/workbox/pull/2284#issuecomment-560470923
     if (!("__WB_DISABLE_DEV_LOGS" in globalThis)) {
         self.__WB_DISABLE_DEV_LOGS = false;
     }
@@ -373,8 +317,6 @@ const logger = process.env.NODE_ENV === "production" ? null : (()=>{
             return;
         }
         if (method === "groupCollapsed") {
-            // Safari doesn't print all console.groupCollapsed() arguments:
-            // https://bugs.webkit.org/show_bug.cgi?id=182754
             if (typeof navigator !== "undefined" && /^((?!chrome|android).)*safari/i.test(navigator.userAgent)) {
                 console[method](...args);
                 return;
@@ -387,7 +329,6 @@ const logger = process.env.NODE_ENV === "production" ? null : (()=>{
             "font-weight: bold",
             "padding: 2px 0.5em"
         ];
-        // When in a group, the serwist prefix is not displayed.
         const logPrefix = inGroup ? [] : [
             "%cserwist",
             styles.join(";")
@@ -400,26 +341,15 @@ const logger = process.env.NODE_ENV === "production" ? null : (()=>{
             inGroup = false;
         }
     };
-    // biome-ignore lint/complexity/noBannedTypes: Unknown reason
-    const api = {};
     const loggerMethods = Object.keys(methodToColorMap);
-    for (const key of loggerMethods){
-        const method = key;
+    return loggerMethods.reduce((api, method)=>{
         api[method] = (...args)=>{
             print(method, args);
         };
-    }
-    return api;
+        return api;
+    }, {});
 })();
 
-/*
-  Copyright 2018 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.
-*/ // Callbacks to be executed whenever there's a quota error.
-// biome-ignore lint/complexity/noBannedTypes: Can't change Function type right now.
 const quotaErrorCallbacks = new Set();
 
 export { SerwistError as S, canConstructResponseFromBodyStream as a, cacheNames as c, finalAssertExports as f, logger as l, quotaErrorCallbacks as q };

package/dist/clientsClaim.d.ts

@@ -1,5 +1,5 @@
 /**
- * Claim any currently available clients once the service worker
+ * Claims any currently available clients once the service worker
  * becomes active. This is normally used in conjunction with `skipWaiting()`.
  */
 declare function clientsClaim(): void;

package/dist/index.d.ts

@@ -8,5 +8,5 @@ import { setCacheNameDetails } from "./setCacheNameDetails.js";
  * setting default values that need to be shared (like cache names).
  */
 export { cacheNames, clientsClaim, copyResponse, registerQuotaErrorCallback, setCacheNameDetails };
-export * from "./types.js";
+export type * from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,CAAC;AAEnG,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,CAAC;AAEnG,mBAAmB,YAAY,CAAC"}

package/dist/index.internal.js

@@ -1,26 +1,11 @@
 import { l as logger, q as quotaErrorCallbacks } from './chunks/quotaErrorCallbacks.js';
 export { S as SerwistError, f as assert, a as canConstructResponseFromBodyStream, c as privateCacheNames } from './chunks/quotaErrorCallbacks.js';
 
-/*
-  Copyright 2018 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.
-*/ /**
- * The Deferred class composes Promises in a way that allows for them to be
- * resolved or rejected from outside the constructor. In most cases promises
- * should be used directly, but Deferreds can be necessary when the logic to
- * resolve a promise must be separate.
- *
- * @private
- */ class Deferred {
+class Deferred {
     promise;
     resolve;
     reject;
-    /**
-   * Creates a promise and exposes its resolve and reject functions as methods.
-   */ constructor(){
+    constructor(){
         this.promise = new Promise((resolve, reject)=>{
             this.resolve = resolve;
             this.reject = reject;
@@ -28,36 +13,18 @@ export { S as SerwistError, f as assert, a as canConstructResponseFromBodyStream
     }
 }
 
-/*
-  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.
-*/ function stripParams(fullURL, ignoreParams) {
+function stripParams(fullURL, ignoreParams) {
     const strippedURL = new URL(fullURL);
     for (const param of ignoreParams){
         strippedURL.searchParams.delete(param);
     }
     return strippedURL.href;
 }
-/**
- * Matches an item in the cache, ignoring specific URL params. This is similar
- * to the `ignoreSearch` option, but it allows you to ignore just specific
- * params (while continuing to match on the others).
- *
- * @private
- * @param cache
- * @param request
- * @param matchOptions
- * @param ignoreParams
- * @returns
- */ async function cacheMatchIgnoreParams(cache, request, ignoreParams, matchOptions) {
+async function cacheMatchIgnoreParams(cache, request, ignoreParams, matchOptions) {
     const strippedRequestURL = stripParams(request.url, ignoreParams);
-    // If the request doesn't include any ignored params, match as normal.
     if (request.url === strippedRequestURL) {
         return cache.match(request, matchOptions);
     }
-    // Otherwise, match by comparing keys
     const keysOptions = {
         ...matchOptions,
         ignoreSearch: true
@@ -72,24 +39,9 @@ export { S as SerwistError, f as assert, a as canConstructResponseFromBodyStream
     return;
 }
 
-/*
-  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.
-*/ let supportStatus;
-/**
- * A utility function that determines whether the current browser supports
- * constructing a [`ReadableStream`](https://developer.mozilla.org/en-US/docs/Web/API/ReadableStream/ReadableStream)
- * object.
- *
- * @returns `true`, if the current browser can successfully construct a `ReadableStream`, `false` otherwise.
- *
- * @private
- */ function canConstructReadableStream() {
+let supportStatus;
+function canConstructReadableStream() {
     if (supportStatus === undefined) {
-        // See https://github.com/GoogleChrome/workbox/issues/1473
         try {
             new ReadableStream({
                 start () {}
@@ -102,26 +54,11 @@ export { S as SerwistError, f as assert, a as canConstructResponseFromBodyStream
     return supportStatus;
 }
 
-/*
-  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.
-*/ /**
- * A helper function that prevents a promise from being flagged as unused.
- *
- * @private
- **/ function dontWaitFor(promise) {
-    // Effective no-op.
+function dontWaitFor(promise) {
     void promise.then(()=>{});
 }
 
-/**
- * Runs all of the callback functions, one at a time sequentially, in the order
- * in which they were registered.
- *
- * @private
- */ async function executeQuotaErrorCallbacks() {
+async function executeQuotaErrorCallbacks() {
     if (process.env.NODE_ENV !== "production") {
         logger.log(`About to run ${quotaErrorCallbacks.size} callbacks to clean up caches.`);
     }
@@ -136,46 +73,17 @@ export { S as SerwistError, f as assert, a as canConstructResponseFromBodyStream
     }
 }
 
-/*
-  Copyright 2018 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.
-*/ const getFriendlyURL = (url)=>{
+const getFriendlyURL = (url)=>{
     const urlObj = new URL(String(url), location.href);
-    // See https://github.com/GoogleChrome/workbox/issues/2323
-    // We want to include everything, except for the origin if it's same-origin.
     return urlObj.href.replace(new RegExp(`^${location.origin}`), "");
 };
 
-/*
-  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.
-*/ /**
- * Returns a promise that resolves and the passed number of milliseconds.
- * This utility is an async/await-friendly version of `setTimeout`.
- *
- * @param ms
- * @returns
- * @private
- */ function timeout(ms) {
+function timeout(ms) {
     return new Promise((resolve)=>setTimeout(resolve, ms));
 }
 
 const MAX_RETRY_TIME = 2000;
-/**
- * Returns a promise that resolves to a window client matching the passed
- * `resultingClientId`. For browsers that don't support `resultingClientId`
- * or if waiting for the resulting client to apper takes too long, resolve to
- * `undefined`.
- *
- * @param resultingClientId
- * @returns
- * @private
- */ async function resultingClientExists(resultingClientId) {
+async function resultingClientExists(resultingClientId) {
     if (!resultingClientId) {
         return;
     }
@@ -185,45 +93,28 @@ const MAX_RETRY_TIME = 2000;
     const existingWindowIds = new Set(existingWindows.map((w)=>w.id));
     let resultingWindow = undefined;
     const startTime = performance.now();
-    // Only wait up to `MAX_RETRY_TIME` to find a matching client.
     while(performance.now() - startTime < MAX_RETRY_TIME){
         existingWindows = await self.clients.matchAll({
             type: "window"
         });
         resultingWindow = existingWindows.find((w)=>{
             if (resultingClientId) {
-                // If we have a `resultingClientId`, we can match on that.
                 return w.id === resultingClientId;
             }
-            // Otherwise match on finding a window not in `existingWindowIds`.
             return !existingWindowIds.has(w.id);
         });
         if (resultingWindow) {
             break;
         }
-        // Sleep for 100ms and retry.
         await timeout(100);
     }
     return resultingWindow;
 }
 
-/*
-  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.
-*/ /**
- * A utility method that makes it easier to use `event.waitUntil` with
- * async functions and return the result.
- *
- * @param event
- * @param asyncFn
- * @returns
- * @private
- */ function waitUntil(event, asyncFn) {
+const waitUntil = (event, asyncFn)=>{
     const returnPromise = asyncFn();
     event.waitUntil(returnPromise);
     return returnPromise;
-}
+};
 
 export { Deferred, cacheMatchIgnoreParams, canConstructReadableStream, dontWaitFor, executeQuotaErrorCallbacks, getFriendlyURL, logger, resultingClientExists, timeout, waitUntil };

package/dist/index.js

@@ -1,17 +1,6 @@
 import { c as cacheNames$1, S as SerwistError, a as canConstructResponseFromBodyStream, f as finalAssertExports, q as quotaErrorCallbacks, l as logger } from './chunks/quotaErrorCallbacks.js';
 
-/**
- * Get the current cache names and prefix/suffix used by Workbox.
- *
- * `cacheNames.precache` is used for precached assets,
- * `cacheNames.googleAnalytics` is used by `@serwist/google-analytics` to
- * store `analytics.js`, and `cacheNames.runtime` is used for everything else.
- *
- * `cacheNames.prefix` can be used to retrieve just the current prefix value.
- * `cacheNames.suffix` can be used to retrieve just the current suffix value.
- *
- * @returns An object with `precache`, `runtime`, `prefix`, and `googleAnalytics` properties.
- */ const cacheNames = {
+const cacheNames = {
     get googleAnalytics () {
         return cacheNames$1.getGoogleAnalyticsName();
     },
@@ -29,40 +18,12 @@ import { c as cacheNames$1, S as SerwistError, a as canConstructResponseFromBody
     }
 };
 
-/*
-  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.
-*/ // Give TypeScript the correct global.
-/**
- * Claim any currently available clients once the service worker
- * becomes active. This is normally used in conjunction with `skipWaiting()`.
- */ function clientsClaim() {
+function clientsClaim() {
     self.addEventListener("activate", ()=>self.clients.claim());
 }
 
-/**
- * Allows developers to copy a response and modify its `headers`, `status`,
- * or `statusText` values (the values settable via a
- * [`ResponseInit`](https://developer.mozilla.org/en-US/docs/Web/API/Response/Response#Syntax)
- * object in the constructor).
- * To modify these values, pass a function as the second argument. That
- * function will be invoked with a single object with the response properties
- * `{headers, status, statusText}`. The return value of this function will
- * be used as the `ResponseInit` for the new `Response`. To change the values
- * either modify the passed parameter(s) and return it, or return a totally
- * new object.
- *
- * This method is intentionally limited to same-origin responses, regardless of
- * whether CORS was used or not.
- *
- * @param response
- * @param modifier
- */ async function copyResponse(response, modifier) {
+async function copyResponse(response, modifier) {
     let origin = null;
-    // If response.url isn't set, assume it's cross-origin and keep origin null.
     if (response.url) {
         const responseURL = new URL(response.url);
         origin = responseURL.origin;
@@ -73,27 +34,16 @@ import { c as cacheNames$1, S as SerwistError, a as canConstructResponseFromBody
         });
     }
     const clonedResponse = response.clone();
-    // Create a fresh `ResponseInit` object by cloning the headers.
     const responseInit = {
         headers: new Headers(clonedResponse.headers),
         status: clonedResponse.status,
         statusText: clonedResponse.statusText
     };
-    // Apply any user modifications.
     const modifiedResponseInit = modifier ? modifier(responseInit) : responseInit;
-    // Create the new response from the body stream and `ResponseInit`
-    // modifications. Note: not all browsers support the Response.body stream,
-    // so fall back to reading the entire body into memory as a blob.
     const body = canConstructResponseFromBodyStream() ? clonedResponse.body : await clonedResponse.blob();
     return new Response(body, modifiedResponseInit);
 }
 
-/**
- * Adds a function to the set of quotaErrorCallbacks that will be executed if
- * there's a quota error.
- *
- * @param callback
- */ // biome-ignore lint/complexity/noBannedTypes: Can't change Function type
 function registerQuotaErrorCallback(callback) {
     if (process.env.NODE_ENV !== "production") {
         finalAssertExports.isType(callback, "function", {
@@ -108,12 +58,7 @@ function registerQuotaErrorCallback(callback) {
     }
 }
 
-/**
- * Modifies the default cache names used by the Serwist packages.
- * Cache names are generated as `<prefix>-<Cache Name>-<suffix>`.
- *
- * @param details
- */ function setCacheNameDetails(details) {
+function setCacheNameDetails(details) {
     if (process.env.NODE_ENV !== "production") {
         for (const key of Object.keys(details)){
             finalAssertExports.isType(details[key], "string", {

package/dist/models/messages/messageGenerator.d.ts

@@ -1,2 +1,4 @@
-export declare const messageGenerator: ((code: string, ...args: any[]) => string) | ((code: string, details?: {}) => string);
+import type { MapLikeObject } from "../../types.js";
+import { type MessageKey } from "./messages.js";
+export declare const messageGenerator: ((code: string, ...args: any[]) => string) | ((code: MessageKey, details?: MapLikeObject) => string);
 //# sourceMappingURL=messageGenerator.d.ts.map

package/dist/models/messages/messageGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messageGenerator.d.ts","sourceRoot":"","sources":["../../../src/models/messages/messageGenerator.ts"],"names":[],"mappings":"AA2BA,eAAO,MAAM,gBAAgB,UAjBL,MAAM,WAAW,GAAG,EAAE,uBAQb,MAAM,0BAS6D,CAAC"}
+{"version":3,"file":"messageGenerator.d.ts","sourceRoot":"","sources":["../../../src/models/messages/messageGenerator.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,KAAK,UAAU,EAAY,MAAM,eAAe,CAAC;AAmB1D,eAAO,MAAM,gBAAgB,UAjBL,MAAM,WAAW,GAAG,EAAE,uBAQb,UAAU,YAAW,aAAa,YASiC,CAAC"}

package/dist/models/messages/messages.d.ts

@@ -1,9 +1,44 @@
 interface LoggableObject {
     [key: string]: string | number;
 }
-interface MessageMap {
-    [messageID: string]: (param: LoggableObject) => string;
-}
-export declare const messages: MessageMap;
+export declare const messages: {
+    "invalid-value": ({ paramName, validValueDescription, value }: LoggableObject) => string;
+    "not-an-array": ({ moduleName, className, funcName, paramName }: LoggableObject) => string;
+    "incorrect-type": ({ expectedType, paramName, moduleName, className, funcName }: LoggableObject) => string;
+    "incorrect-class": ({ expectedClassName, paramName, moduleName, className, funcName, isReturnValueProblem }: LoggableObject) => string;
+    "missing-a-method": ({ expectedMethod, paramName, moduleName, className, funcName }: LoggableObject) => string;
+    "add-to-cache-list-unexpected-type": ({ entry }: LoggableObject) => string;
+    "add-to-cache-list-conflicting-entries": ({ firstEntry, secondEntry }: LoggableObject) => string;
+    "plugin-error-request-will-fetch": ({ thrownErrorMessage }: LoggableObject) => string;
+    "invalid-cache-name": ({ cacheNameId, value }: LoggableObject) => string;
+    "unregister-route-but-not-found-with-method": ({ method }: LoggableObject) => string;
+    "unregister-route-route-not-registered": () => string;
+    "queue-replay-failed": ({ name }: LoggableObject) => string;
+    "duplicate-queue-name": ({ name }: LoggableObject) => string;
+    "expired-test-without-max-age": ({ methodName, paramName }: LoggableObject) => string;
+    "unsupported-route-type": ({ moduleName, className, funcName, paramName }: LoggableObject) => string;
+    "not-array-of-class": ({ value, expectedClass, moduleName, className, funcName, paramName }: LoggableObject) => string;
+    "max-entries-or-age-required": ({ moduleName, className, funcName }: LoggableObject) => string;
+    "statuses-or-headers-required": ({ moduleName, className, funcName }: LoggableObject) => string;
+    "invalid-string": ({ moduleName, funcName, paramName }: LoggableObject) => string;
+    "channel-name-required": () => string;
+    "invalid-responses-are-same-args": () => string;
+    "expire-custom-caches-only": () => string;
+    "unit-must-be-bytes": ({ normalizedRangeHeader }: LoggableObject) => string;
+    "single-range-only": ({ normalizedRangeHeader }: LoggableObject) => string;
+    "invalid-range-values": ({ normalizedRangeHeader }: LoggableObject) => string;
+    "no-range-header": () => string;
+    "range-not-satisfiable": ({ size, start, end }: LoggableObject) => string;
+    "attempt-to-cache-non-get-request": ({ url, method }: LoggableObject) => string;
+    "cache-put-with-no-response": ({ url }: LoggableObject) => string;
+    "no-response": ({ url, error }: LoggableObject) => string;
+    "bad-precaching-response": ({ url, status }: LoggableObject) => string;
+    "non-precached-url": ({ url }: LoggableObject) => string;
+    "add-to-cache-list-conflicting-integrities": ({ url }: LoggableObject) => string;
+    "missing-precache-entry": ({ cacheName, url }: LoggableObject) => string;
+    "cross-origin-copy-response": ({ origin }: LoggableObject) => string;
+    "opaque-streams-source": ({ type }: LoggableObject) => string;
+};
+export type MessageKey = keyof typeof messages;
 export {};
 //# sourceMappingURL=messages.d.ts.map

package/dist/models/messages/messages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../../src/models/messages/messages.ts"],"names":[],"mappings":"AAQA,UAAU,cAAc;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;CAChC;AACD,UAAU,UAAU;IAClB,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,MAAM,CAAC;CACxD;AAED,eAAO,MAAM,QAAQ,EAAE,UAuNtB,CAAC"}
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../../src/models/messages/messages.ts"],"names":[],"mappings":"AAQA,UAAU,cAAc;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;CAChC;AAKD,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuNC,CAAC;AAEvB,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,QAAQ,CAAC"}

package/dist/setCacheNameDetails.d.ts

@@ -1,6 +1,6 @@
 import type { PartialCacheNameDetails } from "./_private/cacheNames.js";
 /**
- * Modifies the default cache names used by the Serwist packages.
+ * Modifies the default cache names used by Serwist packages.
  * Cache names are generated as `<prefix>-<Cache Name>-<suffix>`.
  *
  * @param details

package/dist/types.d.ts

@@ -1,3 +1,4 @@
+export type PromiseOrNot<T> = T | Promise<T>;
 export interface MapLikeObject {
     [key: string]: any;
 }
@@ -131,7 +132,7 @@ export interface CacheDidUpdateCallbackParam {
     state?: PluginState;
 }
 export interface CacheDidUpdateCallback {
-    (param: CacheDidUpdateCallbackParam): Promise<any>;
+    (param: CacheDidUpdateCallbackParam): PromiseOrNot<any>;
 }
 export interface CacheKeyWillBeUsedCallbackParam {
     mode: string;
@@ -141,7 +142,7 @@ export interface CacheKeyWillBeUsedCallbackParam {
     state?: PluginState;
 }
 export interface CacheKeyWillBeUsedCallback {
-    (param: CacheKeyWillBeUsedCallbackParam): Promise<Request | string>;
+    (param: CacheKeyWillBeUsedCallbackParam): PromiseOrNot<Request | string>;
 }
 export interface CacheWillUpdateCallbackParam {
     request: Request;
@@ -150,7 +151,7 @@ export interface CacheWillUpdateCallbackParam {
     state?: PluginState;
 }
 export interface CacheWillUpdateCallback {
-    (param: CacheWillUpdateCallbackParam): Promise<any>;
+    (param: CacheWillUpdateCallbackParam): PromiseOrNot<any>;
 }
 export interface CachedResponseWillBeUsedCallbackParam {
     /**
@@ -172,7 +173,7 @@ export interface CachedResponseWillBeUsedCallbackParam {
     state?: PluginState;
 }
 export interface CachedResponseWillBeUsedCallback {
-    (param: CachedResponseWillBeUsedCallbackParam): Promise<any>;
+    (param: CachedResponseWillBeUsedCallbackParam): PromiseOrNot<any>;
 }
 export interface FetchDidFailCallbackParam {
     error: Error;
@@ -182,7 +183,7 @@ export interface FetchDidFailCallbackParam {
     state?: PluginState;
 }
 export interface FetchDidFailCallback {
-    (param: FetchDidFailCallbackParam): Promise<any>;
+    (param: FetchDidFailCallbackParam): PromiseOrNot<any>;
 }
 export interface FetchDidSucceedCallbackParam {
     request: Request;
@@ -191,7 +192,7 @@ export interface FetchDidSucceedCallbackParam {
     state?: PluginState;
 }
 export interface FetchDidSucceedCallback {
-    (param: FetchDidSucceedCallbackParam): Promise<Response>;
+    (param: FetchDidSucceedCallbackParam): PromiseOrNot<Response>;
 }
 export interface RequestWillFetchCallbackParam {
     request: Request;
@@ -199,7 +200,7 @@ export interface RequestWillFetchCallbackParam {
     state?: PluginState;
 }
 export interface RequestWillFetchCallback {
-    (param: RequestWillFetchCallbackParam): Promise<Request>;
+    (param: RequestWillFetchCallbackParam): PromiseOrNot<Request>;
 }
 export interface HandlerWillRespondCallbackParam {
     request: Request;
@@ -208,7 +209,7 @@ export interface HandlerWillRespondCallbackParam {
     state?: PluginState;
 }
 export interface HandlerWillRespondCallback {
-    (param: HandlerWillRespondCallbackParam): Promise<Response>;
+    (param: HandlerWillRespondCallbackParam): PromiseOrNot<Response>;
 }
 export interface HandlerDidErrorCallbackParam {
     request: Request;
@@ -217,7 +218,7 @@ export interface HandlerDidErrorCallbackParam {
     state?: PluginState;
 }
 export interface HandlerDidErrorCallback {
-    (param: HandlerDidErrorCallbackParam): Promise<Response | undefined>;
+    (param: HandlerDidErrorCallbackParam): PromiseOrNot<Response | undefined>;
 }
 export interface HandlerDidRespondCallbackParam {
     request: Request;
@@ -226,7 +227,7 @@ export interface HandlerDidRespondCallbackParam {
     state?: PluginState;
 }
 export interface HandlerDidRespondCallback {
-    (param: HandlerDidRespondCallbackParam): Promise<any>;
+    (param: HandlerDidRespondCallbackParam): PromiseOrNot<any>;
 }
 export interface HandlerDidCompleteCallbackParam {
     request: Request;
@@ -236,7 +237,7 @@ export interface HandlerDidCompleteCallbackParam {
     state?: PluginState;
 }
 export interface HandlerDidCompleteCallback {
-    (param: HandlerDidCompleteCallbackParam): Promise<any>;
+    (param: HandlerDidCompleteCallbackParam): PromiseOrNot<any>;
 }
 /**
  * An object with optional lifecycle callback properties for the fetch and
@@ -270,4 +271,9 @@ export interface SerwistPluginCallbackParam {
     handlerWillStart: HandlerWillStartCallbackParam;
     requestWillFetch: RequestWillFetchCallbackParam;
 }
+export interface SerwistGlobalConfig {
+    __WB_DISABLE_DEV_LOGS: boolean;
+    __WB_FORCE_RUNTIME_CACHING: boolean;
+    __WB_CONCURRENT_PRECACHING: number;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serwist/core",
-  "version": "9.0.0-preview.0",
+  "version": "9.0.0-preview.10",
   "type": "module",
   "description": "This module is used by a number of the other Serwist modules to share common code.",
   "files": [
@@ -39,8 +39,8 @@
   },
   "devDependencies": {
     "rollup": "4.9.6",
-    "typescript": "5.4.0-dev.20240203",
-    "@serwist/constants": "9.0.0-preview.0"
+    "typescript": "5.4.0-dev.20240206",
+    "@serwist/constants": "9.0.0-preview.10"
   },
   "peerDependencies": {
     "typescript": ">=5.0.0"

package/src/_private/SerwistError.ts

@@ -7,6 +7,7 @@
 */
 
 import { messageGenerator } from "../models/messages/messageGenerator.js";
+import type { MessageKey } from "../models/messages/messages.js";
 import type { MapLikeObject } from "../types.js";
 
 /**
@@ -29,7 +30,7 @@ class SerwistError extends Error {
    * that will help developers identify issues should
    * be added as a key on the context object.
    */
-  constructor(errorCode: string, details?: MapLikeObject) {
+  constructor(errorCode: MessageKey, details?: MapLikeObject) {
     const message = messageGenerator(errorCode, details);
 
     super(message);

package/src/_private/logger.ts

@@ -16,11 +16,16 @@ declare global {
   }
 }
 
-type LoggerMethods = "debug" | "log" | "warn" | "error" | "groupCollapsed" | "groupEnd";
-
-const logger = (
+/**
+ * The logger used by Serwist inside of both service workers and the window global scope.
+ *
+ * Note: This is forcibly `null` in production mode to reduce bundle size. Do check whether
+ * you are currently in development mode (by using `process.env.NODE_ENV !== "production"`)
+ * before using it.
+ */
+export const logger =
   process.env.NODE_ENV === "production"
-    ? null
+    ? null!
     : (() => {
         // Don't overwrite this value if it's already set.
         // See https://github.com/GoogleChrome/workbox/pull/2284#issuecomment-560470923
@@ -30,7 +35,7 @@ const logger = (
 
         let inGroup = false;
 
-        const methodToColorMap: { [methodName: string]: string | null } = {
+        const methodToColorMap = {
           debug: "#7f8c8d", // Gray
           log: "#2ecc71", // Green
           warn: "#f39c12", // Yellow
@@ -39,6 +44,8 @@ const logger = (
           groupEnd: null, // No colored prefix on groupEnd
         };
 
+        type LoggerMethods = keyof typeof methodToColorMap;
+
         const print = (method: LoggerMethods, args: any[]) => {
           if (self.__WB_DISABLE_DEV_LOGS) {
             return;
@@ -73,20 +80,16 @@ const logger = (
             inGroup = false;
           }
         };
-        // biome-ignore lint/complexity/noBannedTypes: Unknown reason
-        const api: { [methodName: string]: Function } = {};
-        const loggerMethods = Object.keys(methodToColorMap);
-
-        for (const key of loggerMethods) {
-          const method = key as LoggerMethods;
-
-          api[method] = (...args: any[]) => {
-            print(method, args);
-          };
-        }
-
-        return api as unknown;
-      })()
-) as Console;
 
-export { logger };
+        const loggerMethods = Object.keys(methodToColorMap) as LoggerMethods[];
+
+        return loggerMethods.reduce(
+          (api, method) => {
+            api[method] = (...args: any[]) => {
+              print(method, args);
+            };
+            return api;
+          },
+          {} as { [method in LoggerMethods]: (...args: any[]) => void },
+        );
+      })();

package/src/_private/waitUntil.ts

@@ -14,10 +14,8 @@
  * @returns
  * @private
  */
-function waitUntil(event: ExtendableEvent, asyncFn: () => Promise<any>): Promise<any> {
+export const waitUntil = <T = any>(event: ExtendableEvent, asyncFn: () => Promise<T>): Promise<T> => {
   const returnPromise = asyncFn();
   event.waitUntil(returnPromise);
   return returnPromise;
-}
-
-export { waitUntil };
+};

package/src/clientsClaim.ts

@@ -10,7 +10,7 @@
 declare let self: ServiceWorkerGlobalScope;
 
 /**
- * Claim any currently available clients once the service worker
+ * Claims any currently available clients once the service worker
  * becomes active. This is normally used in conjunction with `skipWaiting()`.
  */
 function clientsClaim(): void {

package/src/index.ts

@@ -17,4 +17,4 @@ import { setCacheNameDetails } from "./setCacheNameDetails.js";
  */
 export { cacheNames, clientsClaim, copyResponse, registerQuotaErrorCallback, setCacheNameDetails };
 
-export * from "./types.js";
+export type * from "./types.js";

package/src/models/messages/messageGenerator.ts

@@ -6,7 +6,8 @@
   https://opensource.org/licenses/MIT.
 */
 
-import { messages } from "./messages.js";
+import type { MapLikeObject } from "../../types.js";
+import { type MessageKey, messages } from "./messages.js";
 
 const fallback = (code: string, ...args: any[]) => {
   let msg = code;
@@ -16,7 +17,7 @@ const fallback = (code: string, ...args: any[]) => {
   return msg;
 };
 
-const generatorFunction = (code: string, details = {}) => {
+const generatorFunction = (code: MessageKey, details: MapLikeObject = {}) => {
   const message = messages[code];
   if (!message) {
     throw new Error(`Unable to find message for code '${code}'.`);

package/src/models/messages/messages.ts

@@ -13,7 +13,7 @@ interface MessageMap {
   [messageID: string]: (param: LoggableObject) => string;
 }
 
-export const messages: MessageMap = {
+export const messages = {
   "invalid-value": ({ paramName, validValueDescription, value }) => {
     if (!paramName || !validValueDescription) {
       throw new Error(`Unexpected input to 'invalid-value' error.`);
@@ -82,7 +82,7 @@ export const messages: MessageMap = {
       throw new Error("Unexpected input to " + `'plugin-error-request-will-fetch', error.`);
     }
 
-    return `An error was thrown by a plugins 'requestWillFetch()' method. The thrown error message was: '${thrownErrorMessage}'.`;
+    return `An error was thrown by a plugin's 'requestWillFetch()' method. The thrown error message was: '${thrownErrorMessage}'.`;
   },
 
   "invalid-cache-name": ({ cacheNameId, value }) => {
@@ -228,4 +228,6 @@ export const messages: MessageMap = {
     }
     return `${message} Please ensure your sources are CORS-enabled.`;
   },
-};
+} satisfies MessageMap;
+
+export type MessageKey = keyof typeof messages;

package/src/setCacheNameDetails.ts

@@ -12,7 +12,7 @@ import type { PartialCacheNameDetails } from "./_private/cacheNames.js";
 import { cacheNames } from "./_private/cacheNames.js";
 
 /**
- * Modifies the default cache names used by the Serwist packages.
+ * Modifies the default cache names used by Serwist packages.
  * Cache names are generated as `<prefix>-<Cache Name>-<suffix>`.
  *
  * @param details

package/src/types.ts

@@ -5,6 +5,7 @@
   license that can be found in the LICENSE file or at
   https://opensource.org/licenses/MIT.
 */
+export type PromiseOrNot<T> = T | Promise<T>;
 
 export interface MapLikeObject {
   [key: string]: any;
@@ -152,7 +153,7 @@ export interface CacheDidUpdateCallbackParam {
 }
 
 export interface CacheDidUpdateCallback {
-  (param: CacheDidUpdateCallbackParam): Promise<any>;
+  (param: CacheDidUpdateCallbackParam): PromiseOrNot<any>;
 }
 
 export interface CacheKeyWillBeUsedCallbackParam {
@@ -164,7 +165,7 @@ export interface CacheKeyWillBeUsedCallbackParam {
 }
 
 export interface CacheKeyWillBeUsedCallback {
-  (param: CacheKeyWillBeUsedCallbackParam): Promise<Request | string>;
+  (param: CacheKeyWillBeUsedCallbackParam): PromiseOrNot<Request | string>;
 }
 
 export interface CacheWillUpdateCallbackParam {
@@ -175,7 +176,7 @@ export interface CacheWillUpdateCallbackParam {
 }
 
 export interface CacheWillUpdateCallback {
-  (param: CacheWillUpdateCallbackParam): Promise<any>;
+  (param: CacheWillUpdateCallbackParam): PromiseOrNot<any>;
 }
 
 export interface CachedResponseWillBeUsedCallbackParam {
@@ -199,7 +200,7 @@ export interface CachedResponseWillBeUsedCallbackParam {
 }
 
 export interface CachedResponseWillBeUsedCallback {
-  (param: CachedResponseWillBeUsedCallbackParam): Promise<any>;
+  (param: CachedResponseWillBeUsedCallbackParam): PromiseOrNot<any>;
 }
 
 export interface FetchDidFailCallbackParam {
@@ -211,7 +212,7 @@ export interface FetchDidFailCallbackParam {
 }
 
 export interface FetchDidFailCallback {
-  (param: FetchDidFailCallbackParam): Promise<any>;
+  (param: FetchDidFailCallbackParam): PromiseOrNot<any>;
 }
 
 export interface FetchDidSucceedCallbackParam {
@@ -222,7 +223,7 @@ export interface FetchDidSucceedCallbackParam {
 }
 
 export interface FetchDidSucceedCallback {
-  (param: FetchDidSucceedCallbackParam): Promise<Response>;
+  (param: FetchDidSucceedCallbackParam): PromiseOrNot<Response>;
 }
 
 export interface RequestWillFetchCallbackParam {
@@ -232,7 +233,7 @@ export interface RequestWillFetchCallbackParam {
 }
 
 export interface RequestWillFetchCallback {
-  (param: RequestWillFetchCallbackParam): Promise<Request>;
+  (param: RequestWillFetchCallbackParam): PromiseOrNot<Request>;
 }
 
 export interface HandlerWillRespondCallbackParam {
@@ -243,7 +244,7 @@ export interface HandlerWillRespondCallbackParam {
 }
 
 export interface HandlerWillRespondCallback {
-  (param: HandlerWillRespondCallbackParam): Promise<Response>;
+  (param: HandlerWillRespondCallbackParam): PromiseOrNot<Response>;
 }
 
 export interface HandlerDidErrorCallbackParam {
@@ -254,7 +255,7 @@ export interface HandlerDidErrorCallbackParam {
 }
 
 export interface HandlerDidErrorCallback {
-  (param: HandlerDidErrorCallbackParam): Promise<Response | undefined>;
+  (param: HandlerDidErrorCallbackParam): PromiseOrNot<Response | undefined>;
 }
 
 export interface HandlerDidRespondCallbackParam {
@@ -265,7 +266,7 @@ export interface HandlerDidRespondCallbackParam {
 }
 
 export interface HandlerDidRespondCallback {
-  (param: HandlerDidRespondCallbackParam): Promise<any>;
+  (param: HandlerDidRespondCallbackParam): PromiseOrNot<any>;
 }
 
 export interface HandlerDidCompleteCallbackParam {
@@ -277,7 +278,7 @@ export interface HandlerDidCompleteCallbackParam {
 }
 
 export interface HandlerDidCompleteCallback {
-  (param: HandlerDidCompleteCallbackParam): Promise<any>;
+  (param: HandlerDidCompleteCallbackParam): PromiseOrNot<any>;
 }
 
 /**
@@ -313,3 +314,9 @@ export interface SerwistPluginCallbackParam {
   handlerWillStart: HandlerWillStartCallbackParam;
   requestWillFetch: RequestWillFetchCallbackParam;
 }
+
+export interface SerwistGlobalConfig {
+  __WB_DISABLE_DEV_LOGS: boolean;
+  __WB_FORCE_RUNTIME_CACHING: boolean;
+  __WB_CONCURRENT_PRECACHING: number;
+}