@gesslar/toolkit 3.24.0 → 3.25.0

package/package.json

@@ -5,7 +5,7 @@
     "name": "gesslar",
     "url": "https://gesslar.dev"
   },
-  "version": "3.24.0",
+  "version": "3.25.0",
   "license": "Unlicense",
   "homepage": "https://github.com/gesslar/toolkit#readme",
   "repository": {
@@ -49,7 +49,7 @@
     "UNLICENSE.txt"
   ],
   "engines": {
-    "node": ">=22"
+    "node": ">=24.13.0"
   },
   "dependencies": {
     "@eslint/js": "^9.39.2",

package/src/node/lib/Notify.js

@@ -7,6 +7,7 @@
 import {EventEmitter} from "node:events"
 
 import Valid from "./Valid.js"
+import Util from "./Util.js"
 
 /**
  * @typedef {object} NotifyEventOptions
@@ -33,12 +34,26 @@ export default new class Notify {
    * @returns {void}
    */
   emit(type, payload=undefined) {
-    Valid.type(type, "String")
-    Valid.assert(type.length > 0, "Event type cannot be an empty string.")
+    Valid.type(type, "String", {allowEmpty: false})
 
     this.#emitter.emit(type, payload)
   }
 
+  /**
+   * Emits an event asynchronously and waits for all listeners to complete.
+   * Unlike emit() which is synchronous, this method properly handles async
+   * event listeners by waiting for all of them to resolve.
+   *
+   * @param {string} type - Event name to dispatch.
+   * @param {unknown} [payload] - Data to send with the event.
+   * @returns {Promise<void>} Resolves when all listeners have completed.
+   */
+  async asyncEmit(type, payload) {
+    Valid.type(type, "String", {allowEmpty: false})
+
+    await Util.asyncEmit(this.#emitter, type, payload)
+  }
+
   /**
    * Emits an event and returns the payload for simple request/response flows.
    * Listeners can mutate the payload object to provide responses.
@@ -48,8 +63,7 @@ export default new class Notify {
    * @returns {unknown} The payload after listeners have processed it.
    */
   request(type, payload={}) {
-    Valid.type(type, "String")
-    Valid.assert(type.length > 0, "Event type cannot be an empty string.")
+    Valid.type(type, "String", {allowEmpty: false})
 
     this.#emitter.emit(type, payload)
 
@@ -66,8 +80,7 @@ export default new class Notify {
    * @returns {() => void} Dispose function to unregister the handler.
    */
   on(type, handler, emitter=this.#emitter, options=undefined) {
-    Valid.type(type, "String")
-    Valid.assert(type.length > 0, "Event type cannot be an empty string.")
+    Valid.type(type, "String", {allowEmpty: false})
     Valid.type(handler, "Function")
 
     if(options?.once) {
@@ -88,6 +101,8 @@ export default new class Notify {
    * @returns {void}
    */
   off(type, handler, emitter=this.#emitter) {
+    Valid.type(type, "String", {allowEmpty: false})
+
     emitter.off(type, handler)
   }
 }

package/src/node/lib/Util.js

@@ -108,11 +108,6 @@ export default class Util extends BrowserUtil {
     } catch(error) {
       const argsDesc = args.length > 0 ? `with arguments: ${args.map(String).join(", ")}` : "with no arguments"
 
-      // If it's already a Sass error, just re-throw to avoid double-wrapping
-      if(error instanceof Sass) {
-        throw error
-      }
-
       throw Sass.new(
         `Processing '${event}' event ${argsDesc}.`,
         error
@@ -144,11 +139,6 @@ export default class Util extends BrowserUtil {
     } catch(error) {
       const argsDesc = args.length > 0 ? `with arguments: ${args.map(String).join(", ")}` : "with no arguments"
 
-      // If it's already a Sass error, just re-throw to avoid double-wrapping
-      if(error instanceof Sass) {
-        throw error
-      }
-
       throw Sass.new(
         `Processing '${event}' event ${argsDesc}.`,
         error

package/types/node/lib/Notify.d.ts

@@ -11,6 +11,16 @@ declare const _default: {
      * @returns {void}
      */
     emit(type: string, payload?: unknown): void;
+    /**
+     * Emits an event asynchronously and waits for all listeners to complete.
+     * Unlike emit() which is synchronous, this method properly handles async
+     * event listeners by waiting for all of them to resolve.
+     *
+     * @param {string} type - Event name to dispatch.
+     * @param {unknown} [payload] - Data to send with the event.
+     * @returns {Promise<void>} Resolves when all listeners have completed.
+     */
+    asyncEmit(type: string, payload?: unknown): Promise<void>;
     /**
      * Emits an event and returns the payload for simple request/response flows.
      * Listeners can mutate the payload object to provide responses.

package/types/node/lib/Notify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Notify.d.ts","sourceRoot":"","sources":["../../../src/node/lib/Notify.js"],"names":[],"mappings":";IAqBE,iDAAiD;UAAtC,MAAM;IAGjB,kDAAkD;2BAAvC,YAAY;IAGvB;;;;;;OAMG;eAHQ,MAAM,YACN,OAAO,GACL,IAAI;IASjB;;;;;;;OAOG;kBAHQ,MAAM,YACN,OAAO,GACL,OAAO;IAWpB;;;;;;;;OAQG;aALQ,MAAM,WACN,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,YAC1B,YAAY,YACZ,kBAAkB,GAChB,MAAM,IAAI;IAgBvB;;;;;;;OAOG;cAJQ,MAAM,WACN,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,YAC1B,YAAY,GACV,IAAI;;;;;;;WA3EL,OAAO;;;;aACP,WAAW"}
+{"version":3,"file":"Notify.d.ts","sourceRoot":"","sources":["../../../src/node/lib/Notify.js"],"names":[],"mappings":";IAsBE,iDAAiD;UAAtC,MAAM;IAGjB,kDAAkD;2BAAvC,YAAY;IAGvB;;;;;;OAMG;eAHQ,MAAM,YACN,OAAO,GACL,IAAI;IAQjB;;;;;;;;OAQG;oBAHQ,MAAM,YACN,OAAO,GACL,OAAO,CAAC,IAAI,CAAC;IAQ1B;;;;;;;OAOG;kBAHQ,MAAM,YACN,OAAO,GACL,OAAO;IAUpB;;;;;;;;OAQG;aALQ,MAAM,WACN,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,YAC1B,YAAY,YACZ,kBAAkB,GAChB,MAAM,IAAI;IAevB;;;;;;;OAOG;cAJQ,MAAM,WACN,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,YAC1B,YAAY,GACV,IAAI;;;;;;;WAvFL,OAAO;;;;aACP,WAAW"}

package/types/node/lib/Util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Util.d.ts","sourceRoot":"","sources":["../../../src/node/lib/Util.js"],"names":[],"mappings":"AAQA;;;GAGG;AACH;IACE;;;;;OAKG;IACH,iBAHW,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,mCAHW,MAAM,GACJ,KAAK,CAAC,MAAM,CAAC,CAazB;IAED;;;;;;;;OAQG;IACH,+CALW,MAAM,SACN,MAAM,WACH,OAAO,EAAA,GACR,OAAO,CAAC,IAAI,CAAC,CAmBzB;IAED;;;;;;;;;;;;OAYG;IACH,0BALW,YAAY,SACZ,MAAM,WACH,OAAO,EAAA,GACR,OAAO,CAAC,IAAI,CAAC,CAqBzB;IAED;;;;;;;;;;OAUG;IACH,+BALW,MAAM,SACN,MAAM,WACH,OAAO,EAAA,GACR,OAAO,CAAC,IAAI,CAAC,CAyBzB;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,kBALW,MAAM,QACN,OAAO,GACL,OAAO,CAmBnB;CACF;oCApMiC,wBAAwB"}
+{"version":3,"file":"Util.d.ts","sourceRoot":"","sources":["../../../src/node/lib/Util.js"],"names":[],"mappings":"AAQA;;;GAGG;AACH;IACE;;;;;OAKG;IACH,iBAHW,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,mCAHW,MAAM,GACJ,KAAK,CAAC,MAAM,CAAC,CAazB;IAED;;;;;;;;OAQG;IACH,+CALW,MAAM,SACN,MAAM,WACH,OAAO,EAAA,GACR,OAAO,CAAC,IAAI,CAAC,CAmBzB;IAED;;;;;;;;;;;;OAYG;IACH,0BALW,YAAY,SACZ,MAAM,WACH,OAAO,EAAA,GACR,OAAO,CAAC,IAAI,CAAC,CAgBzB;IAED;;;;;;;;;;OAUG;IACH,+BALW,MAAM,SACN,MAAM,WACH,OAAO,EAAA,GACR,OAAO,CAAC,IAAI,CAAC,CAoBzB;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,kBALW,MAAM,QACN,OAAO,GACL,OAAO,CAmBnB;CACF;oCA1LiC,wBAAwB"}