@choksheak/ts-utils 0.3.6 → 0.3.7

package/kvStore.mjs

@@ -1,15 +1,322 @@
-import {
-  KvStoreConfig,
-  configureKvStore,
-  createKvStore,
-  init_kvStore,
-  kvStore,
-  kvStoreItem
-} from "./chunk-TJFYGFOW.mjs";
-import "./chunk-VG7VV7J2.mjs";
-import "./chunk-M5PIM2HB.mjs";
-import "./chunk-M6PYQYOX.mjs";
-init_kvStore();
+// src/timeConstants.ts
+var MS_PER_SECOND = 1e3;
+var MS_PER_MINUTE = 6e4;
+var MS_PER_HOUR = 36e5;
+var MS_PER_DAY = 864e5;
+
+// src/duration.ts
+function durationToMs(duration) {
+  const daysMs = (duration.days ?? 0) * MS_PER_DAY;
+  const hoursMs = (duration.hours ?? 0) * MS_PER_HOUR;
+  const minsMs = (duration.minutes ?? 0) * MS_PER_MINUTE;
+  const secsMs = (duration.seconds ?? 0) * MS_PER_SECOND;
+  const msMs = duration.milliseconds ?? 0;
+  return daysMs + hoursMs + minsMs + secsMs + msMs;
+}
+function durationOrMsToMs(duration) {
+  return typeof duration === "number" ? duration : durationToMs(duration);
+}
+
+// src/kvStore.ts
+var KvStoreConfig = {
+  /**
+   * Name of the DB in the indexed DB.
+   * Updating the DB name will cause all old entries to be gone.
+   */
+  dbName: "KVStore",
+  /**
+   * Version of the DB schema. Most likely you will never want to change this.
+   * Updating the version will cause all old entries to be gone.
+   */
+  dbVersion: 1,
+  /**
+   * Name of the store within the indexed DB. Each DB can have multiple stores.
+   * In practice, it doesn't matter what you name this to be.
+   */
+  storeName: "kvStore",
+  /** 30 days in ms. */
+  expiryMs: MS_PER_DAY * 30,
+  /** Do GC once per day. */
+  gcIntervalMs: MS_PER_DAY
+};
+function configureKvStore(config) {
+  Object.assign(KvStoreConfig, config);
+}
+function validateStoredObject(obj) {
+  if (!obj || typeof obj !== "object" || typeof obj.key !== "string" || obj.value === void 0 || typeof obj.storedMs !== "number" || typeof obj.expiryMs !== "number" || Date.now() >= obj.expiryMs) {
+    return void 0;
+  }
+  return obj;
+}
+function withOnError(request, reject) {
+  request.onerror = (event) => {
+    reject(event);
+  };
+  return request;
+}
+function createKvStore(dbName, options) {
+  let db;
+  const dbVersion = options?.dbVersion ?? KvStoreConfig.dbVersion;
+  const storeName = options?.storeName ?? KvStoreConfig.storeName;
+  const defaultExpiryMs = options?.defaultExpiryMs ? durationOrMsToMs(options.defaultExpiryMs) : KvStoreConfig.expiryMs;
+  const gcIntervalMs = options?.gcIntervalMs ? durationOrMsToMs(options.gcIntervalMs) : KvStoreConfig.gcIntervalMs;
+  const gcMsStorageKey = `__kvStore:lastGcMs:${dbName}:v${dbVersion}:${storeName}`;
+  async function getOrCreateDb() {
+    if (!db) {
+      db = await new Promise((resolve, reject) => {
+        const request = withOnError(indexedDB.open(dbName, dbVersion), reject);
+        request.onupgradeneeded = (event) => {
+          const db2 = event.target.result;
+          const objectStore = db2.createObjectStore(storeName, {
+            keyPath: "key"
+          });
+          objectStore.createIndex("key", "key", {
+            unique: true
+          });
+        };
+        request.onsuccess = (event) => {
+          const db2 = event.target.result;
+          resolve(db2);
+        };
+      });
+    }
+    return db;
+  }
+  async function transact(mode, callback) {
+    const db2 = await getOrCreateDb();
+    return await new Promise((resolve, reject) => {
+      const transaction = withOnError(db2.transaction(storeName, mode), reject);
+      transaction.onabort = (event) => {
+        reject(event);
+      };
+      const objectStore = transaction.objectStore(storeName);
+      callback(objectStore, resolve, reject);
+    });
+  }
+  const obj = {
+    /** Input name for the DB. */
+    dbName,
+    /** Input version for the DB. */
+    dbVersion,
+    /** Input name for the DB store. */
+    storeName,
+    /** Default expiry to use if not specified in set(). */
+    defaultExpiryMs,
+    /** Time interval for when GC's occur. */
+    gcIntervalMs,
+    /** Local storage key name for the last GC completed timestamp. */
+    gcMsStorageKey,
+    /** Set a value in the store. */
+    async set(key, value, expiryDeltaMs) {
+      const nowMs = Date.now();
+      const stored = {
+        key,
+        value,
+        storedMs: nowMs,
+        expiryMs: nowMs + durationOrMsToMs(expiryDeltaMs ?? defaultExpiryMs)
+      };
+      return await transact("readwrite", (objectStore, resolve, reject) => {
+        const request = withOnError(objectStore.put(stored), reject);
+        request.onsuccess = () => {
+          resolve(value);
+          obj.gc();
+        };
+      });
+    },
+    /** Delete one or multiple keys. */
+    async delete(key) {
+      return await transact(
+        "readwrite",
+        (objectStore, resolve, reject) => {
+          objectStore.transaction.oncomplete = () => {
+            resolve();
+          };
+          if (typeof key === "string") {
+            withOnError(objectStore.delete(key), reject);
+          } else {
+            for (const k of key) {
+              withOnError(objectStore.delete(k), reject);
+            }
+          }
+        }
+      );
+    },
+    /** Mainly used to get the expiration timestamp of an object. */
+    async getStoredObject(key) {
+      const stored = await transact(
+        "readonly",
+        (objectStore, resolve, reject) => {
+          const request = withOnError(objectStore.get(key), reject);
+          request.onsuccess = () => {
+            resolve(request.result);
+          };
+        }
+      );
+      if (!stored) {
+        return void 0;
+      }
+      try {
+        const valid = validateStoredObject(stored);
+        if (!valid) {
+          await obj.delete(key);
+          obj.gc();
+          return void 0;
+        }
+        return valid;
+      } catch (e) {
+        console.error(`Invalid kv value: ${key}=${JSON.stringify(stored)}:`, e);
+        await obj.delete(key);
+        obj.gc();
+        return void 0;
+      }
+    },
+    /** Get a value by key, or undefined if it does not exist. */
+    async get(key) {
+      const stored = await obj.getStoredObject(key);
+      return stored?.value;
+    },
+    /** Generic way to iterate through all entries. */
+    async forEach(callback) {
+      await transact("readonly", (objectStore, resolve, reject) => {
+        const request = withOnError(objectStore.openCursor(), reject);
+        request.onsuccess = async (event) => {
+          const cursor = event.target.result;
+          if (cursor) {
+            if (cursor.key) {
+              const valid = validateStoredObject(cursor.value);
+              if (valid !== void 0) {
+                await callback(
+                  String(cursor.key),
+                  valid.value,
+                  valid.expiryMs,
+                  valid.storedMs
+                );
+              }
+            }
+            cursor.continue();
+          } else {
+            resolve();
+          }
+        };
+      });
+    },
+    /**
+     * Returns the number of items in the store. Note that getting the size
+     * requires iterating through the entire store because the items could expire
+     * at any time, and hence the size is a dynamic number.
+     */
+    async size() {
+      let count = 0;
+      await obj.forEach(() => {
+        count++;
+      });
+      return count;
+    },
+    /** Remove all items from the store. */
+    async clear() {
+      await transact("readwrite", (objectStore, resolve, reject) => {
+        const request = withOnError(objectStore.clear(), reject);
+        request.onsuccess = () => {
+          resolve();
+        };
+      });
+    },
+    /**
+     * Returns all items as map of key to value, mainly used for debugging dumps.
+     * The type T is applied to all values, even though they might not be of type
+     * T (in the case when you store different data types in the same store).
+     */
+    async asMap() {
+      const map = /* @__PURE__ */ new Map();
+      await obj.forEach((key, value, expiryMs, storedMs) => {
+        map.set(key, { value, expiryMs, storedMs });
+      });
+      return map;
+    },
+    /** Returns the ms timestamp for the last GC (garbage collection). */
+    getLastGcMs() {
+      const lastGcMsStr = localStorage.getItem(gcMsStorageKey);
+      if (!lastGcMsStr) return 0;
+      const ms = Number(lastGcMsStr);
+      return isNaN(ms) ? 0 : ms;
+    },
+    /** Set the ms timestamp for the last GC (garbage collection). */
+    setLastGcMs(ms) {
+      localStorage.setItem(gcMsStorageKey, String(ms));
+    },
+    /** Perform garbage-collection if due, else do nothing. */
+    async gc() {
+      const lastGcMs = obj.getLastGcMs();
+      if (!lastGcMs) {
+        obj.setLastGcMs(Date.now());
+        return;
+      }
+      if (Date.now() < lastGcMs + gcIntervalMs) {
+        return;
+      }
+      await obj.gcNow();
+    },
+    /**
+     * Perform garbage collection immediately without checking whether we are
+     * due for the next GC or not.
+     */
+    async gcNow() {
+      console.log(`Starting kvStore GC on ${dbName} v${dbVersion}...`);
+      obj.setLastGcMs(Date.now());
+      const keysToDelete = [];
+      await obj.forEach(
+        async (key, value, expiryMs) => {
+          if (value === void 0 || Date.now() >= expiryMs) {
+            keysToDelete.push(key);
+          }
+        }
+      );
+      if (keysToDelete.length) {
+        await obj.delete(keysToDelete);
+      }
+      console.log(
+        `Finished kvStore GC on ${dbName} v${dbVersion} - deleted ${keysToDelete.length} keys`
+      );
+      obj.setLastGcMs(Date.now());
+    },
+    /** Returns `this` casted into a StorageAdapter<T>. */
+    asStorageAdapter() {
+      return obj;
+    }
+  };
+  return obj;
+}
+var kvStore = createKvStore(KvStoreConfig.dbName);
+function kvStoreItem(key, expiryMs, store = kvStore) {
+  const defaultExpiryMs = expiryMs && durationOrMsToMs(expiryMs);
+  const obj = {
+    key,
+    defaultExpiryMs,
+    store,
+    /** Set a value in the store. */
+    async set(value, expiryDeltaMs) {
+      await store.set(key, value, expiryDeltaMs ?? defaultExpiryMs);
+    },
+    /**
+     * Example usage:
+     *
+     *   const { value, storedMs, expiryMs, storedMs } =
+     *     await myKvItem.getStoredObject();
+     */
+    async getStoredObject() {
+      return await store.getStoredObject(key);
+    },
+    /** Get a value by key, or undefined if it does not exist. */
+    async get() {
+      return await store.get(key);
+    },
+    /** Delete this key from the store. */
+    async delete() {
+      await store.delete(key);
+    }
+  };
+  return obj;
+}
 export {
   KvStoreConfig,
   configureKvStore,

package/localStore.cjs

@@ -1,19 +1,268 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
+// src/localStore.ts
+var localStore_exports = {};
+__export(localStore_exports, {
+  LocalStoreConfig: () => LocalStoreConfig,
+  configureLocalStore: () => configureLocalStore,
+  createLocalStore: () => createLocalStore,
+  localStore: () => localStore,
+  localStoreItem: () => localStoreItem
+});
+module.exports = __toCommonJS(localStore_exports);
 
+// src/timeConstants.ts
+var MS_PER_SECOND = 1e3;
+var MS_PER_MINUTE = 6e4;
+var MS_PER_HOUR = 36e5;
+var MS_PER_DAY = 864e5;
 
+// src/duration.ts
+function durationToMs(duration) {
+  const daysMs = (duration.days ?? 0) * MS_PER_DAY;
+  const hoursMs = (duration.hours ?? 0) * MS_PER_HOUR;
+  const minsMs = (duration.minutes ?? 0) * MS_PER_MINUTE;
+  const secsMs = (duration.seconds ?? 0) * MS_PER_SECOND;
+  const msMs = duration.milliseconds ?? 0;
+  return daysMs + hoursMs + minsMs + secsMs + msMs;
+}
+function durationOrMsToMs(duration) {
+  return typeof duration === "number" ? duration : durationToMs(duration);
+}
 
-
-
-var _chunkDUN4UY2Qcjs = require('./chunk-DUN4UY2Q.cjs');
-require('./chunk-4GLOLTJ5.cjs');
-require('./chunk-Y7MC73BZ.cjs');
-require('./chunk-ILGTU46T.cjs');
-_chunkDUN4UY2Qcjs.init_localStore.call(void 0, );
-
-
-
-
-
-
-exports.LocalStoreConfig = _chunkDUN4UY2Qcjs.LocalStoreConfig; exports.configureLocalStore = _chunkDUN4UY2Qcjs.configureLocalStore; exports.createLocalStore = _chunkDUN4UY2Qcjs.createLocalStore; exports.localStore = _chunkDUN4UY2Qcjs.localStore; exports.localStoreItem = _chunkDUN4UY2Qcjs.localStoreItem;
+// src/localStore.ts
+var LocalStoreConfig = {
+  /** All items with the same store name will share the same storage space. */
+  storeName: "ts-utils",
+  /** 30 days in ms. */
+  expiryMs: MS_PER_DAY * 30,
+  /** Do GC once per day. */
+  gcIntervalMs: MS_PER_DAY
+};
+function configureLocalStore(config) {
+  Object.assign(LocalStoreConfig, config);
+}
+function validateStoredObject(obj) {
+  if (!obj || typeof obj !== "object" || obj.value === void 0 || typeof obj.storedMs !== "number" || typeof obj.expiryMs !== "number" || Date.now() >= obj.expiryMs) {
+    return void 0;
+  }
+  return obj;
+}
+function createLocalStore(storeName, options) {
+  const keyPrefix = storeName + ":";
+  const defaultExpiryMs = options?.defaultExpiryMs ? durationOrMsToMs(options.defaultExpiryMs) : LocalStoreConfig.expiryMs;
+  const gcIntervalMs = options?.gcIntervalMs ? durationOrMsToMs(options.gcIntervalMs) : LocalStoreConfig.gcIntervalMs;
+  const gcMsStorageKey = `__localStore:lastGcMs:${storeName}`;
+  const obj = {
+    /** Input name for the store. */
+    storeName,
+    /**
+     * The prefix string for the local storage key which identifies items
+     * belonging to this namespace.
+     */
+    keyPrefix,
+    /** Default expiry to use if not specified in set(). */
+    defaultExpiryMs,
+    /** Time interval for when GC's occur. */
+    gcIntervalMs,
+    /** Local storage key name for the last GC completed timestamp. */
+    gcMsStorageKey,
+    /** Set a value in the store. */
+    set(key, value, expiryDeltaMs) {
+      const nowMs = Date.now();
+      const stored = {
+        value,
+        storedMs: nowMs,
+        expiryMs: nowMs + durationOrMsToMs(expiryDeltaMs ?? defaultExpiryMs)
+      };
+      localStorage.setItem(keyPrefix + key, JSON.stringify(stored));
+      obj.gc();
+      return value;
+    },
+    /** Delete one or multiple keys. */
+    delete(key) {
+      if (typeof key === "string") {
+        localStorage.removeItem(keyPrefix + key);
+      } else {
+        for (const k of key) {
+          localStorage.removeItem(keyPrefix + k);
+        }
+      }
+    },
+    /** Mainly used to get the expiration timestamp of an object. */
+    getStoredObject(key) {
+      const k = keyPrefix + key;
+      const stored = localStorage.getItem(k);
+      if (!stored) {
+        return void 0;
+      }
+      try {
+        const parsed = JSON.parse(stored);
+        const valid = validateStoredObject(parsed);
+        if (!valid) {
+          obj.delete(k);
+          obj.gc();
+          return void 0;
+        }
+        return valid;
+      } catch (e) {
+        console.error(`Invalid local value: ${k}=${stored}:`, e);
+        obj.delete(k);
+        obj.gc();
+        return void 0;
+      }
+    },
+    /** Get a value by key, or undefined if it does not exist. */
+    get(key) {
+      const stored = obj.getStoredObject(key);
+      return stored?.value;
+    },
+    /** Generic way to iterate through all entries. */
+    forEach(callback) {
+      for (const k of Object.keys(localStorage)) {
+        if (!k.startsWith(keyPrefix)) continue;
+        const key = k.slice(keyPrefix.length);
+        const stored = obj.getStoredObject(key);
+        if (!stored) continue;
+        callback(key, stored.value, stored.expiryMs, stored.storedMs);
+      }
+    },
+    /**
+     * Returns the number of items in the store. Note that getting the size
+     * requires iterating through the entire store because the items could expire
+     * at any time, and hence the size is a dynamic number.
+     */
+    size() {
+      let count = 0;
+      obj.forEach(() => {
+        count++;
+      });
+      return count;
+    },
+    /** Remove all items from the store. */
+    clear() {
+      for (const key of Object.keys(localStorage)) {
+        if (key.startsWith(keyPrefix)) {
+          localStorage.removeItem(key);
+        }
+      }
+    },
+    /**
+     * Returns all items as map of key to value, mainly used for debugging dumps.
+     * The type T is applied to all values, even though they might not be of type
+     * T (in the case when you store different data types in the same store).
+     */
+    asMap() {
+      const map = /* @__PURE__ */ new Map();
+      obj.forEach(
+        (key, value, expiryMs, storedMs) => {
+          map.set(key, { value, expiryMs, storedMs });
+        }
+      );
+      return map;
+    },
+    /** Returns the ms timestamp for the last GC (garbage collection). */
+    getLastGcMs() {
+      const lastGcMsStr = localStorage.getItem(gcMsStorageKey);
+      if (!lastGcMsStr) return 0;
+      const ms = Number(lastGcMsStr);
+      return isNaN(ms) ? 0 : ms;
+    },
+    /** Set the ms timestamp for the last GC (garbage collection). */
+    setLastGcMs(ms) {
+      localStorage.setItem(gcMsStorageKey, String(ms));
+    },
+    /** Perform garbage-collection if due, else do nothing. */
+    gc() {
+      const lastGcMs = obj.getLastGcMs();
+      if (!lastGcMs) {
+        obj.setLastGcMs(Date.now());
+        return;
+      }
+      if (Date.now() < lastGcMs + gcIntervalMs) {
+        return;
+      }
+      obj.gcNow();
+    },
+    /**
+     * Perform garbage collection immediately without checking whether we are
+     * due for the next GC or not.
+     */
+    gcNow() {
+      console.log(`Starting localStore GC on ${storeName}`);
+      obj.setLastGcMs(Date.now());
+      let count = 0;
+      obj.forEach((key, value, expiryMs) => {
+        if (Date.now() >= expiryMs) {
+          obj.delete(key);
+          count++;
+        }
+      });
+      console.log(
+        `Finished localStore GC on ${storeName} - deleted ${count} keys`
+      );
+      obj.setLastGcMs(Date.now());
+    },
+    /** Returns `this` casted into a StorageAdapter<T>. */
+    asStorageAdapter() {
+      return obj;
+    }
+  };
+  return obj;
+}
+var localStore = createLocalStore(LocalStoreConfig.storeName);
+function localStoreItem(key, expiryMs, store = localStore) {
+  const defaultExpiryMs = expiryMs && durationOrMsToMs(expiryMs);
+  const obj = {
+    key,
+    defaultExpiryMs,
+    store,
+    /** Set a value in the store. */
+    set(value, expiryDeltaMs) {
+      store.set(key, value, expiryDeltaMs ?? defaultExpiryMs);
+    },
+    /**
+     * Example usage:
+     *
+     *   const { value, storedMs, expiryMs, storedMs } =
+     *     await myLocalItem.getStoredObject();
+     */
+    getStoredObject() {
+      return store.getStoredObject(key);
+    },
+    /** Get a value by key, or undefined if it does not exist. */
+    get() {
+      return store.get(key);
+    },
+    /** Delete this key from the store. */
+    delete() {
+      store.delete(key);
+    }
+  };
+  return obj;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LocalStoreConfig,
+  configureLocalStore,
+  createLocalStore,
+  localStore,
+  localStoreItem
+});

