@serwist/core 9.0.0-preview.2 → 9.0.0-preview.21

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.
@@ -8,7 +9,7 @@ import type { MapLikeObject } from "../types.js";
  *
  * @private
  */
-declare class SerwistError extends Error {
+export declare class SerwistError extends Error {
     details?: MapLikeObject;
     /**
      *
@@ -18,7 +19,6 @@ 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,qBAAa,YAAa,SAAQ,KAAK;IACrC,OAAO,CAAC,EAAE,aAAa,CAAC;IAExB;;;;;;;OAOG;gBACS,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,aAAa;CAQ3D"}

package/dist/_private/dontWaitFor.d.ts

@@ -2,6 +2,6 @@
  * A helper function that prevents a promise from being flagged as unused.
  *
  * @private
- **/
+ */
 export declare function dontWaitFor(promise: Promise<any>): void;
 //# sourceMappingURL=dontWaitFor.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"dontWaitFor.d.ts","sourceRoot":"","sources":["../../src/_private/dontWaitFor.ts"],"names":[],"mappings":"AAOA;;;;IAII;AACJ,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAGvD"}
+{"version":3,"file":"dontWaitFor.d.ts","sourceRoot":"","sources":["../../src/_private/dontWaitFor.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAGvD"}

package/dist/_private/executeQuotaErrorCallbacks.d.ts

@@ -4,6 +4,5 @@
  *
  * @private
  */
-declare function executeQuotaErrorCallbacks(): Promise<void>;
-export { executeQuotaErrorCallbacks };
+export declare const executeQuotaErrorCallbacks: () => Promise<void>;
 //# sourceMappingURL=executeQuotaErrorCallbacks.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"executeQuotaErrorCallbacks.d.ts","sourceRoot":"","sources":["../../src/_private/executeQuotaErrorCallbacks.ts"],"names":[],"mappings":"AAWA;;;;;GAKG;AACH,iBAAe,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC,CAezD;AAED,OAAO,EAAE,0BAA0B,EAAE,CAAC"}
+{"version":3,"file":"executeQuotaErrorCallbacks.d.ts","sourceRoot":"","sources":["../../src/_private/executeQuotaErrorCallbacks.ts"],"names":[],"mappings":"AAWA;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,QAAa,QAAQ,IAAI,CAe/D,CAAC"}

package/dist/_private/logger.d.ts

@@ -6,6 +6,13 @@ declare global {
         __WB_DISABLE_DEV_LOGS: boolean;
     }
 }
+/**
+ * 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;

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;AAED,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"}
+{"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,WAAW,MAAM,QAAQ,CAAC,CAAC,KAAG,QAAQ,CAAC,CAI/F,CAAC"}

package/dist/cacheNames.d.ts

@@ -1,5 +1,5 @@
 /**
- * Get the current cache names and prefix/suffix used by Workbox.
+ * Get the current cache names and prefix/suffix used by Serwist.
  *
  * `cacheNames.precache` is used for precached assets,
  * `cacheNames.googleAnalytics` is used by `@serwist/google-analytics` to
@@ -10,12 +10,11 @@
  *
  * @returns An object with `precache`, `runtime`, `prefix`, and `googleAnalytics` properties.
  */
-declare const cacheNames: {
+export declare const cacheNames: {
     readonly googleAnalytics: string;
     readonly precache: string;
     readonly prefix: string;
     readonly runtime: string;
     readonly suffix: string;
 };
-export { cacheNames };
 //# sourceMappingURL=cacheNames.d.ts.map

package/dist/cacheNames.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cacheNames.d.ts","sourceRoot":"","sources":["../src/cacheNames.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;GAWG;AACH,QAAA,MAAM,UAAU;;;;;;CAgBf,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"cacheNames.d.ts","sourceRoot":"","sources":["../src/cacheNames.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,UAAU;;;;;;CAgBtB,CAAC"}

package/dist/chunks/quotaErrorCallbacks.js

@@ -92,7 +92,7 @@ const messages = {
         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) {
@@ -125,10 +125,10 @@ const messages = {
         return `The supplied '${paramName}' parameter must be an array of '${expectedClass}' objects. Received '${JSON.stringify(value)},'. Please check the call to ${moduleName}.${className}.${funcName}() to fix the issue.`;
     },
     "max-entries-or-age-required": ({ moduleName, className, funcName })=>{
-        return `You must define either config.maxEntries or config.maxAgeSecondsin ${moduleName}.${className}.${funcName}`;
+        return `You must define either 'config.maxEntries' or 'config.maxAgeSeconds' in '${moduleName}.${className}.${funcName}'`;
     },
     "statuses-or-headers-required": ({ moduleName, className, funcName })=>{
-        return `You must define either config.statuses or config.headersin ${moduleName}.${className}.${funcName}`;
+        return `You must define either 'config.statuses' or 'config.headers' in '${moduleName}.${className}.${funcName}'`;
     },
     "invalid-string": ({ moduleName, funcName, paramName })=>{
         if (!paramName || !moduleName || !funcName) {
@@ -186,7 +186,7 @@ const messages = {
         return `The precaching request for '${url}' failed${status ? ` with an HTTP status of ${status}.` : "."}`;
     },
     "non-precached-url": ({ url })=>{
-        return `createHandlerBoundToURL('${url}') was called, but that URL is not precached. Please pass in a URL that is precached instead.`;
+        return `'createHandlerBoundToURL("${url}")' was called, but that URL is not precached. Please pass in a URL that is precached instead.`;
     },
     "add-to-cache-list-conflicting-integrities": ({ url })=>{
         return `Two of the entries passed to '@serwist/precaching.PrecacheController.addToCacheList()' had the URL ${url} with different integrity values. Please remove one of them.`;
@@ -195,10 +195,10 @@ const messages = {
         return `Unable to find a precached response in ${cacheName} for ${url}.`;
     },
     "cross-origin-copy-response": ({ origin })=>{
-        return `@serwist/core.copyResponse() can only be used with same-origin responses. It was passed a response with origin ${origin}.`;
+        return `'@serwist/core.copyResponse()' can only be used with same-origin responses. It was passed a response with origin ${origin}.`;
     },
     "opaque-streams-source": ({ type })=>{
-        const message = `One of the @serwist/streams sources resulted in an '${type}' response.`;
+        const message = `One of the '@serwist/streams' sources resulted in an '${type}' response.`;
         if (type === "opaqueredirect") {
             return `${message} Please do not use a navigation request that results in a redirect as a source.`;
         }

package/dist/clientsClaim.d.ts

@@ -1,7 +1,6 @@
 /**
- * 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;
-export { clientsClaim };
+export declare const clientsClaim: () => void;
 //# sourceMappingURL=clientsClaim.d.ts.map

package/dist/clientsClaim.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clientsClaim.d.ts","sourceRoot":"","sources":["../src/clientsClaim.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,iBAAS,YAAY,IAAI,IAAI,CAE5B;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"clientsClaim.d.ts","sourceRoot":"","sources":["../src/clientsClaim.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,eAAO,MAAM,YAAY,QAAO,IAE/B,CAAC"}

package/dist/copyResponse.d.ts

@@ -16,6 +16,5 @@
  * @param response
  * @param modifier
  */
-declare function copyResponse(response: Response, modifier?: (responseInit: ResponseInit) => ResponseInit): Promise<Response>;
-export { copyResponse };
+export declare const copyResponse: (response: Response, modifier?: ((responseInit: ResponseInit) => ResponseInit) | undefined) => Promise<Response>;
 //# sourceMappingURL=copyResponse.d.ts.map

package/dist/copyResponse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"copyResponse.d.ts","sourceRoot":"","sources":["../src/copyResponse.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;;;;;;;GAiBG;AACH,iBAAe,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC,YAAY,EAAE,YAAY,KAAK,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CA8B1H;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"copyResponse.d.ts","sourceRoot":"","sources":["../src/copyResponse.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,YAAY,aAAoB,QAAQ,6BAA4B,YAAY,KAAK,YAAY,kBAAG,QAAQ,QAAQ,CA8BhI,CAAC"}

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

@@ -58,7 +58,7 @@ function dontWaitFor(promise) {
     void promise.then(()=>{});
 }
 
-async function executeQuotaErrorCallbacks() {
+const executeQuotaErrorCallbacks = async ()=>{
     if (process.env.NODE_ENV !== "production") {
         logger.log(`About to run ${quotaErrorCallbacks.size} callbacks to clean up caches.`);
     }
@@ -71,7 +71,7 @@ async function executeQuotaErrorCallbacks() {
     if (process.env.NODE_ENV !== "production") {
         logger.log("Finished running callbacks.");
     }
-}
+};
 
 const getFriendlyURL = (url)=>{
     const urlObj = new URL(String(url), location.href);
@@ -111,10 +111,10 @@ async function resultingClientExists(resultingClientId) {
     return resultingWindow;
 }
 
-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

@@ -18,11 +18,11 @@ const cacheNames = {
     }
 };
 
-function clientsClaim() {
+const clientsClaim = ()=>{
     self.addEventListener("activate", ()=>self.clients.claim());
-}
+};
 
-async function copyResponse(response, modifier) {
+const copyResponse = async (response, modifier)=>{
     let origin = null;
     if (response.url) {
         const responseURL = new URL(response.url);
@@ -42,9 +42,9 @@ async function copyResponse(response, modifier) {
     const modifiedResponseInit = modifier ? modifier(responseInit) : responseInit;
     const body = canConstructResponseFromBodyStream() ? clonedResponse.body : await clonedResponse.blob();
     return new Response(body, modifiedResponseInit);
-}
+};
 
-function registerQuotaErrorCallback(callback) {
+const registerQuotaErrorCallback = (callback)=>{
     if (process.env.NODE_ENV !== "production") {
         finalAssertExports.isType(callback, "function", {
             moduleName: "@serwist/core",
@@ -56,9 +56,9 @@ function registerQuotaErrorCallback(callback) {
     if (process.env.NODE_ENV !== "production") {
         logger.log("Registered a callback to respond to quota errors.", callback);
     }
-}
+};
 
-function setCacheNameDetails(details) {
+const setCacheNameDetails = (details)=>{
     if (process.env.NODE_ENV !== "production") {
         for (const key of Object.keys(details)){
             finalAssertExports.isType(details[key], "string", {
@@ -87,6 +87,6 @@ function setCacheNameDetails(details) {
         }
     }
     cacheNames$1.updateDetails(details);
-}
+};
 
 export { cacheNames, clientsClaim, copyResponse, registerQuotaErrorCallback, setCacheNameDetails };

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/registerQuotaErrorCallback.d.ts

@@ -4,6 +4,5 @@
  *
  * @param callback
  */
-declare function registerQuotaErrorCallback(callback: Function): void;
-export { registerQuotaErrorCallback };
+export declare const registerQuotaErrorCallback: (callback: Function) => void;
 //# sourceMappingURL=registerQuotaErrorCallback.d.ts.map

package/dist/registerQuotaErrorCallback.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registerQuotaErrorCallback.d.ts","sourceRoot":"","sources":["../src/registerQuotaErrorCallback.ts"],"names":[],"mappings":"AAYA;;;;;GAKG;AAEH,iBAAS,0BAA0B,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAc5D;AAED,OAAO,EAAE,0BAA0B,EAAE,CAAC"}
+{"version":3,"file":"registerQuotaErrorCallback.d.ts","sourceRoot":"","sources":["../src/registerQuotaErrorCallback.ts"],"names":[],"mappings":"AAYA;;;;;GAKG;AAEH,eAAO,MAAM,0BAA0B,aAAc,QAAQ,KAAG,IAc/D,CAAC"}

package/dist/setCacheNameDetails.d.ts

@@ -1,10 +1,9 @@
 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
  */
-declare function setCacheNameDetails(details: PartialCacheNameDetails): void;
-export { setCacheNameDetails };
+export declare const setCacheNameDetails: (details: PartialCacheNameDetails) => void;
 //# sourceMappingURL=setCacheNameDetails.d.ts.map

package/dist/setCacheNameDetails.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setCacheNameDetails.d.ts","sourceRoot":"","sources":["../src/setCacheNameDetails.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAGxE;;;;;GAKG;AACH,iBAAS,mBAAmB,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAiCnE;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC"}
+{"version":3,"file":"setCacheNameDetails.d.ts","sourceRoot":"","sources":["../src/setCacheNameDetails.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAGxE;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,YAAa,uBAAuB,KAAG,IAiCtE,CAAC"}

package/dist/types.d.ts

@@ -1,3 +1,4 @@
+export type PromiseOrNot<T> = T | Promise<T>;
 export interface MapLikeObject {
     [key: string]: any;
 }
@@ -26,13 +27,11 @@ export interface RouteMatchCallbackOptions {
  * is a non-empty array or object, that value will be set on the handler's
  * `options.params` argument.
  */
-export interface RouteMatchCallback {
-    (options: RouteMatchCallbackOptions): any;
-}
+export type RouteMatchCallback = (options: RouteMatchCallbackOptions) => any;
 /**
  * Options passed to a `RouteHandlerCallback` function.
  */
-export declare interface RouteHandlerCallbackOptions {
+export interface RouteHandlerCallbackOptions {
     /**
      * The event associated with the request.
      */
@@ -59,6 +58,11 @@ export interface ManualHandlerCallbackOptions {
      * A request to run this strategy for.
      */
     request: Request | string;
+    url?: never;
+    /**
+     * The return value from `@serwist/routing`'s `matchCallback` (if applicable).
+     */
+    params?: never;
 }
 export type HandlerCallbackOptions = RouteHandlerCallbackOptions | ManualHandlerCallbackOptions;
 /**
@@ -69,9 +73,7 @@ export type HandlerCallbackOptions = RouteHandlerCallbackOptions | ManualHandler
  * If a non-empty array or object is returned by the `RouteMatchCallback` it
  * will be passed in as this handler's `options.params` argument.
  */
-export interface RouteHandlerCallback {
-    (options: RouteHandlerCallbackOptions): Promise<Response>;
-}
+export type RouteHandlerCallback = (options: RouteHandlerCallbackOptions) => Promise<Response>;
 /**
  * The "handler" callback is invoked whenever a `Router` matches a URL/Request
  * to a `Route` via its `RouteMatchCallback`. This handler callback should
@@ -80,9 +82,7 @@ export interface RouteHandlerCallback {
  * If a non-empty array or object is returned by the `RouteMatchCallback` it
  * will be passed in as this handler's `options.params` argument.
  */
-export interface ManualHandlerCallback {
-    (options: ManualHandlerCallbackOptions): Promise<Response>;
-}
+export type ManualHandlerCallback = (options: ManualHandlerCallbackOptions) => Promise<Response>;
 /**
  * An object with a `handle` method of type `RouteHandlerCallback`.
  *
@@ -103,9 +103,7 @@ export interface HandlerWillStartCallbackParam {
     event: ExtendableEvent;
     state?: PluginState;
 }
-export interface HandlerWillStartCallback {
-    (param: HandlerWillStartCallbackParam): Promise<any>;
-}
+export type HandlerWillStartCallback = (param: HandlerWillStartCallbackParam) => Promise<any>;
 export interface CacheDidUpdateCallbackParam {
     /**
      * Name of the cache the responses belong to. This is included in the
@@ -130,9 +128,7 @@ export interface CacheDidUpdateCallbackParam {
     oldResponse?: Response | null;
     state?: PluginState;
 }
-export interface CacheDidUpdateCallback {
-    (param: CacheDidUpdateCallbackParam): Promise<any>;
-}
+export type CacheDidUpdateCallback = (param: CacheDidUpdateCallbackParam) => PromiseOrNot<any>;
 export interface CacheKeyWillBeUsedCallbackParam {
     mode: string;
     request: Request;
@@ -140,18 +136,14 @@ export interface CacheKeyWillBeUsedCallbackParam {
     params?: any;
     state?: PluginState;
 }
-export interface CacheKeyWillBeUsedCallback {
-    (param: CacheKeyWillBeUsedCallbackParam): Promise<Request | string>;
-}
+export type CacheKeyWillBeUsedCallback = (param: CacheKeyWillBeUsedCallbackParam) => PromiseOrNot<Request | string>;
 export interface CacheWillUpdateCallbackParam {
     request: Request;
     response: Response;
     event: ExtendableEvent;
     state?: PluginState;
 }
-export interface CacheWillUpdateCallback {
-    (param: CacheWillUpdateCallbackParam): Promise<any>;
-}
+export type CacheWillUpdateCallback = (param: CacheWillUpdateCallbackParam) => PromiseOrNot<any>;
 export interface CachedResponseWillBeUsedCallbackParam {
     /**
      * Name of the cache the response is in.
@@ -171,9 +163,7 @@ export interface CachedResponseWillBeUsedCallbackParam {
     matchOptions?: CacheQueryOptions;
     state?: PluginState;
 }
-export interface CachedResponseWillBeUsedCallback {
-    (param: CachedResponseWillBeUsedCallbackParam): Promise<any>;
-}
+export type CachedResponseWillBeUsedCallback = (param: CachedResponseWillBeUsedCallbackParam) => PromiseOrNot<any>;
 export interface FetchDidFailCallbackParam {
     error: Error;
     originalRequest: Request;
@@ -181,53 +171,41 @@ export interface FetchDidFailCallbackParam {
     event: ExtendableEvent;
     state?: PluginState;
 }
-export interface FetchDidFailCallback {
-    (param: FetchDidFailCallbackParam): Promise<any>;
-}
+export type FetchDidFailCallback = (param: FetchDidFailCallbackParam) => PromiseOrNot<any>;
 export interface FetchDidSucceedCallbackParam {
     request: Request;
     response: Response;
     event: ExtendableEvent;
     state?: PluginState;
 }
-export interface FetchDidSucceedCallback {
-    (param: FetchDidSucceedCallbackParam): Promise<Response>;
-}
+export type FetchDidSucceedCallback = (param: FetchDidSucceedCallbackParam) => PromiseOrNot<Response>;
 export interface RequestWillFetchCallbackParam {
     request: Request;
     event: ExtendableEvent;
     state?: PluginState;
 }
-export interface RequestWillFetchCallback {
-    (param: RequestWillFetchCallbackParam): Promise<Request>;
-}
+export type RequestWillFetchCallback = (param: RequestWillFetchCallbackParam) => PromiseOrNot<Request>;
 export interface HandlerWillRespondCallbackParam {
     request: Request;
     response: Response;
     event: ExtendableEvent;
     state?: PluginState;
 }
-export interface HandlerWillRespondCallback {
-    (param: HandlerWillRespondCallbackParam): Promise<Response>;
-}
+export type HandlerWillRespondCallback = (param: HandlerWillRespondCallbackParam) => PromiseOrNot<Response>;
 export interface HandlerDidErrorCallbackParam {
     request: Request;
     event: ExtendableEvent;
     error: Error;
     state?: PluginState;
 }
-export interface HandlerDidErrorCallback {
-    (param: HandlerDidErrorCallbackParam): Promise<Response | undefined>;
-}
+export type HandlerDidErrorCallback = (param: HandlerDidErrorCallbackParam) => PromiseOrNot<Response | undefined>;
 export interface HandlerDidRespondCallbackParam {
     request: Request;
     event: ExtendableEvent;
     response?: Response;
     state?: PluginState;
 }
-export interface HandlerDidRespondCallback {
-    (param: HandlerDidRespondCallbackParam): Promise<any>;
-}
+export type HandlerDidRespondCallback = (param: HandlerDidRespondCallbackParam) => PromiseOrNot<any>;
 export interface HandlerDidCompleteCallbackParam {
     request: Request;
     error?: Error;
@@ -235,9 +213,7 @@ export interface HandlerDidCompleteCallbackParam {
     response?: Response;
     state?: PluginState;
 }
-export interface HandlerDidCompleteCallback {
-    (param: HandlerDidCompleteCallbackParam): Promise<any>;
-}
+export type HandlerDidCompleteCallback = (param: HandlerDidCompleteCallbackParam) => PromiseOrNot<any>;
 /**
  * An object with optional lifecycle callback properties for the fetch and
  * cache operations.
@@ -270,4 +246,12 @@ export interface SerwistPluginCallbackParam {
     handlerWillStart: HandlerWillStartCallbackParam;
     requestWillFetch: RequestWillFetchCallbackParam;
 }
+export interface SerwistGlobalConfig {
+    /**
+     * Whether Serwist should disable development logging.
+     *
+     * @default false
+     */
+    __WB_DISABLE_DEV_LOGS: boolean;
+}
 //# 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.2",
+  "version": "9.0.0-preview.21",
   "type": "module",
   "description": "This module is used by a number of the other Serwist modules to share common code.",
   "files": [
@@ -15,8 +15,8 @@
   ],
   "author": "Google's Web DevRel Team, Serwist's Team",
   "license": "MIT",
-  "repository": "serwist/serwist",
-  "bugs": "https://github.com/serwist/serwist/issues",
+  "repository": "https://gitlab.com/serwist/serwist",
+  "bugs": "https://gitlab.com/serwist/serwist/issues",
   "homepage": "https://serwist.pages.dev",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -38,9 +38,9 @@
     }
   },
   "devDependencies": {
-    "rollup": "4.9.6",
-    "typescript": "5.4.0-dev.20240206",
-    "@serwist/constants": "9.0.0-preview.2"
+    "rollup": "4.13.0",
+    "typescript": "5.5.0-dev.20240323",
+    "@serwist/constants": "9.0.0-preview.21"
   },
   "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";
 
 /**
@@ -18,7 +19,7 @@ import type { MapLikeObject } from "../types.js";
  *
  * @private
  */
-class SerwistError extends Error {
+export class SerwistError extends Error {
   details?: MapLikeObject;
 
   /**
@@ -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);
@@ -38,5 +39,3 @@ class SerwistError extends Error {
     this.details = details;
   }
 }
-
-export { SerwistError };

package/src/_private/dontWaitFor.ts

@@ -9,7 +9,7 @@
  * A helper function that prevents a promise from being flagged as unused.
  *
  * @private
- **/
+ */
 export function dontWaitFor(promise: Promise<any>): void {
   // Effective no-op.
   void promise.then(() => {});

package/src/_private/executeQuotaErrorCallbacks.ts

@@ -15,7 +15,7 @@ import { quotaErrorCallbacks } from "../models/quotaErrorCallbacks.js";
  *
  * @private
  */
-async function executeQuotaErrorCallbacks(): Promise<void> {
+export const executeQuotaErrorCallbacks = async (): Promise<void> => {
   if (process.env.NODE_ENV !== "production") {
     logger.log(`About to run ${quotaErrorCallbacks.size} callbacks to clean up caches.`);
   }
@@ -30,6 +30,4 @@ async function executeQuotaErrorCallbacks(): Promise<void> {
   if (process.env.NODE_ENV !== "production") {
     logger.log("Finished running callbacks.");
   }
-}
-
-export { executeQuotaErrorCallbacks };
+};

package/src/_private/logger.ts

@@ -16,6 +16,13 @@ declare global {
   }
 }
 
+/**
+ * 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!

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/cacheNames.ts

@@ -9,7 +9,7 @@
 import { cacheNames as _cacheNames } from "./_private/cacheNames.js";
 
 /**
- * Get the current cache names and prefix/suffix used by Workbox.
+ * Get the current cache names and prefix/suffix used by Serwist.
  *
  * `cacheNames.precache` is used for precached assets,
  * `cacheNames.googleAnalytics` is used by `@serwist/google-analytics` to
@@ -20,7 +20,7 @@ import { cacheNames as _cacheNames } from "./_private/cacheNames.js";
  *
  * @returns An object with `precache`, `runtime`, `prefix`, and `googleAnalytics` properties.
  */
-const cacheNames = {
+export const cacheNames = {
   get googleAnalytics(): string {
     return _cacheNames.getGoogleAnalyticsName();
   },
@@ -37,5 +37,3 @@ const cacheNames = {
     return _cacheNames.getSuffix();
   },
 };
-
-export { cacheNames };

package/src/clientsClaim.ts

@@ -10,11 +10,9 @@
 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 {
+export const clientsClaim = (): void => {
   self.addEventListener("activate", () => self.clients.claim());
-}
-
-export { clientsClaim };
+};

package/src/copyResponse.ts

@@ -27,7 +27,7 @@ import { canConstructResponseFromBodyStream } from "./_private/canConstructRespo
  * @param response
  * @param modifier
  */
-async function copyResponse(response: Response, modifier?: (responseInit: ResponseInit) => ResponseInit): Promise<Response> {
+export const copyResponse = async (response: Response, modifier?: (responseInit: ResponseInit) => ResponseInit): Promise<Response> => {
   let origin = null;
   // If response.url isn't set, assume it's cross-origin and keep origin null.
   if (response.url) {
@@ -57,6 +57,4 @@ async function copyResponse(response: Response, modifier?: (responseInit: Respon
   const body = canConstructResponseFromBodyStream() ? clonedResponse.body : await clonedResponse.blob();
 
   return new Response(body, modifiedResponseInit);
-}
-
-export { copyResponse };
+};

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 }) => {
@@ -130,11 +130,11 @@ export const messages: MessageMap = {
   },
 
   "max-entries-or-age-required": ({ moduleName, className, funcName }) => {
-    return `You must define either config.maxEntries or config.maxAgeSecondsin ${moduleName}.${className}.${funcName}`;
+    return `You must define either 'config.maxEntries' or 'config.maxAgeSeconds' in '${moduleName}.${className}.${funcName}'`;
   },
 
   "statuses-or-headers-required": ({ moduleName, className, funcName }) => {
-    return `You must define either config.statuses or config.headersin ${moduleName}.${className}.${funcName}`;
+    return `You must define either 'config.statuses' or 'config.headers' in '${moduleName}.${className}.${funcName}'`;
   },
 
   "invalid-string": ({ moduleName, funcName, paramName }) => {
@@ -206,7 +206,7 @@ export const messages: MessageMap = {
   },
 
   "non-precached-url": ({ url }) => {
-    return `createHandlerBoundToURL('${url}') was called, but that URL is not precached. Please pass in a URL that is precached instead.`;
+    return `'createHandlerBoundToURL("${url}")' was called, but that URL is not precached. Please pass in a URL that is precached instead.`;
   },
 
   "add-to-cache-list-conflicting-integrities": ({ url }) => {
@@ -218,14 +218,16 @@ export const messages: MessageMap = {
   },
 
   "cross-origin-copy-response": ({ origin }) => {
-    return `@serwist/core.copyResponse() can only be used with same-origin responses. It was passed a response with origin ${origin}.`;
+    return `'@serwist/core.copyResponse()' can only be used with same-origin responses. It was passed a response with origin ${origin}.`;
   },
 
   "opaque-streams-source": ({ type }) => {
-    const message = `One of the @serwist/streams sources resulted in an '${type}' response.`;
+    const message = `One of the '@serwist/streams' sources resulted in an '${type}' response.`;
     if (type === "opaqueredirect") {
       return `${message} Please do not use a navigation request that results in a redirect as a source.`;
     }
     return `${message} Please ensure your sources are CORS-enabled.`;
   },
-};
+} satisfies MessageMap;
+
+export type MessageKey = keyof typeof messages;

package/src/registerQuotaErrorCallback.ts

@@ -17,7 +17,7 @@ import { quotaErrorCallbacks } from "./models/quotaErrorCallbacks.js";
  * @param callback
  */
 // biome-ignore lint/complexity/noBannedTypes: Can't change Function type
-function registerQuotaErrorCallback(callback: Function): void {
+export const registerQuotaErrorCallback = (callback: Function): void => {
   if (process.env.NODE_ENV !== "production") {
     assert!.isType(callback, "function", {
       moduleName: "@serwist/core",
@@ -31,6 +31,4 @@ function registerQuotaErrorCallback(callback: Function): void {
   if (process.env.NODE_ENV !== "production") {
     logger.log("Registered a callback to respond to quota errors.", callback);
   }
-}
-
-export { registerQuotaErrorCallback };
+};

package/src/setCacheNameDetails.ts

@@ -12,12 +12,12 @@ 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
  */
-function setCacheNameDetails(details: PartialCacheNameDetails): void {
+export const setCacheNameDetails = (details: PartialCacheNameDetails): void => {
   if (process.env.NODE_ENV !== "production") {
     for (const key of Object.keys(details)) {
       assert!.isType(details[key], "string", {
@@ -50,6 +50,4 @@ function setCacheNameDetails(details: PartialCacheNameDetails): void {
   }
 
   cacheNames.updateDetails(details);
-}
-
-export { setCacheNameDetails };
+};

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;
@@ -37,14 +38,12 @@ export interface RouteMatchCallbackOptions {
  * is a non-empty array or object, that value will be set on the handler's
  * `options.params` argument.
  */
-export interface RouteMatchCallback {
-  (options: RouteMatchCallbackOptions): any;
-}
+export type RouteMatchCallback = (options: RouteMatchCallbackOptions) => any;
 
 /**
  * Options passed to a `RouteHandlerCallback` function.
  */
-export declare interface RouteHandlerCallbackOptions {
+export interface RouteHandlerCallbackOptions {
   /**
    * The event associated with the request.
    */
@@ -71,6 +70,11 @@ export interface ManualHandlerCallbackOptions {
    * A request to run this strategy for.
    */
   request: Request | string;
+  url?: never;
+  /**
+   * The return value from `@serwist/routing`'s `matchCallback` (if applicable).
+   */
+  params?: never;
 }
 
 export type HandlerCallbackOptions = RouteHandlerCallbackOptions | ManualHandlerCallbackOptions;
@@ -83,9 +87,7 @@ export type HandlerCallbackOptions = RouteHandlerCallbackOptions | ManualHandler
  * If a non-empty array or object is returned by the `RouteMatchCallback` it
  * will be passed in as this handler's `options.params` argument.
  */
-export interface RouteHandlerCallback {
-  (options: RouteHandlerCallbackOptions): Promise<Response>;
-}
+export type RouteHandlerCallback = (options: RouteHandlerCallbackOptions) => Promise<Response>;
 
 /**
  * The "handler" callback is invoked whenever a `Router` matches a URL/Request
@@ -95,9 +97,7 @@ export interface RouteHandlerCallback {
  * If a non-empty array or object is returned by the `RouteMatchCallback` it
  * will be passed in as this handler's `options.params` argument.
  */
-export interface ManualHandlerCallback {
-  (options: ManualHandlerCallbackOptions): Promise<Response>;
-}
+export type ManualHandlerCallback = (options: ManualHandlerCallbackOptions) => Promise<Response>;
 
 /**
  * An object with a `handle` method of type `RouteHandlerCallback`.
@@ -122,9 +122,7 @@ export interface HandlerWillStartCallbackParam {
   state?: PluginState;
 }
 
-export interface HandlerWillStartCallback {
-  (param: HandlerWillStartCallbackParam): Promise<any>;
-}
+export type HandlerWillStartCallback = (param: HandlerWillStartCallbackParam) => Promise<any>;
 
 export interface CacheDidUpdateCallbackParam {
   /**
@@ -151,9 +149,7 @@ export interface CacheDidUpdateCallbackParam {
   state?: PluginState;
 }
 
-export interface CacheDidUpdateCallback {
-  (param: CacheDidUpdateCallbackParam): Promise<any>;
-}
+export type CacheDidUpdateCallback = (param: CacheDidUpdateCallbackParam) => PromiseOrNot<any>;
 
 export interface CacheKeyWillBeUsedCallbackParam {
   mode: string;
@@ -163,9 +159,7 @@ export interface CacheKeyWillBeUsedCallbackParam {
   state?: PluginState;
 }
 
-export interface CacheKeyWillBeUsedCallback {
-  (param: CacheKeyWillBeUsedCallbackParam): Promise<Request | string>;
-}
+export type CacheKeyWillBeUsedCallback = (param: CacheKeyWillBeUsedCallbackParam) => PromiseOrNot<Request | string>;
 
 export interface CacheWillUpdateCallbackParam {
   request: Request;
@@ -174,9 +168,7 @@ export interface CacheWillUpdateCallbackParam {
   state?: PluginState;
 }
 
-export interface CacheWillUpdateCallback {
-  (param: CacheWillUpdateCallbackParam): Promise<any>;
-}
+export type CacheWillUpdateCallback = (param: CacheWillUpdateCallbackParam) => PromiseOrNot<any>;
 
 export interface CachedResponseWillBeUsedCallbackParam {
   /**
@@ -198,9 +190,7 @@ export interface CachedResponseWillBeUsedCallbackParam {
   state?: PluginState;
 }
 
-export interface CachedResponseWillBeUsedCallback {
-  (param: CachedResponseWillBeUsedCallbackParam): Promise<any>;
-}
+export type CachedResponseWillBeUsedCallback = (param: CachedResponseWillBeUsedCallbackParam) => PromiseOrNot<any>;
 
 export interface FetchDidFailCallbackParam {
   error: Error;
@@ -210,9 +200,7 @@ export interface FetchDidFailCallbackParam {
   state?: PluginState;
 }
 
-export interface FetchDidFailCallback {
-  (param: FetchDidFailCallbackParam): Promise<any>;
-}
+export type FetchDidFailCallback = (param: FetchDidFailCallbackParam) => PromiseOrNot<any>;
 
 export interface FetchDidSucceedCallbackParam {
   request: Request;
@@ -221,9 +209,7 @@ export interface FetchDidSucceedCallbackParam {
   state?: PluginState;
 }
 
-export interface FetchDidSucceedCallback {
-  (param: FetchDidSucceedCallbackParam): Promise<Response>;
-}
+export type FetchDidSucceedCallback = (param: FetchDidSucceedCallbackParam) => PromiseOrNot<Response>;
 
 export interface RequestWillFetchCallbackParam {
   request: Request;
@@ -231,9 +217,7 @@ export interface RequestWillFetchCallbackParam {
   state?: PluginState;
 }
 
-export interface RequestWillFetchCallback {
-  (param: RequestWillFetchCallbackParam): Promise<Request>;
-}
+export type RequestWillFetchCallback = (param: RequestWillFetchCallbackParam) => PromiseOrNot<Request>;
 
 export interface HandlerWillRespondCallbackParam {
   request: Request;
@@ -242,9 +226,7 @@ export interface HandlerWillRespondCallbackParam {
   state?: PluginState;
 }
 
-export interface HandlerWillRespondCallback {
-  (param: HandlerWillRespondCallbackParam): Promise<Response>;
-}
+export type HandlerWillRespondCallback = (param: HandlerWillRespondCallbackParam) => PromiseOrNot<Response>;
 
 export interface HandlerDidErrorCallbackParam {
   request: Request;
@@ -253,9 +235,7 @@ export interface HandlerDidErrorCallbackParam {
   state?: PluginState;
 }
 
-export interface HandlerDidErrorCallback {
-  (param: HandlerDidErrorCallbackParam): Promise<Response | undefined>;
-}
+export type HandlerDidErrorCallback = (param: HandlerDidErrorCallbackParam) => PromiseOrNot<Response | undefined>;
 
 export interface HandlerDidRespondCallbackParam {
   request: Request;
@@ -264,9 +244,7 @@ export interface HandlerDidRespondCallbackParam {
   state?: PluginState;
 }
 
-export interface HandlerDidRespondCallback {
-  (param: HandlerDidRespondCallbackParam): Promise<any>;
-}
+export type HandlerDidRespondCallback = (param: HandlerDidRespondCallbackParam) => PromiseOrNot<any>;
 
 export interface HandlerDidCompleteCallbackParam {
   request: Request;
@@ -276,9 +254,7 @@ export interface HandlerDidCompleteCallbackParam {
   state?: PluginState;
 }
 
-export interface HandlerDidCompleteCallback {
-  (param: HandlerDidCompleteCallbackParam): Promise<any>;
-}
+export type HandlerDidCompleteCallback = (param: HandlerDidCompleteCallbackParam) => PromiseOrNot<any>;
 
 /**
  * An object with optional lifecycle callback properties for the fetch and
@@ -313,3 +289,12 @@ export interface SerwistPluginCallbackParam {
   handlerWillStart: HandlerWillStartCallbackParam;
   requestWillFetch: RequestWillFetchCallbackParam;
 }
+
+export interface SerwistGlobalConfig {
+  /**
+   * Whether Serwist should disable development logging.
+   *
+   * @default false
+   */
+  __WB_DISABLE_DEV_LOGS: boolean;
+}

package/src/utils/welcome.ts

@@ -19,7 +19,6 @@ if (process.env.NODE_ENV !== "production") {
       "You can force this with serwist.setConfig({debug: true|false}).",
   );
   logger.log(`📖 Read the guides and documentation\n${padding}https://developers.google.com/web/tools/workbox/`);
-  logger.log(`❓ Use the Discussions tab on Github to ask questions\n${padding}https://github.com/serwist/serwist/discussions`);
-  logger.log(`🐛 Found a bug? Report it on GitHub\n${padding}https://github.com/serwist/serwist/issues/new`);
+  logger.log(`🐛 Found a bug or want to ask a question? Open a new issue on GitLab\n${padding}https://gitlab.com/serwist/serwist/issues/new`);
   logger.groupEnd();
 }