tiny-essentials 1.28.19 → 1.29.0

package/dist/v1/libs/sw/service/plugins/GlobBypassPlugin.cjs

@@ -0,0 +1,88 @@
+'use strict';
+
+var objChecker = require('../../../../basics/objChecker.cjs');
+var Glob = require('../../../../regexp/Glob.cjs');
+var TinyServiceWorkerEngine = require('../TinyServiceWorkerEngine.cjs');
+
+const { TinyPluginLayer } = TinyServiceWorkerEngine;
+
+/**
+ * Configuration options for the GlobBypassPlugin.
+ * @typedef {Object} GlobBypassOptions
+ * @property {string[]} patterns - Array of glob patterns (e.g., ['\*\*\/*.js', '\*\*\/\*.{css,html}']) that, when matched, make the request bypass the router validation.
+ * @property {string[]} [exclude] - Array of glob patterns to ignore (e.g., ['**\/sw.js']).
+ * @property {boolean} [sameOriginOnly=true] - When true, only same-origin requests are evaluated.
+ */
+
+/**
+ * A plugin for TinyServiceWorkerEngine that bypasses the router validation for
+ * every request whose pathname matches one of the provided glob patterns.
+ *
+ * @type {import('../TinyServiceWorkerEngine.mjs').SwPluginInstaller<InstanceType<typeof TinyPluginLayer>, 'GlobBypass', '1.0.0', [GlobBypassOptions]>}
+ * @throws {TypeError} If the engine is invalid or if the provided options do not match the required schema.
+ */
+const GlobBypassPlugin = (instance, options) => {
+  const engine = instance.engine;
+  instance.id = 'GlobBypass';
+  instance.version = '1.0.0';
+  instance.description = 'Glob-based router bypass detector.';
+  instance.authors = ['JasminDreasond'];
+  instance.contributors = ['JasminDreasond'];
+  instance.categories = ['router-validator'];
+  instance.tags = ['glob', 'regex', 'bypass', 'router'];
+
+  // 1. Validation
+  if (!(engine instanceof TinyServiceWorkerEngine)) {
+    throw new TypeError('Plugin requires a TinyServiceWorkerEngine instance to function.');
+  }
+
+  if (!objChecker.isJsonObject(options)) {
+    throw new TypeError('[GlobBypassPlugin] Options must be a non-null object.');
+  }
+  if (!Array.isArray(options.patterns) || !options.patterns.every((p) => typeof p === 'string')) {
+    throw new TypeError('[GlobBypassPlugin] options.patterns must be an array of strings.');
+  }
+  if (
+    typeof options.exclude !== 'undefined' &&
+    (!Array.isArray(options.exclude) || !options.exclude.every((p) => typeof p === 'string'))
+  ) {
+    throw new TypeError('[GlobBypassPlugin] options.exclude must be an array of strings.');
+  }
+  if (
+    typeof options.sameOriginOnly !== 'undefined' &&
+    typeof options.sameOriginOnly !== 'boolean'
+  ) {
+    throw new TypeError('[GlobBypassPlugin] options.sameOriginOnly must be a boolean.');
+  }
+
+  const { patterns, exclude, sameOriginOnly = true } = options;
+
+  // 2. Implementation
+
+  // Pre-compile exclusion patterns into Regex for performance
+  const excludeRegexes = (exclude || []).map((pattern) => Glob.compileGlobRegExp(pattern));
+
+  for (const pattern of patterns) {
+    const regex = Glob.compileGlobRegExp(pattern);
+    engine.addFetchRegExpListener(regex.source, (fetchObj, response) => {
+      if (sameOriginOnly && !fetchObj.isSameOrigin) {
+        return; // Skip cross-origin requests
+      }
+
+      // Check if the current URL matches any exclusion pattern
+      if (excludeRegexes.some((re) => re.test(fetchObj.url.pathname))) {
+        return; // Skip excluded requests
+      }
+
+      // Bypass the router validation for the matched request
+      instance.log('info', `File detected: ${fetchObj.url.toString()}`);
+      response.continueCheck = false;
+      response.needValidation = false;
+      response.code = 200;
+    });
+  }
+
+  return new TinyPluginLayer();
+};
+
+module.exports = GlobBypassPlugin;

