@sv443-network/coreutils 2.0.3 → 3.0.1

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,33 +44,13 @@ 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 = {};
 __export(lib_exports, {
   BrowserStorageEngine: () => BrowserStorageEngine,
   ChecksumMismatchError: () => ChecksumMismatchError,
+  CustomError: () => CustomError,
   DataStore: () => DataStore,
   DataStoreEngine: () => DataStoreEngine,
   DataStoreSerializer: () => DataStoreSerializer,
@@ -107,6 +59,8 @@ __export(lib_exports, {
   FileStorageEngine: () => FileStorageEngine,
   MigrationError: () => MigrationError,
   NanoEmitter: () => NanoEmitter,
+  NetworkError: () => NetworkError,
+  ScriptContextError: () => ScriptContextError,
   ValidationError: () => ValidationError,
   abtoa: () => abtoa,
   atoab: () => atoab,
@@ -126,6 +80,7 @@ __export(lib_exports, {
   digitCount: () => digitCount,
   fetchAdvanced: () => fetchAdvanced,
   formatNumber: () => formatNumber,
+  getCallStack: () => getCallStack,
   getListLength: () => getListLength,
   hexToRgb: () => hexToRgb,
   insertValues: () => insertValues,
@@ -239,10 +194,10 @@ 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) {
+function valsWithin(a, b, dec = 1, withinRange = 0.5) {
   return Math.abs(roundFixed(a, dec) - roundFixed(b, dec)) <= withinRange;
 }
 
@@ -303,7 +258,7 @@ 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})`;
+    return `rgba(${r}, ${g}, ${b}, ${a ?? NaN})`;
   else
     return `rgb(${r}, ${g}, ${b})`;
 }
@@ -337,43 +292,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 Uint8Array ? 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 uintArr = new Uint8Array(yield new Response(comp.readable).arrayBuffer());
-    return outputType === "arrayBuffer" ? uintArr : abtoa(uintArr);
-  });
+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 Uint8Array ? 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 uintArr = new Uint8Array(yield new Response(decomp.readable).arrayBuffer());
-    return outputType === "arrayBuffer" ? uintArr : new TextDecoder().decode(uintArr);
-  });
+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)
@@ -400,39 +347,81 @@ function randomId(length = 16, radix = 16, enhancedEntropy = false, randomCase =
   return arr.map((v) => caseArr[randRange(0, caseArr.length - 1, enhancedEntropy)] === 1 ? v.toUpperCase() : v).join("");
 }
 
+// lib/Errors.ts
+var DatedError = class extends Error {
+  date;
+  constructor(message, options) {
+    super(message, options);
+    this.name = this.constructor.name;
+    this.date = /* @__PURE__ */ new Date();
+  }
+};
+var ChecksumMismatchError = class extends DatedError {
+  constructor(message, options) {
+    super(message, options);
+    this.name = "ChecksumMismatchError";
+  }
+};
+var CustomError = class extends DatedError {
+  constructor(name, message, options) {
+    super(message, options);
+    this.name = name;
+  }
+};
+var MigrationError = class extends DatedError {
+  constructor(message, options) {
+    super(message, options);
+    this.name = "MigrationError";
+  }
+};
+var ValidationError = class extends DatedError {
+  constructor(message, options) {
+    super(message, options);
+    this.name = "ValidationError";
+  }
+};
+var ScriptContextError = class extends DatedError {
+  constructor(message, options) {
+    super(message, options);
+    this.name = "ScriptContextError";
+  }
+};
+var NetworkError = class extends DatedError {
+  constructor(message, options) {
+    super(message, options);
+    this.name = "NetworkError";
+  }
+};
+
 // 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, signal, ...restOpts } = options;
+  const ctl = new AbortController();
+  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 NetworkError("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;
@@ -442,12 +431,12 @@ function pauseFor(time, signal, rejectOnAbort = false) {
     const timeout = setTimeout(() => res(), time);
     signal == null ? void 0 : signal.addEventListener("abort", () => {
       clearTimeout(timeout);
-      rejectOnAbort ? rej(new Error("The pause was aborted")) : res();
+      rejectOnAbort ? rej(new CustomError("AbortError", "The pause was aborted")) : res();
     });
   });
 }
 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;
@@ -464,12 +453,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();
 }
@@ -477,14 +466,24 @@ function scheduleExit(code = 0, timeout = 0) {
   if (timeout < 0)
     throw new TypeError("Timeout must be a non-negative number");
   let exit;
-  if (typeof process !== "undefined" && "exit" in process)
+  if (typeof process !== "undefined" && "exit" in process && typeof process.exit === "function")
     exit = () => process.exit(code);
-  else if (typeof Deno !== "undefined" && "exit" in Deno)
+  else if (typeof Deno !== "undefined" && "exit" in Deno && typeof Deno.exit === "function")
     exit = () => Deno.exit(code);
   else
-    throw new Error("Cannot exit the process, no exit method available");
+    throw new ScriptContextError("Cannot exit the process, no exit method available");
   setTimeout(exit, timeout);
 }
+function getCallStack(asArray, lines = Infinity) {
+  if (typeof lines !== "number" || isNaN(lines) || lines < 0)
+    throw new TypeError("lines parameter must be a non-negative number");
+  try {
+    throw new Error("This is to capture a stack trace with CoreUtils.getCallStack(). (If you see this somewhere, you can safely ignore it.)");
+  } catch (err) {
+    const stack = (err.stack ?? "").split("\n").map((line) => line.trim()).slice(2, lines + 2);
+    return asArray !== false ? stack : stack.join("\n");
+  }
+}
 
 // lib/text.ts
 function autoPlural(term, num, pluralType = "auto") {
@@ -536,9 +535,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 ") {
@@ -554,56 +553,49 @@ function joinArrayReadable(array, separators = ", ", lastSeparator = " and ") {
   return arr.join(separators) + lastItm;
 }
 function secsToTimeStr(seconds) {
-  if (seconds < 0)
-    throw new TypeError("Seconds must be a positive number");
-  const hours = Math.floor(seconds / 3600);
-  const minutes = Math.floor(seconds % 3600 / 60);
-  const secs = Math.floor(seconds % 60);
-  return [
-    hours ? hours + ":" : "",
-    String(minutes).padStart(minutes > 0 || hours > 0 ? 2 : 1, "0"),
+  const isNegative = seconds < 0;
+  const s = Math.abs(seconds);
+  if (isNaN(s) || !isFinite(s))
+    throw new TypeError("The seconds argument must be a valid number");
+  const hrs = Math.floor(s / 3600);
+  const mins = Math.floor(s % 3600 / 60);
+  const secs = Math.floor(s % 60);
+  return (isNegative ? "-" : "") + [
+    hrs ? hrs + ":" : "",
+    String(mins).padStart(mins > 0 || hrs > 0 ? 2 : 1, "0"),
     ":",
-    String(secs).padStart(secs > 0 || minutes > 0 || hours > 0 ? 2 : 1, "0")
+    String(secs).padStart(secs > 0 || mins > 0 || hrs > 0 || seconds === 0 ? 2 : 1, "0")
   ].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 {
-  constructor(message, options) {
-    super(message, options);
-    __publicField(this, "date");
-    this.name = this.constructor.name;
-    this.date = /* @__PURE__ */ new Date();
-  }
-};
-var ChecksumMismatchError = class extends DatedError {
-  constructor(message, options) {
-    super(message, options);
-    this.name = "ChecksumMismatchError";
-  }
-};
-var MigrationError = class extends DatedError {
-  constructor(message, options) {
-    super(message, options);
-    this.name = "MigrationError";
-  }
-};
-var ValidationError = class extends DatedError {
-  constructor(message, options) {
-    super(message, options);
-    this.name = "ValidationError";
-  }
-};
-
 // lib/DataStore.ts
 var dsFmtVer = 1;
 var DataStore = class {
+  id;
+  formatVersion;
+  defaultData;
+  encodeData;
+  decodeData;
+  compressionFormat = "deflate-raw";
+  memoryCache = true;
+  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 = [];
+  //#region constructor
   /**
    * 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.  
@@ -614,29 +606,12 @@ var DataStore = class {
    * @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, "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.
-     */
-    __publicField(this, "firstInit", true);
-    /** In-memory cached copy of the data that is saved in persistent storage used for synchronous read access. */
-    __publicField(this, "cachedData");
-    __publicField(this, "migrations");
-    __publicField(this, "migrateIds", []);
-    var _a, _b, _c;
+    var _a;
     this.id = opts.id;
     this.formatVersion = opts.formatVersion;
     this.defaultData = opts.defaultData;
-    this.cachedData = opts.defaultData;
+    this.memoryCache = Boolean(opts.memoryCache ?? true);
+    this.cachedData = this.memoryCache ? opts.defaultData : {};
     this.migrations = opts.migrations;
     if (opts.migrateIds)
       this.migrateIds = Array.isArray(opts.migrateIds) ? opts.migrateIds : [opts.migrateIds];
@@ -645,18 +620,14 @@ var DataStore = class {
     this.engine = typeof opts.engine === "function" ? opts.engine() : opts.engine;
     this.options = opts;
     if (typeof opts.compressionFormat === "undefined")
-      this.compressionFormat = opts.compressionFormat = (_b = (_a = opts.encodeData) == null ? void 0 : _a[0]) != null ? _b : "deflate-raw";
+      this.compressionFormat = 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]];
-      this.compressionFormat = (_c = opts.encodeData[0]) != null ? _c : null;
+      this.compressionFormat = opts.encodeData[0] ?? null;
     } else if (opts.compressionFormat === null) {
       this.encodeData = void 0;
       this.decodeData = void 0;
@@ -665,123 +636,130 @@ var DataStore = class {
       throw new TypeError("Either `compressionFormat` or `encodeData` and `decodeData` have to be set and valid, but not all three at a time. Please refer to the documentation for more info.");
     this.engine.setDataStoreOptions(opts);
   }
-  //#region public
+  //#region loadData
   /**
    * Loads the data saved in persistent storage into the in-memory cache and also returns a copy of it.  
    * 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));
-              };
-              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));
-              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));
+        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));
+          };
+          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 ? this.compressionFormat ?? null : null);
+          else {
+            promises.push(this.engine.setValue(`__ds-${this.id}-enf`, this.compressionFormat));
+            promises.push(this.engine.deleteValue(`_uucfgenc-${this.id}`));
           }
+          await Promise.allSettled(promises);
         }
-        if (this.migrateIds.length > 0) {
-          yield this.migrateId(this.migrateIds);
-          this.migrateIds = [];
-        }
-        const storedDataRaw = yield this.engine.getValue(`__ds-${this.id}-dat`, null);
-        let storedFmtVer = Number(yield this.engine.getValue(`__ds-${this.id}-ver`, NaN));
-        if (typeof storedDataRaw !== "string") {
-          yield this.saveDefaultData();
-          return __spreadValues({}, this.defaultData);
-        }
-        const storedData = storedDataRaw != null ? storedDataRaw : JSON.stringify(this.defaultData);
-        const encodingFmt = String(yield this.engine.getValue(`__ds-${this.id}-enf`, null));
-        const isEncoded = encodingFmt !== "null" && encodingFmt !== "false";
-        let saveData = false;
-        if (isNaN(storedFmtVer)) {
-          yield this.engine.setValue(`__ds-${this.id}-ver`, storedFmtVer = this.formatVersion);
-          saveData = true;
-        }
-        let parsed = yield this.engine.deserializeData(storedData, isEncoded);
-        if (storedFmtVer < this.formatVersion && this.migrations)
-          parsed = yield this.runMigrations(parsed, storedFmtVer);
-        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 (isNaN(dsVer) || dsVer < dsFmtVer)
+          await this.engine.setValue("__ds_fmt_ver", dsFmtVer);
       }
-    });
+      if (this.migrateIds.length > 0) {
+        await this.migrateId(this.migrateIds);
+        this.migrateIds = [];
+      }
+      const storedDataRaw = await this.engine.getValue(`__ds-${this.id}-dat`, null);
+      let storedFmtVer = Number(await this.engine.getValue(`__ds-${this.id}-ver`, NaN));
+      if (typeof storedDataRaw !== "string") {
+        await this.saveDefaultData();
+        return this.engine.deepCopy(this.defaultData);
+      }
+      const storedData = storedDataRaw ?? JSON.stringify(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);
+      if (this.memoryCache)
+        return this.cachedData = this.engine.deepCopy(parsed);
+      else
+        return 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;
+    }
   }
+  //#region getData
   /**
    * Returns a copy of the data from the in-memory cache.  
-   * Use {@linkcode loadData()} to get fresh data from persistent storage (usually not necessary since the cache should always exactly reflect persistent storage).
+   * Use {@linkcode loadData()} to get fresh data from persistent storage (usually not necessary since the cache should always exactly reflect persistent storage).  
+   * ⚠️ If `memoryCache` was set to `false` in the constructor options, this method will throw an error.
    */
   getData() {
+    if (!this.memoryCache)
+      throw new DatedError("In-memory cache is disabled for this DataStore instance, so getData() can't be used. Please use loadData() instead.");
     return this.engine.deepCopy(this.cachedData);
   }
+  //#region setData
   /** Saves the data synchronously to the in-memory cache and asynchronously to the persistent storage */
   setData(data) {
-    this.cachedData = data;
-    return new Promise((resolve) => __async(this, null, function* () {
-      yield Promise.allSettled([
-        this.engine.setValue(`__ds-${this.id}-dat`, yield this.engine.serializeData(data, this.encodingEnabled())),
+    if (this.memoryCache)
+      this.cachedData = data;
+    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}-enf`, this.compressionFormat)
       ]);
       resolve();
-    }));
+    });
   }