package/localStore.min.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkOGF34H4Tmincjs = require('./chunk-OGF34H4T.min.cjs');require('./chunk-27MBP3ES.min.cjs');require('./chunk-GAP2HS5M.min.cjs');require('./chunk-QNNJNLGK.min.cjs');_chunkOGF34H4Tmincjs.f.call(void 0, );exports.LocalStoreConfig = _chunkOGF34H4Tmincjs.a; exports.configureLocalStore = _chunkOGF34H4Tmincjs.b; exports.createLocalStore = _chunkOGF34H4Tmincjs.c; exports.localStore = _chunkOGF34H4Tmincjs.d; exports.localStoreItem = _chunkOGF34H4Tmincjs.e;
+"use strict";var p=Object.defineProperty;var y=Object.getOwnPropertyDescriptor;var T=Object.getOwnPropertyNames;var b=Object.prototype.hasOwnProperty;var D=(t,s)=>{for(var r in s)p(t,r,{get:s[r],enumerable:!0})},h=(t,s,r,c)=>{if(s&&typeof s=="object"||typeof s=="function")for(let i of T(s))!b.call(t,i)&&i!==r&&p(t,i,{get:()=>s[i],enumerable:!(c=y(s,i))||c.enumerable});return t};var x=t=>h(p({},"__esModule",{value:!0}),t);var _={};D(_,{LocalStoreConfig:()=>g,configureLocalStore:()=>v,createLocalStore:()=>m,localStore:()=>M,localStoreItem:()=>I});module.exports=x(_);function O(t){let s=(t.days??0)*864e5,r=(t.hours??0)*36e5,c=(t.minutes??0)*6e4,i=(t.seconds??0)*1e3,l=t.milliseconds??0;return s+r+c+i+l}function f(t){return typeof t=="number"?t:O(t)}var g={storeName:"ts-utils",expiryMs:864e5*30,gcIntervalMs:864e5};function v(t){Object.assign(g,t)}function E(t){if(!(!t||typeof t!="object"||t.value===void 0||typeof t.storedMs!="number"||typeof t.expiryMs!="number"||Date.now()>=t.expiryMs))return t}function m(t,s){let r=t+":",c=s?.defaultExpiryMs?f(s.defaultExpiryMs):g.expiryMs,i=s?.gcIntervalMs?f(s.gcIntervalMs):g.gcIntervalMs,l=`__localStore:lastGcMs:${t}`,o={storeName:t,keyPrefix:r,defaultExpiryMs:c,gcIntervalMs:i,gcMsStorageKey:l,set(e,n,u){let a=Date.now(),d={value:n,storedMs:a,expiryMs:a+f(u??c)};return localStorage.setItem(r+e,JSON.stringify(d)),o.gc(),n},delete(e){if(typeof e=="string")localStorage.removeItem(r+e);else for(let n of e)localStorage.removeItem(r+n)},getStoredObject(e){let n=r+e,u=localStorage.getItem(n);if(u)try{let a=JSON.parse(u),d=E(a);if(!d){o.delete(n),o.gc();return}return d}catch(a){console.error(`Invalid local value: ${n}=${u}:`,a),o.delete(n),o.gc();return}},get(e){return o.getStoredObject(e)?.value},forEach(e){for(let n of Object.keys(localStorage)){if(!n.startsWith(r))continue;let u=n.slice(r.length),a=o.getStoredObject(u);a&&e(u,a.value,a.expiryMs,a.storedMs)}},size(){let e=0;return o.forEach(()=>{e++}),e},clear(){for(let e of Object.keys(localStorage))e.startsWith(r)&&localStorage.removeItem(e)},asMap(){let e=new Map;return o.forEach((n,u,a,d)=>{e.set(n,{value:u,expiryMs:a,storedMs:d})}),e},getLastGcMs(){let e=localStorage.getItem(l);if(!e)return 0;let n=Number(e);return isNaN(n)?0:n},setLastGcMs(e){localStorage.setItem(l,String(e))},gc(){let e=o.getLastGcMs();if(!e){o.setLastGcMs(Date.now());return}Date.now()<e+i||o.gcNow()},gcNow(){console.log(`Starting localStore GC on ${t}`),o.setLastGcMs(Date.now());let e=0;o.forEach((n,u,a)=>{Date.now()>=a&&(o.delete(n),e++)}),console.log(`Finished localStore GC on ${t} - deleted ${e} keys`),o.setLastGcMs(Date.now())},asStorageAdapter(){return o}};return o}var M=m(g.storeName);function I(t,s,r=M){let c=s&&f(s);return{key:t,defaultExpiryMs:c,store:r,set(l,o){r.set(t,l,o??c)},getStoredObject(){return r.getStoredObject(t)},get(){return r.get(t)},delete(){r.delete(t)}}}0&&(module.exports={LocalStoreConfig,configureLocalStore,createLocalStore,localStore,localStoreItem});
 //# sourceMappingURL=localStore.min.cjs.map