package/dist/v1/libs/sw/service/plugins/GlobBypassPlugin.d.mts

@@ -0,0 +1,32 @@
+declare const TinyPluginLayer: typeof import("../../../plugin/TinyPlugin.mjs").TinyPluginLayer;
+export type GlobBypassOptions = {
+    /**
+     * - Array of glob patterns (e.g., ['\*\*\/*.js', '\*\*\/\*.{css,html}']) that, when matched, make the request bypass the router validation.
+     */
+    patterns: string[];
+    /**
+     * - Array of glob patterns to ignore (e.g., ['**\/sw.js']).
+     */
+    exclude?: string[];
+    /**
+     * - When true, only same-origin requests are evaluated.
+     */
+    sameOriginOnly?: boolean;
+};
+/**
+ * Configuration options for the GlobBypassPlugin.
+ * @typedef {Object} GlobBypassOptions
+ * @property {string[]} patterns - Array of glob patterns (e.g., ['\*\*\/*.js', '\*\*\/\*.{css,html}']) that, when matched, make the request bypass the router validation.
+ * @property {string[]} [exclude] - Array of glob patterns to ignore (e.g., ['**\/sw.js']).
+ * @property {boolean} [sameOriginOnly=true] - When true, only same-origin requests are evaluated.
+ */
+/**
+ * A plugin for TinyServiceWorkerEngine that bypasses the router validation for
+ * every request whose pathname matches one of the provided glob patterns.
+ *
+ * @type {import('../TinyServiceWorkerEngine.mjs').SwPluginInstaller<InstanceType<typeof TinyPluginLayer>, 'GlobBypass', '1.0.0', [GlobBypassOptions]>}
+ * @throws {TypeError} If the engine is invalid or if the provided options do not match the required schema.
+ */
+declare const GlobBypassPlugin: import('../TinyServiceWorkerEngine.mjs').SwPluginInstaller<InstanceType<typeof TinyPluginLayer>, 'GlobBypass', '1.0.0', [GlobBypassOptions]>;
+export default GlobBypassPlugin;
+//# sourceMappingURL=GlobBypassPlugin.d.mts.map

package/dist/v1/libs/sw/service/plugins/GlobBypassPlugin.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobBypassPlugin.d.mts","sourceRoot":"","sources":["../../../../../../../src/v1/libs/sw/service/plugins/GlobBypassPlugin.mjs"],"names":[],"mappings":"AAIA,QAAA,MAAQ,eAAe,iEAA4B,CAAC;AAIjD,YAAkB,iBAAiB,GACnC;;;;IAAqB,QAAQ,EAAlB,MAAM,EAAE,CACnB;;;;IAAsB,OAAO,AAA7B,CACA,EADW,MAAM,EAAE,CACnB;;;;IAAqB,cAAc,AAAnC,CACF,EADa,OAAO,CACpB;CAAA,CAAA;AAND;;;;;;GAMG;AAEH;;;;;;GAMG;AACH,QAAA,MAAM,gBAAgB,EAHZ,OAAO,gCAAgC,EAAE,iBAAiB,CAAC,YAAY,CAAC,OAAO,eAAe,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,iBAAiB,CAAC,CAiEpJ,CAAC;eAEa,gBAAgB"}

package/dist/v1/libs/sw/service/plugins/GlobBypassPlugin.mjs