+  //#region saveDefaultData
   /** 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* () {
+  async saveDefaultData() {
+    if (this.memoryCache)
       this.cachedData = this.defaultData;
-      yield Promise.allSettled([
-        this.engine.setValue(`__ds-${this.id}-dat`, yield 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)
-      ]);
-    });
+    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)
+    ]);
   }
+  //#region deleteData
   /**
    * 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.
    */
-  deleteData() {
-    return __async(this, null, function* () {
-      var _a, _b;
-      yield Promise.allSettled([
-        this.engine.deleteValue(`__ds-${this.id}-dat`),
-        this.engine.deleteValue(`__ds-${this.id}-ver`),
-        this.engine.deleteValue(`__ds-${this.id}-enf`)
-      ]);
-      yield (_b = (_a = this.engine).deleteStorage) == null ? void 0 : _b.call(_a);
-    });
-  }
+  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));
+  }
+  //#region encodingEnabled
   /** Returns whether encoding and decoding are enabled for this DataStore instance */
   encodingEnabled() {
     return Boolean(this.encodeData && this.decodeData) && this.compressionFormat !== null || Boolean(this.compressionFormat);
   }
-  //#region migrations
+  //#region runMigrations
   /**
    * Runs all necessary migration functions consecutively and saves the result to the in-memory cache and persistent storage and also returns it.  
    * This method is automatically called by {@linkcode loadData()} if the data format has changed since the last time the data was saved.  
@@ -789,73 +767,73 @@ 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}-enf`, this.compressionFormat)
-      ]);
-      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)
+    ]);
+    if (this.memoryCache)
+      return this.cachedData = this.engine.deepCopy(newData);
+    else
+      return this.engine.deepCopy(newData);
+  }
+  //#region migrateId
   /**
    * 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, fmtVer, isEncoded] = yield (() => __async(this, null, function* () {
-          const [d, f, e] = yield 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 = 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}-enf`, this.compressionFormat),
-          this.engine.deleteValue(`__ds-${id}-dat`),
-          this.engine.deleteValue(`__ds-${id}-ver`),
-          this.engine.deleteValue(`__ds-${id}-enf`)
+  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 {
+  dataStoreOptions;
   // setDataStoreOptions() is called from inside the DataStore constructor to set this value
   constructor(options) {
-    __publicField(this, "dataStoreOptions");
     if (options)
       this.dataStoreOptions = options;
   }
@@ -864,30 +842,26 @@ var DataStoreEngine = class {
     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;
-      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 yield encRes;
-      return encRes;
-    });
+  /** Serializes the given object to a string, optionally encoded with `options.encodeData` if {@linkcode useEncoding} is not set to false and the `encodeData` and `decodeData` options are set */
+  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;
-      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 = 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 */
@@ -905,191 +879,175 @@ 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 engines across multiple {@linkcode DataStore} instances
+   * - ⚠️ Don't reuse engine instances, always create a new one for each {@linkcode DataStore} instance
    */
   constructor(options) {
     super(options == null ? void 0 : options.dataStoreOptions);
-    __publicField(this, "options");
-    this.options = __spreadValues({
-      type: "localStorage"
-    }, options);
+    this.options = {
+      type: "localStorage",
+      ...options
+    };
   }
   //#region storage api
   /** Fetches a value from persistent storage */
