@nexim/service-worker 1.0.4 → 2.0.0

package/CHANGELOG.md

@@ -3,6 +3,25 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [2.0.0](https://github.com/the-nexim/nanolib/compare/@nexim/service-worker@2.0.0-alpha.0...@nexim/service-worker@2.0.0) (2025-04-21)
+
+**Note:** Version bump only for package @nexim/service-worker
+
+## [2.0.0-alpha.0](https://github.com/the-nexim/nanolib/compare/@nexim/service-worker@1.0.4...@nexim/service-worker@2.0.0-alpha.0) (2025-01-19)
+
+### Features
+
+* **service-worker:** add periodic update checks for service worker ([c2b5dd9](https://github.com/the-nexim/nanolib/commit/c2b5dd971d39e484db4f2ca5e6fe9be6b5b4bd67)) by @arashagp
+* **service-worker:** add support for configurable periodic update checks ([68ecd16](https://github.com/the-nexim/nanolib/commit/68ecd167b9c301570bc5daf18b1e2a2d62849003)) by @arashagp
+
+### Bug Fixes
+
+* **service-worker:** correctly set redundant event ([6167dee](https://github.com/the-nexim/nanolib/commit/6167dee8d96f790d4a5dae9037feb7f55f7c2a71)) by @njfamirm
+
+### Code Refactoring
+
+* **service-worker:** resolve comment ([f7bfb36](https://github.com/the-nexim/nanolib/commit/f7bfb360e3b76ee877634659a88c9beba2078766)) by @arashagp
+
 ## [1.0.4](https://github.com/the-nexim/nanolib/compare/@nexim/service-worker@1.0.3...@nexim/service-worker@1.0.4) (2025-01-11)
 
 **Note:** Version bump only for package @nexim/service-worker

package/README.md

@@ -20,31 +20,6 @@ npm install @nexim/service-worker
 yarn add @nexim/service-worker
 ```
 
-## Api
+## Documentation
 
-### registerServiceWorker
-
-Register the service worker and handle updates.
-
-```ts
-import {registerServiceWorker} from '@nexim/service-worker';
-
-const serviceWorkerPath = '/service-worker.js';
-registerServiceWorker(serviceWorkerPath);
-```
-
-### serviceWorkerSignal
-
-Signal for service worker events.
-
-```ts
-import {serviceWorkerSignal} from '@nexim/service-worker';
-
-serviceWorkerSignal.subscribe(({event}) => {
-  console.log('Service worker event:', event);
-});
-```
-
-### Type ServiceWorkerEvent
-
-The events that can be emitted by the service worker.
+Read full documentation [here](./docs/README.md).

package/dist/main.cjs

@@ -1,4 +1,4 @@
-/* @nexim/service-worker v1.0.4 */
+/* @nexim/service-worker v2.0.0 */
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -25,27 +25,36 @@ __export(main_exports, {
   serviceWorkerSignal: () => serviceWorkerSignal
 });
 module.exports = __toCommonJS(main_exports);
+var import_parse_duration = require("@alwatr/parse-duration");
 var import_flux = require("@alwatr/flux");
 var import_logger = require("@alwatr/logger");
 var import_package_tracer = require("@alwatr/package-tracer");
-__dev_mode__: import_package_tracer.packageTracer.add("@nexim/service-worker", "1.0.4");
+__dev_mode__: import_package_tracer.packageTracer.add("@nexim/service-worker", "2.0.0");
 var logger = /* @__PURE__ */ (0, import_logger.createLogger)("@nexim/service-worker");
 var serviceWorkerSignal = /* @__PURE__ */ new import_flux.AlwatrSignal({
   name: "serviceWorker"
 });
-async function registerServiceWorker(serviceWorkerPath) {
-  logger.logMethodArgs?.("registerServiceWorker", { serviceWorkerPath });
-  if ("serviceWorker" in navigator === false) {
+async function registerServiceWorker(options) {
+  logger.logMethodArgs?.("registerServiceWorker", { options });
+  if (!("serviceWorker" in navigator)) {
     logger.incident?.("registerServiceWorker", "service_worker_not_supported");
     return;
   }
   try {
-    const swRegistration = await navigator.serviceWorker.register(serviceWorkerPath);
+    const swRegistration = await navigator.serviceWorker.register(options.serviceWorkerPath);
     serviceWorkerSignal.notify({ event: "service_worker_registered" });
-    swRegistration.addEventListener("updatefound", () => serviceWorkerUpdateFoundHandler(swRegistration.installing));
+    swRegistration.addEventListener("updatefound", () => {
+      serviceWorkerUpdateFoundHandler(swRegistration.installing);
+    });
     logger.logOther?.("Service worker registered.");
+    if (options.timeForAutoUpdate != null) {
+      setInterval(async () => {
+        logger.logOther?.("startPeriodicUpdateChecks");
+        await swRegistration.update();
+      }, (0, import_parse_duration.parseDuration)(options.timeForAutoUpdate));
+    }
   } catch (error) {
-    logger.error("registerServiceWorker", "registration_failed ", { error });
+    logger.error("registerServiceWorker", "registration_failed", { error });
     serviceWorkerSignal.notify({ event: "service_worker_register_failed" });
   }
 }
@@ -57,7 +66,9 @@ function serviceWorkerUpdateFoundHandler(serviceWorker) {
   } else {
     serviceWorkerSignal.notify({ event: "service_worker_first_install" });
   }
-  serviceWorker.addEventListener("statechange", () => serviceWorkerStateChangeHandler(serviceWorker));
+  serviceWorker.addEventListener("statechange", () => {
+    serviceWorkerStateChangeHandler(serviceWorker);
+  });
 }
 function serviceWorkerStateChangeHandler(serviceWorker) {
   logger.logMethodArgs?.("serviceWorkerStateChangeHandler", { state: serviceWorker.state });
@@ -69,7 +80,7 @@ function serviceWorkerStateChangeHandler(serviceWorker) {
     }
   } else if (serviceWorker.state === "redundant") {
     logger.accident("serviceWorkerStateChangeHandler", "sw_redundant", "Service worker redundant");
-    serviceWorkerSignal.notify({ event: "service_worker_installed" });
+    serviceWorkerSignal.notify({ event: "service_worker_update_failed" });
   }
 }
 // Annotate the CommonJS export names for ESM import in node:
@@ -77,5 +88,4 @@ function serviceWorkerStateChangeHandler(serviceWorker) {
   registerServiceWorker,
   serviceWorkerSignal
 });
-/*! For license information please see main.cjs.LEGAL.txt */
 //# sourceMappingURL=main.cjs.map

package/dist/main.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/main.ts"],
-  "sourcesContent": ["import {AlwatrSignal} from '@alwatr/flux';\nimport {createLogger} from '@alwatr/logger';\nimport {packageTracer} from '@alwatr/package-tracer';\n\n/**\n * The events that can be emitted by the service worker.\n */\nexport type ServiceWorkerEvent =\n  | 'service_worker_registered'\n  | 'service_worker_register_failed'\n  | 'service_worker_first_install'\n  | 'service_worker_updated'\n  | 'service_worker_installed'\n  | 'service_worker_update_found';\n\n__dev_mode__: packageTracer.add(__package_name__, __package_version__);\n\nconst logger = /* @__PURE__ */ createLogger(__package_name__);\n\n/**\n * Signal for service worker events.\n *\n * @example\n * ```\n * import {serviceWorkerSignal} from '@nexim/service-worker';\n *\n * serviceWorkerSignal.subscribe(({event}) => {\n *   console.log('Service worker event:', event);\n * });\n * ```\n */\nexport const serviceWorkerSignal = /* @__PURE__ */ new AlwatrSignal<{event: ServiceWorkerEvent}>({\n  name: 'serviceWorker',\n});\n\n/**\n * Register the service worker and handle updates.\n *\n * @param serviceWorkerPath - The path to the service worker.\n *\n * @example\n * ```\n * import {registerServiceWorker} from '@nexim/service-worker';\n *\n * const serviceWorkerPath = '/service-worker.js';\n * registerServiceWorker(serviceWorkerPath);\n * ```\n */\nexport async function registerServiceWorker(serviceWorkerPath: string): Promise<void> {\n  logger.logMethodArgs?.('registerServiceWorker', {serviceWorkerPath});\n\n  if ('serviceWorker' in navigator === false) {\n    logger.incident?.('registerServiceWorker', 'service_worker_not_supported');\n    return;\n  }\n\n  try {\n    const swRegistration = await navigator.serviceWorker.register(serviceWorkerPath);\n    serviceWorkerSignal.notify({event: 'service_worker_registered'});\n    swRegistration.addEventListener('updatefound', () => serviceWorkerUpdateFoundHandler(swRegistration.installing));\n    logger.logOther?.('Service worker registered.');\n  }\n  catch (error) {\n    logger.error('registerServiceWorker', 'registration_failed ', {error});\n    serviceWorkerSignal.notify({event: 'service_worker_register_failed'});\n  }\n}\n\n/**\n * Handle the 'updatefound' event\n *\n * @param serviceWorker - The service worker\n */\nfunction serviceWorkerUpdateFoundHandler(serviceWorker: ServiceWorker | null): void {\n  if (serviceWorker == null) return;\n  logger.logMethod?.('swUpdateFound');\n\n  // Only notify update found if there's an existing controller\n  if (navigator.serviceWorker.controller) {\n    serviceWorkerSignal.notify({event: 'service_worker_update_found'});\n  }\n  else {\n    serviceWorkerSignal.notify({event: 'service_worker_first_install'});\n  }\n\n  serviceWorker.addEventListener('statechange', () => serviceWorkerStateChangeHandler(serviceWorker));\n}\n\n/**\n * Handle the 'statechange' event.\n *\n * If the service worker state is 'installed' then it is either a new install or an update.\n * If the service worker state is 'redundant' then the service worker is redundant.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/API/ServiceWorker/state\n *\n * @param serviceWorker - The service worker.\n */\nfunction serviceWorkerStateChangeHandler(serviceWorker: ServiceWorker): void {\n  logger.logMethodArgs?.('serviceWorkerStateChangeHandler', {state: serviceWorker.state});\n\n  if (serviceWorker.state === 'installed') {\n    // if old controller available then its update else its new install\n    if (navigator.serviceWorker.controller) {\n      serviceWorkerSignal.notify({event: 'service_worker_updated'});\n    }\n    else {\n      serviceWorkerSignal.notify({event: 'service_worker_installed'});\n    }\n  }\n  else if (serviceWorker.state === 'redundant') {\n    logger.accident('serviceWorkerStateChangeHandler', 'sw_redundant', 'Service worker redundant');\n    serviceWorkerSignal.notify({event: 'service_worker_installed'});\n  }\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,kBAA2B;AAC3B,oBAA2B;AAC3B,4BAA4B;AAa5B,aAAc,qCAAc,IAAI,yBAAkB,OAAmB;AAErE,IAAM,SAAyB,gDAAa,uBAAgB;AAcrD,IAAM,sBAAsC,oBAAI,yBAA0C;AAAA,EAC/F,MAAM;AACR,CAAC;AAeD,eAAsB,sBAAsB,mBAA0C;AACpF,SAAO,gBAAgB,yBAAyB,EAAC,kBAAiB,CAAC;AAEnE,MAAI,mBAAmB,cAAc,OAAO;AAC1C,WAAO,WAAW,yBAAyB,8BAA8B;AACzE;AAAA,EACF;AAEA,MAAI;AACF,UAAM,iBAAiB,MAAM,UAAU,cAAc,SAAS,iBAAiB;AAC/E,wBAAoB,OAAO,EAAC,OAAO,4BAA2B,CAAC;AAC/D,mBAAe,iBAAiB,eAAe,MAAM,gCAAgC,eAAe,UAAU,CAAC;AAC/G,WAAO,WAAW,4BAA4B;AAAA,EAChD,SACO,OAAO;AACZ,WAAO,MAAM,yBAAyB,wBAAwB,EAAC,MAAK,CAAC;AACrE,wBAAoB,OAAO,EAAC,OAAO,iCAAgC,CAAC;AAAA,EACtE;AACF;AAOA,SAAS,gCAAgC,eAA2C;AAClF,MAAI,iBAAiB,KAAM;AAC3B,SAAO,YAAY,eAAe;AAGlC,MAAI,UAAU,cAAc,YAAY;AACtC,wBAAoB,OAAO,EAAC,OAAO,8BAA6B,CAAC;AAAA,EACnE,OACK;AACH,wBAAoB,OAAO,EAAC,OAAO,+BAA8B,CAAC;AAAA,EACpE;AAEA,gBAAc,iBAAiB,eAAe,MAAM,gCAAgC,aAAa,CAAC;AACpG;AAYA,SAAS,gCAAgC,eAAoC;AAC3E,SAAO,gBAAgB,mCAAmC,EAAC,OAAO,cAAc,MAAK,CAAC;AAEtF,MAAI,cAAc,UAAU,aAAa;AAEvC,QAAI,UAAU,cAAc,YAAY;AACtC,0BAAoB,OAAO,EAAC,OAAO,yBAAwB,CAAC;AAAA,IAC9D,OACK;AACH,0BAAoB,OAAO,EAAC,OAAO,2BAA0B,CAAC;AAAA,IAChE;AAAA,EACF,WACS,cAAc,UAAU,aAAa;AAC5C,WAAO,SAAS,mCAAmC,gBAAgB,0BAA0B;AAC7F,wBAAoB,OAAO,EAAC,OAAO,2BAA0B,CAAC;AAAA,EAChE;AACF;",
+  "sourcesContent": ["import { type Duration, parseDuration } from '@alwatr/parse-duration';\nimport { AlwatrSignal } from '@alwatr/flux';\nimport { createLogger } from '@alwatr/logger';\nimport { packageTracer } from '@alwatr/package-tracer';\n\n/**\n * The events that can be emitted by the service worker.\n */\nexport type ServiceWorkerEvent =\n  | 'service_worker_registered'\n  | 'service_worker_register_failed'\n  | 'service_worker_first_install'\n  | 'service_worker_updated'\n  | 'service_worker_installed'\n  | 'service_worker_update_found'\n  | 'service_worker_update_failed';\n\n__dev_mode__: packageTracer.add(__package_name__, __package_version__);\n\nconst logger = /* @__PURE__ */ createLogger(__package_name__);\n\n/**\n * Signal for service worker events.\n *\n * @example\n * ```ts\n * import {serviceWorkerSignal} from '@nexim/service-worker';\n *\n * serviceWorkerSignal.subscribe(({event}) => {\n *   console.log('Service worker event:', event);\n * });\n * ```\n */\nexport const serviceWorkerSignal = /* @__PURE__ */ new AlwatrSignal<{ event: ServiceWorkerEvent }>({\n  name: 'serviceWorker',\n});\n\n/**\n * Register the service worker and handle updates.\n *\n * @param options - An object containing the service worker path and optional auto-update time.\n * @param serviceWorkerPath - [Options] The path to the service worker.\n * @param timeForAutoUpdate - [Options] Optional duration for automatically updating the service worker.\n *\n * @example\n * ```ts\n * import {registerServiceWorker} from '@nexim/service-worker';\n *\n * const serviceWorkerPath = '/service-worker.js';\n *\n * // without auto update\n * registerServiceWorker({ serviceWorkerPath });\n *\n * // with auto update\n * registerServiceWorker({ serviceWorkerPath, timeForAutoUpdate: '10m' });\n * ```\n */\nexport async function registerServiceWorker(options: { serviceWorkerPath: string; timeForAutoUpdate?: Duration }): Promise<void> {\n  logger.logMethodArgs?.('registerServiceWorker', { options });\n  if (!('serviceWorker' in navigator)) {\n    logger.incident?.('registerServiceWorker', 'service_worker_not_supported');\n    return;\n  }\n\n  try {\n    const swRegistration = await navigator.serviceWorker.register(options.serviceWorkerPath);\n    serviceWorkerSignal.notify({ event: 'service_worker_registered' });\n    swRegistration.addEventListener('updatefound', () => {\n      serviceWorkerUpdateFoundHandler(swRegistration.installing);\n    });\n    logger.logOther?.('Service worker registered.');\n\n    if (options.timeForAutoUpdate != null) {\n      setInterval(async () => {\n        logger.logOther?.('startPeriodicUpdateChecks');\n\n        await swRegistration.update();\n      }, parseDuration(options.timeForAutoUpdate));\n    }\n  }\n  catch (error) {\n    logger.error('registerServiceWorker', 'registration_failed', { error });\n    serviceWorkerSignal.notify({ event: 'service_worker_register_failed' });\n  }\n}\n\n/**\n * Handle the 'updatefound' event\n *\n * @param serviceWorker - The service worker\n */\nfunction serviceWorkerUpdateFoundHandler(serviceWorker: ServiceWorker | null): void {\n  if (serviceWorker == null) return;\n  logger.logMethod?.('swUpdateFound');\n\n  // Only notify update found if there's an existing controller\n  if (navigator.serviceWorker.controller) {\n    serviceWorkerSignal.notify({ event: 'service_worker_update_found' });\n  }\n  else {\n    serviceWorkerSignal.notify({ event: 'service_worker_first_install' });\n  }\n\n  serviceWorker.addEventListener('statechange', () => {\n    serviceWorkerStateChangeHandler(serviceWorker);\n  });\n}\n\n/**\n * Handle the 'statechange' event.\n *\n * If the service worker state is 'installed' then it is either a new install or an update.\n * If the service worker state is 'redundant' then the service worker is redundant.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/API/ServiceWorker/state\n *\n * @param serviceWorker - The service worker.\n */\nfunction serviceWorkerStateChangeHandler(serviceWorker: ServiceWorker): void {\n  logger.logMethodArgs?.('serviceWorkerStateChangeHandler', { state: serviceWorker.state });\n\n  if (serviceWorker.state === 'installed') {\n    // if old controller available then its update else its new install\n    if (navigator.serviceWorker.controller) {\n      serviceWorkerSignal.notify({ event: 'service_worker_updated' });\n    }\n    else {\n      serviceWorkerSignal.notify({ event: 'service_worker_installed' });\n    }\n  }\n  else if (serviceWorker.state === 'redundant') {\n    logger.accident('serviceWorkerStateChangeHandler', 'sw_redundant', 'Service worker redundant');\n    serviceWorkerSignal.notify({ event: 'service_worker_update_failed' });\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,4BAA6C;AAC7C,kBAA6B;AAC7B,oBAA6B;AAC7B,4BAA8B;AAc9B,aAAc,qCAAc,IAAI,yBAAkB,OAAmB;AAErE,IAAM,SAAyB,gDAAa,uBAAgB;AAcrD,IAAM,sBAAsC,oBAAI,yBAA4C;AAAA,EACjG,MAAM;AACR,CAAC;AAsBD,eAAsB,sBAAsB,SAAqF;AAC/H,SAAO,gBAAgB,yBAAyB,EAAE,QAAQ,CAAC;AAC3D,MAAI,EAAE,mBAAmB,YAAY;AACnC,WAAO,WAAW,yBAAyB,8BAA8B;AACzE;AAAA,EACF;AAEA,MAAI;AACF,UAAM,iBAAiB,MAAM,UAAU,cAAc,SAAS,QAAQ,iBAAiB;AACvF,wBAAoB,OAAO,EAAE,OAAO,4BAA4B,CAAC;AACjE,mBAAe,iBAAiB,eAAe,MAAM;AACnD,sCAAgC,eAAe,UAAU;AAAA,IAC3D,CAAC;AACD,WAAO,WAAW,4BAA4B;AAE9C,QAAI,QAAQ,qBAAqB,MAAM;AACrC,kBAAY,YAAY;AACtB,eAAO,WAAW,2BAA2B;AAE7C,cAAM,eAAe,OAAO;AAAA,MAC9B,OAAG,qCAAc,QAAQ,iBAAiB,CAAC;AAAA,IAC7C;AAAA,EACF,SACO,OAAO;AACZ,WAAO,MAAM,yBAAyB,uBAAuB,EAAE,MAAM,CAAC;AACtE,wBAAoB,OAAO,EAAE,OAAO,iCAAiC,CAAC;AAAA,EACxE;AACF;AAOA,SAAS,gCAAgC,eAA2C;AAClF,MAAI,iBAAiB,KAAM;AAC3B,SAAO,YAAY,eAAe;AAGlC,MAAI,UAAU,cAAc,YAAY;AACtC,wBAAoB,OAAO,EAAE,OAAO,8BAA8B,CAAC;AAAA,EACrE,OACK;AACH,wBAAoB,OAAO,EAAE,OAAO,+BAA+B,CAAC;AAAA,EACtE;AAEA,gBAAc,iBAAiB,eAAe,MAAM;AAClD,oCAAgC,aAAa;AAAA,EAC/C,CAAC;AACH;AAYA,SAAS,gCAAgC,eAAoC;AAC3E,SAAO,gBAAgB,mCAAmC,EAAE,OAAO,cAAc,MAAM,CAAC;AAExF,MAAI,cAAc,UAAU,aAAa;AAEvC,QAAI,UAAU,cAAc,YAAY;AACtC,0BAAoB,OAAO,EAAE,OAAO,yBAAyB,CAAC;AAAA,IAChE,OACK;AACH,0BAAoB,OAAO,EAAE,OAAO,2BAA2B,CAAC;AAAA,IAClE;AAAA,EACF,WACS,cAAc,UAAU,aAAa;AAC5C,WAAO,SAAS,mCAAmC,gBAAgB,0BAA0B;AAC7F,wBAAoB,OAAO,EAAE,OAAO,+BAA+B,CAAC;AAAA,EACtE;AACF;",
   "names": []
 }

package/dist/main.d.ts

@@ -1,13 +1,14 @@
+import { type Duration } from '@alwatr/parse-duration';
 import { AlwatrSignal } from '@alwatr/flux';
 /**
  * The events that can be emitted by the service worker.
  */
-export type ServiceWorkerEvent = 'service_worker_registered' | 'service_worker_register_failed' | 'service_worker_first_install' | 'service_worker_updated' | 'service_worker_installed' | 'service_worker_update_found';
+export type ServiceWorkerEvent = 'service_worker_registered' | 'service_worker_register_failed' | 'service_worker_first_install' | 'service_worker_updated' | 'service_worker_installed' | 'service_worker_update_found' | 'service_worker_update_failed';
 /**
  * Signal for service worker events.
  *
  * @example
- * ```
+ * ```ts
  * import {serviceWorkerSignal} from '@nexim/service-worker';
  *
  * serviceWorkerSignal.subscribe(({event}) => {
@@ -21,15 +22,25 @@ export declare const serviceWorkerSignal: AlwatrSignal<{
 /**
  * Register the service worker and handle updates.
  *
- * @param serviceWorkerPath - The path to the service worker.
+ * @param options - An object containing the service worker path and optional auto-update time.
+ * @param serviceWorkerPath - [Options] The path to the service worker.
+ * @param timeForAutoUpdate - [Options] Optional duration for automatically updating the service worker.
  *
  * @example
- * ```
+ * ```ts
  * import {registerServiceWorker} from '@nexim/service-worker';
  *
  * const serviceWorkerPath = '/service-worker.js';
- * registerServiceWorker(serviceWorkerPath);
+ *
+ * // without auto update
+ * registerServiceWorker({ serviceWorkerPath });
+ *
+ * // with auto update
+ * registerServiceWorker({ serviceWorkerPath, timeForAutoUpdate: '10m' });
  * ```
  */
-export declare function registerServiceWorker(serviceWorkerPath: string): Promise<void>;
+export declare function registerServiceWorker(options: {
+    serviceWorkerPath: string;
+    timeForAutoUpdate?: Duration;
+}): Promise<void>;
 //# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,cAAc,CAAC;AAI1C;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,2BAA2B,GAC3B,gCAAgC,GAChC,8BAA8B,GAC9B,wBAAwB,GACxB,0BAA0B,GAC1B,6BAA6B,CAAC;AAMlC;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB;WAA4C,kBAAkB;EAE5F,CAAC;AAEH;;;;;;;;;;;;GAYG;AACH,wBAAsB,qBAAqB,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBpF"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAiB,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAI5C;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,2BAA2B,GAC3B,gCAAgC,GAChC,8BAA8B,GAC9B,wBAAwB,GACxB,0BAA0B,GAC1B,6BAA6B,GAC7B,8BAA8B,CAAC;AAMnC;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB;WAA6C,kBAAkB;EAE7F,CAAC;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE;IAAE,iBAAiB,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,QAAQ,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA2B/H"}

package/dist/main.mjs

@@ -1,27 +1,36 @@
-/* @nexim/service-worker v1.0.4 */
+/* @nexim/service-worker v2.0.0 */
 
 // src/main.ts
+import { parseDuration } from "@alwatr/parse-duration";
 import { AlwatrSignal } from "@alwatr/flux";
 import { createLogger } from "@alwatr/logger";
 import { packageTracer } from "@alwatr/package-tracer";
-__dev_mode__: packageTracer.add("@nexim/service-worker", "1.0.4");
+__dev_mode__: packageTracer.add("@nexim/service-worker", "2.0.0");
 var logger = /* @__PURE__ */ createLogger("@nexim/service-worker");
 var serviceWorkerSignal = /* @__PURE__ */ new AlwatrSignal({
   name: "serviceWorker"
 });
-async function registerServiceWorker(serviceWorkerPath) {
-  logger.logMethodArgs?.("registerServiceWorker", { serviceWorkerPath });
-  if ("serviceWorker" in navigator === false) {
+async function registerServiceWorker(options) {
+  logger.logMethodArgs?.("registerServiceWorker", { options });
+  if (!("serviceWorker" in navigator)) {
     logger.incident?.("registerServiceWorker", "service_worker_not_supported");
     return;
   }
   try {
-    const swRegistration = await navigator.serviceWorker.register(serviceWorkerPath);
+    const swRegistration = await navigator.serviceWorker.register(options.serviceWorkerPath);
     serviceWorkerSignal.notify({ event: "service_worker_registered" });
-    swRegistration.addEventListener("updatefound", () => serviceWorkerUpdateFoundHandler(swRegistration.installing));
+    swRegistration.addEventListener("updatefound", () => {
+      serviceWorkerUpdateFoundHandler(swRegistration.installing);
+    });
     logger.logOther?.("Service worker registered.");
+    if (options.timeForAutoUpdate != null) {
+      setInterval(async () => {
+        logger.logOther?.("startPeriodicUpdateChecks");
+        await swRegistration.update();
+      }, parseDuration(options.timeForAutoUpdate));
+    }
   } catch (error) {
-    logger.error("registerServiceWorker", "registration_failed ", { error });
+    logger.error("registerServiceWorker", "registration_failed", { error });
     serviceWorkerSignal.notify({ event: "service_worker_register_failed" });
   }
 }
@@ -33,7 +42,9 @@ function serviceWorkerUpdateFoundHandler(serviceWorker) {
   } else {
     serviceWorkerSignal.notify({ event: "service_worker_first_install" });
   }
-  serviceWorker.addEventListener("statechange", () => serviceWorkerStateChangeHandler(serviceWorker));
+  serviceWorker.addEventListener("statechange", () => {
+    serviceWorkerStateChangeHandler(serviceWorker);
+  });
 }
 function serviceWorkerStateChangeHandler(serviceWorker) {
   logger.logMethodArgs?.("serviceWorkerStateChangeHandler", { state: serviceWorker.state });
@@ -45,12 +56,11 @@ function serviceWorkerStateChangeHandler(serviceWorker) {
     }
   } else if (serviceWorker.state === "redundant") {
     logger.accident("serviceWorkerStateChangeHandler", "sw_redundant", "Service worker redundant");
-    serviceWorkerSignal.notify({ event: "service_worker_installed" });
+    serviceWorkerSignal.notify({ event: "service_worker_update_failed" });
   }
 }
 export {
   registerServiceWorker,
   serviceWorkerSignal
 };
-/*! For license information please see main.mjs.LEGAL.txt */
 //# sourceMappingURL=main.mjs.map

package/dist/main.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/main.ts"],
-  "sourcesContent": ["import {AlwatrSignal} from '@alwatr/flux';\nimport {createLogger} from '@alwatr/logger';\nimport {packageTracer} from '@alwatr/package-tracer';\n\n/**\n * The events that can be emitted by the service worker.\n */\nexport type ServiceWorkerEvent =\n  | 'service_worker_registered'\n  | 'service_worker_register_failed'\n  | 'service_worker_first_install'\n  | 'service_worker_updated'\n  | 'service_worker_installed'\n  | 'service_worker_update_found';\n\n__dev_mode__: packageTracer.add(__package_name__, __package_version__);\n\nconst logger = /* @__PURE__ */ createLogger(__package_name__);\n\n/**\n * Signal for service worker events.\n *\n * @example\n * ```\n * import {serviceWorkerSignal} from '@nexim/service-worker';\n *\n * serviceWorkerSignal.subscribe(({event}) => {\n *   console.log('Service worker event:', event);\n * });\n * ```\n */\nexport const serviceWorkerSignal = /* @__PURE__ */ new AlwatrSignal<{event: ServiceWorkerEvent}>({\n  name: 'serviceWorker',\n});\n\n/**\n * Register the service worker and handle updates.\n *\n * @param serviceWorkerPath - The path to the service worker.\n *\n * @example\n * ```\n * import {registerServiceWorker} from '@nexim/service-worker';\n *\n * const serviceWorkerPath = '/service-worker.js';\n * registerServiceWorker(serviceWorkerPath);\n * ```\n */\nexport async function registerServiceWorker(serviceWorkerPath: string): Promise<void> {\n  logger.logMethodArgs?.('registerServiceWorker', {serviceWorkerPath});\n\n  if ('serviceWorker' in navigator === false) {\n    logger.incident?.('registerServiceWorker', 'service_worker_not_supported');\n    return;\n  }\n\n  try {\n    const swRegistration = await navigator.serviceWorker.register(serviceWorkerPath);\n    serviceWorkerSignal.notify({event: 'service_worker_registered'});\n    swRegistration.addEventListener('updatefound', () => serviceWorkerUpdateFoundHandler(swRegistration.installing));\n    logger.logOther?.('Service worker registered.');\n  }\n  catch (error) {\n    logger.error('registerServiceWorker', 'registration_failed ', {error});\n    serviceWorkerSignal.notify({event: 'service_worker_register_failed'});\n  }\n}\n\n/**\n * Handle the 'updatefound' event\n *\n * @param serviceWorker - The service worker\n */\nfunction serviceWorkerUpdateFoundHandler(serviceWorker: ServiceWorker | null): void {\n  if (serviceWorker == null) return;\n  logger.logMethod?.('swUpdateFound');\n\n  // Only notify update found if there's an existing controller\n  if (navigator.serviceWorker.controller) {\n    serviceWorkerSignal.notify({event: 'service_worker_update_found'});\n  }\n  else {\n    serviceWorkerSignal.notify({event: 'service_worker_first_install'});\n  }\n\n  serviceWorker.addEventListener('statechange', () => serviceWorkerStateChangeHandler(serviceWorker));\n}\n\n/**\n * Handle the 'statechange' event.\n *\n * If the service worker state is 'installed' then it is either a new install or an update.\n * If the service worker state is 'redundant' then the service worker is redundant.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/API/ServiceWorker/state\n *\n * @param serviceWorker - The service worker.\n */\nfunction serviceWorkerStateChangeHandler(serviceWorker: ServiceWorker): void {\n  logger.logMethodArgs?.('serviceWorkerStateChangeHandler', {state: serviceWorker.state});\n\n  if (serviceWorker.state === 'installed') {\n    // if old controller available then its update else its new install\n    if (navigator.serviceWorker.controller) {\n      serviceWorkerSignal.notify({event: 'service_worker_updated'});\n    }\n    else {\n      serviceWorkerSignal.notify({event: 'service_worker_installed'});\n    }\n  }\n  else if (serviceWorker.state === 'redundant') {\n    logger.accident('serviceWorkerStateChangeHandler', 'sw_redundant', 'Service worker redundant');\n    serviceWorkerSignal.notify({event: 'service_worker_installed'});\n  }\n}\n"],
-  "mappings": ";;;AAAA,SAAQ,oBAAmB;AAC3B,SAAQ,oBAAmB;AAC3B,SAAQ,qBAAoB;AAa5B,aAAc,eAAc,IAAI,yBAAkB,OAAmB;AAErE,IAAM,SAAyB,6BAAa,uBAAgB;AAcrD,IAAM,sBAAsC,oBAAI,aAA0C;AAAA,EAC/F,MAAM;AACR,CAAC;AAeD,eAAsB,sBAAsB,mBAA0C;AACpF,SAAO,gBAAgB,yBAAyB,EAAC,kBAAiB,CAAC;AAEnE,MAAI,mBAAmB,cAAc,OAAO;AAC1C,WAAO,WAAW,yBAAyB,8BAA8B;AACzE;AAAA,EACF;AAEA,MAAI;AACF,UAAM,iBAAiB,MAAM,UAAU,cAAc,SAAS,iBAAiB;AAC/E,wBAAoB,OAAO,EAAC,OAAO,4BAA2B,CAAC;AAC/D,mBAAe,iBAAiB,eAAe,MAAM,gCAAgC,eAAe,UAAU,CAAC;AAC/G,WAAO,WAAW,4BAA4B;AAAA,EAChD,SACO,OAAO;AACZ,WAAO,MAAM,yBAAyB,wBAAwB,EAAC,MAAK,CAAC;AACrE,wBAAoB,OAAO,EAAC,OAAO,iCAAgC,CAAC;AAAA,EACtE;AACF;AAOA,SAAS,gCAAgC,eAA2C;AAClF,MAAI,iBAAiB,KAAM;AAC3B,SAAO,YAAY,eAAe;AAGlC,MAAI,UAAU,cAAc,YAAY;AACtC,wBAAoB,OAAO,EAAC,OAAO,8BAA6B,CAAC;AAAA,EACnE,OACK;AACH,wBAAoB,OAAO,EAAC,OAAO,+BAA8B,CAAC;AAAA,EACpE;AAEA,gBAAc,iBAAiB,eAAe,MAAM,gCAAgC,aAAa,CAAC;AACpG;AAYA,SAAS,gCAAgC,eAAoC;AAC3E,SAAO,gBAAgB,mCAAmC,EAAC,OAAO,cAAc,MAAK,CAAC;AAEtF,MAAI,cAAc,UAAU,aAAa;AAEvC,QAAI,UAAU,cAAc,YAAY;AACtC,0BAAoB,OAAO,EAAC,OAAO,yBAAwB,CAAC;AAAA,IAC9D,OACK;AACH,0BAAoB,OAAO,EAAC,OAAO,2BAA0B,CAAC;AAAA,IAChE;AAAA,EACF,WACS,cAAc,UAAU,aAAa;AAC5C,WAAO,SAAS,mCAAmC,gBAAgB,0BAA0B;AAC7F,wBAAoB,OAAO,EAAC,OAAO,2BAA0B,CAAC;AAAA,EAChE;AACF;",
+  "sourcesContent": ["import { type Duration, parseDuration } from '@alwatr/parse-duration';\nimport { AlwatrSignal } from '@alwatr/flux';\nimport { createLogger } from '@alwatr/logger';\nimport { packageTracer } from '@alwatr/package-tracer';\n\n/**\n * The events that can be emitted by the service worker.\n */\nexport type ServiceWorkerEvent =\n  | 'service_worker_registered'\n  | 'service_worker_register_failed'\n  | 'service_worker_first_install'\n  | 'service_worker_updated'\n  | 'service_worker_installed'\n  | 'service_worker_update_found'\n  | 'service_worker_update_failed';\n\n__dev_mode__: packageTracer.add(__package_name__, __package_version__);\n\nconst logger = /* @__PURE__ */ createLogger(__package_name__);\n\n/**\n * Signal for service worker events.\n *\n * @example\n * ```ts\n * import {serviceWorkerSignal} from '@nexim/service-worker';\n *\n * serviceWorkerSignal.subscribe(({event}) => {\n *   console.log('Service worker event:', event);\n * });\n * ```\n */\nexport const serviceWorkerSignal = /* @__PURE__ */ new AlwatrSignal<{ event: ServiceWorkerEvent }>({\n  name: 'serviceWorker',\n});\n\n/**\n * Register the service worker and handle updates.\n *\n * @param options - An object containing the service worker path and optional auto-update time.\n * @param serviceWorkerPath - [Options] The path to the service worker.\n * @param timeForAutoUpdate - [Options] Optional duration for automatically updating the service worker.\n *\n * @example\n * ```ts\n * import {registerServiceWorker} from '@nexim/service-worker';\n *\n * const serviceWorkerPath = '/service-worker.js';\n *\n * // without auto update\n * registerServiceWorker({ serviceWorkerPath });\n *\n * // with auto update\n * registerServiceWorker({ serviceWorkerPath, timeForAutoUpdate: '10m' });\n * ```\n */\nexport async function registerServiceWorker(options: { serviceWorkerPath: string; timeForAutoUpdate?: Duration }): Promise<void> {\n  logger.logMethodArgs?.('registerServiceWorker', { options });\n  if (!('serviceWorker' in navigator)) {\n    logger.incident?.('registerServiceWorker', 'service_worker_not_supported');\n    return;\n  }\n\n  try {\n    const swRegistration = await navigator.serviceWorker.register(options.serviceWorkerPath);\n    serviceWorkerSignal.notify({ event: 'service_worker_registered' });\n    swRegistration.addEventListener('updatefound', () => {\n      serviceWorkerUpdateFoundHandler(swRegistration.installing);\n    });\n    logger.logOther?.('Service worker registered.');\n\n    if (options.timeForAutoUpdate != null) {\n      setInterval(async () => {\n        logger.logOther?.('startPeriodicUpdateChecks');\n\n        await swRegistration.update();\n      }, parseDuration(options.timeForAutoUpdate));\n    }\n  }\n  catch (error) {\n    logger.error('registerServiceWorker', 'registration_failed', { error });\n    serviceWorkerSignal.notify({ event: 'service_worker_register_failed' });\n  }\n}\n\n/**\n * Handle the 'updatefound' event\n *\n * @param serviceWorker - The service worker\n */\nfunction serviceWorkerUpdateFoundHandler(serviceWorker: ServiceWorker | null): void {\n  if (serviceWorker == null) return;\n  logger.logMethod?.('swUpdateFound');\n\n  // Only notify update found if there's an existing controller\n  if (navigator.serviceWorker.controller) {\n    serviceWorkerSignal.notify({ event: 'service_worker_update_found' });\n  }\n  else {\n    serviceWorkerSignal.notify({ event: 'service_worker_first_install' });\n  }\n\n  serviceWorker.addEventListener('statechange', () => {\n    serviceWorkerStateChangeHandler(serviceWorker);\n  });\n}\n\n/**\n * Handle the 'statechange' event.\n *\n * If the service worker state is 'installed' then it is either a new install or an update.\n * If the service worker state is 'redundant' then the service worker is redundant.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/API/ServiceWorker/state\n *\n * @param serviceWorker - The service worker.\n */\nfunction serviceWorkerStateChangeHandler(serviceWorker: ServiceWorker): void {\n  logger.logMethodArgs?.('serviceWorkerStateChangeHandler', { state: serviceWorker.state });\n\n  if (serviceWorker.state === 'installed') {\n    // if old controller available then its update else its new install\n    if (navigator.serviceWorker.controller) {\n      serviceWorkerSignal.notify({ event: 'service_worker_updated' });\n    }\n    else {\n      serviceWorkerSignal.notify({ event: 'service_worker_installed' });\n    }\n  }\n  else if (serviceWorker.state === 'redundant') {\n    logger.accident('serviceWorkerStateChangeHandler', 'sw_redundant', 'Service worker redundant');\n    serviceWorkerSignal.notify({ event: 'service_worker_update_failed' });\n  }\n}\n"],
+  "mappings": ";;;AAAA,SAAwB,qBAAqB;AAC7C,SAAS,oBAAoB;AAC7B,SAAS,oBAAoB;AAC7B,SAAS,qBAAqB;AAc9B,aAAc,eAAc,IAAI,yBAAkB,OAAmB;AAErE,IAAM,SAAyB,6BAAa,uBAAgB;AAcrD,IAAM,sBAAsC,oBAAI,aAA4C;AAAA,EACjG,MAAM;AACR,CAAC;AAsBD,eAAsB,sBAAsB,SAAqF;AAC/H,SAAO,gBAAgB,yBAAyB,EAAE,QAAQ,CAAC;AAC3D,MAAI,EAAE,mBAAmB,YAAY;AACnC,WAAO,WAAW,yBAAyB,8BAA8B;AACzE;AAAA,EACF;AAEA,MAAI;AACF,UAAM,iBAAiB,MAAM,UAAU,cAAc,SAAS,QAAQ,iBAAiB;AACvF,wBAAoB,OAAO,EAAE,OAAO,4BAA4B,CAAC;AACjE,mBAAe,iBAAiB,eAAe,MAAM;AACnD,sCAAgC,eAAe,UAAU;AAAA,IAC3D,CAAC;AACD,WAAO,WAAW,4BAA4B;AAE9C,QAAI,QAAQ,qBAAqB,MAAM;AACrC,kBAAY,YAAY;AACtB,eAAO,WAAW,2BAA2B;AAE7C,cAAM,eAAe,OAAO;AAAA,MAC9B,GAAG,cAAc,QAAQ,iBAAiB,CAAC;AAAA,IAC7C;AAAA,EACF,SACO,OAAO;AACZ,WAAO,MAAM,yBAAyB,uBAAuB,EAAE,MAAM,CAAC;AACtE,wBAAoB,OAAO,EAAE,OAAO,iCAAiC,CAAC;AAAA,EACxE;AACF;AAOA,SAAS,gCAAgC,eAA2C;AAClF,MAAI,iBAAiB,KAAM;AAC3B,SAAO,YAAY,eAAe;AAGlC,MAAI,UAAU,cAAc,YAAY;AACtC,wBAAoB,OAAO,EAAE,OAAO,8BAA8B,CAAC;AAAA,EACrE,OACK;AACH,wBAAoB,OAAO,EAAE,OAAO,+BAA+B,CAAC;AAAA,EACtE;AAEA,gBAAc,iBAAiB,eAAe,MAAM;AAClD,oCAAgC,aAAa;AAAA,EAC/C,CAAC;AACH;AAYA,SAAS,gCAAgC,eAAoC;AAC3E,SAAO,gBAAgB,mCAAmC,EAAE,OAAO,cAAc,MAAM,CAAC;AAExF,MAAI,cAAc,UAAU,aAAa;AAEvC,QAAI,UAAU,cAAc,YAAY;AACtC,0BAAoB,OAAO,EAAE,OAAO,yBAAyB,CAAC;AAAA,IAChE,OACK;AACH,0BAAoB,OAAO,EAAE,OAAO,2BAA2B,CAAC;AAAA,IAClE;AAAA,EACF,WACS,cAAc,UAAU,aAAa;AAC5C,WAAO,SAAS,mCAAmC,gBAAgB,0BAA0B;AAC7F,wBAAoB,OAAO,EAAE,OAAO,+BAA+B,CAAC;AAAA,EACtE;AACF;",
   "names": []
 }

package/dist/main.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=main.test.d.ts.map

package/dist/main.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.test.d.ts","sourceRoot":"","sources":["../src/main.test.js"],"names":[],"mappings":""}

package/docs/README.md

@@ -0,0 +1,19 @@
+# @nexim/service-worker
+
+## Type Aliases
+
+| Type Alias                                               | Description                                           |
+| -------------------------------------------------------- | ----------------------------------------------------- |
+| [ServiceWorkerEvent](type-aliases/ServiceWorkerEvent.md) | The events that can be emitted by the service worker. |
+
+## Variables
+
+| Variable                                                | Description                       |
+| ------------------------------------------------------- | --------------------------------- |
+| [serviceWorkerSignal](variables/serviceWorkerSignal.md) | Signal for service worker events. |
+
+## Functions
+
+| Function                                                    | Description                                     |
+| ----------------------------------------------------------- | ----------------------------------------------- |
+| [registerServiceWorker](functions/registerServiceWorker.md) | Register the service worker and handle updates. |

package/docs/functions/registerServiceWorker.md

@@ -0,0 +1,33 @@
+[@nexim/service-worker](../README.md) / registerServiceWorker
+
+# Function: registerServiceWorker()
+
+> **registerServiceWorker**(`options`: `object`): `Promise`\<`void`\>
+
+Register the service worker and handle updates.
+
+## Parameters
+
+| Parameter                    | Type                                                                  | Description                                                                 |
+| ---------------------------- | --------------------------------------------------------------------- | --------------------------------------------------------------------------- |
+| `options`                    | \{ `serviceWorkerPath`: `string`; `timeForAutoUpdate`: `Duration`; \} | An object containing the service worker path and optional auto-update time. |
+| `options.serviceWorkerPath`  | `string`                                                              | -                                                                           |
+| `options.timeForAutoUpdate?` | `Duration`                                                            | -                                                                           |
+
+## Returns
+
+`Promise`\<`void`\>
+
+## Example
+
+```ts
+import { registerServiceWorker } from '@nexim/service-worker';
+
+const serviceWorkerPath = '/service-worker.js';
+
+// without auto update
+registerServiceWorker({ serviceWorkerPath });
+
+// with auto update
+registerServiceWorker({ serviceWorkerPath, timeForAutoUpdate: '10m' });
+```

package/docs/type-aliases/ServiceWorkerEvent.md

@@ -0,0 +1,7 @@
+[@nexim/service-worker](../README.md) / ServiceWorkerEvent
+
+# Type Alias: ServiceWorkerEvent
+
+> **ServiceWorkerEvent** = `"service_worker_registered"` \| `"service_worker_register_failed"` \| `"service_worker_first_install"` \| `"service_worker_updated"` \| `"service_worker_installed"` \| `"service_worker_update_found"` \| `"service_worker_update_failed"`
+
+The events that can be emitted by the service worker.

package/docs/variables/serviceWorkerSignal.md

@@ -0,0 +1,17 @@
+[@nexim/service-worker](../README.md) / serviceWorkerSignal
+
+# Variable: serviceWorkerSignal
+
+> `const` **serviceWorkerSignal**: `AlwatrSignal`\<\{ `event`: [`ServiceWorkerEvent`](../type-aliases/ServiceWorkerEvent.md); \}\>
+
+Signal for service worker events.
+
+## Example
+
+```ts
+import { serviceWorkerSignal } from '@nexim/service-worker';
+
+serviceWorkerSignal.subscribe(({ event }) => {
+  console.log('Service worker event:', event);
+});
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexim/service-worker",
-  "version": "1.0.4",
+  "version": "2.0.0",
   "description": "Utilities to simplify the usage of service workers in your web applications.",
   "keywords": [
     "worker",
@@ -40,21 +40,26 @@
   ],
   "scripts": {
     "build": "wireit",
+    "doc": "wireit",
     "test": "wireit",
     "watch": "wireit"
   },
   "dependencies": {
-    "@alwatr/flux": "^4.0.2",
-    "@alwatr/logger": "^5.0.0",
-    "@alwatr/package-tracer": "^5.0.0"
+    "@alwatr/flux": "^4.0.5",
+    "@alwatr/logger": "^5.5.3",
+    "@alwatr/package-tracer": "^5.5.3",
+    "@alwatr/parse-duration": "^5.5.4"
   },
   "devDependencies": {
-    "@alwatr/nano-build": "^5.0.0",
-    "@alwatr/type-helper": "^5.0.0",
+    "@alwatr/nano-build": "^5.5.3",
+    "@alwatr/type-helper": "^5.4.1",
     "@nexim/typescript-config": "^2.0.0",
     "ava": "^6.2.0",
-    "typescript": "^5.7.2",
-    "wireit": "^0.14.9"
+    "typedoc": "^0.28.3",
+    "typedoc-plugin-markdown": "^4.6.2",
+    "typedoc-plugin-no-inherit": "^1.6.1",
+    "typescript": "^5.8.3",
+    "wireit": "^0.14.12"
   },
   "publishConfig": {
     "access": "public"
@@ -70,7 +75,7 @@
       ]
     },
     "build:es": {
-      "command": "nano-build --preset=module",
+      "command": "yarn nano-build --preset=module",
       "files": [
         "src",
         "tsconfig.json"
@@ -95,9 +100,12 @@
       "service": true
     },
     "watch:es": {
-      "command": "nano-build --preset=module --watch",
+      "command": "yarn nano-build --preset=module --watch",
       "service": true
+    },
+    "doc": {
+      "command": "typedoc"
     }
   },
-  "gitHead": "41445f8378b95ffe25437d6b2c4e4936e5090b91"
+  "gitHead": "274503ac545a83a930686f09205cb3ed06ab475d"
 }