@@ -0,0 +1,69 @@
+import { isJsonObject } from '../../../../basics/objChecker.mjs';
+import { compileGlobRegExp } from '../../../../regexp/Glob.mjs';
+import TinyServiceWorkerEngine from '../TinyServiceWorkerEngine.mjs';
+const { TinyPluginLayer } = TinyServiceWorkerEngine;
+/**
+ * Configuration options for the GlobBypassPlugin.
+ * @typedef {Object} GlobBypassOptions
+ * @property {string[]} patterns - Array of glob patterns (e.g., ['\*\*\/*.js', '\*\*\/\*.{css,html}']) that, when matched, make the request bypass the router validation.
+ * @property {string[]} [exclude] - Array of glob patterns to ignore (e.g., ['**\/sw.js']).
+ * @property {boolean} [sameOriginOnly=true] - When true, only same-origin requests are evaluated.
+ */
+/**
+ * A plugin for TinyServiceWorkerEngine that bypasses the router validation for
+ * every request whose pathname matches one of the provided glob patterns.
+ *
+ * @type {import('../TinyServiceWorkerEngine.mjs').SwPluginInstaller<InstanceType<typeof TinyPluginLayer>, 'GlobBypass', '1.0.0', [GlobBypassOptions]>}
+ * @throws {TypeError} If the engine is invalid or if the provided options do not match the required schema.
+ */
+const GlobBypassPlugin = (instance, options) => {
+    const engine = instance.engine;
+    instance.id = 'GlobBypass';
+    instance.version = '1.0.0';
+    instance.description = 'Glob-based router bypass detector.';
+    instance.authors = ['JasminDreasond'];
+    instance.contributors = ['JasminDreasond'];
+    instance.categories = ['router-validator'];
+    instance.tags = ['glob', 'regex', 'bypass', 'router'];
+    // 1. Validation
+    if (!(engine instanceof TinyServiceWorkerEngine)) {
+        throw new TypeError('Plugin requires a TinyServiceWorkerEngine instance to function.');
+    }
+    if (!isJsonObject(options)) {
+        throw new TypeError('[GlobBypassPlugin] Options must be a non-null object.');
+    }
+    if (!Array.isArray(options.patterns) || !options.patterns.every((p) => typeof p === 'string')) {
+        throw new TypeError('[GlobBypassPlugin] options.patterns must be an array of strings.');
+    }
+    if (typeof options.exclude !== 'undefined' &&
+        (!Array.isArray(options.exclude) || !options.exclude.every((p) => typeof p === 'string'))) {
+        throw new TypeError('[GlobBypassPlugin] options.exclude must be an array of strings.');
+    }
+    if (typeof options.sameOriginOnly !== 'undefined' &&
+        typeof options.sameOriginOnly !== 'boolean') {
+        throw new TypeError('[GlobBypassPlugin] options.sameOriginOnly must be a boolean.');
+    }
+    const { patterns, exclude, sameOriginOnly = true } = options;
+    // 2. Implementation
+    // Pre-compile exclusion patterns into Regex for performance
+    const excludeRegexes = (exclude || []).map((pattern) => compileGlobRegExp(pattern));
+    for (const pattern of patterns) {
+        const regex = compileGlobRegExp(pattern);
+        engine.addFetchRegExpListener(regex.source, (fetchObj, response) => {
+            if (sameOriginOnly && !fetchObj.isSameOrigin) {
+                return; // Skip cross-origin requests
+            }
+            // Check if the current URL matches any exclusion pattern
+            if (excludeRegexes.some((re) => re.test(fetchObj.url.pathname))) {
+                return; // Skip excluded requests
+            }
+            // Bypass the router validation for the matched request
+            instance.log('info', `File detected: ${fetchObj.url.toString()}`);
+            response.continueCheck = false;
+            response.needValidation = false;
+            response.code = 200;
+        });
+    }
+    return new TinyPluginLayer();
+};
+export default GlobBypassPlugin;

package/dist/v1/libs/sw/service/plugins/GlobCachePlugin.cjs