package/localStore.min.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/choksheaklau/src/ts-utils/dist/localStore.min.cjs"],"names":[],"mappings":"AAAA,wIAAiD,oCAAiC,oCAAiC,oCAAiC,oCAAE,CAAE,CAAC,yPAAgH","file":"/Users/choksheaklau/src/ts-utils/dist/localStore.min.cjs"}
+{"version":3,"sources":["../src/localStore.ts","../src/duration.ts"],"sourcesContent":["/**\n * Local storage key-value store with support for auto-expirations.\n *\n * Why use this?\n * 1. Extremely simple interface to use local storage.\n * 2. Auto-expirations with GC frees you from worrying about data clean-up.\n * 3. Any serializable data type can be stored (except undefined).\n *\n * How to use?\n * Just use the `localStore` global constant like the local storage.\n *\n * Why not use the localStorage directly?\n * localStorage does not provide auto-expirations with GC. If you don't need\n * this (items never expire), then just use localStorage directly.\n */\n\nimport { Duration, durationOrMsToMs } from \"./duration\";\nimport {\n  FullStorageAdapter,\n  StorageAdapter,\n  StoredObject,\n} from \"./storageAdapter\";\nimport { MS_PER_DAY } from \"./timeConstants\";\n\n/** Global defaults can be updated directly. */\nexport const LocalStoreConfig = {\n  /** All items with the same store name will share the same storage space. */\n  storeName: \"ts-utils\",\n\n  /** 30 days in ms. */\n  expiryMs: MS_PER_DAY * 30,\n\n  /** Do GC once per day. */\n  gcIntervalMs: MS_PER_DAY,\n};\n\nexport type LocalStoreConfig = typeof LocalStoreConfig;\n\n/** Convenience function to update global defaults. */\nexport function configureLocalStore(config: Partial<LocalStoreConfig>) {\n  Object.assign(LocalStoreConfig, config);\n}\n\n/**\n * Parse a stored value string. Returns undefined if invalid or expired.\n * Throws an error if the string cannot be parsed as JSON.\n */\nfunction validateStoredObject<T>(\n  obj: StoredObject<T>,\n): StoredObject<T> | undefined {\n  if (\n    !obj ||\n    typeof obj !== \"object\" ||\n    obj.value === undefined ||\n    typeof obj.storedMs !== \"number\" ||\n    typeof obj.expiryMs !== \"number\" ||\n    Date.now() >= obj.expiryMs\n  ) {\n    return undefined;\n  }\n\n  return obj;\n}\n\n/**\n * You can create multiple LocalStores if you want, but most likely you will only\n * need to use the default `localStore` instance.\n */\n// Using `any` because the store could store any type of data for each key,\n// but the caller can specify a more specific type when calling each of the\n// methods.\n\nexport function createLocalStore(\n  storeName: string,\n  options?: {\n    defaultExpiryMs?: number | Duration;\n    gcIntervalMs?: number | Duration;\n  },\n) {\n  const keyPrefix = storeName + \":\";\n\n  const defaultExpiryMs = options?.defaultExpiryMs\n    ? durationOrMsToMs(options.defaultExpiryMs)\n    : LocalStoreConfig.expiryMs;\n\n  const gcIntervalMs = options?.gcIntervalMs\n    ? durationOrMsToMs(options.gcIntervalMs)\n    : LocalStoreConfig.gcIntervalMs;\n\n  const gcMsStorageKey = `__localStore:lastGcMs:${storeName}`;\n\n  const obj = {\n    /** Input name for the store. */\n    storeName,\n\n    /**\n     * The prefix string for the local storage key which identifies items\n     * belonging to this namespace.\n     */\n    keyPrefix,\n\n    /** Default expiry to use if not specified in set(). */\n    defaultExpiryMs,\n\n    /** Time interval for when GC's occur. */\n    gcIntervalMs,\n\n    /** Local storage key name for the last GC completed timestamp. */\n    gcMsStorageKey,\n\n    /** Set a value in the store. */\n    set<T>(key: string, value: T, expiryDeltaMs?: number | Duration): T {\n      const nowMs = Date.now();\n      const stored: StoredObject<T> = {\n        value,\n        storedMs: nowMs,\n        expiryMs: nowMs + durationOrMsToMs(expiryDeltaMs ?? defaultExpiryMs),\n      };\n\n      localStorage.setItem(keyPrefix + key, JSON.stringify(stored));\n\n      obj.gc(); // check GC on every write\n\n      return value;\n    },\n\n    /** Delete one or multiple keys. */\n    delete(key: string | string[]): void {\n      if (typeof key === \"string\") {\n        localStorage.removeItem(keyPrefix + key);\n      } else {\n        for (const k of key) {\n          localStorage.removeItem(keyPrefix + k);\n        }\n      }\n    },\n\n    /** Mainly used to get the expiration timestamp of an object. */\n    getStoredObject<T>(key: string): StoredObject<T> | undefined {\n      const k = keyPrefix + key;\n      const stored = localStorage.getItem(k);\n\n      if (!stored) {\n        return undefined;\n      }\n\n      try {\n        const parsed = JSON.parse(stored);\n        const valid = validateStoredObject(parsed);\n        if (!valid) {\n          obj.delete(k);\n\n          obj.gc(); // check GC on every read of an expired key\n\n          return undefined;\n        }\n\n        return valid as StoredObject<T>;\n      } catch (e) {\n        console.error(`Invalid local value: ${k}=${stored}:`, e);\n        obj.delete(k);\n\n        obj.gc(); // check GC on every read of an invalid key\n\n        return undefined;\n      }\n    },\n\n    /** Get a value by key, or undefined if it does not exist. */\n    get<T>(key: string): T | undefined {\n      const stored = obj.getStoredObject<T>(key);\n\n      return stored?.value;\n    },\n\n    /** Generic way to iterate through all entries. */\n    forEach<T>(\n      callback: (\n        key: string,\n        value: T,\n        expiryMs: number,\n        storedMs: number,\n      ) => void,\n    ): void {\n      for (const k of Object.keys(localStorage)) {\n        if (!k.startsWith(keyPrefix)) continue;\n\n        const key = k.slice(keyPrefix.length);\n        const stored = obj.getStoredObject(key);\n\n        if (!stored) continue;\n\n        callback(key, stored.value as T, stored.expiryMs, stored.storedMs);\n      }\n    },\n\n    /**\n     * Returns the number of items in the store. Note that getting the size\n     * requires iterating through the entire store because the items could expire\n     * at any time, and hence the size is a dynamic number.\n     */\n    size(): number {\n      let count = 0;\n      obj.forEach(() => {\n        count++;\n      });\n      return count;\n    },\n\n    /** Remove all items from the store. */\n    clear(): void {\n      // Note that we don't need to use obj.forEach() because we are just\n      // going to delete all the items without checking for expiration.\n      for (const key of Object.keys(localStorage)) {\n        if (key.startsWith(keyPrefix)) {\n          localStorage.removeItem(key);\n        }\n      }\n    },\n\n    /**\n     * Returns all items as map of key to value, mainly used for debugging dumps.\n     * The type T is applied to all values, even though they might not be of type\n     * T (in the case when you store different data types in the same store).\n     */\n    asMap<T>(): Map<string, StoredObject<T>> {\n      const map = new Map<string, StoredObject<T>>();\n      obj.forEach(\n        (key: string, value: T, expiryMs: number, storedMs: number) => {\n          map.set(key, { value: value as T, expiryMs, storedMs });\n        },\n      );\n      return map;\n    },\n\n    /** Returns the ms timestamp for the last GC (garbage collection). */\n    getLastGcMs(): number {\n      const lastGcMsStr = localStorage.getItem(gcMsStorageKey);\n      if (!lastGcMsStr) return 0;\n\n      const ms = Number(lastGcMsStr);\n      return isNaN(ms) ? 0 : ms;\n    },\n\n    /** Set the ms timestamp for the last GC (garbage collection). */\n    setLastGcMs(ms: number) {\n      localStorage.setItem(gcMsStorageKey, String(ms));\n    },\n\n    /** Perform garbage-collection if due, else do nothing. */\n    gc(): void {\n      const lastGcMs = obj.getLastGcMs();\n\n      // Set initial timestamp - no need GC now.\n      if (!lastGcMs) {\n        obj.setLastGcMs(Date.now());\n        return;\n      }\n\n      if (Date.now() < lastGcMs + gcIntervalMs) {\n        return; // not due for next GC yet\n      }\n\n      // GC is due now, so run it.\n      obj.gcNow();\n    },\n\n    /**\n     * Perform garbage collection immediately without checking whether we are\n     * due for the next GC or not.\n     */\n    gcNow(): void {\n      console.log(`Starting localStore GC on ${storeName}`);\n\n      // Prevent concurrent GC runs.\n      obj.setLastGcMs(Date.now());\n      let count = 0;\n\n      obj.forEach((key: string, value: unknown, expiryMs: number) => {\n        if (Date.now() >= expiryMs) {\n          obj.delete(key);\n          count++;\n        }\n      });\n\n      console.log(\n        `Finished localStore GC on ${storeName} - deleted ${count} keys`,\n      );\n\n      // Mark the end time as last GC time.\n      obj.setLastGcMs(Date.now());\n    },\n\n    /** Returns `this` casted into a StorageAdapter<T>. */\n    asStorageAdapter<T>(): StorageAdapter<T> {\n      return obj as StorageAdapter<T>;\n    },\n  } as const;\n\n  // Using `any` because the store could store any type of data for each key,\n  // but the caller can specify a more specific type when calling each of the\n  // methods.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  return obj satisfies FullStorageAdapter<any>;\n}\n\nexport type LocalStore = ReturnType<typeof createLocalStore>;\n\n/**\n * Default local store ready for immediate use. You can create new instances if\n * you want, but most likely you will only need one store instance.\n */\nexport const localStore = createLocalStore(LocalStoreConfig.storeName);\n\n/** Create a local store item with a key and a default expiration. */\nexport function localStoreItem<T>(\n  key: string,\n  expiryMs?: number | Duration,\n  store: LocalStore = localStore,\n) {\n  const defaultExpiryMs = expiryMs && durationOrMsToMs(expiryMs);\n\n  const obj = {\n    key,\n    defaultExpiryMs,\n    store,\n\n    /** Set a value in the store. */\n    set(value: T, expiryDeltaMs?: number | undefined): void {\n      store.set(key, value, expiryDeltaMs ?? defaultExpiryMs);\n    },\n\n    /**\n     * Example usage:\n     *\n     *   const { value, storedMs, expiryMs, storedMs } =\n     *     await myLocalItem.getStoredObject();\n     */\n    getStoredObject(): StoredObject<T> | undefined {\n      return store.getStoredObject(key);\n    },\n\n    /** Get a value by key, or undefined if it does not exist. */\n    get(): T | undefined {\n      return store.get(key);\n    },\n\n    /** Delete this key from the store. */\n    delete(): void {\n      store.delete(key);\n    },\n  };\n\n  return obj;\n}\n\nexport type LocalStoreItem<T> = ReturnType<typeof localStoreItem<T>>;\n","/**\n * Bunch of miscellaneous constants and utility functions related to handling\n * date and time durations.\n *\n * Note that month and year do not have fixed durations, and hence are excluded\n * from this file. Weeks have fixed durations, but are excluded because we\n * use days as the max duration supported.\n */\n\nimport {\n  HOURS_PER_DAY,\n  MINUTES_PER_HOUR,\n  MS_PER_DAY,\n  MS_PER_HOUR,\n  MS_PER_MINUTE,\n  MS_PER_SECOND,\n  SECONDS_PER_MINUTE,\n} from \"./timeConstants\";\n\nexport type Duration = {\n  days?: number;\n  hours?: number;\n  minutes?: number;\n  seconds?: number;\n  milliseconds?: number;\n};\n\n/**\n * One of: days, hours, minutes, seconds, milliseconds\n */\nexport type DurationType = keyof Duration;\n\n/**\n * Order in which the duration type appears in the duration string.\n */\nexport const DURATION_TYPE_SEQUENCE: DurationType[] = [\n  \"days\",\n  \"hours\",\n  \"minutes\",\n  \"seconds\",\n  \"milliseconds\",\n];\n\n/**\n * Follows the same format as Intl.DurationFormat.prototype.format().\n *\n * Short: 1 yr, 2 mths, 3 wks, 3 days, 4 hr, 5 min, 6 sec, 7 ms, 8 μs, 9 ns\n * Long: 1 year, 2 months, 3 weeks, 3 days, 4 hours, 5 minutes, 6 seconds,\n *       7 milliseconds, 8 microseconds, 9 nanoseconds\n * Narrow: 1y 2mo 3w 3d 4h 5m 6s 7ms 8μs 9ns\n */\nexport type DurationStyle = \"short\" | \"long\" | \"narrow\";\n\nexport type DurationSuffixMap = {\n  short: string;\n  shorts: string;\n  long: string;\n  longs: string;\n  narrow: string;\n};\n\nexport type DurationSuffixType = keyof DurationSuffixMap;\n\nexport const DURATION_STYLE_SUFFIX_MAP: Record<\n  DurationType,\n  DurationSuffixMap\n> = {\n  days: {\n    short: \"day\",\n    shorts: \"days\",\n    long: \"day\",\n    longs: \"days\",\n    narrow: \"d\",\n  },\n  hours: {\n    short: \"hr\",\n    shorts: \"hrs\",\n    long: \"hour\",\n    longs: \"hours\",\n    narrow: \"h\",\n  },\n  minutes: {\n    short: \"min\",\n    shorts: \"mins\",\n    long: \"minute\",\n    longs: \"minutes\",\n    narrow: \"m\",\n  },\n  seconds: {\n    short: \"sec\",\n    shorts: \"secs\",\n    long: \"second\",\n    longs: \"seconds\",\n    narrow: \"s\",\n  },\n  milliseconds: {\n    short: \"ms\",\n    shorts: \"ms\",\n    long: \"millisecond\",\n    longs: \"milliseconds\",\n    narrow: \"ms\",\n  },\n};\n\nfunction getDurationStyleForPlural(style: DurationStyle): DurationSuffixType {\n  return style == \"short\" ? \"shorts\" : style === \"long\" ? \"longs\" : style;\n}\n\nfunction getValueAndUnitSeparator(style: DurationStyle): string {\n  return style === \"narrow\" ? \"\" : \" \";\n}\n\nfunction getDurationTypeSeparator(style: DurationStyle): string {\n  return style === \"narrow\" ? \" \" : \", \";\n}\n\n/**\n * Convert a milliseconds duration into a Duration object. If the given ms is\n * zero, then return an object with a single field of zero with duration type\n * of durationTypeForZero.\n *\n * @param durationTypeForZero Defaults to 'milliseconds'\n */\nexport function msToDuration(\n  ms: number,\n  durationTypeForZero?: DurationType,\n): Duration {\n  if (ms === 0) {\n    durationTypeForZero = durationTypeForZero ?? \"milliseconds\";\n    return { [durationTypeForZero]: 0 };\n  }\n\n  const duration: Duration = {};\n\n  for (let i = 0; i < 1; i++) {\n    let seconds = Math.floor(ms / MS_PER_SECOND);\n    const millis = ms - seconds * MS_PER_SECOND;\n\n    if (millis > 0) {\n      duration[\"milliseconds\"] = millis;\n    }\n\n    if (seconds === 0) {\n      break;\n    }\n\n    let minutes = Math.floor(seconds / SECONDS_PER_MINUTE);\n    seconds -= minutes * SECONDS_PER_MINUTE;\n\n    if (seconds > 0) {\n      duration[\"seconds\"] = seconds;\n    }\n\n    if (minutes === 0) {\n      break;\n    }\n\n    let hours = Math.floor(minutes / MINUTES_PER_HOUR);\n    minutes -= hours * MINUTES_PER_HOUR;\n\n    if (minutes > 0) {\n      duration[\"minutes\"] = minutes;\n    }\n\n    if (hours === 0) {\n      break;\n    }\n\n    const days = Math.floor(hours / HOURS_PER_DAY);\n    hours -= days * HOURS_PER_DAY;\n\n    if (hours > 0) {\n      duration[\"hours\"] = hours;\n    }\n\n    if (days > 0) {\n      duration[\"days\"] = days;\n    }\n  }\n\n  return duration;\n}\n\n/**\n * Returns the number of milliseconds for the given duration.\n */\nexport function durationToMs(duration: Duration): number {\n  const daysMs = (duration.days ?? 0) * MS_PER_DAY;\n  const hoursMs = (duration.hours ?? 0) * MS_PER_HOUR;\n  const minsMs = (duration.minutes ?? 0) * MS_PER_MINUTE;\n  const secsMs = (duration.seconds ?? 0) * MS_PER_SECOND;\n  const msMs = duration.milliseconds ?? 0;\n\n  return daysMs + hoursMs + minsMs + secsMs + msMs;\n}\n\n/**\n * Convenience function to return a duration given an ms or Duration.\n */\nexport function durationOrMsToMs(duration: number | Duration): number {\n  return typeof duration === \"number\" ? duration : durationToMs(duration);\n}\n\n/**\n * Format a given Duration object into a string. If the object has no fields,\n * then returns an empty string.\n *\n * @param style Defaults to 'short'\n */\nexport function formatDuration(duration: Duration, style?: DurationStyle) {\n  style = style ?? \"short\";\n  const stylePlural = getDurationStyleForPlural(style);\n\n  const space = getValueAndUnitSeparator(style);\n\n  const a: string[] = [];\n\n  for (const unit of DURATION_TYPE_SEQUENCE) {\n    const value = duration[unit];\n    if (value === undefined) continue;\n\n    const suffixMap = DURATION_STYLE_SUFFIX_MAP[unit];\n    const suffix = value === 1 ? suffixMap[style] : suffixMap[stylePlural];\n    a.push(value + space + suffix);\n  }\n\n  const separator = getDurationTypeSeparator(style);\n  return a.join(separator);\n}\n\n/**\n * Convert a millisecond duration into a human-readable duration string.\n *\n * @param options.durationTypeForZero - Defaults to 'milliseconds'\n * @param options.style - Defaults to 'short'\n */\nexport function readableDuration(\n  ms: number,\n  options?: { durationTypeForZero?: DurationType; style?: DurationStyle },\n): string {\n  const duration = msToDuration(ms, options?.durationTypeForZero);\n\n  return formatDuration(duration, options?.style);\n}\n\n/** A shortened duration string useful for logging timings. */\nexport function elapsed(ms: number): string {\n  // Use long format for 1 minute or over.\n  if (ms > MS_PER_MINUTE) {\n    return readableDuration(ms);\n  }\n\n  // Use seconds format for over 100ms.\n  if (ms > 100) {\n    return `${(ms / 1000).toFixed(3)}s`;\n  }\n\n  // Use milliseconds format.\n  return ms + \"ms\";\n}\n"],"mappings":"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","names":["localStore_exports","__export","LocalStoreConfig","configureLocalStore","createLocalStore","localStore","localStoreItem","__toCommonJS","durationToMs","duration","daysMs","hoursMs","minsMs","secsMs","msMs","durationOrMsToMs","LocalStoreConfig","configureLocalStore","config","validateStoredObject","obj","createLocalStore","storeName","options","keyPrefix","defaultExpiryMs","durationOrMsToMs","gcIntervalMs","gcMsStorageKey","key","value","expiryDeltaMs","nowMs","stored","k","parsed","valid","e","callback","count","map","expiryMs","storedMs","lastGcMsStr","ms","lastGcMs","localStore","localStoreItem","store"]}