@sv443-network/coreutils 1.0.0 → 2.0.0

package/dist/CoreUtils.umd.js

@@ -16,41 +16,13 @@
 
 
 
-(function(g,f){if(typeof exports=="object"&&typeof module<"u"){module.exports=f()}else if("function"==typeof define && define.amd){define("CoreUtils",f)}else {g["CoreUtils"]=f()}}(typeof globalThis < "u" ? globalThis : typeof self < "u" ? self : this,function(){var exports={};var __exports=exports;var module={exports};
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getOwnPropSymbols = Object.getOwnPropertySymbols;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __propIsEnum = Object.prototype.propertyIsEnumerable;
-var __pow = Math.pow;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __spreadValues = (a, b) => {
-  for (var prop in b || (b = {}))
-    if (__hasOwnProp.call(b, prop))
-      __defNormalProp(a, prop, b[prop]);
-  if (__getOwnPropSymbols)
-    for (var prop of __getOwnPropSymbols(b)) {
-      if (__propIsEnum.call(b, prop))
-        __defNormalProp(a, prop, b[prop]);
-    }
-  return a;
-};
-var __objRest = (source, exclude) => {
-  var target = {};
-  for (var prop in source)
-    if (__hasOwnProp.call(source, prop) && exclude.indexOf(prop) < 0)
-      target[prop] = source[prop];
-  if (source != null && __getOwnPropSymbols)
-    for (var prop of __getOwnPropSymbols(source)) {
-      if (exclude.indexOf(prop) < 0 && __propIsEnum.call(source, prop))
-        target[prop] = source[prop];
-    }
-  return target;
-};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -72,27 +44,6 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-var __async = (__this, __arguments, generator) => {
-  return new Promise((resolve, reject) => {
-    var fulfilled = (value) => {
-      try {
-        step(generator.next(value));
-      } catch (e) {
-        reject(e);
-      }
-    };
-    var rejected = (value) => {
-      try {
-        step(generator.throw(value));
-      } catch (e) {
-        reject(e);
-      }
-    };
-    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
-    step((generator = generator.apply(__this, __arguments)).next());
-  });
-};
 
 // lib/index.ts
 var lib_exports = {};
@@ -132,6 +83,7 @@ __export(lib_exports, {
   joinArrayReadable: () => joinArrayReadable,
   lightenColor: () => lightenColor,
   mapRange: () => mapRange,
+  overflowVal: () => overflowVal,
   pauseFor: () => pauseFor,
   pureObj: () => pureObj,
   randRange: () => randRange,
@@ -195,6 +147,19 @@ function mapRange(value, range1min, range1max, range2min, range2max) {
     return value * (range2max / range1max);
   return (value - range1min) * ((range2max - range2min) / (range1max - range1min)) + range2min;
 }
+function overflowVal(value, minOrMax, max) {
+  const min = typeof max === "number" ? minOrMax : 0;
+  max = typeof max === "number" ? max : minOrMax;
+  if (min > max)
+    throw new RangeError(`Parameter "min" can't be bigger than "max"`);
+  if (isNaN(value) || isNaN(min) || isNaN(max) || !isFinite(value) || !isFinite(min) || !isFinite(max))
+    return NaN;
+  if (value >= min && value <= max)
+    return value;
+  const range = max - min + 1;
+  const wrappedValue = ((value - min) % range + range) % range + min;
+  return wrappedValue;
+}
 function randRange(...args) {
   let min, max, enhancedEntropy = false;
   if (typeof args[0] === "number" && typeof args[1] === "number")
@@ -225,7 +190,7 @@ function randRange(...args) {
     return Math.floor(Math.random() * (max - min + 1)) + min;
 }
 function roundFixed(num, fractionDigits) {
-  const scale = __pow(10, fractionDigits);
+  const scale = 10 ** fractionDigits;
   return Math.round(num * scale) / scale;
 }
 function valsWithin(a, b, dec = 10, withinRange = 0.5) {
@@ -289,11 +254,9 @@ function darkenColor(color, percent, upperCase = false) {
   if (isHexCol)
     return rgbToHex(r, g, b, a, color.startsWith("#"), upperCase);
   else if (color.startsWith("rgba"))
-    return `rgba(${r}, ${g}, ${b}, ${a != null ? a : NaN})`;
-  else if (color.startsWith("rgb"))
-    return `rgb(${r}, ${g}, ${b})`;
+    return `rgba(${r}, ${g}, ${b}, ${a ?? NaN})`;
   else
-    throw new TypeError("Unsupported color format");
+    return `rgb(${r}, ${g}, ${b})`;
 }
 function hexToRgb(hex) {
   hex = (hex.startsWith("#") ? hex.slice(1) : hex).trim();
@@ -325,43 +288,35 @@ function abtoa(buf) {
 function atoab(str) {
   return Uint8Array.from(atob(str), (c) => c.charCodeAt(0));
 }
-function compress(input, compressionFormat, outputType = "string") {
-  return __async(this, null, function* () {
-    var _a;
-    const byteArray = input instanceof ArrayBuffer ? input : new TextEncoder().encode((_a = input == null ? void 0 : input.toString()) != null ? _a : String(input));
-    const comp = new CompressionStream(compressionFormat);
-    const writer = comp.writable.getWriter();
-    writer.write(byteArray);
-    writer.close();
-    const buf = yield new Response(comp.readable).arrayBuffer();
-    return outputType === "arrayBuffer" ? buf : abtoa(buf);
-  });
+async function compress(input, compressionFormat, outputType = "string") {
+  const byteArray = input instanceof Uint8Array ? input : new TextEncoder().encode((input == null ? void 0 : input.toString()) ?? String(input));
+  const comp = new CompressionStream(compressionFormat);
+  const writer = comp.writable.getWriter();
+  writer.write(byteArray);
+  writer.close();
+  const uintArr = new Uint8Array(await new Response(comp.readable).arrayBuffer());
+  return outputType === "arrayBuffer" ? uintArr : abtoa(uintArr);
 }
-function decompress(input, compressionFormat, outputType = "string") {
-  return __async(this, null, function* () {
-    var _a;
-    const byteArray = input instanceof ArrayBuffer ? input : atoab((_a = input == null ? void 0 : input.toString()) != null ? _a : String(input));
-    const decomp = new DecompressionStream(compressionFormat);
-    const writer = decomp.writable.getWriter();
-    writer.write(byteArray);
-    writer.close();
-    const buf = yield new Response(decomp.readable).arrayBuffer();
-    return outputType === "arrayBuffer" ? buf : new TextDecoder().decode(buf);
-  });
+async function decompress(input, compressionFormat, outputType = "string") {
+  const byteArray = input instanceof Uint8Array ? input : atoab((input == null ? void 0 : input.toString()) ?? String(input));
+  const decomp = new DecompressionStream(compressionFormat);
+  const writer = decomp.writable.getWriter();
+  writer.write(byteArray);
+  writer.close();
+  const uintArr = new Uint8Array(await new Response(decomp.readable).arrayBuffer());
+  return outputType === "arrayBuffer" ? uintArr : new TextDecoder().decode(uintArr);
 }
-function computeHash(input, algorithm = "SHA-256") {
-  return __async(this, null, function* () {
-    let data;
-    if (typeof input === "string") {
-      const encoder = new TextEncoder();
-      data = encoder.encode(input);
-    } else
-      data = input;
-    const hashBuffer = yield crypto.subtle.digest(algorithm, data);
-    const hashArray = Array.from(new Uint8Array(hashBuffer));
-    const hashHex = hashArray.map((byte) => byte.toString(16).padStart(2, "0")).join("");
-    return hashHex;
-  });
+async function computeHash(input, algorithm = "SHA-256") {
+  let data;
+  if (typeof input === "string") {
+    const encoder = new TextEncoder();
+    data = encoder.encode(input);
+  } else
+    data = input;
+  const hashBuffer = await crypto.subtle.digest(algorithm, data);
+  const hashArray = Array.from(new Uint8Array(hashBuffer));
+  const hashHex = hashArray.map((byte) => byte.toString(16).padStart(2, "0")).join("");
+  return hashHex;
 }
 function randomId(length = 16, radix = 16, enhancedEntropy = false, randomCase = true) {
   if (length < 1)
@@ -389,38 +344,35 @@ function randomId(length = 16, radix = 16, enhancedEntropy = false, randomCase =
 }
 
 // lib/misc.ts
-function consumeGen(valGen) {
-  return __async(this, null, function* () {
-    return yield typeof valGen === "function" ? valGen() : valGen;
-  });
+async function consumeGen(valGen) {
+  return await (typeof valGen === "function" ? valGen() : valGen);
 }
-function consumeStringGen(strGen) {
-  return __async(this, null, function* () {
-    return typeof strGen === "string" ? strGen : String(
-      typeof strGen === "function" ? yield strGen() : strGen
-    );
-  });
+async function consumeStringGen(strGen) {
+  return typeof strGen === "string" ? strGen : String(
+    typeof strGen === "function" ? await strGen() : strGen
+  );
 }
-function fetchAdvanced(_0) {
-  return __async(this, arguments, function* (input, options = {}) {
-    const { timeout = 1e4 } = options;
-    const ctl = new AbortController();
-    const _a = options, { signal } = _a, restOpts = __objRest(_a, ["signal"]);
-    signal == null ? void 0 : signal.addEventListener("abort", () => ctl.abort());
-    let sigOpts = {}, id = void 0;
-    if (timeout >= 0) {
-      id = setTimeout(() => ctl.abort(), timeout);
-      sigOpts = { signal: ctl.signal };
-    }
-    try {
-      const res = yield fetch(input, __spreadValues(__spreadValues({}, restOpts), sigOpts));
-      typeof id !== "undefined" && clearTimeout(id);
-      return res;
-    } catch (err) {
-      typeof id !== "undefined" && clearTimeout(id);
-      throw new Error("Error while calling fetch", { cause: err });
-    }
-  });
+async function fetchAdvanced(input, options = {}) {
+  const { timeout = 1e4 } = options;
+  const ctl = new AbortController();
+  const { signal, ...restOpts } = options;
+  signal == null ? void 0 : signal.addEventListener("abort", () => ctl.abort());
+  let sigOpts = {}, id = void 0;
+  if (timeout >= 0) {
+    id = setTimeout(() => ctl.abort(), timeout);
+    sigOpts = { signal: ctl.signal };
+  }
+  try {
+    const res = await fetch(input, {
+      ...restOpts,
+      ...sigOpts
+    });
+    typeof id !== "undefined" && clearTimeout(id);
+    return res;
+  } catch (err) {
+    typeof id !== "undefined" && clearTimeout(id);
+    throw new Error("Error while calling fetch", { cause: err });
+  }
 }
 function getListLength(listLike, zeroOnInvalid = true) {
   return "length" in listLike ? listLike.length : "size" in listLike ? listLike.size : "count" in listLike ? listLike.count : zeroOnInvalid ? 0 : NaN;
@@ -435,7 +387,7 @@ function pauseFor(time, signal, rejectOnAbort = false) {
   });
 }
 function pureObj(obj) {
-  return Object.assign(/* @__PURE__ */ Object.create(null), obj != null ? obj : {});
+  return Object.assign(/* @__PURE__ */ Object.create(null), obj ?? {});
 }
 function setImmediateInterval(callback, interval, signal) {
   let intervalId;
@@ -452,12 +404,12 @@ function setImmediateInterval(callback, interval, signal) {
 function setImmediateTimeoutLoop(callback, interval, signal) {
   let timeout;
   const cleanup = () => clearTimeout(timeout);
-  const loop = () => __async(null, null, function* () {
+  const loop = async () => {
     if (signal == null ? void 0 : signal.aborted)
       return cleanup();
-    yield callback();
+    await callback();
     timeout = setTimeout(loop, interval);
-  });
+  };
   signal == null ? void 0 : signal.addEventListener("abort", cleanup);
   loop();
 }
@@ -524,9 +476,9 @@ function createProgressBar(percentage, barLength, chars = defaultPbChars) {
 }
 function insertValues(input, ...values) {
   return input.replace(/%\d/gm, (match) => {
-    var _a, _b;
+    var _a;
     const argIndex = Number(match.substring(1)) - 1;
-    return (_b = (_a = values[argIndex]) != null ? _a : match) == null ? void 0 : _b.toString();
+    return (_a = values[argIndex] ?? match) == null ? void 0 : _a.toString();
   });
 }
 function joinArrayReadable(array, separators = ", ", lastSeparator = " and ") {
@@ -555,17 +507,16 @@ function secsToTimeStr(seconds) {
   ].join("");
 }
 function truncStr(input, length, endStr = "...") {
-  var _a;
-  const str = (_a = input == null ? void 0 : input.toString()) != null ? _a : String(input);
+  const str = (input == null ? void 0 : input.toString()) ?? String(input);
   const finalStr = str.length > length ? str.substring(0, length - endStr.length) + endStr : str;
   return finalStr.length > length ? finalStr.substring(0, length) : finalStr;
 }
 
 // lib/Errors.ts
 var DatedError = class extends Error {
+  date;
   constructor(message, options) {
     super(message, options);
-    __publicField(this, "date");
     this.name = this.constructor.name;
     this.date = /* @__PURE__ */ new Date();
   }
@@ -592,28 +543,35 @@ var ValidationError = class extends DatedError {
 // lib/DataStore.ts
 var dsFmtVer = 1;
 var DataStore = class {
+  id;
+  formatVersion;
+  defaultData;
+  encodeData;
+  decodeData;
+  compressionFormat = "deflate-raw";
+  engine;
+  options;
+  /**
+   * Whether all first-init checks should be done.  
+   * This includes migrating the internal DataStore format, migrating data from the UserUtils format, and anything similar.  
+   * This is set to `true` by default. Create a subclass and set it to `false` before calling {@linkcode loadData()} if you want to explicitly skip these checks.
+   */
+  firstInit = true;
+  /** In-memory cached copy of the data that is saved in persistent storage used for synchronous read access. */
+  cachedData;
+  migrations;
+  migrateIds = [];
   /**
    * Creates an instance of DataStore to manage a sync & async database that is cached in memory and persistently saved across sessions.  
    * Supports migrating data from older versions to newer ones and populating the cache with default data if no persistent data is found.  
    *   
-   * - ⚠️ Requires the directives `@grant GM.getValue` and `@grant GM.setValue` if the storageMethod is left as the default of `"GM"`  
    * - ⚠️ Make sure to call {@linkcode loadData()} at least once after creating an instance, or the returned data will be the same as `options.defaultData`
    * 
    * @template TData The type of the data that is saved in persistent storage for the currently set format version (will be automatically inferred from `defaultData` if not provided) - **This has to be a JSON-compatible object!** (no undefined, circular references, etc.)
    * @param opts The options for this DataStore instance
    */
   constructor(opts) {
-    __publicField(this, "id");
-    __publicField(this, "formatVersion");
-    __publicField(this, "defaultData");
-    __publicField(this, "encodeData");
-    __publicField(this, "decodeData");
-    __publicField(this, "compressionFormat", "deflate-raw");
-    __publicField(this, "engine");
-    __publicField(this, "firstInit", true);
-    __publicField(this, "cachedData");
-    __publicField(this, "migrations");
-    __publicField(this, "migrateIds", []);
+    var _a;
     this.id = opts.id;
     this.formatVersion = opts.formatVersion;
     this.defaultData = opts.defaultData;
@@ -624,15 +582,12 @@ var DataStore = class {
     this.encodeData = opts.encodeData;
     this.decodeData = opts.decodeData;
     this.engine = typeof opts.engine === "function" ? opts.engine() : opts.engine;
+    this.options = opts;
     if (typeof opts.compressionFormat === "undefined")
-      opts.compressionFormat = "deflate-raw";
+      opts.compressionFormat = ((_a = opts.encodeData) == null ? void 0 : _a[0]) ?? "deflate-raw";
     if (typeof opts.compressionFormat === "string") {
-      this.encodeData = [opts.compressionFormat, (data) => __async(this, null, function* () {
-        return yield compress(data, opts.compressionFormat, "string");
-      })];
-      this.decodeData = [opts.compressionFormat, (data) => __async(this, null, function* () {
-        return yield compress(data, opts.compressionFormat, "string");
-      })];
+      this.encodeData = [opts.compressionFormat, async (data) => await compress(data, opts.compressionFormat, "string")];
+      this.decodeData = [opts.compressionFormat, async (data) => await compress(data, opts.compressionFormat, "string")];
     } else if ("encodeData" in opts && "decodeData" in opts && Array.isArray(opts.encodeData) && Array.isArray(opts.decodeData)) {
       this.encodeData = [opts.encodeData[0], opts.encodeData[1]];
       this.decodeData = [opts.decodeData[0], opts.decodeData[1]];
@@ -649,58 +604,62 @@ var DataStore = class {
    * Automatically populates persistent storage with default data if it doesn't contain any data yet.  
    * Also runs all necessary migration functions if the data format has changed since the last time the data was saved.
    */
-  loadData() {
-    return __async(this, null, function* () {
-      try {
-        if (this.firstInit) {
-          this.firstInit = false;
-          const dsVer = Number(yield this.engine.getValue("__ds_fmt_ver", 0));
-          if (isNaN(dsVer) || dsVer < 1) {
-            const oldData = yield this.engine.getValue(`_uucfg-${this.id}`, null);
-            if (oldData) {
-              const oldVer = Number(yield this.engine.getValue(`_uucfgver-${this.id}`, NaN));
-              const oldEnc = yield this.engine.getValue(`_uucfgenc-${this.id}`, null);
-              const promises = [];
-              const migrateFmt = (oldKey, newKey, value) => {
-                promises.push(this.engine.setValue(newKey, value));
-                promises.push(this.engine.deleteValue(oldKey));
-              };
-              oldData && migrateFmt(`_uucfg-${this.id}`, `__ds-${this.id}-dat`, oldData);
-              !isNaN(oldVer) && migrateFmt(`_uucfgver-${this.id}`, `__ds-${this.id}-ver`, oldVer);
-              typeof oldEnc === "boolean" && migrateFmt(`_uucfgenc-${this.id}`, `__ds-${this.id}-enc`, oldEnc === true ? this.compressionFormat : null);
-              yield Promise.allSettled(promises);
-            }
-            yield this.engine.setValue("__ds_fmt_ver", dsFmtVer);
+  async loadData() {
+    try {
+      if (this.firstInit) {
+        this.firstInit = false;
+        const dsVer = Number(await this.engine.getValue("__ds_fmt_ver", 0));
+        if (isNaN(dsVer) || dsVer < 1) {
+          const oldData = await this.engine.getValue(`_uucfg-${this.id}`, null);
+          if (oldData) {
+            const oldVer = Number(await this.engine.getValue(`_uucfgver-${this.id}`, NaN));
+            const oldEnc = await this.engine.getValue(`_uucfgenc-${this.id}`, null);
+            const promises = [];
+            const migrateFmt = (oldKey, newKey, value) => {
+              promises.push(this.engine.setValue(newKey, value));
+              promises.push(this.engine.deleteValue(oldKey));
+            };
+            if (oldData)
+              migrateFmt(`_uucfg-${this.id}`, `__ds-${this.id}-dat`, oldData);
+            if (!isNaN(oldVer))
+              migrateFmt(`_uucfgver-${this.id}`, `__ds-${this.id}-ver`, oldVer);
+            if (typeof oldEnc === "boolean")
+              migrateFmt(`_uucfgenc-${this.id}`, `__ds-${this.id}-enf`, oldEnc === true ? Boolean(this.compressionFormat) || null : null);
+            else
+              promises.push(this.engine.setValue(`__ds-${this.id}-enf`, this.compressionFormat));
+            await Promise.allSettled(promises);
           }
+          await this.engine.setValue("__ds_fmt_ver", dsFmtVer);
         }
-        if (this.migrateIds.length > 0) {
-          yield this.migrateId(this.migrateIds);
-          this.migrateIds = [];
-        }
-        const gmData = yield this.engine.getValue(`__ds-${this.id}-dat`, JSON.stringify(this.defaultData));
-        let gmFmtVer = Number(yield this.engine.getValue(`__ds-${this.id}-ver`, NaN));
-        if (typeof gmData !== "string") {
-          yield this.saveDefaultData();
-          return __spreadValues({}, this.defaultData);
-        }
-        const isEncoded = Boolean(yield this.engine.getValue(`__ds-${this.id}-enc`, false));
-        let saveData = false;
-        if (isNaN(gmFmtVer)) {
-          yield this.engine.setValue(`__ds-${this.id}-ver`, gmFmtVer = this.formatVersion);
-          saveData = true;
-        }
-        let parsed = yield this.engine.deserializeData(gmData, isEncoded);
-        if (gmFmtVer < this.formatVersion && this.migrations)
-          parsed = yield this.runMigrations(parsed, gmFmtVer);
-        if (saveData)
-          yield this.setData(parsed);
-        return this.cachedData = this.engine.deepCopy(parsed);
-      } catch (err) {
-        console.warn("Error while parsing JSON data, resetting it to the default value.", err);
-        yield this.saveDefaultData();
-        return this.defaultData;
       }
-    });
+      if (this.migrateIds.length > 0) {
+        await this.migrateId(this.migrateIds);
+        this.migrateIds = [];
+      }
+      const storedData = await this.engine.getValue(`__ds-${this.id}-dat`, JSON.stringify(this.defaultData));
+      let storedFmtVer = Number(await this.engine.getValue(`__ds-${this.id}-ver`, NaN));
+      if (typeof storedData !== "string") {
+        await this.saveDefaultData();
+        return { ...this.defaultData };
+      }
+      const encodingFmt = String(await this.engine.getValue(`__ds-${this.id}-enf`, null));
+      const isEncoded = encodingFmt !== "null" && encodingFmt !== "false";
+      let saveData = false;
+      if (isNaN(storedFmtVer)) {
+        await this.engine.setValue(`__ds-${this.id}-ver`, storedFmtVer = this.formatVersion);
+        saveData = true;
+      }
+      let parsed = await this.engine.deserializeData(storedData, isEncoded);
+      if (storedFmtVer < this.formatVersion && this.migrations)
+        parsed = await this.runMigrations(parsed, storedFmtVer);
+      if (saveData)
+        await this.setData(parsed);
+      return this.cachedData = this.engine.deepCopy(parsed);
+    } catch (err) {
+      console.warn("Error while parsing JSON data, resetting it to the default value.", err);
+      await this.saveDefaultData();
+      return this.defaultData;
+    }
   }
   /**
    * Returns a copy of the data from the in-memory cache.  
@@ -712,47 +671,41 @@ var DataStore = class {
   /** Saves the data synchronously to the in-memory cache and asynchronously to the persistent storage */
   setData(data) {
     this.cachedData = data;
-    const useEncoding = this.encodingEnabled();
-    return new Promise((resolve) => __async(this, null, function* () {
-      yield Promise.allSettled([
-        this.engine.setValue(`__ds-${this.id}-dat`, yield this.engine.serializeData(data, useEncoding)),
+    return new Promise(async (resolve) => {
+      await Promise.allSettled([
+        this.engine.setValue(`__ds-${this.id}-dat`, await this.engine.serializeData(data, this.encodingEnabled())),
         this.engine.setValue(`__ds-${this.id}-ver`, this.formatVersion),
-        this.engine.setValue(`__ds-${this.id}-enc`, useEncoding)
+        this.engine.setValue(`__ds-${this.id}-enf`, this.compressionFormat)
       ]);
       resolve();
-    }));
+    });
   }
   /** Saves the default data passed in the constructor synchronously to the in-memory cache and asynchronously to persistent storage */
-  saveDefaultData() {
-    return __async(this, null, function* () {
-      this.cachedData = this.defaultData;
-      const useEncoding = this.encodingEnabled();
-      yield Promise.allSettled([
-        this.engine.setValue(`__ds-${this.id}-dat`, yield this.engine.serializeData(this.defaultData, useEncoding)),
-        this.engine.setValue(`__ds-${this.id}-ver`, this.formatVersion),
-        this.engine.setValue(`__ds-${this.id}-enc`, useEncoding)
-      ]);
-    });
+  async saveDefaultData() {
+    this.cachedData = this.defaultData;
+    await Promise.allSettled([
+      this.engine.setValue(`__ds-${this.id}-dat`, await this.engine.serializeData(this.defaultData, this.encodingEnabled())),
+      this.engine.setValue(`__ds-${this.id}-ver`, this.formatVersion),
+      this.engine.setValue(`__ds-${this.id}-enf`, this.compressionFormat)
+    ]);
   }
   /**
-   * Call this method to clear all persistently stored data associated with this DataStore instance.  
+   * Call this method to clear all persistently stored data associated with this DataStore instance, including the storage container (if supported by the DataStoreEngine).  
    * The in-memory cache will be left untouched, so you may still access the data with {@linkcode getData()}  
-   * Calling {@linkcode loadData()} or {@linkcode setData()} after this method was called will recreate persistent storage with the cached or default data.  
-   *   
-   * - ⚠️ This requires the additional directive `@grant GM.deleteValue` if the storageMethod is left as the default of `"GM"`
+   * Calling {@linkcode loadData()} or {@linkcode setData()} after this method was called will recreate persistent storage with the cached or default data.
    */
-  deleteData() {
-    return __async(this, null, function* () {
-      yield Promise.allSettled([
-        this.engine.deleteValue(`__ds-${this.id}-dat`),
-        this.engine.deleteValue(`__ds-${this.id}-ver`),
-        this.engine.deleteValue(`__ds-${this.id}-enc`)
-      ]);
-    });
+  async deleteData() {
+    var _a, _b;
+    await Promise.allSettled([
+      this.engine.deleteValue(`__ds-${this.id}-dat`),
+      this.engine.deleteValue(`__ds-${this.id}-ver`),
+      this.engine.deleteValue(`__ds-${this.id}-enf`)
+    ]);
+    await ((_b = (_a = this.engine).deleteStorage) == null ? void 0 : _b.call(_a));
   }
   /** Returns whether encoding and decoding are enabled for this DataStore instance */
   encodingEnabled() {
-    return Boolean(this.encodeData && this.decodeData);
+    return Boolean(this.encodeData && this.decodeData) && this.compressionFormat !== null || Boolean(this.compressionFormat);
   }
   //#region migrations
   /**
@@ -762,98 +715,106 @@ var DataStore = class {
    *   
    * If one of the migrations fails, the data will be reset to the default value if `resetOnError` is set to `true` (default). Otherwise, an error will be thrown and no data will be saved.
    */
-  runMigrations(oldData, oldFmtVer, resetOnError = true) {
-    return __async(this, null, function* () {
-      if (!this.migrations)
-        return oldData;
-      let newData = oldData;
-      const sortedMigrations = Object.entries(this.migrations).sort(([a], [b]) => Number(a) - Number(b));
-      let lastFmtVer = oldFmtVer;
-      for (const [fmtVer, migrationFunc] of sortedMigrations) {
-        const ver = Number(fmtVer);
-        if (oldFmtVer < this.formatVersion && oldFmtVer < ver) {
-          try {
-            const migRes = migrationFunc(newData);
-            newData = migRes instanceof Promise ? yield migRes : migRes;
-            lastFmtVer = oldFmtVer = ver;
-          } catch (err) {
-            if (!resetOnError)
-              throw new MigrationError(`Error while running migration function for format version '${fmtVer}'`, { cause: err });
-            yield this.saveDefaultData();
-            return this.getData();
-          }
+  async runMigrations(oldData, oldFmtVer, resetOnError = true) {
+    if (!this.migrations)
+      return oldData;
+    let newData = oldData;
+    const sortedMigrations = Object.entries(this.migrations).sort(([a], [b]) => Number(a) - Number(b));
+    let lastFmtVer = oldFmtVer;
+    for (const [fmtVer, migrationFunc] of sortedMigrations) {
+      const ver = Number(fmtVer);
+      if (oldFmtVer < this.formatVersion && oldFmtVer < ver) {
+        try {
+          const migRes = migrationFunc(newData);
+          newData = migRes instanceof Promise ? await migRes : migRes;
+          lastFmtVer = oldFmtVer = ver;
+        } catch (err) {
+          if (!resetOnError)
+            throw new MigrationError(`Error while running migration function for format version '${fmtVer}'`, { cause: err });
+          await this.saveDefaultData();
+          return this.getData();
         }
       }
-      yield Promise.allSettled([
-        this.engine.setValue(`__ds-${this.id}-dat`, yield this.engine.serializeData(newData)),
-        this.engine.setValue(`__ds-${this.id}-ver`, lastFmtVer),
-        this.engine.setValue(`__ds-${this.id}-enc`, this.encodingEnabled())
-      ]);
-      return this.cachedData = __spreadValues({}, newData);
-    });
+    }
+    await Promise.allSettled([
+      this.engine.setValue(`__ds-${this.id}-dat`, await this.engine.serializeData(newData)),
+      this.engine.setValue(`__ds-${this.id}-ver`, lastFmtVer),
+      this.engine.setValue(`__ds-${this.id}-enf`, this.compressionFormat)
+    ]);
+    return this.cachedData = { ...newData };
   }
   /**
    * Tries to migrate the currently saved persistent data from one or more old IDs to the ID set in the constructor.  
    * If no data exist for the old ID(s), nothing will be done, but some time may still pass trying to fetch the non-existent data.
    */
-  migrateId(oldIds) {
-    return __async(this, null, function* () {
-      const ids = Array.isArray(oldIds) ? oldIds : [oldIds];
-      yield Promise.all(ids.map((id) => __async(this, null, function* () {
-        const data = yield this.engine.getValue(`__ds-${id}-dat`, JSON.stringify(this.defaultData));
-        const fmtVer = Number(yield this.engine.getValue(`__ds-${id}-ver`, NaN));
-        const isEncoded = Boolean(yield this.engine.getValue(`__ds-${id}-enc`, false));
-        if (data === void 0 || isNaN(fmtVer))
-          return;
-        const parsed = yield this.engine.deserializeData(data, isEncoded);
-        yield Promise.allSettled([
-          this.engine.setValue(`__ds-${this.id}-dat`, yield this.engine.serializeData(parsed)),
-          this.engine.setValue(`__ds-${this.id}-ver`, fmtVer),
-          this.engine.setValue(`__ds-${this.id}-enc`, isEncoded),
-          this.engine.deleteValue(`__ds-${id}-dat`),
-          this.engine.deleteValue(`__ds-${id}-ver`),
-          this.engine.deleteValue(`__ds-${id}-enc`)
+  async migrateId(oldIds) {
+    const ids = Array.isArray(oldIds) ? oldIds : [oldIds];
+    await Promise.all(ids.map(async (id) => {
+      const [data, fmtVer, isEncoded] = await (async () => {
+        const [d, f, e] = await Promise.all([
+          this.engine.getValue(`__ds-${id}-dat`, JSON.stringify(this.defaultData)),
+          this.engine.getValue(`__ds-${id}-ver`, NaN),
+          this.engine.getValue(`__ds-${id}-enf`, null)
         ]);
-      })));
-    });
+        return [d, Number(f), Boolean(e) && String(e) !== "null"];
+      })();
+      if (data === void 0 || isNaN(fmtVer))
+        return;
+      const parsed = await this.engine.deserializeData(data, isEncoded);
+      await Promise.allSettled([
+        this.engine.setValue(`__ds-${this.id}-dat`, await this.engine.serializeData(parsed)),
+        this.engine.setValue(`__ds-${this.id}-ver`, fmtVer),
+        this.engine.setValue(`__ds-${this.id}-enf`, this.compressionFormat),
+        this.engine.deleteValue(`__ds-${id}-dat`),
+        this.engine.deleteValue(`__ds-${id}-ver`),
+        this.engine.deleteValue(`__ds-${id}-enf`)
+      ]);
+    }));
   }
 };
 
 // lib/DataStoreEngine.ts
 var DataStoreEngine = class {
-  constructor() {
-    __publicField(this, "dataStoreOptions");
-  }
+  dataStoreOptions;
   // setDataStoreOptions() is called from inside the DataStore constructor to set this value
-  /** Called by DataStore on creation, to pass its options */
+  constructor(options) {
+    if (options)
+      this.dataStoreOptions = options;
+  }
+  /** Called by DataStore on creation, to pass its options. Only call this if you are using this instance standalone! */
   setDataStoreOptions(dataStoreOptions) {
     this.dataStoreOptions = dataStoreOptions;
   }
   //#region serialization api
   /** Serializes the given object to a string, optionally encoded with `options.encodeData` if {@linkcode useEncoding} is set to true */
-  serializeData(data, useEncoding) {
-    return __async(this, null, function* () {
-      var _a, _b, _c, _d, _e;
-      const stringData = JSON.stringify(data);
-      if (!useEncoding || !((_a = this.dataStoreOptions) == null ? void 0 : _a.encodeData) || !((_b = this.dataStoreOptions) == null ? void 0 : _b.decodeData))
-        return stringData;
-      const encRes = (_e = (_d = (_c = this.dataStoreOptions) == null ? void 0 : _c.encodeData) == null ? void 0 : _d[1]) == null ? void 0 : _e.call(_d, stringData);
-      if (encRes instanceof Promise)
-        return yield encRes;
-      return encRes;
-    });
+  async serializeData(data, useEncoding) {
+    var _a, _b, _c, _d, _e;
+    this.ensureDataStoreOptions();
+    const stringData = JSON.stringify(data);
+    if (!useEncoding || !((_a = this.dataStoreOptions) == null ? void 0 : _a.encodeData) || !((_b = this.dataStoreOptions) == null ? void 0 : _b.decodeData))
+      return stringData;
+    const encRes = (_e = (_d = (_c = this.dataStoreOptions) == null ? void 0 : _c.encodeData) == null ? void 0 : _d[1]) == null ? void 0 : _e.call(_d, stringData);
+    if (encRes instanceof Promise)
+      return await encRes;
+    return encRes;
   }
   /** Deserializes the given string to a JSON object, optionally decoded with `options.decodeData` if {@linkcode useEncoding} is set to true */
-  deserializeData(data, useEncoding) {
-    return __async(this, null, function* () {
-      var _a, _b, _c;
-      let decRes = ((_a = this.dataStoreOptions) == null ? void 0 : _a.decodeData) && useEncoding ? (_c = (_b = this.dataStoreOptions.decodeData) == null ? void 0 : _b[1]) == null ? void 0 : _c.call(_b, data) : void 0;
-      if (decRes instanceof Promise)
-        decRes = yield decRes;
-      return JSON.parse(decRes != null ? decRes : data);
-    });
+  async deserializeData(data, useEncoding) {
+    var _a, _b, _c;
+    this.ensureDataStoreOptions();
+    let decRes = ((_a = this.dataStoreOptions) == null ? void 0 : _a.decodeData) && useEncoding ? (_c = (_b = this.dataStoreOptions.decodeData) == null ? void 0 : _b[1]) == null ? void 0 : _c.call(_b, data) : void 0;
+    if (decRes instanceof Promise)
+      decRes = await decRes;
+    return JSON.parse(decRes ?? data);
   }
   //#region misc api
+  /** Throws an error if the DataStoreOptions are not set or invalid */
+  ensureDataStoreOptions() {
+    if (!this.dataStoreOptions)
+      throw new DatedError("DataStoreEngine must be initialized with DataStore options before use. If you are using this instance standalone, set them in the constructor or call `setDataStoreOptions()` with the DataStore options.");
+    if (!this.dataStoreOptions.id)
+      throw new DatedError("DataStoreEngine must be initialized with a valid DataStore ID");
+  }
   /**
    * Copies a JSON-compatible object and loses all its internal references in the process.  
    * Uses [`structuredClone()`](https://developer.mozilla.org/en-US/docs/Web/API/structuredClone) if available, otherwise falls back to `JSON.parse(JSON.stringify(obj))`.
@@ -862,157 +823,158 @@ var DataStoreEngine = class {
     try {
       if ("structuredClone" in globalThis)
         return structuredClone(obj);
-    } catch (e) {
+    } catch {
     }
     return JSON.parse(JSON.stringify(obj));
   }
 };
 var BrowserStorageEngine = class extends DataStoreEngine {
+  options;
   /**
    * Creates an instance of `BrowserStorageEngine`.  
    *   
-   * ⚠️ Requires a DOM environment  
-   * ⚠️ Don't reuse this engine across multiple {@linkcode DataStore} instances
+   * - ⚠️ Requires a DOM environment  
+   * - ⚠️ Don't reuse engines across multiple {@linkcode DataStore} instances
    */
   constructor(options) {
-    super();
-    __publicField(this, "options");
-    this.options = __spreadValues({
-      type: "localStorage"
-    }, options);
+    super(options == null ? void 0 : options.dataStoreOptions);
+    this.options = {
+      type: "localStorage",
+      ...options
+    };
   }
   //#region storage api
   /** Fetches a value from persistent storage */
-  getValue(name, defaultValue) {
-    return __async(this, null, function* () {
-      var _a;
-      return (_a = this.options.type === "localStorage" ? globalThis.localStorage.getItem(name) : globalThis.sessionStorage.getItem(name)) != null ? _a : defaultValue;
-    });
+  async getValue(name, defaultValue) {
+    return (this.options.type === "localStorage" ? globalThis.localStorage.getItem(name) : globalThis.sessionStorage.getItem(name)) ?? defaultValue;
   }
   /** Sets a value in persistent storage */
-  setValue(name, value) {
-    return __async(this, null, function* () {
-      if (this.options.type === "localStorage")
-        globalThis.localStorage.setItem(name, String(value));
-      else
-        globalThis.sessionStorage.setItem(name, String(value));
-    });
+  async setValue(name, value) {
+    if (this.options.type === "localStorage")
+      globalThis.localStorage.setItem(name, String(value));
+    else
+      globalThis.sessionStorage.setItem(name, String(value));
   }
   /** Deletes a value from persistent storage */
-  deleteValue(name) {
-    return __async(this, null, function* () {
-      if (this.options.type === "localStorage")
-        globalThis.localStorage.removeItem(name);
-      else
-        globalThis.sessionStorage.removeItem(name);
-    });
+  async deleteValue(name) {
+    if (this.options.type === "localStorage")
+      globalThis.localStorage.removeItem(name);
+    else
+      globalThis.sessionStorage.removeItem(name);
   }
 };
 var fs;
 var FileStorageEngine = class extends DataStoreEngine {
+  options;
   /**
    * Creates an instance of `FileStorageEngine`.  
    *   
-   * ⚠️ Requires Node.js or Deno with Node compatibility (v1.31+)  
-   * ⚠️ Don't reuse this engine across multiple {@linkcode DataStore} instances
+   * - ⚠️ Requires Node.js or Deno with Node compatibility (v1.31+)  
+   * - ⚠️ Don't reuse engines across multiple {@linkcode DataStore} instances
    */
   constructor(options) {
-    super();
-    __publicField(this, "options");
-    this.options = __spreadValues({
-      filePath: (id) => `.ds-${id}`
-    }, options);
+    super(options == null ? void 0 : options.dataStoreOptions);
+    this.options = {
+      filePath: (id) => `.ds-${id}`,
+      ...options
+    };
   }
   //#region json file
   /** Reads the file contents */
-  readFile() {
-    return __async(this, null, function* () {
-      var _a, _b, _c, _d;
-      try {
-        if (!fs)
-          fs = (yield import("fs/promises")).default;
-        if (!fs)
-          throw new DatedError("FileStorageEngine requires Node.js or Deno with Node compatibility (v1.31+)", { cause: new Error("'node:fs/promises' module not available") });
-        const path = typeof this.options.filePath === "string" ? this.options.filePath : this.options.filePath(this.dataStoreOptions.id);
-        const data = yield fs.readFile(path, "utf-8");
-        return data ? JSON.parse((_d = yield (_c = (_b = (_a = this.dataStoreOptions) == null ? void 0 : _a.decodeData) == null ? void 0 : _b[1]) == null ? void 0 : _c.call(_b, data)) != null ? _d : data) : void 0;
-      } catch (e) {
-        return void 0;
-      }
-    });
+  async readFile() {
+    var _a, _b, _c, _d;
+    this.ensureDataStoreOptions();
+    try {
+      if (!fs)
+        fs = (_a = await import("fs/promises")) == null ? void 0 : _a.default;
+      if (!fs)
+        throw new DatedError("FileStorageEngine requires Node.js or Deno with Node compatibility (v1.31+)", { cause: new Error("'node:fs/promises' module not available") });
+      const path = typeof this.options.filePath === "string" ? this.options.filePath : this.options.filePath(this.dataStoreOptions.id);
+      const data = await fs.readFile(path, "utf-8");
+      return data ? JSON.parse(await ((_d = (_c = (_b = this.dataStoreOptions) == null ? void 0 : _b.decodeData) == null ? void 0 : _c[1]) == null ? void 0 : _d.call(_c, data)) ?? data) : void 0;
+    } catch {
+      return void 0;
+    }
   }
   /** Overwrites the file contents */
-  writeFile(data) {
-    return __async(this, null, function* () {
-      var _a, _b, _c, _d;
-      try {
-        if (!fs)
-          fs = (yield import("fs/promises")).default;
-        if (!fs)
-          throw new DatedError("FileStorageEngine requires Node.js or Deno with Node compatibility (v1.31+)", { cause: new Error("'node:fs/promises' module not available") });
-        const path = typeof this.options.filePath === "string" ? this.options.filePath : this.options.filePath(this.dataStoreOptions.id);
-        yield fs.mkdir(path.slice(0, path.lastIndexOf("/")), { recursive: true });
-        yield fs.writeFile(path, (_d = yield (_c = (_b = (_a = this.dataStoreOptions) == null ? void 0 : _a.encodeData) == null ? void 0 : _b[1]) == null ? void 0 : _c.call(_b, JSON.stringify(data))) != null ? _d : JSON.stringify(data, void 0, 2), "utf-8");
-      } catch (err) {
-        console.error("Error writing file:", err);
-      }
-    });
+  async writeFile(data) {
+    var _a, _b, _c, _d;
+    this.ensureDataStoreOptions();
+    try {
+      if (!fs)
+        fs = (_a = await import("fs/promises")) == null ? void 0 : _a.default;
+      if (!fs)
+        throw new DatedError("FileStorageEngine requires Node.js or Deno with Node compatibility (v1.31+)", { cause: new Error("'node:fs/promises' module not available") });
+      const path = typeof this.options.filePath === "string" ? this.options.filePath : this.options.filePath(this.dataStoreOptions.id);
+      await fs.mkdir(path.slice(0, path.lastIndexOf("/")), { recursive: true });
+      await fs.writeFile(path, await ((_d = (_c = (_b = this.dataStoreOptions) == null ? void 0 : _b.encodeData) == null ? void 0 : _c[1]) == null ? void 0 : _d.call(_c, JSON.stringify(data))) ?? JSON.stringify(data, void 0, 2), "utf-8");
+    } catch (err) {
+      console.error("Error writing file:", err);
+    }
   }
   //#region storage api
   /** Fetches a value from persistent storage */
-  getValue(name, defaultValue) {
-    return __async(this, null, function* () {
-      const data = yield this.readFile();
-      if (!data)
-        return defaultValue;
-      const value = data == null ? void 0 : data[name];
-      if (value === void 0)
-        return defaultValue;
-      if (typeof value === "string")
-        return value;
-      return String(value != null ? value : defaultValue);
-    });
+  async getValue(name, defaultValue) {
+    const data = await this.readFile();
+    if (!data)
+      return defaultValue;
+    const value = data == null ? void 0 : data[name];
+    if (value === void 0)
+      return defaultValue;
+    if (typeof value === "string")
+      return value;
+    return String(value ?? defaultValue);
   }
   /** Sets a value in persistent storage */
-  setValue(name, value) {
-    return __async(this, null, function* () {
-      let data = yield this.readFile();
-      if (!data)
-        data = {};
-      data[name] = value;
-      yield this.writeFile(data);
-    });
+  async setValue(name, value) {
+    let data = await this.readFile();
+    if (!data)
+      data = {};
+    data[name] = value;
+    await this.writeFile(data);
   }
   /** Deletes a value from persistent storage */
-  deleteValue(name) {
-    return __async(this, null, function* () {
-      const data = yield this.readFile();
-      if (!data)
-        return;
-      delete data[name];
-      yield this.writeFile(data);
-    });
+  async deleteValue(name) {
+    const data = await this.readFile();
+    if (!data)
+      return;
+    delete data[name];
+    await this.writeFile(data);
+  }
+  /** Deletes the file that contains the data of this DataStore. */
+  async deleteStorage() {
+    var _a;
+    this.ensureDataStoreOptions();
+    try {
+      if (!fs)
+        fs = (_a = await import("fs/promises")) == null ? void 0 : _a.default;
+      if (!fs)
+        throw new DatedError("FileStorageEngine requires Node.js or Deno with Node compatibility (v1.31+)", { cause: new Error("'node:fs/promises' module not available") });
+      const path = typeof this.options.filePath === "string" ? this.options.filePath : this.options.filePath(this.dataStoreOptions.id);
+      await fs.unlink(path);
+    } catch (err) {
+      console.error("Error deleting file:", err);
+    }
   }
 };
 
 // lib/DataStoreSerializer.ts
 var DataStoreSerializer = class _DataStoreSerializer {
+  stores;
+  options;
   constructor(stores, options = {}) {
-    __publicField(this, "stores");
-    __publicField(this, "options");
     if (!crypto || !crypto.subtle)
       throw new Error("DataStoreSerializer has to run in a secure context (HTTPS) or in another environment that implements the subtleCrypto API!");
     this.stores = stores;
-    this.options = __spreadValues({
+    this.options = {
       addChecksum: true,
-      ensureIntegrity: true
-    }, options);
+      ensureIntegrity: true,
+      ...options
+    };
   }
   /** Calculates the checksum of a string */
-  calcChecksum(input) {
-    return __async(this, null, function* () {
-      return computeHash(input, "SHA-256");
-    });
+  async calcChecksum(input) {
+    return computeHash(input, "SHA-256");
   }
   /**
    * Serializes only a subset of the data stores into a string.  
@@ -1020,68 +982,62 @@ var DataStoreSerializer = class _DataStoreSerializer {
    * @param useEncoding Whether to encode the data using each DataStore's `encodeData()` method
    * @param stringified Whether to return the result as a string or as an array of `SerializedDataStore` objects
    */
-  serializePartial(stores, useEncoding = true, stringified = true) {
-    return __async(this, null, function* () {
-      const serData = [];
-      for (const storeInst of this.stores.filter((s) => typeof stores === "function" ? stores(s.id) : stores.includes(s.id))) {
-        const data = useEncoding && storeInst.encodingEnabled() ? yield storeInst.encodeData[1](JSON.stringify(storeInst.getData())) : JSON.stringify(storeInst.getData());
-        serData.push({
-          id: storeInst.id,
-          data,
-          formatVersion: storeInst.formatVersion,
-          encoded: useEncoding && storeInst.encodingEnabled(),
-          checksum: this.options.addChecksum ? yield this.calcChecksum(data) : void 0
-        });
-      }
-      return stringified ? JSON.stringify(serData) : serData;
-    });
+  async serializePartial(stores, useEncoding = true, stringified = true) {
+    var _a;
+    const serData = [];
+    for (const storeInst of this.stores.filter((s) => typeof stores === "function" ? stores(s.id) : stores.includes(s.id))) {
+      const encoded = Boolean(useEncoding && storeInst.encodingEnabled() && ((_a = storeInst.encodeData) == null ? void 0 : _a[1]));
+      const data = encoded ? await storeInst.encodeData[1](JSON.stringify(storeInst.getData())) : JSON.stringify(storeInst.getData());
+      serData.push({
+        id: storeInst.id,
+        data,
+        formatVersion: storeInst.formatVersion,
+        encoded,
+        checksum: this.options.addChecksum ? await this.calcChecksum(data) : void 0
+      });
+    }
+    return stringified ? JSON.stringify(serData) : serData;
   }
   /**
    * Serializes the data stores into a string.  
    * @param useEncoding Whether to encode the data using each DataStore's `encodeData()` method
    * @param stringified Whether to return the result as a string or as an array of `SerializedDataStore` objects
    */
-  serialize(useEncoding = true, stringified = true) {
-    return __async(this, null, function* () {
-      return this.serializePartial(this.stores.map((s) => s.id), useEncoding, stringified);
-    });
+  async serialize(useEncoding = true, stringified = true) {
+    return this.serializePartial(this.stores.map((s) => s.id), useEncoding, stringified);
   }
   /**
    * Deserializes the data exported via {@linkcode serialize()} and imports only a subset into the DataStore instances.  
    * Also triggers the migration process if the data format has changed.
    */
-  deserializePartial(stores, data) {
-    return __async(this, null, function* () {
-      const deserStores = typeof data === "string" ? JSON.parse(data) : data;
-      if (!Array.isArray(deserStores) || !deserStores.every(_DataStoreSerializer.isSerializedDataStoreObj))
-        throw new TypeError("Invalid serialized data format! Expected an array of SerializedDataStore objects.");
-      for (const storeData of deserStores.filter((s) => typeof stores === "function" ? stores(s.id) : stores.includes(s.id))) {
-        const storeInst = this.stores.find((s) => s.id === storeData.id);
-        if (!storeInst)
-          throw new Error(`DataStore instance with ID "${storeData.id}" not found! Make sure to provide it in the DataStoreSerializer constructor.`);
-        if (this.options.ensureIntegrity && typeof storeData.checksum === "string") {
-          const checksum = yield this.calcChecksum(storeData.data);
-          if (checksum !== storeData.checksum)
-            throw new ChecksumMismatchError(`Checksum mismatch for DataStore with ID "${storeData.id}"!
+  async deserializePartial(stores, data) {
+    const deserStores = typeof data === "string" ? JSON.parse(data) : data;
+    if (!Array.isArray(deserStores) || !deserStores.every(_DataStoreSerializer.isSerializedDataStoreObj))
+      throw new TypeError("Invalid serialized data format! Expected an array of SerializedDataStore objects.");
+    for (const storeData of deserStores.filter((s) => typeof stores === "function" ? stores(s.id) : stores.includes(s.id))) {
+      const storeInst = this.stores.find((s) => s.id === storeData.id);
+      if (!storeInst)
+        throw new Error(`DataStore instance with ID "${storeData.id}" not found! Make sure to provide it in the DataStoreSerializer constructor.`);
+      if (this.options.ensureIntegrity && typeof storeData.checksum === "string") {
+        const checksum = await this.calcChecksum(storeData.data);
+        if (checksum !== storeData.checksum)
+          throw new ChecksumMismatchError(`Checksum mismatch for DataStore with ID "${storeData.id}"!
 Expected: ${storeData.checksum}
 Has: ${checksum}`);
-        }
-        const decodedData = storeData.encoded && storeInst.encodingEnabled() ? yield storeInst.decodeData[1](storeData.data) : storeData.data;
-        if (storeData.formatVersion && !isNaN(Number(storeData.formatVersion)) && Number(storeData.formatVersion) < storeInst.formatVersion)
-          yield storeInst.runMigrations(JSON.parse(decodedData), Number(storeData.formatVersion), false);
-        else
-          yield storeInst.setData(JSON.parse(decodedData));
       }
-    });
+      const decodedData = storeData.encoded && storeInst.encodingEnabled() ? await storeInst.decodeData[1](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);
+      else
+        await storeInst.setData(JSON.parse(decodedData));
+    }
   }
   /**
    * Deserializes the data exported via {@linkcode serialize()} and imports the data into all matching DataStore instances.  
    * Also triggers the migration process if the data format has changed.
    */
-  deserialize(data) {
-    return __async(this, null, function* () {
-      return this.deserializePartial(this.stores.map((s) => s.id), data);
-    });
+  async deserialize(data) {
+    return this.deserializePartial(this.stores.map((s) => s.id), data);
   }
   /**
    * Loads the persistent data of the DataStore instances into the in-memory cache.  
@@ -1089,40 +1045,32 @@ Has: ${checksum}`);
    * @param stores An array of store IDs or a function that takes the store IDs and returns a boolean - if omitted, all stores will be loaded
    * @returns Returns a PromiseSettledResult array with the results of each DataStore instance in the format `{ id: string, data: object }`
    */
-  loadStoresData(stores) {
-    return __async(this, null, function* () {
-      return Promise.allSettled(
-        this.getStoresFiltered(stores).map((store) => __async(this, null, function* () {
-          return {
-            id: store.id,
-            data: yield store.loadData()
-          };
-        }))
-      );
-    });
+  async loadStoresData(stores) {
+    return Promise.allSettled(
+      this.getStoresFiltered(stores).map(async (store) => ({
+        id: store.id,
+        data: await store.loadData()
+      }))
+    );
   }
   /**
    * Resets the persistent and in-memory data of the DataStore instances to their default values.
    * @param stores An array of store IDs or a function that takes the store IDs and returns a boolean - if omitted, all stores will be affected
    */
-  resetStoresData(stores) {
-    return __async(this, null, function* () {
-      return Promise.allSettled(
-        this.getStoresFiltered(stores).map((store) => store.saveDefaultData())
-      );
-    });
+  async resetStoresData(stores) {
+    return Promise.allSettled(
+      this.getStoresFiltered(stores).map((store) => store.saveDefaultData())
+    );
   }
   /**
    * Deletes the persistent data of the DataStore instances.  
    * Leaves the in-memory data untouched.  
    * @param stores An array of store IDs or a function that takes the store IDs and returns a boolean - if omitted, all stores will be affected
    */
-  deleteStoresData(stores) {
-    return __async(this, null, function* () {
-      return Promise.allSettled(
-        this.getStoresFiltered(stores).map((store) => store.deleteData())
-      );
-    });
+  async deleteStoresData(stores) {
+    return Promise.allSettled(
+      this.getStoresFiltered(stores).map((store) => store.deleteData())
+    );
   }
   /** Checks if a given value is an array of SerializedDataStore objects */
   static isSerializedDataStoreObjArray(obj) {
@@ -1147,27 +1095,28 @@ var createNanoEvents = () => ({
   },
   events: {},
   on(event, cb) {
-    var _a;
     ;
-    ((_a = this.events)[event] || (_a[event] = [])).push(cb);
+    (this.events[event] ||= []).push(cb);
     return () => {
-      var _a2;
-      this.events[event] = (_a2 = this.events[event]) == null ? void 0 : _a2.filter((i) => cb !== i);
+      var _a;
+      this.events[event] = (_a = this.events[event]) == null ? void 0 : _a.filter((i) => cb !== i);
     };
   }
 });
 
 // lib/NanoEmitter.ts
 var NanoEmitter = class {
+  events = createNanoEvents();
+  eventUnsubscribes = [];
+  emitterOptions;
   /** Creates a new instance of NanoEmitter - a lightweight event emitter with helper methods and a strongly typed event map */
   constructor(options = {}) {
-    __publicField(this, "events", createNanoEvents());
-    __publicField(this, "eventUnsubscribes", []);
-    __publicField(this, "emitterOptions");
-    this.emitterOptions = __spreadValues({
-      publicEmit: false
-    }, options);
+    this.emitterOptions = {
+      publicEmit: false,
+      ...options
+    };
   }
+  //#region on
   /**
    * Subscribes to an event and calls the callback when it's emitted.  
    * @param event The event to subscribe to. Use `as "_"` in case your event names aren't thoroughly typed (like when using a template literal, e.g. \`event-${val}\` as "_")
@@ -1201,6 +1150,7 @@ var NanoEmitter = class {
     this.eventUnsubscribes.push(unsub);
     return unsubProxy;
   }
+  //#region once
   /**
    * Subscribes to an event and calls the callback or resolves the Promise only once when it's emitted.  
    * @param event The event to subscribe to. Use `as "_"` in case your event names aren't thoroughly typed (like when using a template literal, e.g. \`event-${val}\` as "_")
@@ -1231,9 +1181,90 @@ var NanoEmitter = class {
       this.eventUnsubscribes.push(unsub);
     });
   }
+  //#region onMulti
+  /**
+   * Allows subscribing to multiple events and calling the callback only when one of, all of, or a subset of the events are emitted, either continuously or only once.  
+   * @param options An object or array of objects with the following properties:  
+   * `callback` (required) is the function that will be called when the conditions are met.  
+   *   
+   * Set `once` to true to call the callback only once for the first event (or set of events) that match the criteria, then stop listening.  
+   * If `signal` is provided, the subscription will be aborted when the given signal is aborted.  
+   *   
+   * If `oneOf` is used, the callback will be called when any of the matching events are emitted.  
+   * If `allOf` is used, the callback will be called after all of the matching events are emitted at least once, then any time any of them are emitted.  
+   * You may use a combination of the above two options, but at least one of them must be provided.  
+   *   
+   * @returns Returns a function that can be called to unsubscribe all listeners created by this call. Alternatively, pass an `AbortSignal` to all options objects to achieve the same effect or for finer control.
+   */
+  onMulti(options) {
+    const allUnsubs = [];
+    const unsubAll = () => {
+      for (const unsub of allUnsubs)
+        unsub();
+      allUnsubs.splice(0, allUnsubs.length);
+      this.eventUnsubscribes = this.eventUnsubscribes.filter((u) => !allUnsubs.includes(u));
+    };
+    for (const opts of Array.isArray(options) ? options : [options]) {
+      const optsWithDefaults = {
+        allOf: [],
+        oneOf: [],
+        once: false,
+        ...opts
+      };
+      const {
+        oneOf,
+        allOf,
+        once,
+        signal,
+        callback
+      } = optsWithDefaults;
+      if (signal == null ? void 0 : signal.aborted)
+        return unsubAll;
+      const curEvtUnsubs = [];
+      const checkUnsubAllEvt = (force = false) => {
+        if (!(signal == null ? void 0 : signal.aborted) && !force)
+          return;
+        for (const unsub of curEvtUnsubs)
+          unsub();
+        curEvtUnsubs.splice(0, curEvtUnsubs.length);
+        this.eventUnsubscribes = this.eventUnsubscribes.filter((u) => !curEvtUnsubs.includes(u));
+      };
+      for (const event of oneOf) {
+        const unsub = this.events.on(event, (...args) => {
+          checkUnsubAllEvt();
+          callback(event, ...args);
+          if (once)
+            checkUnsubAllEvt(true);
+        });
+        curEvtUnsubs.push(unsub);
+      }
+      const allOfEmitted = /* @__PURE__ */ new Set();
+      const checkAllOf = (event, ...args) => {
+        checkUnsubAllEvt();
+        allOfEmitted.add(event);
+        if (allOfEmitted.size === allOf.length) {
+          callback(event, ...args);
+          if (once)
+            checkUnsubAllEvt(true);
+        }
+      };
+      for (const event of allOf) {
+        const unsub = this.events.on(event, (...args) => {
+          checkUnsubAllEvt();
+          checkAllOf(event, ...args);
+        });
+        curEvtUnsubs.push(unsub);
+      }
+      if (oneOf.length === 0 && allOf.length === 0)
+        throw new TypeError("NanoEmitter.onMulti(): Either `oneOf` or `allOf` or both must be provided in the options");
+      allUnsubs.push(() => checkUnsubAllEvt(true));
+    }
+    return unsubAll;
+  }
+  //#region emit
   /**
    * Emits an event on this instance.  
-   * ⚠️ Needs `publicEmit` to be set to true in the NanoEmitter constructor or super() call!
+   * - ⚠️ Needs `publicEmit` to be set to true in the NanoEmitter constructor or super() call!
    * @param event The event to emit
    * @param args The arguments to pass to the event listeners
    * @returns Returns true if `publicEmit` is true and the event was emitted successfully
@@ -1245,6 +1276,7 @@ var NanoEmitter = class {
     }
     return false;
   }
+  //#region unsubscribeAll
   /** Unsubscribes all event listeners from this instance */
   unsubscribeAll() {
     for (const unsub of this.eventUnsubscribes)
@@ -1264,13 +1296,13 @@ var Debouncer = class extends NanoEmitter {
     super();
     this.timeout = timeout;
     this.type = type;
-    /** All registered listener functions and the time they were attached */
-    __publicField(this, "listeners", []);
-    /** The currently active timeout */
-    __publicField(this, "activeTimeout");
-    /** The latest queued call */
-    __publicField(this, "queuedCall");
   }
+  /** All registered listener functions and the time they were attached */
+  listeners = [];
+  /** The currently active timeout */
+  activeTimeout;
+  /** The latest queued call */
+  queuedCall;
   //#region listeners
   /** Adds a listener function that will be called on timeout */
   addListener(fn) {
@@ -1357,8 +1389,6 @@ function debounce(fn, timeout = 200, type = "immediate") {
   return func;
 }
 
-if(__exports != exports)module.exports = exports;return module.exports}));
-
 
 
 if (typeof module.exports == "object" && typeof exports == "object") {