@@ -0,0 +1,112 @@
+'use strict';
+
+var objChecker = require('../../../../basics/objChecker.cjs');
+var Glob = require('../../../../regexp/Glob.cjs');
+var TinyServiceWorkerEngine = require('../TinyServiceWorkerEngine.cjs');
+
+const { TinyPluginLayer } = TinyServiceWorkerEngine;
+
+/**
+ * @typedef {Object} GlobCacheOptions
+ * @property {string[]} patterns - Array of glob patterns (e.g., ['\*\*\/\*.js', '\*\*\/\*.{css,html}']).
+ * @property {string[]} [exclude] - Array of glob patterns to ignore (e.g., ['\*\*\/sw.js']).
+ * @property {boolean} [sameOriginOnly=true]
+ * @property {string} cacheName - The name of the CacheStorage bucket to use.
+ */
+
+/**
+ * A plugin for TinyServiceWorkerEngine that implements runtime caching based on glob patterns.
+ * @type {import('../TinyServiceWorkerEngine.mjs').SwPluginInstaller<InstanceType<typeof TinyPluginLayer>, 'GlobCache', '1.0.0', [GlobCacheOptions]>}
+ * @throws {TypeError} If options or patterns are invalid.
+ */
+const GlobCachePlugin = (instance, options) => {
+  const engine = instance.engine;
+  instance.id = 'GlobCache';
+  instance.version = '1.0.0';
+  instance.description = 'The glob cache manager.';
+  instance.authors = ['JasminDreasond'];
+  instance.contributors = ['JasminDreasond'];
+  instance.categories = ['router-validator'];
+  instance.tags = ['glob', 'regex', 'cache'];
+
+  // 1. Validation
+  if (!(engine instanceof TinyServiceWorkerEngine)) {
+    throw new TypeError('Plugin requires a TinyServiceWorkerEngine instance to function.');
+  }
+
+  if (!objChecker.isJsonObject(options)) {
+    throw new TypeError('[GlobCachePlugin] Options must be a non-null object.');
+  }
+  if (
+    typeof options.sameOriginOnly !== 'undefined' &&
+    typeof options.sameOriginOnly !== 'boolean'
+  ) {
+    throw new TypeError('[GlobCachePlugin] options.sameOriginOnly must be an boolean.');
+  }
+  if (!Array.isArray(options.patterns) || !options.patterns.every((p) => typeof p === 'string')) {
+    throw new TypeError('[GlobCachePlugin] options.patterns must be an array of strings.');
+  }
+  if (
+    typeof options.exclude !== 'undefined' &&
+    (!Array.isArray(options.exclude) || !options.exclude.every((p) => typeof p === 'string'))
+  ) {
+    throw new TypeError('[GlobCachePlugin] options.exclude must be an array of strings.');
+  }
+  if (typeof options.cacheName !== 'string') {
+    throw new TypeError('[GlobCachePlugin] options.cacheName must be a string.');
+  }
+
+  const { patterns, exclude, cacheName, sameOriginOnly = true } = options;
+
+  // Pre-compile exclusion patterns into Regex for performance
+  const excludeRegexes = (exclude || []).map((pattern) => Glob.compileGlobRegExp(pattern));
+
+  // 2. Implementation
+  for (const pattern of patterns) {
+    const regex = Glob.compileGlobRegExp(pattern);
+    engine.addFetchRegExpListener(regex.source, async (fetchObj, result) => {
+      const { request, url } = fetchObj;
+      if (sameOriginOnly && !fetchObj.isSameOrigin) {
+        return; // Skip this request
+      }
+
+      // Check if the current URL matches any exclusion pattern
+      const isExcluded = excludeRegexes.some((re) => re.test(url.pathname));
+      if (isExcluded) {
+        return; // Skip this request
+      }
+
+      try {
+        const cache = await caches.open(cacheName);
+        const cachedResponse = await cache.match(request);
+
+        if (cachedResponse) {
+          // Inject the cached response into the result object
+          result.customResponse = cachedResponse;
+          return;
+        }
+
+        // If not in cache, fetch from network
+        const networkResponse = await fetch(request);
+
+        // We must clone the response to add it to the cache,
+        // as the body can only be consumed once.
+        // Cache API only supports storing GET requests.
+        if (networkResponse.status === 200 && request.method === 'GET') {
+          cache.put(request, networkResponse.clone());
+        }
+
+        instance.log('info', `File detected: ${fetchObj.url.toString()}`);
+        result.customResponse = networkResponse;
+      } catch (error) {
+        // If caching fails, we don't break the flow,
+        // we just let the engine proceed to the next plugin or router.
+        console.error(`[GlobCachePlugin] Error during cache operation for ${url.pathname}:`, error);
+      }
+    });
+  }
+
+  return new TinyPluginLayer();
+};
+
+module.exports = GlobCachePlugin;