-  getValue(name, defaultValue) {
-    return __async(this, null, function* () {
-      const val = this.options.type === "localStorage" ? globalThis.localStorage.getItem(name) : globalThis.sessionStorage.getItem(name);
-      return typeof val === "undefined" ? defaultValue : val;
-    });
+  async getValue(name, defaultValue) {
+    const val = this.options.type === "localStorage" ? globalThis.localStorage.getItem(name) : globalThis.sessionStorage.getItem(name);
+    return typeof val === "undefined" ? defaultValue : val;
   }
   /** 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;
+  fileAccessQueue = Promise.resolve();
   /**
    * Creates an instance of `FileStorageEngine`.  
    *   
    * - ⚠️ Requires Node.js or Deno with Node compatibility (v1.31+)  
-   * - ⚠️ Don't reuse engines across multiple {@linkcode DataStore} instances
+   * - ⚠️ Don't reuse engine instances, always create a new one for each {@linkcode DataStore} instance
    */
   constructor(options) {
     super(options == null ? void 0 : options.dataStoreOptions);
-    __publicField(this, "options");
-    __publicField(this, "fileAccessQueue", Promise.resolve());
-    this.options = __spreadValues({
-      filePath: (id) => `.ds-${id}`
-    }, options);
+    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, _e;
-      this.ensureDataStoreOptions();
-      try {
-        if (!fs)
-          fs = (_a = yield 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 = yield fs.readFile(path, "utf-8");
-        return data ? JSON.parse((_e = yield (_d = (_c = (_b = this.dataStoreOptions) == null ? void 0 : _b.decodeData) == null ? void 0 : _c[1]) == null ? void 0 : _d.call(_c, data)) != null ? _e : 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 ScriptContextError("FileStorageEngine requires Node.js or Deno with Node compatibility (v1.31+)", { cause: new DatedError("'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, _e;
-      this.ensureDataStoreOptions();
-      try {
-        if (!fs)
-          fs = (_a = yield 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);
-        yield fs.mkdir(path.slice(0, path.lastIndexOf(path.includes("/") ? "/" : "\\")), { recursive: true });
-        yield fs.writeFile(path, (_e = yield (_d = (_c = (_b = this.dataStoreOptions) == null ? void 0 : _b.encodeData) == null ? void 0 : _c[1]) == null ? void 0 : _d.call(_c, JSON.stringify(data))) != null ? _e : 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 ScriptContextError("FileStorageEngine requires Node.js or Deno with Node compatibility (v1.31+)", { cause: new DatedError("'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(path.includes("/") ? "/" : "\\")), { 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 (typeof value === "undefined")
-        return defaultValue;
-      if (typeof value === "string")
-        return value;
+  async getValue(name, defaultValue) {
+    const data = await this.readFile();
+    if (!data)
+      return defaultValue;
+    const value = data == null ? void 0 : data[name];
+    if (typeof value === "undefined")
+      return defaultValue;
+    if (typeof value === "string")
       return value;
-    });
+    return value;
   }
   /** Sets a value in persistent storage */
-  setValue(name, value) {
-    return __async(this, null, function* () {
-      this.fileAccessQueue = this.fileAccessQueue.then(() => __async(this, null, function* () {
-        let data = yield this.readFile();
-        if (!data)
-          data = {};
-        data[name] = value;
-        yield this.writeFile(data);
-      })).catch((err) => {
-        console.error("Error in setValue:", err);
-        throw err;
-      });
-      yield this.fileAccessQueue.catch(() => {
-      });
+  async setValue(name, value) {
+    this.fileAccessQueue = this.fileAccessQueue.then(async () => {
+      let data = await this.readFile();
+      if (!data)
+        data = {};
+      data[name] = value;
+      await this.writeFile(data);
+    }).catch((err) => {
+      console.error("Error in setValue:", err);
+      throw err;
+    });
+    await this.fileAccessQueue.catch(() => {
     });
   }
   /** Deletes a value from persistent storage */
-  deleteValue(name) {
-    return __async(this, null, function* () {
-      this.fileAccessQueue = this.fileAccessQueue.then(() => __async(this, null, function* () {
-        const data = yield this.readFile();
-        if (!data)
-          return;
-        delete data[name];
-        yield this.writeFile(data);
-      })).catch((err) => {
-        console.error("Error in deleteValue:", err);
-        throw err;
-      });
-      yield this.fileAccessQueue.catch(() => {
-      });
+  async deleteValue(name) {
+    this.fileAccessQueue = this.fileAccessQueue.then(async () => {
+      const data = await this.readFile();
+      if (!data)
+        return;
+      delete data[name];
+      await this.writeFile(data);
+    }).catch((err) => {
+      console.error("Error in deleteValue:", err);
+      throw err;
+    });
+    await this.fileAccessQueue.catch(() => {
     });
   }
   /** Deletes the file that contains the data of this DataStore. */
-  deleteStorage() {
-    return __async(this, null, function* () {
-      var _a;
-      this.ensureDataStoreOptions();
-      try {
-        if (!fs)
-          fs = (_a = yield 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);
-        yield fs.unlink(path);
-      } catch (err) {
-        console.error("Error deleting file:", err);
-      }
-    });
+  async deleteStorage() {
+    var _a;
+    this.ensureDataStoreOptions();
+    try {
+      if (!fs)
+        fs = (_a = await import("fs/promises")) == null ? void 0 : _a.default;
+      if (!fs)
+        throw new ScriptContextError("FileStorageEngine requires Node.js or Deno with Node compatibility (v1.31+)", { cause: new DatedError("'node:fs/promises' module not available") });
+      const path = typeof this.options.filePath === "string" ? this.options.filePath : this.options.filePath(this.dataStoreOptions.id);
+      return 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!");
+      throw new ScriptContextError("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,
+      remapIds: {},
+      ...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.  
@@ -1097,70 +1055,72 @@ 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* () {
-      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 ? yield 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 ? yield this.calcChecksum(data) : void 0
-        });
-      }
-      return stringified ? JSON.stringify(serData) : serData;
-    });
+  async serializePartial(stores, useEncoding = true, stringified = true) {
+    var _a;
+    const serData = [];
+    const filteredStores = this.stores.filter((s) => typeof stores === "function" ? stores(s.id) : stores.includes(s.id));
+    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);
+      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.");
+    const resolveStoreId = (id) => {
+      var _a;
+      return ((_a = Object.entries(this.options.remapIds).find(([, v]) => v.includes(id))) == null ? void 0 : _a[0]) ?? id;
+    };
+    const matchesFilter = (id) => typeof stores === "function" ? stores(id) : stores.includes(id);
+    for (const storeData of deserStores) {
+      const effectiveId = resolveStoreId(storeData.id);
+      if (!matchesFilter(effectiveId))
+        continue;
+      const storeInst = this.stores.find((s) => s.id === effectiveId);
+      if (!storeInst)
+        throw new DatedError(`Can't deserialize data because no DataStore instance with the ID "${effectiveId}" was 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.  
@@ -1168,40 +1128,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) {
@@ -1226,26 +1178,26 @@ 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
   /**
@@ -1319,11 +1271,12 @@ var NanoEmitter = class {
    * `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 `signal` is provided, the subscription will be canceled 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.  
+   * If both `oneOf` and `allOf` are used together, the callback will be called when any of the `oneOf` events are emitted AND all of the `allOf` events have been emitted at least once.  
+   * At least one of `oneOf` or `allOf` 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.
    */
@@ -1336,11 +1289,12 @@ var NanoEmitter = class {
       this.eventUnsubscribes = this.eventUnsubscribes.filter((u) => !allUnsubs.includes(u));
     };
     for (const opts of Array.isArray(options) ? options : [options]) {
-      const optsWithDefaults = __spreadValues({
+      const optsWithDefaults = {
         allOf: [],
         oneOf: [],
-        once: false
-      }, opts);
+        once: false,
+        ...opts
+      };
       const {
         oneOf,
         allOf,
@@ -1350,6 +1304,8 @@ var NanoEmitter = class {
       } = optsWithDefaults;
       if (signal == null ? void 0 : signal.aborted)
         return unsubAll;
+      if (oneOf.length === 0 && allOf.length === 0)
+        throw new TypeError("NanoEmitter.onMulti(): Either `oneOf` or `allOf` or both must be provided in the options");
       const curEvtUnsubs = [];
       const checkUnsubAllEvt = (force = false) => {
         if (!(signal == null ? void 0 : signal.aborted) && !force)
@@ -1359,34 +1315,31 @@ var NanoEmitter = class {
         curEvtUnsubs.splice(0, curEvtUnsubs.length);
         this.eventUnsubscribes = this.eventUnsubscribes.filter((u) => !curEvtUnsubs.includes(u));
       };
+      const allOfEmitted = /* @__PURE__ */ new Set();
+      const allOfConditionMet = () => allOf.length === 0 || allOfEmitted.size === allOf.length;
       for (const event of oneOf) {
         const unsub = this.events.on(event, ((...args) => {
           checkUnsubAllEvt();
-          callback(event, ...args);
-          if (once)
-            checkUnsubAllEvt(true);
+          if (allOfConditionMet()) {
+            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);
+          allOfEmitted.add(event);
+          if (allOfConditionMet() && (oneOf.length === 0 || oneOf.includes(event))) {
+            callback(event, ...args);
+            if (once)
+              checkUnsubAllEvt(true);
+          }
         }));
         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;
@@ -1426,13 +1379,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) {
@@ -1519,8 +1472,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") {