@sv443-network/coreutils 3.5.0 → 3.6.0

package/dist/CoreUtils.mjs

@@ -284,12 +284,12 @@ var NetworkError = class extends DatedError {
 };
 
 // lib/misc.ts
-async function consumeGen(valGen) {
-  return await (typeof valGen === "function" ? valGen() : valGen);
+async function consumeGen(valGen, ...args) {
+  return await (typeof valGen === "function" ? valGen(...args) : valGen);
 }
-async function consumeStringGen(strGen) {
+async function consumeStringGen(strGen, ...args) {
   return typeof strGen === "string" ? strGen : String(
-    typeof strGen === "function" ? await strGen() : strGen
+    typeof strGen === "function" ? await strGen(...args) : strGen
   );
 }
 async function fetchAdvanced(input, options = {}) {
@@ -328,6 +328,17 @@ function pauseFor(time, signal, rejectOnAbort = false) {
 function pureObj(obj) {
   return Object.assign(/* @__PURE__ */ Object.create(null), obj ?? {});
 }
+function getterifyObj(obj, asCopy = false) {
+  const newObj = {};
+  for (const key in obj) {
+    Object.defineProperty(newObj, key, {
+      get: () => obj[key],
+      enumerable: true,
+      configurable: true
+    });
+  }
+  return asCopy ? structuredClone(newObj) : newObj;
+}
 function setImmediateInterval(callback, interval, signal) {
   let intervalId;
   const cleanup = () => clearInterval(intervalId);
@@ -686,6 +697,8 @@ var NanoEmitter = class {
   events = createNanoEvents();
   eventUnsubscribes = [];
   emitterOptions;
+  /** Stores the last arguments for each event listed in `catchUpEvents` */
+  catchUpMemory = /* @__PURE__ */ new Map();
   /** Creates a new instance of NanoEmitter - a lightweight event emitter with helper methods and a strongly typed event map */
   constructor(options = {}) {
     this.emitterOptions = {
@@ -693,6 +706,18 @@ var NanoEmitter = class {
       ...options
     };
   }
+  //#region emitEvent
+  /**
+   * Emits an event on this instance, bypassing the `publicEmit` guard.
+   * Prefer this over `this.events.emit()` in subclasses — it updates catch-up memory
+   * for any event listed in `catchUpEvents` so late listeners can still receive the last value.
+   */
+  emitEvent(event, ...args) {
+    var _a;
+    if ((_a = this.emitterOptions.catchUpEvents) == null ? void 0 : _a.includes(event))
+      this.catchUpMemory.set(event, args);
+    this.events.emit(event, ...args);
+  }
   //#region on
   /**
    * Subscribes to an event and calls the callback when it's emitted.  
@@ -725,6 +750,9 @@ var NanoEmitter = class {
     };
     unsub = this.events.on(event, cb);
     this.eventUnsubscribes.push(unsub);
+    const memory = this.catchUpMemory.get(event);
+    if (memory)
+      cb(...memory);
     return unsubProxy;
   }
   //#region once
@@ -747,6 +775,12 @@ var NanoEmitter = class {
    * ```
    */
   once(event, cb) {
+    const memory = this.catchUpMemory.get(event);
+    if (memory) {
+      const args = memory;
+      cb == null ? void 0 : cb(...args);
+      return Promise.resolve(args);
+    }
     return new Promise((resolve) => {
       let unsub;
       const onceProxy = ((...args) => {
@@ -848,7 +882,7 @@ var NanoEmitter = class {
    */
   emit(event, ...args) {
     if (this.emitterOptions.publicEmit) {
-      this.events.emit(event, ...args);
+      this.emitEvent(event, ...args);
       return true;
     }
     return false;
@@ -971,7 +1005,7 @@ var DataStore = class extends NanoEmitter {
       if (typeof storedDataRaw !== "string" && typeof storedDataRaw !== "object" || storedDataRaw === null || isNaN(storedFmtVer)) {
         await this.saveDefaultData(false);
         const data = this.engine.deepCopy(this.defaultData);
-        this.events.emit("loadData", data);
+        this.emitEvent("loadData", data);
         return data;
       }
       const storedData = storedDataRaw ?? JSON.stringify(this.defaultData);
@@ -981,12 +1015,12 @@ var DataStore = class extends NanoEmitter {
       if (storedFmtVer < this.formatVersion && this.migrations)
         parsed = await this.runMigrations(parsed, storedFmtVer);
       const result = this.memoryCache ? this.cachedData = this.engine.deepCopy(parsed) : this.engine.deepCopy(parsed);
-      this.events.emit("loadData", result);
+      this.emitEvent("loadData", result);
       return result;
     } catch (err) {
       const error = err instanceof Error ? err : new Error(String(err));
       console.warn("Error while parsing JSON data, resetting it to the default value.", err);
-      this.events.emit("error", error);
+      this.emitEvent("error", error);
       await this.saveDefaultData();
       return this.defaultData;
     }
@@ -1008,7 +1042,7 @@ var DataStore = class extends NanoEmitter {
     const dataCopy = this.engine.deepCopy(data);
     if (this.memoryCache) {
       this.cachedData = data;
-      this.events.emit("updateDataSync", dataCopy);
+      this.emitEvent("updateDataSync", dataCopy);
     }
     return new Promise(async (resolve) => {
       const results = await Promise.allSettled([
@@ -1017,11 +1051,11 @@ var DataStore = class extends NanoEmitter {
         this.engine.setValue(`${this.keyPrefix}${this.id}-enf`, this.compressionFormat)
       ]);
       if (results.every((r) => r.status === "fulfilled"))
-        this.events.emit("updateData", dataCopy);
+        this.emitEvent("updateData", dataCopy);
       else {
         const error = new Error("Error while saving data to persistent storage: " + results.map((r) => r.status === "rejected" ? r.reason : null).filter(Boolean).join("; "));
         console.error(error);
-        this.events.emit("error", error);
+        this.emitEvent("error", error);
       }
       resolve();
     });
@@ -1040,11 +1074,11 @@ var DataStore = class extends NanoEmitter {
       this.engine.setValue(`${this.keyPrefix}${this.id}-enf`, this.compressionFormat)
     ]);
     if (results.every((r) => r.status === "fulfilled"))
-      emitEvent && this.events.emit("setDefaultData", this.defaultData);
+      emitEvent && this.emitEvent("setDefaultData", this.defaultData);
     else {
       const error = new Error("Error while saving default data to persistent storage: " + results.map((r) => r.status === "rejected" ? r.reason : null).filter(Boolean).join("; "));
       console.error(error);
-      this.events.emit("error", error);
+      this.emitEvent("error", error);
     }
   }
   //#region deleteData
@@ -1061,7 +1095,7 @@ var DataStore = class extends NanoEmitter {
       this.engine.deleteValue(`${this.keyPrefix}${this.id}-enf`)
     ]);
     await ((_b = (_a = this.engine).deleteStorage) == null ? void 0 : _b.call(_a));
-    this.events.emit("deleteData");
+    this.emitEvent("deleteData");
   }
   //#region encodingEnabled
   /** Returns whether encoding and decoding are enabled for this DataStore instance */
@@ -1091,11 +1125,11 @@ var DataStore = class extends NanoEmitter {
           newData = migRes instanceof Promise ? await migRes : migRes;
           lastFmtVer = oldFmtVer = ver;
           const isFinal = ver >= this.formatVersion || i === sortedMigrations.length - 1;
-          this.events.emit("migrateData", ver, newData, isFinal);
+          this.emitEvent("migrateData", ver, newData, isFinal);
         } catch (err) {
           const migError = new MigrationError(`Error while running migration function for format version '${fmtVer}'`, { cause: err });
-          this.events.emit("migrationError", ver, migError);
-          this.events.emit("error", migError);
+          this.emitEvent("migrationError", ver, migError);
+          this.emitEvent("error", migError);
           if (!resetOnError)
             throw migError;
           await this.saveDefaultData();
@@ -1109,7 +1143,7 @@ var DataStore = class extends NanoEmitter {
       this.engine.setValue(`${this.keyPrefix}${this.id}-enf`, this.compressionFormat)
     ]);
     const result = this.memoryCache ? this.cachedData = this.engine.deepCopy(newData) : this.engine.deepCopy(newData);
-    this.events.emit("updateData", result);
+    this.emitEvent("updateData", result);
     return result;
   }
   //#region migrateId
@@ -1139,7 +1173,7 @@ var DataStore = class extends NanoEmitter {
         this.engine.deleteValue(`${this.keyPrefix}${id}-ver`),
         this.engine.deleteValue(`${this.keyPrefix}${id}-enf`)
       ]);
-      this.events.emit("migrateId", id, this.id);
+      this.emitEvent("migrateId", id, this.id);
     }));
   }
 };
@@ -1382,15 +1416,20 @@ var DataStoreSerializer = class _DataStoreSerializer {
       addChecksum: true,
       ensureIntegrity: true,
       remapIds: {},
+      stringifyData: true,
       ...options
     };
   }
   /**
-   * Calculates the checksum of a string. Uses {@linkcode computeHash()} with SHA-256 and digests as a hex string by default.  
+   * Calculates the checksum of a string or {@linkcode DataStoreData} object. Uses {@linkcode computeHash()} with SHA-256 and digests as a hex string by default.  
    * Override this in a subclass if a custom checksum method is needed.
    */
   async calcChecksum(input) {
-    return computeHash(input, "SHA-256");
+    try {
+      return computeHash(typeof input === "string" ? input : JSON.stringify(input), "SHA-256");
+    } catch (err) {
+      throw new Error(`Failed to calculate checksum: ${err.message}`, { cause: err });
+    }
   }
   /**
    * Serializes only a subset of the data stores into a string.  
@@ -1405,7 +1444,7 @@ var DataStoreSerializer = class _DataStoreSerializer {
     for (const storeInst of filteredStores) {
       const encoded = Boolean(useEncoding && storeInst.encodingEnabled() && ((_a = storeInst.encodeData) == null ? void 0 : _a[1]));
       const rawData = storeInst.memoryCache ? storeInst.getData() : await storeInst.loadData();
-      const data = encoded ? await storeInst.encodeData[1](JSON.stringify(rawData)) : JSON.stringify(rawData);
+      const data = encoded ? await storeInst.encodeData[1](JSON.stringify(rawData)) : this.options.stringifyData ? JSON.stringify(rawData) : rawData;
       serData.push({
         id: storeInst.id,
         data,
@@ -1451,11 +1490,11 @@ var DataStoreSerializer = class _DataStoreSerializer {
 Expected: ${storeData.checksum}
 Has: ${checksum}`);
       }
-      const decodedData = storeData.encoded && storeInst.encodingEnabled() ? await storeInst.decodeData[1](storeData.data) : storeData.data;
+      const decodedData = storeData.encoded && storeInst.encodingEnabled() ? await storeInst.decodeData[1](typeof storeData.data === "string" ? storeData.data : JSON.stringify(storeData.data)) : storeData.data;
       if (storeData.formatVersion && !isNaN(Number(storeData.formatVersion)) && Number(storeData.formatVersion) < storeInst.formatVersion)
-        await storeInst.runMigrations(JSON.parse(decodedData), Number(storeData.formatVersion), false);
+        await storeInst.runMigrations(typeof decodedData === "string" ? JSON.parse(decodedData) : decodedData, Number(storeData.formatVersion), false);
       else
-        await storeInst.setData(JSON.parse(decodedData));
+        await storeInst.setData(typeof decodedData === "string" ? JSON.parse(decodedData) : decodedData);
     }
   }
   /**
@@ -1524,6 +1563,8 @@ var Debouncer = class extends NanoEmitter {
     this.timeout = timeout;
     this.type = type;
   }
+  timeout;
+  type;
   /** All registered listener functions and the time they were attached */
   listeners = [];
   /** The currently active timeout */
@@ -1551,7 +1592,7 @@ var Debouncer = class extends NanoEmitter {
   //#region timeout
   /** Sets the timeout for the debouncer */
   setTimeout(timeout) {
-    this.events.emit("change", this.timeout = timeout, this.type);
+    this.emitEvent("change", this.timeout = timeout, this.type);
   }
   /** Returns the current timeout */
   getTimeout() {
@@ -1564,7 +1605,7 @@ var Debouncer = class extends NanoEmitter {
   //#region type
   /** Sets the edge type for the debouncer */
   setType(type) {
-    this.events.emit("change", this.timeout, this.type = type);
+    this.emitEvent("change", this.timeout, this.type = type);
   }
   /** Returns the current edge type */
   getType() {
@@ -1575,7 +1616,7 @@ var Debouncer = class extends NanoEmitter {
   call(...args) {
     const cl = (...a) => {
       this.queuedCall = void 0;
-      this.events.emit("call", ...a);
+      this.emitEvent("call", ...a);
       this.listeners.forEach((l) => l.call(this, ...a));
     };
     const setRepeatTimeout = () => {
@@ -1653,6 +1694,7 @@ export {
   formatNumber,
   getCallStack,
   getListLength,
+  getterifyObj,
   hexToRgb,
   insertValues,
   joinArrayReadable,