package/dist/v1/libs/sw/service/plugins/GlobCachePlugin.d.mts

@@ -0,0 +1,31 @@
+declare const TinyPluginLayer: typeof import("../../../plugin/TinyPlugin.mjs").TinyPluginLayer;
+export type GlobCacheOptions = {
+    /**
+     * - Array of glob patterns (e.g., ['\*\*\/\*.js', '\*\*\/\*.{css,html}']).
+     */
+    patterns: string[];
+    /**
+     * - Array of glob patterns to ignore (e.g., ['\*\*\/sw.js']).
+     */
+    exclude?: string[];
+    sameOriginOnly?: boolean;
+    /**
+     * - The name of the CacheStorage bucket to use.
+     */
+    cacheName: string;
+};
+/**
+ * @typedef {Object} GlobCacheOptions
+ * @property {string[]} patterns - Array of glob patterns (e.g., ['\*\*\/\*.js', '\*\*\/\*.{css,html}']).
+ * @property {string[]} [exclude] - Array of glob patterns to ignore (e.g., ['\*\*\/sw.js']).
+ * @property {boolean} [sameOriginOnly=true]
+ * @property {string} cacheName - The name of the CacheStorage bucket to use.
+ */
+/**
+ * A plugin for TinyServiceWorkerEngine that implements runtime caching based on glob patterns.
+ * @type {import('../TinyServiceWorkerEngine.mjs').SwPluginInstaller<InstanceType<typeof TinyPluginLayer>, 'GlobCache', '1.0.0', [GlobCacheOptions]>}
+ * @throws {TypeError} If options or patterns are invalid.
+ */
+declare const GlobCachePlugin: import('../TinyServiceWorkerEngine.mjs').SwPluginInstaller<InstanceType<typeof TinyPluginLayer>, 'GlobCache', '1.0.0', [GlobCacheOptions]>;
+export default GlobCachePlugin;
+//# sourceMappingURL=GlobCachePlugin.d.mts.map

package/dist/v1/libs/sw/service/plugins/GlobCachePlugin.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobCachePlugin.d.mts","sourceRoot":"","sources":["../../../../../../../src/v1/libs/sw/service/plugins/GlobCachePlugin.mjs"],"names":[],"mappings":"AAIA,QAAA,MAAQ,eAAe,iEAA4B,CAAC;AAGjD,YAAkB,gBAAgB,GAClC;;;;IAAqB,QAAQ,EAAlB,MAAM,EAAE,CACnB;;;;IAAsB,OAAO,AAA7B,CACA,EADW,MAAM,EAAE,CACnB;IAAqB,cAAc,AAAnC,CACA,EADW,OAAO,CAClB;;;;IAAmB,SAAS,EAAjB,MAAM,CACnB;CAAA,CAAA;AAND;;;;;;GAMG;AAEH;;;;GAIG;AACH,QAAA,MAAM,eAAe,EAHX,OAAO,gCAAgC,EAAE,iBAAiB,CAAC,YAAY,CAAC,OAAO,eAAe,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,gBAAgB,CAAC,CA2FlJ,CAAC;eAEa,eAAe"}

package/dist/v1/libs/sw/service/plugins/GlobCachePlugin.mjs

