@ztimson/utils 0.24.12 → 0.25.1

package/dist/cache.d.ts

@@ -1,8 +1,9 @@
+import { Collection } from './database.ts';
 export type CacheOptions = {
     /** Delete keys automatically after x amount of seconds */
     ttl?: number;
     /** Storage to persist cache */
-    storage?: Storage;
+    storage?: Storage | Collection<any, any>;
     /** Key cache will be stored under */
     storageKey?: string;
     /** Keep or delete cached items once expired, defaults to delete */
@@ -52,12 +53,12 @@ export declare class Cache<K extends string | number | symbol, T> {
     /**
      * Remove all keys from cache
      */
-    clear(): void;
+    clear(): this;
     /**
      * Delete an item from the cache
      * @param {K} key Item's primary key
      */
-    delete(key: K): void;
+    delete(key: K): this;
     /**
      * Return cache as an array of key-value pairs
      * @return {[K, T][]} Key-value pairs array
@@ -67,13 +68,13 @@ export declare class Cache<K extends string | number | symbol, T> {
      * Manually expire a cached item
      * @param {K} key Key to expire
      */
-    expire(key: K): void;
+    expire(key: K): this;
     /**
      * Get item from the cache
      * @param {K} key Key to lookup
      * @return {T} Cached item
      */
-    get(key: K, expired?: boolean): T | null;
+    get(key: K, expired?: boolean): CachedValue<T> | null;
     /**
      * Get a list of cached keys
      * @return {K[]} Array of keys

package/dist/color.d.ts

@@ -3,4 +3,4 @@
  * @param {string} background Color to compare against
  * @return {"white" | "black"} Color with the most contrast
  */
-export declare function blackOrWhite(background: string): 'white' | 'black';
+export declare function contrast(background: string): 'white' | 'black';

package/dist/database.d.ts

@@ -0,0 +1,17 @@
+export declare class Collection<K extends IDBValidKey, T> {
+    readonly db: string;
+    readonly collection: string;
+    readonly version?: number | undefined;
+    private setup?;
+    private database;
+    constructor(db: string, collection: string, version?: number | undefined, setup?: ((db: IDBDatabase, event: IDBVersionChangeEvent) => void) | undefined);
+    tx<T>(collection: string, fn: ((store: IDBObjectStore) => IDBRequest), readonly?: boolean): Promise<T>;
+    add(value: T, key?: K): Promise<void>;
+    count(): Promise<number>;
+    put(key: K, value: T): Promise<void>;
+    getAll(): Promise<T[]>;
+    getAllKeys(): Promise<K[]>;
+    get(key: K): Promise<T>;
+    delete(key: K): Promise<void>;
+    clear(): Promise<void>;
+}

package/dist/index.cjs

@@ -65,7 +65,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
             extras.push(arg);
             continue;
           }
-          const value = argDef.default === false ? true : argDef.default === true ? false : queue.splice(queue.findIndex((q) => q[0] != "-"), 1)[0] || argDef.default;
+          const value = combined[1] != null ? combined[1] : argDef.default === false ? true : argDef.default === true ? false : queue.splice(queue.findIndex((q) => q[0] != "-"), 1)[0] || argDef.default;
           if (value == null) parsed["_error"].push(`Option missing value: ${argDef.name || combined[0]}`);
           parsed[argDef.name] = value;
         } else {
@@ -124,7 +124,7 @@ ${opts.message || this.desc}`;
   function clean(obj, undefinedOnly = false) {
     if (obj == null) throw new Error("Cannot clean a NULL value");
     if (Array.isArray(obj)) {
-      obj = obj.filter((o) => o != null);
+      obj = obj.filter((o) => undefinedOnly ? o !== void 0 : o != null);
     } else {
       Object.entries(obj).forEach(([key, value]) => {
         if (undefinedOnly && value === void 0 || !undefinedOnly && value == null) delete obj[key];
@@ -175,7 +175,6 @@ ${opts.message || this.desc}`;
       for (const key of Object.keys(obj)) {
         const propName = parent ? `${parent}.${key}` : key;
         if (typeof obj[key] === "object" && obj[key] != null && !Array.isArray(obj[key])) {
-          console.log(propName);
           flattenObj(obj[key], propName, result);
         } else {
           result[propName] = obj[key];
@@ -231,55 +230,15 @@ ${opts.message || this.desc}`;
     return obj;
   }
   function JSONSanitize(obj, space) {
+    const cache = [];
     return JSON.stringify(obj, (key, value) => {
+      if (typeof value === "object" && value !== null) {
+        if (cache.includes(value)) return "[Circular]";
+        cache.push(value);
+      }
       return value;
     }, space);
   }
-  function addUnique(array, el) {
-    if (array.indexOf(el) === -1) array.push(el);
-    return array;
-  }
-  function arrayDiff(a, b) {
-    return makeUnique([
-      ...a.filter((v1) => !b.includes((v2) => isEqual(v1, v2))),
-      ...b.filter((v1) => !a.includes((v2) => isEqual(v1, v2)))
-    ]);
-  }
-  function caseInsensitiveSort(prop) {
-    return function(a, b) {
-      const aVal = dotNotation(a, prop);
-      const bVal = dotNotation(b, prop);
-      if (typeof aVal !== "string" || typeof bVal !== "string") return 1;
-      return aVal.toLowerCase().localeCompare(bVal.toLowerCase());
-    };
-  }
-  function findByProp(prop, value) {
-    return (v) => isEqual(dotNotation(v, prop), value);
-  }
-  function flattenArr(arr, result = []) {
-    arr.forEach((el) => Array.isArray(el) ? flattenArr(el, result) : result.push(el));
-    return result;
-  }
-  function sortByProp(prop, reverse = false) {
-    return function(a, b) {
-      const aVal = dotNotation(a, prop);
-      const bVal = dotNotation(b, prop);
-      if (typeof aVal == "number" && typeof bVal == "number")
-        return (reverse ? -1 : 1) * (aVal - bVal);
-      if (aVal > bVal) return reverse ? -1 : 1;
-      if (aVal < bVal) return reverse ? 1 : -1;
-      return 0;
-    };
-  }
-  function makeUnique(arr) {
-    for (let i = arr.length - 1; i >= 0; i--) {
-      if (arr.slice(0, i).find((n) => isEqual(n, arr[i]))) arr.splice(i, 1);
-    }
-    return arr;
-  }
-  function makeArray(value) {
-    return Array.isArray(value) ? value : [value];
-  }
   class ASet extends Array {
     /** Number of elements in set */
     get size() {
@@ -395,6 +354,102 @@ ${opts.message || this.desc}`;
       return new ASet([...this, ...set]);
     }
   }
+  function addUnique(array, el) {
+    if (array.indexOf(el) === -1) array.push(el);
+    return array;
+  }
+  function arrayDiff(a, b) {
+    return new ASet(a).symmetricDifference(new ASet(b));
+  }
+  function caseInsensitiveSort(prop) {
+    return function(a, b) {
+      const aVal = dotNotation(a, prop);
+      const bVal = dotNotation(b, prop);
+      if (typeof aVal !== "string" || typeof bVal !== "string") return 1;
+      return aVal.toLowerCase().localeCompare(bVal.toLowerCase());
+    };
+  }
+  function findByProp(prop, value) {
+    return (v) => isEqual(dotNotation(v, prop), value);
+  }
+  function flattenArr(arr, result = []) {
+    arr.forEach((el) => Array.isArray(el) ? flattenArr(el, result) : result.push(el));
+    return result;
+  }
+  function sortByProp(prop, reverse = false) {
+    return function(a, b) {
+      const aVal = dotNotation(a, prop);
+      const bVal = dotNotation(b, prop);
+      if (typeof aVal == "number" && typeof bVal == "number")
+        return (reverse ? -1 : 1) * (aVal - bVal);
+      if (aVal > bVal) return reverse ? -1 : 1;
+      if (aVal < bVal) return reverse ? 1 : -1;
+      return 0;
+    };
+  }
+  function makeUnique(arr) {
+    for (let i = arr.length - 1; i >= 0; i--) {
+      if (arr.slice(0, i).find((n) => isEqual(n, arr[i]))) arr.splice(i, 1);
+    }
+    return arr;
+  }
+  function makeArray(value) {
+    return Array.isArray(value) ? value : [value];
+  }
+  class Collection {
+    constructor(db, collection, version, setup) {
+      __publicField(this, "database");
+      this.db = db;
+      this.collection = collection;
+      this.version = version;
+      this.setup = setup;
+      this.database = new Promise((resolve, reject) => {
+        const req = indexedDB.open(this.db, this.version);
+        req.onerror = () => reject(req.error);
+        req.onsuccess = () => resolve(req.result);
+        req.onupgradeneeded = (event) => {
+          const db2 = req.result;
+          if (!db2.objectStoreNames.contains(collection)) db2.createObjectStore(collection, { keyPath: void 0 });
+          if (this.setup) this.setup(db2, event);
+        };
+      });
+    }
+    async tx(collection, fn2, readonly) {
+      const db = await this.database;
+      const tx = db.transaction(collection, readonly ? "readonly" : "readwrite");
+      const store = tx.objectStore(collection);
+      return new Promise((resolve, reject) => {
+        const request = fn2(store);
+        request.onsuccess = () => resolve(request.result);
+        request.onerror = () => reject(request.error);
+      });
+    }
+    add(value, key) {
+      return this.tx(this.collection, (store) => store.add(value, key));
+    }
+    count() {
+      return this.tx(this.collection, (store) => store.count(), true);
+    }
+    put(key, value) {
+      debugger;
+      return this.tx(this.collection, (store) => store.put(value, key));
+    }
+    getAll() {
+      return this.tx(this.collection, (store) => store.getAll(), true);
+    }
+    getAllKeys() {
+      return this.tx(this.collection, (store) => store.getAllKeys(), true);
+    }
+    get(key) {
+      return this.tx(this.collection, (store) => store.get(key), true);
+    }
+    delete(key) {
+      return this.tx(this.collection, (store) => store.delete(key));
+    }
+    clear() {
+      return this.tx(this.collection, (store) => store.clear());
+    }
+  }
   class Cache {
     /**
      * Create new cache
@@ -410,14 +465,19 @@ ${opts.message || this.desc}`;
        * @return {T[]} Array of items
        */
       __publicField(this, "values", this.all());
+      var _a;
       this.key = key;
       this.options = options;
-      if (options.storageKey && !options.storage && typeof Storage !== "undefined")
-        options.storage = localStorage;
-      if (options.storageKey && options.storage) {
-        const stored = options.storage.getItem(options.storageKey);
-        if (stored) {
-          try {
+      if (options.storageKey && !options.storage && typeof Storage !== "undefined") options.storage = localStorage;
+      if (options.storage) {
+        if (options.storage instanceof Collection) {
+          (async () => {
+            var _a2;
+            (await ((_a2 = options.storage) == null ? void 0 : _a2.getAll())).forEach((v) => this.add(v));
+          })();
+        } else if (options.storageKey) {
+          const stored = (_a = options.storage) == null ? void 0 : _a.getItem(options.storageKey);
+          if (stored != null) try {
             Object.assign(this.store, JSON.parse(stored));
           } catch {
           }
@@ -439,9 +499,14 @@ ${opts.message || this.desc}`;
       if (!this.key) throw new Error("No key defined");
       return value[this.key];
     }
-    save() {
-      if (this.options.storageKey && this.options.storage)
-        this.options.storage.setItem(this.options.storageKey, JSON.stringify(this.store));
+    save(key) {
+      if (this.options.storage) {
+        if (this.options.storage instanceof Collection) {
+          this.options.storage.put(key, this.store[key]);
+        } else if (this.options.storageKey) {
+          this.options.storage.setItem(this.options.storageKey, JSONSanitize(this.store));
+        }
+      }
     }
     /**
      * Get all cached items
@@ -479,6 +544,7 @@ ${opts.message || this.desc}`;
     clear() {
       this.complete = false;
       this.store = {};
+      return this;
     }
     /**
      * Delete an item from the cache
@@ -486,7 +552,8 @@ ${opts.message || this.desc}`;
      */
     delete(key) {
       delete this.store[key];
-      this.save();
+      this.save(key);
+      return this;
     }
     /**
      * Return cache as an array of key-value pairs
@@ -503,6 +570,7 @@ ${opts.message || this.desc}`;
       this.complete = false;
       if (this.options.expiryPolicy == "keep") this.store[key]._expired = true;
       else this.delete(key);
+      return this;
     }
     /**
      * Get item from the cache
@@ -542,18 +610,18 @@ ${opts.message || this.desc}`;
     set(key, value, ttl = this.options.ttl) {
       if (this.options.expiryPolicy == "keep") delete value._expired;
       this.store[key] = value;
-      this.save();
+      this.save(key);
       if (ttl) setTimeout(() => {
         this.expire(key);
-        this.save();
-      }, ttl * 1e3);
+        this.save(key);
+      }, (ttl || 0) * 1e3);
       return this;
     }
   }
-  function blackOrWhite(background) {
-    const exploded = background == null ? void 0 : background.match(background.length >= 6 ? /\w\w/g : /\w/g);
-    if (!exploded) return "black";
-    const [r, g, b] = exploded.map((hex) => parseInt(hex, 16));
+  function contrast(background) {
+    const exploded = background == null ? void 0 : background.match(background.length >= 6 ? /[0-9a-fA-F]{2}/g : /[0-9a-fA-F]/g);
+    if (!exploded || (exploded == null ? void 0 : exploded.length) < 3) return "black";
+    const [r, g, b] = exploded.map((hex) => parseInt(hex.length == 1 ? `${hex}${hex}` : hex, 16));
     const luminance = (0.299 * r + 0.587 * g + 0.114 * b) / 255;
     return luminance > 0.5 ? "black" : "white";
   }
@@ -563,7 +631,7 @@ ${opts.message || this.desc}`;
   const CHAR_LIST = LETTER_LIST + LETTER_LIST.toLowerCase() + NUMBER_LIST + SYMBOL_LIST;
   function camelCase(str) {
     const text = pascalCase(str);
-    return text[0].toLowerCase() + text.slice(1);
+    return !text ? "" : text[0].toLowerCase() + text.slice(1);
   }
   function formatBytes(bytes, decimals = 2) {
     if (bytes === 0) return "0 Bytes";
@@ -589,12 +657,9 @@ ${opts.message || this.desc}`;
     return text.toString().padEnd(length, char);
   }
   function pascalCase(str) {
+    var _a;
     if (!str) return "";
-    const text = str.replaceAll(/(^[^a-zA-Z]+|[^a-zA-Z0-9-_])/g, "").replaceAll(/[^a-zA-Z0-9]+(\w?)/g, (...args) => {
-      var _a;
-      return ((_a = args[1]) == null ? void 0 : _a.toUpperCase()) || "";
-    });
-    return text[0].toUpperCase() + text.slice(1);
+    return ((_a = str.match(/[a-zA-Z0-9]+/g)) == null ? void 0 : _a.map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join("")) ?? "";
   }
   function randomHex(length) {
     return Array(length).fill(null).map(() => Math.round(Math.random() * 15).toString(16)).join("");
@@ -1016,7 +1081,7 @@ ${opts.message || this.desc}`;
     }
     static off(event, listener) {
       const e = event.toString();
-      this.listeners[e] = (this.listeners[e] || []).filter((l) => l === listener);
+      this.listeners[e] = (this.listeners[e] || []).filter((l) => l != listener);
     }
     static on(event, listener) {
       var _a;
@@ -1039,7 +1104,7 @@ ${opts.message || this.desc}`;
       (this.listeners[event] || []).forEach((l) => l(...args));
     }
     off(event, listener) {
-      this.listeners[event] = (this.listeners[event] || []).filter((l) => l === listener);
+      this.listeners[event] = (this.listeners[event] || []).filter((l) => l != listener);
     }
     on(event, listener) {
       var _a;
@@ -1336,6 +1401,11 @@ ${opts.message || this.desc}`;
   __publicField(_Http, "interceptors", {});
   __publicField(_Http, "headers", {});
   let Http = _Http;
+  function createJwt(payload, signature = "unsigned") {
+    const header = Buffer.from(JSON.stringify({ alg: "HS256", typ: "JWT" })).toString("base64url");
+    const body = Buffer.from(JSON.stringify(payload)).toString("base64url");
+    return `${header}.${body}.${signature}`;
+  }
   function decodeJwt(token) {
     const base64 = token.split(".")[1].replace(/-/g, "+").replace(/_/g, "/");
     return JSONAttemptParse(decodeURIComponent(atob(base64).split("").map(function(c) {
@@ -1431,20 +1501,22 @@ ${opts.message || this.desc}`;
   };
   __publicField(_Logger, "LOG_LEVEL", 4);
   let Logger = _Logger;
-  function dec2Frac(num) {
-    const gcd = (a, b) => {
-      if (b < 1e-7) return a;
-      return gcd(b, ~~(a % b));
-    };
-    const len = num.toString().length - 2;
-    let denominator = Math.pow(10, len);
-    let numerator = num * denominator;
-    const divisor = gcd(numerator, denominator);
-    numerator = ~~(numerator / divisor);
-    denominator = ~~(denominator / divisor);
-    const remainder = ~~(numerator / denominator);
-    numerator -= remainder * denominator;
-    return `${remainder ? remainder + " " : ""}${~~numerator}/${~~denominator}`;
+  function dec2Frac(num, maxDen = 1e3) {
+    let sign = Math.sign(num);
+    num = Math.abs(num);
+    if (Number.isInteger(num)) return sign * num + "";
+    let closest = { n: 0, d: 1, diff: Math.abs(num) };
+    for (let d = 1; d <= maxDen; d++) {
+      let n = Math.round(num * d);
+      let diff = Math.abs(num - n / d);
+      if (diff < closest.diff) {
+        closest = { n, d, diff };
+        if (diff < 1e-8) break;
+      }
+    }
+    let integer = Math.floor(closest.n / closest.d);
+    let numerator = closest.n - integer * closest.d;
+    return (sign < 0 ? "-" : "") + (integer ? integer + " " : "") + (numerator ? numerator + "/" + closest.d : "");
   }
   function fracToDec(frac) {
     let split = frac.split(" ");
@@ -1564,6 +1636,7 @@ ${opts.message || this.desc}`;
         const l1 = p1.fullPath.length, l2 = p2.fullPath.length;
         return l1 < l2 ? 1 : l1 > l2 ? -1 : 0;
       }).reduce((acc, p) => {
+        if (acc && !acc.fullPath.startsWith(p.fullPath)) return acc;
         if (p.none) hitNone = true;
         if (!acc) return p;
         if (hitNone) return acc;
@@ -1671,15 +1744,15 @@ ${opts.message || this.desc}`;
       this.prefix = prefix;
     }
     emit(event, ...args) {
-      const parsed = new PathEvent(`${this.prefix}/${typeof event == "string" ? event : event.toString()}`);
-      this.listeners.filter((l) => PathEvent.has(l[0], event)).forEach(async (l) => l[1](parsed, ...args));
+      const parsed = new PathEvent(`${this.prefix}/${new PathEvent(event).toString()}`);
+      this.listeners.filter((l) => PathEvent.has(l[0], `${this.prefix}/${event}`)).forEach(async (l) => l[1](parsed, ...args));
     }
     off(listener) {
       this.listeners = this.listeners.filter((l) => l[1] != listener);
     }
     on(event, listener) {
       makeArray(event).forEach((e) => this.listeners.push([
-        new PathEvent(`${this.prefix}/${typeof e == "string" ? event : event.toString()}`),
+        new PathEvent(`${this.prefix}/${new PathEvent(e).toString()}`),
         listener
       ]));
       return () => this.off(listener);
@@ -1750,9 +1823,6 @@ ${opts.message || this.desc}`;
       }).length == and.length;
     });
   }
-  function typeKeys() {
-    return Object.keys({});
-  }
   var commonjsGlobal = typeof globalThis !== "undefined" ? globalThis : typeof window !== "undefined" ? window : typeof global !== "undefined" ? global : typeof self !== "undefined" ? self : {};
   var dist = {};
   var persist$1 = {};
@@ -1932,6 +2002,7 @@ ${opts.message || this.desc}`;
   exports2.CliBackground = CliBackground;
   exports2.CliEffects = CliEffects;
   exports2.CliForeground = CliForeground;
+  exports2.Collection = Collection;
   exports2.CustomError = CustomError;
   exports2.ForbiddenError = ForbiddenError;
   exports2.GatewayTimeoutError = GatewayTimeoutError;
@@ -1962,10 +2033,11 @@ ${opts.message || this.desc}`;
   exports2.addUnique = addUnique;
   exports2.adjustedInterval = adjustedInterval;
   exports2.arrayDiff = arrayDiff;
-  exports2.blackOrWhite = blackOrWhite;
   exports2.camelCase = camelCase;
   exports2.caseInsensitiveSort = caseInsensitiveSort;
   exports2.clean = clean;
+  exports2.contrast = contrast;
+  exports2.createJwt = createJwt;
   exports2.dec2Frac = dec2Frac;
   exports2.decodeJwt = decodeJwt;
   exports2.deepCopy = deepCopy;
@@ -2015,7 +2087,6 @@ ${opts.message || this.desc}`;
   exports2.timeUntil = timeUntil;
   exports2.timestampFilename = timestampFilename;
   exports2.toCsv = toCsv;
-  exports2.typeKeys = typeKeys;
   exports2.uploadWithProgress = uploadWithProgress;
   exports2.validateEmail = validateEmail;
   Object.defineProperty(exports2, Symbol.toStringTag, { value: "Module" });