@@ -0,0 +1,91 @@
+import { isJsonObject } from '../../../../basics/objChecker.mjs';
+import { compileGlobRegExp } from '../../../../regexp/Glob.mjs';
+import TinyServiceWorkerEngine from '../TinyServiceWorkerEngine.mjs';
+const { TinyPluginLayer } = TinyServiceWorkerEngine;
+/**
+ * @typedef {Object} GlobCacheOptions
+ * @property {string[]} patterns - Array of glob patterns (e.g., ['\*\*\/\*.js', '\*\*\/\*.{css,html}']).
+ * @property {string[]} [exclude] - Array of glob patterns to ignore (e.g., ['\*\*\/sw.js']).
+ * @property {boolean} [sameOriginOnly=true]
+ * @property {string} cacheName - The name of the CacheStorage bucket to use.
+ */
+/**
+ * A plugin for TinyServiceWorkerEngine that implements runtime caching based on glob patterns.
+ * @type {import('../TinyServiceWorkerEngine.mjs').SwPluginInstaller<InstanceType<typeof TinyPluginLayer>, 'GlobCache', '1.0.0', [GlobCacheOptions]>}
+ * @throws {TypeError} If options or patterns are invalid.
+ */
+const GlobCachePlugin = (instance, options) => {
+    const engine = instance.engine;
+    instance.id = 'GlobCache';
+    instance.version = '1.0.0';
+    instance.description = 'The glob cache manager.';
+    instance.authors = ['JasminDreasond'];
+    instance.contributors = ['JasminDreasond'];
+    instance.categories = ['router-validator'];
+    instance.tags = ['glob', 'regex', 'cache'];
+    // 1. Validation
+    if (!(engine instanceof TinyServiceWorkerEngine)) {
+        throw new TypeError('Plugin requires a TinyServiceWorkerEngine instance to function.');
+    }
+    if (!isJsonObject(options)) {
+        throw new TypeError('[GlobCachePlugin] Options must be a non-null object.');
+    }
+    if (typeof options.sameOriginOnly !== 'undefined' &&
+        typeof options.sameOriginOnly !== 'boolean') {
+        throw new TypeError('[GlobCachePlugin] options.sameOriginOnly must be an boolean.');
+    }
+    if (!Array.isArray(options.patterns) || !options.patterns.every((p) => typeof p === 'string')) {
+        throw new TypeError('[GlobCachePlugin] options.patterns must be an array of strings.');
+    }
+    if (typeof options.exclude !== 'undefined' &&
+        (!Array.isArray(options.exclude) || !options.exclude.every((p) => typeof p === 'string'))) {
+        throw new TypeError('[GlobCachePlugin] options.exclude must be an array of strings.');
+    }
+    if (typeof options.cacheName !== 'string') {
+        throw new TypeError('[GlobCachePlugin] options.cacheName must be a string.');
+    }
+    const { patterns, exclude, cacheName, sameOriginOnly = true } = options;
+    // Pre-compile exclusion patterns into Regex for performance
+    const excludeRegexes = (exclude || []).map((pattern) => compileGlobRegExp(pattern));
+    // 2. Implementation
+    for (const pattern of patterns) {
+        const regex = compileGlobRegExp(pattern);
+        engine.addFetchRegExpListener(regex.source, async (fetchObj, result) => {
+            const { request, url } = fetchObj;
+            if (sameOriginOnly && !fetchObj.isSameOrigin) {
+                return; // Skip this request
+            }
+            // Check if the current URL matches any exclusion pattern
+            const isExcluded = excludeRegexes.some((re) => re.test(url.pathname));
+            if (isExcluded) {
+                return; // Skip this request
+            }
+            try {
+                const cache = await caches.open(cacheName);
+                const cachedResponse = await cache.match(request);
+                if (cachedResponse) {
+                    // Inject the cached response into the result object
+                    result.customResponse = cachedResponse;
+                    return;
+                }
+                // If not in cache, fetch from network
+                const networkResponse = await fetch(request);
+                // We must clone the response to add it to the cache,
+                // as the body can only be consumed once.
+                // Cache API only supports storing GET requests.
+                if (networkResponse.status === 200 && request.method === 'GET') {
+                    cache.put(request, networkResponse.clone());
+                }
+                instance.log('info', `File detected: ${fetchObj.url.toString()}`);
+                result.customResponse = networkResponse;
+            }
+            catch (error) {
+                // If caching fails, we don't break the flow,
+                // we just let the engine proceed to the next plugin or router.
+                console.error(`[GlobCachePlugin] Error during cache operation for ${url.pathname}:`, error);
+            }
+        });
+    }
+    return new TinyPluginLayer();
+};
+export default GlobCachePlugin;

package/dist/v1/libs/sw/service/plugins/Ping.cjs

@@ -0,0 +1,32 @@
+'use strict';
+
+var TinyServiceWorkerEngine = require('../TinyServiceWorkerEngine.cjs');
+
+const { TinyPluginLayer } = TinyServiceWorkerEngine;
+
+/**
+ * Ping/Pong Logic to plugin test.
+ *
+ * @type {import('../TinyServiceWorkerEngine.mjs').SwPluginInstaller<InstanceType<typeof TinyPluginLayer>, 'SimplePing', '1.0.0', []>}
+ */
+const TinyPingPwa = (instance) => {
+  const engine = instance.engine;
+  instance.id = 'SimplePing';
+  instance.version = '1.0.0';
+  instance.description = 'Ping tester plugin.';
+  instance.authors = ['JasminDreasond'];
+  instance.contributors = ['JasminDreasond'];
+  instance.categories = ['dev-tool'];
+  instance.tags = ['ping', 'test'];
+
+  if (!(engine instanceof TinyServiceWorkerEngine)) {
+    throw new TypeError('Plugin requires a TinyServiceWorkerEngine instance to function.');
+  }
+
+  engine.addMessageListener('ping', ({ reply }) => {
+    reply('pong', { msg: 'mio! :3' });
+  });
+  return new TinyPluginLayer();
+};
+
+module.exports = TinyPingPwa;

package/dist/v1/libs/sw/service/plugins/Ping.d.mts

@@ -0,0 +1,9 @@
+declare const TinyPluginLayer: typeof import("../../../plugin/TinyPlugin.mjs").TinyPluginLayer;
+/**
+ * Ping/Pong Logic to plugin test.
+ *
+ * @type {import('../TinyServiceWorkerEngine.mjs').SwPluginInstaller<InstanceType<typeof TinyPluginLayer>, 'SimplePing', '1.0.0', []>}
+ */
+declare const TinyPingPwa: import('../TinyServiceWorkerEngine.mjs').SwPluginInstaller<InstanceType<typeof TinyPluginLayer>, 'SimplePing', '1.0.0', []>;
+export default TinyPingPwa;
+//# sourceMappingURL=Ping.d.mts.map

package/dist/v1/libs/sw/service/plugins/Ping.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Ping.d.mts","sourceRoot":"","sources":["../../../../../../../src/v1/libs/sw/service/plugins/Ping.mjs"],"names":[],"mappings":"AAEA,QAAA,MAAQ,eAAe,iEAA4B,CAAC;AAEpD;;;;GAIG;AACH,QAAA,MAAM,WAAW,EAFP,OAAO,gCAAgC,EAAE,iBAAiB,CAAC,YAAY,CAAC,OAAO,eAAe,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,CAoBnI,CAAC;eAEa,WAAW"}

package/dist/v1/libs/sw/service/plugins/Ping.mjs

@@ -0,0 +1,25 @@
+import TinyServiceWorkerEngine from '../TinyServiceWorkerEngine.mjs';
+const { TinyPluginLayer } = TinyServiceWorkerEngine;
+/**
+ * Ping/Pong Logic to plugin test.
+ *
+ * @type {import('../TinyServiceWorkerEngine.mjs').SwPluginInstaller<InstanceType<typeof TinyPluginLayer>, 'SimplePing', '1.0.0', []>}
+ */
+const TinyPingPwa = (instance) => {
+    const engine = instance.engine;
+    instance.id = 'SimplePing';
+    instance.version = '1.0.0';
+    instance.description = 'Ping tester plugin.';
+    instance.authors = ['JasminDreasond'];
+    instance.contributors = ['JasminDreasond'];
+    instance.categories = ['dev-tool'];
+    instance.tags = ['ping', 'test'];
+    if (!(engine instanceof TinyServiceWorkerEngine)) {
+        throw new TypeError('Plugin requires a TinyServiceWorkerEngine instance to function.');
+    }
+    engine.addMessageListener('ping', ({ reply }) => {
+        reply('pong', { msg: 'mio! :3' });
+    });
+    return new TinyPluginLayer();
+};
+export default TinyPingPwa;