@choksheak/ts-utils 0.2.9 → 0.3.0

package/kvStore.mjs

@@ -0,0 +1,300 @@
+// 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 DEFAULT_DB_NAME = "KVStore";
+var DEFAULT_DB_VERSION = 1;
+var STORE_NAME = "kvStore";
+var MILLIS_PER_DAY = 864e5;
+var DEFAULT_EXPIRY_DELTA_MS = MILLIS_PER_DAY * 30;
+var GC_INTERVAL_MS = MILLIS_PER_DAY;
+function validateStoredObject(obj) {
+  if (!obj || typeof obj !== "object" || !("key" in obj) || typeof obj.key !== "string" || !("value" in obj) || !("storedMs" in obj) || typeof obj.storedMs !== "number" || obj.value === void 0 || !("expiryMs" in obj) || typeof obj.expiryMs !== "number" || Date.now() >= obj.expiryMs) {
+    return void 0;
+  }
+  return obj;
+}
+function withOnError(request, reject) {
+  request.onerror = (event) => {
+    reject(event);
+  };
+  return request;
+}
+var KVStoreField = class {
+  constructor(store, key) {
+    this.store = store;
+    this.key = key;
+  }
+  get() {
+    return this.store.get(this.key);
+  }
+  set(t) {
+    return this.store.set(this.key, t);
+  }
+  delete() {
+    return this.store.delete(this.key);
+  }
+};
+var KVStore = class {
+  constructor(dbName, dbVersion, defaultExpiryDeltaMs) {
+    this.dbName = dbName;
+    this.dbVersion = dbVersion;
+    this.defaultExpiryDeltaMs = defaultExpiryDeltaMs;
+    this.gcMsStorageKey = `__kvStore:lastGcMs:${dbName}:v${dbVersion}:${STORE_NAME}`;
+  }
+  // We'll init the DB only on first use.
+  db;
+  // Local storage key name for the last GC completed timestamp.
+  gcMsStorageKey;
+  async getOrCreateDb() {
+    if (!this.db) {
+      this.db = await new Promise((resolve, reject) => {
+        const request = withOnError(
+          globalThis.indexedDB.open(this.dbName, this.dbVersion),
+          reject
+        );
+        request.onupgradeneeded = (event) => {
+          const db = event.target.result;
+          const objectStore = db.createObjectStore(STORE_NAME, {
+            keyPath: "key"
+          });
+          objectStore.createIndex("key", "key", {
+            unique: true
+          });
+        };
+        request.onsuccess = (event) => {
+          const db = event.target.result;
+          resolve(db);
+        };
+      });
+    }
+    return this.db;
+  }
+  async transact(mode, callback) {
+    const db = await this.getOrCreateDb();
+    return await new Promise((resolve, reject) => {
+      const transaction = withOnError(db.transaction(STORE_NAME, mode), reject);
+      transaction.onabort = (event) => {
+        reject(event);
+      };
+      const objectStore = transaction.objectStore(STORE_NAME);
+      callback(objectStore, resolve, reject);
+    });
+  }
+  async set(key, value, expiryDeltaMs = this.defaultExpiryDeltaMs) {
+    const nowMs = Date.now();
+    const obj = {
+      key,
+      value,
+      storedMs: nowMs,
+      expiryMs: nowMs + durationOrMsToMs(expiryDeltaMs)
+    };
+    return await this.transact(
+      "readwrite",
+      (objectStore, resolve, reject) => {
+        const request = withOnError(objectStore.put(obj), reject);
+        request.onsuccess = () => {
+          resolve(value);
+          this.gc();
+        };
+      }
+    );
+  }
+  /** Delete one or multiple keys. */
+  async delete(key) {
+    return await this.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);
+          }
+        }
+      }
+    );
+  }
+  async getStoredObject(key) {
+    const stored = await this.transact(
+      "readonly",
+      (objectStore, resolve, reject) => {
+        const request = withOnError(objectStore.get(key), reject);
+        request.onsuccess = () => {
+          resolve(request.result);
+        };
+      }
+    );
+    if (!stored) {
+      return void 0;
+    }
+    try {
+      const obj = validateStoredObject(stored);
+      if (!obj) {
+        await this.delete(key);
+        this.gc();
+        return void 0;
+      }
+      return obj;
+    } catch (e) {
+      console.error(`Invalid kv value: ${key}=${JSON.stringify(stored)}:`, e);
+      await this.delete(key);
+      this.gc();
+      return void 0;
+    }
+  }
+  async get(key) {
+    const obj = await this.getStoredObject(key);
+    return obj?.value;
+  }
+  async forEach(callback) {
+    await this.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 obj = validateStoredObject(cursor.value);
+            if (obj) {
+              await callback(String(cursor.key), obj.value, obj.expiryMs);
+            } else {
+              await callback(String(cursor.key), void 0, 0);
+            }
+          }
+          cursor.continue();
+        } else {
+          resolve();
+        }
+      };
+    });
+  }
+  /** Cannot be a getter because this needs to be async. */
+  async size() {
+    let count = 0;
+    await this.forEach(() => {
+      count++;
+    });
+    return count;
+  }
+  async clear() {
+    const keys = [];
+    await this.forEach((key) => {
+      keys.push(key);
+    });
+    await this.delete(keys);
+  }
+  /** Mainly for debugging dumps. */
+  async asMap() {
+    const map = /* @__PURE__ */ new Map();
+    await this.forEach((key, value, expiryMs) => {
+      map.set(key, { value, expiryMs });
+    });
+    return map;
+  }
+  get lastGcMs() {
+    const lastGcMsStr = globalThis.localStorage.getItem(this.gcMsStorageKey);
+    if (!lastGcMsStr) return 0;
+    const ms = Number(lastGcMsStr);
+    return isNaN(ms) ? 0 : ms;
+  }
+  set lastGcMs(ms) {
+    globalThis.localStorage.setItem(this.gcMsStorageKey, String(ms));
+  }
+  /** Perform garbage-collection if due. */
+  async gc() {
+    const lastGcMs = this.lastGcMs;
+    if (!lastGcMs) {
+      this.lastGcMs = Date.now();
+      return;
+    }
+    if (Date.now() < lastGcMs + GC_INTERVAL_MS) {
+      return;
+    }
+    await this.gcNow();
+  }
+  /** Perform garbage-collection immediately without checking. */
+  async gcNow() {
+    console.log(`Starting kvStore GC on ${this.dbName} v${this.dbVersion}...`);
+    this.lastGcMs = Date.now();
+    const keysToDelete = [];
+    await this.forEach(
+      async (key, value, expiryMs) => {
+        if (value === void 0 || Date.now() >= expiryMs) {
+          keysToDelete.push(key);
+        }
+      }
+    );
+    if (keysToDelete.length) {
+      await this.delete(keysToDelete);
+    }
+    console.log(
+      `Finished kvStore GC on ${this.dbName} v${this.dbVersion} - deleted ${keysToDelete.length} keys`
+    );
+    this.lastGcMs = Date.now();
+  }
+  /** Get an independent store item with a locked key and value type. */
+  field(key) {
+    return new KVStoreField(this, key);
+  }
+};
+var kvStore = new KVStore(
+  DEFAULT_DB_NAME,
+  DEFAULT_DB_VERSION,
+  DEFAULT_EXPIRY_DELTA_MS
+);
+var KvStoreItem = class {
+  constructor(key, defaultExpiryDeltaMs, store = kvStore) {
+    this.key = key;
+    this.defaultExpiryDeltaMs = defaultExpiryDeltaMs;
+    this.store = store;
+  }
+  /**
+   * Example usage:
+   *
+   *   const { value, storedMs, expiryMs } = await myKvItem.getStoredObject();
+   */
+  async getStoredObject() {
+    return await this.store.getStoredObject(this.key);
+  }
+  async get() {
+    return await this.store.get(this.key);
+  }
+  async set(value, expiryDeltaMs = this.defaultExpiryDeltaMs) {
+    await this.store.set(this.key, value, expiryDeltaMs);
+  }
+  async delete() {
+    await this.store.delete(this.key);
+  }
+};
+function kvStoreItem(key, defaultExpiration) {
+  const defaultExpiryDeltaMs = durationOrMsToMs(defaultExpiration);
+  return new KvStoreItem(key, defaultExpiryDeltaMs);
+}
+export {
+  DEFAULT_EXPIRY_DELTA_MS,
+  GC_INTERVAL_MS,
+  KVStore,
+  KVStoreField,
+  MILLIS_PER_DAY,
+  kvStore,
+  kvStoreItem
+};

package/{localStorageCache.js → localStorageCache.cjs}

@@ -32,12 +32,11 @@ var MS_PER_DAY = 864e5;
 
 // src/duration.ts
 function durationToMs(duration) {
-  var _a, _b, _c, _d, _e;
-  const daysMs = ((_a = duration.days) != null ? _a : 0) * MS_PER_DAY;
-  const hoursMs = ((_b = duration.hours) != null ? _b : 0) * MS_PER_HOUR;
-  const minsMs = ((_c = duration.minutes) != null ? _c : 0) * MS_PER_MINUTE;
-  const secsMs = ((_d = duration.seconds) != null ? _d : 0) * MS_PER_SECOND;
-  const msMs = (_e = duration.milliseconds) != null ? _e : 0;
+  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) {
@@ -118,4 +117,3 @@ var CacheItem = class {
 0 && (module.exports = {
   storeItem
 });
-//# sourceMappingURL=localStorageCache.js.map

package/localStorageCache.d.mts

@@ -0,0 +1,57 @@
+import { Duration } from './duration.mjs';
+
+type StoredItem<T> = {
+    value: T;
+    storedMs: number;
+    expiryMs: number;
+};
+/**
+ * Simple local storage cache with support for auto-expiration.
+ * Note that this works in the browser context only because nodejs does not
+ * have local storage.
+ *
+ * Create a cache item accessor object with auto-expiration. The value will
+ * always be stored as a string by applying JSON.stringify(), and will be
+ * returned in the same object type by applying JSON.parse().
+ *
+ * In order to provide proper type-checking, please always specify the T
+ * type parameter. E.g. const item = storeItem<string>("name", 10_000);
+ *
+ * @param key The store key in local storage.
+ * @param expires Either a number in milliseconds, or a Duration object
+ * @param logError Log an error if we found an invalid object in the store.
+ *   The invalid object is usually a string that cannot be parsed as JSON.
+ * @param defaultValue Specify a default value to use for the object. Defaults
+ *   to undefined.
+ */
+declare function storeItem<T>(key: string, expires: number | Duration, logError?: boolean, defaultValue?: T): CacheItem<T>;
+declare class CacheItem<T> {
+    readonly key: string;
+    readonly expireDeltaMs: number;
+    readonly logError: boolean;
+    readonly defaultValue: T | undefined;
+    /**
+     * Create a cache item accessor object with auto-expiration.
+     */
+    constructor(key: string, expireDeltaMs: number, logError: boolean, defaultValue: T | undefined);
+    /**
+     * Set the value of this item with auto-expiration.
+     */
+    set(value: T, expiryDelta?: number | Duration): void;
+    /**
+     * Example usage:
+     *
+     *   const { value, storedMs, expiryMs } = await myItem.getStoredItem();
+     */
+    getStoredItem(): StoredItem<T> | undefined;
+    /**
+     * Get the value of this item, or undefined if value is not set or expired.
+     */
+    get(): T | undefined;
+    /**
+     * Remove the value of this item.
+     */
+    remove(): void;
+}
+
+export { type StoredItem, storeItem };

package/localStorageCache.min.cjs

@@ -0,0 +1,2 @@
+"use strict";var i=Object.defineProperty;var l=Object.getOwnPropertyDescriptor;var c=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var d=(r,o)=>{for(var t in o)i(r,t,{get:o[t],enumerable:!0})},f=(r,o,t,n)=>{if(o&&typeof o=="object"||typeof o=="function")for(let e of c(o))!p.call(r,e)&&e!==t&&i(r,e,{get:()=>o[e],enumerable:!(n=l(o,e))||n.enumerable});return r};var S=r=>f(i({},"__esModule",{value:!0}),r);var h={};d(h,{storeItem:()=>M});module.exports=S(h);function y(r){let o=(r.days??0)*864e5,t=(r.hours??0)*36e5,n=(r.minutes??0)*6e4,e=(r.seconds??0)*1e3,s=r.milliseconds??0;return o+t+n+e+s}function u(r){return typeof r=="number"?r:y(r)}function M(r,o,t=!0,n){let e=u(o);return new a(r,e,t,n)}var a=class{constructor(o,t,n,e){this.key=o;this.expireDeltaMs=t;this.logError=n;this.defaultValue=e}set(o,t=this.expireDeltaMs){let n=Date.now(),e={value:o,storedMs:n,expiryMs:n+u(t)},s=JSON.stringify(e);globalThis.localStorage.setItem(this.key,s)}getStoredItem(){let o=globalThis.localStorage.getItem(this.key);if(o)try{let t=JSON.parse(o);if(!t||typeof t!="object"||!("value"in t)||!("storedMs"in t)||typeof t.storedMs!="number"||!("expiryMs"in t)||typeof t.expiryMs!="number"||Date.now()>=t.expiryMs){this.remove();return}return t}catch(t){this.logError&&console.error(`Found invalid storage value: ${this.key}=${o}:`,t),this.remove();return}}get(){let o=this.getStoredItem();return o!==void 0?o.value:this.defaultValue}remove(){globalThis.localStorage.removeItem(this.key)}};0&&(module.exports={storeItem});
+//# sourceMappingURL=localStorageCache.min.cjs.map

package/localStorageCache.min.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/localStorageCache.ts","../src/duration.ts"],"sourcesContent":["import { Duration, durationOrMsToMs } from \"./duration\";\n\nexport type StoredItem<T> = { value: T; storedMs: number; expiryMs: number };\n\n/**\n * Simple local storage cache with support for auto-expiration.\n * Note that this works in the browser context only because nodejs does not\n * have local storage.\n *\n * Create a cache item accessor object with auto-expiration. The value will\n * always be stored as a string by applying JSON.stringify(), and will be\n * returned in the same object type by applying JSON.parse().\n *\n * In order to provide proper type-checking, please always specify the T\n * type parameter. E.g. const item = storeItem<string>(\"name\", 10_000);\n *\n * @param key The store key in local storage.\n * @param expires Either a number in milliseconds, or a Duration object\n * @param logError Log an error if we found an invalid object in the store.\n *   The invalid object is usually a string that cannot be parsed as JSON.\n * @param defaultValue Specify a default value to use for the object. Defaults\n *   to undefined.\n */\nexport function storeItem<T>(\n  key: string,\n  expires: number | Duration,\n  logError = true,\n  defaultValue?: T,\n) {\n  const expireDeltaMs = durationOrMsToMs(expires);\n\n  return new CacheItem<T>(key, expireDeltaMs, logError, defaultValue);\n}\n\nclass CacheItem<T> {\n  /**\n   * Create a cache item accessor object with auto-expiration.\n   */\n  public constructor(\n    public readonly key: string,\n    public readonly expireDeltaMs: number,\n    public readonly logError: boolean,\n    public readonly defaultValue: T | undefined,\n  ) {}\n\n  /**\n   * Set the value of this item with auto-expiration.\n   */\n  public set(\n    value: T,\n    expiryDelta: number | Duration = this.expireDeltaMs,\n  ): void {\n    const nowMs = Date.now();\n    const toStore: StoredItem<T> = {\n      value,\n      storedMs: nowMs,\n      expiryMs: nowMs + durationOrMsToMs(expiryDelta),\n    };\n    const valueStr = JSON.stringify(toStore);\n\n    globalThis.localStorage.setItem(this.key, valueStr);\n  }\n\n  /**\n   * Example usage:\n   *\n   *   const { value, storedMs, expiryMs } = await myItem.getStoredItem();\n   */\n  public getStoredItem(): StoredItem<T> | undefined {\n    const jsonStr = globalThis.localStorage.getItem(this.key);\n\n    if (!jsonStr) {\n      return undefined;\n    }\n\n    try {\n      const obj: StoredItem<T> | undefined = JSON.parse(jsonStr);\n\n      if (\n        !obj ||\n        typeof obj !== \"object\" ||\n        !(\"value\" in obj) ||\n        !(\"storedMs\" in obj) ||\n        typeof obj.storedMs !== \"number\" ||\n        !(\"expiryMs\" in obj) ||\n        typeof obj.expiryMs !== \"number\" ||\n        Date.now() >= obj.expiryMs\n      ) {\n        this.remove();\n        return undefined;\n      }\n\n      return obj;\n    } catch (e) {\n      if (this.logError) {\n        console.error(\n          `Found invalid storage value: ${this.key}=${jsonStr}:`,\n          e,\n        );\n      }\n      this.remove();\n      return undefined;\n    }\n  }\n\n  /**\n   * Get the value of this item, or undefined if value is not set or expired.\n   */\n  public get(): T | undefined {\n    const stored = this.getStoredItem();\n\n    return stored !== undefined ? stored.value : this.defaultValue;\n  }\n\n  /**\n   * Remove the value of this item.\n   */\n  public remove(): void {\n    globalThis.localStorage.removeItem(this.key);\n  }\n}\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":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,eAAAE,IAAA,eAAAC,EAAAH,GC0LO,SAASI,EAAaC,EAA4B,CACvD,IAAMC,GAAUD,EAAS,MAAQ,GAAK,MAChCE,GAAWF,EAAS,OAAS,GAAK,KAClCG,GAAUH,EAAS,SAAW,GAAK,IACnCI,GAAUJ,EAAS,SAAW,GAAK,IACnCK,EAAOL,EAAS,cAAgB,EAEtC,OAAOC,EAASC,EAAUC,EAASC,EAASC,CAC9C,CAKO,SAASC,EAAiBN,EAAqC,CACpE,OAAO,OAAOA,GAAa,SAAWA,EAAWD,EAAaC,CAAQ,CACxE,CDlLO,SAASO,EACdC,EACAC,EACAC,EAAW,GACXC,EACA,CACA,IAAMC,EAAgBC,EAAiBJ,CAAO,EAE9C,OAAO,IAAIK,EAAaN,EAAKI,EAAeF,EAAUC,CAAY,CACpE,CAEA,IAAMG,EAAN,KAAmB,CAIV,YACWN,EACAI,EACAF,EACAC,EAChB,CAJgB,SAAAH,EACA,mBAAAI,EACA,cAAAF,EACA,kBAAAC,CACf,CAKI,IACLI,EACAC,EAAiC,KAAK,cAChC,CACN,IAAMC,EAAQ,KAAK,IAAI,EACjBC,EAAyB,CAC7B,MAAAH,EACA,SAAUE,EACV,SAAUA,EAAQJ,EAAiBG,CAAW,CAChD,EACMG,EAAW,KAAK,UAAUD,CAAO,EAEvC,WAAW,aAAa,QAAQ,KAAK,IAAKC,CAAQ,CACpD,CAOO,eAA2C,CAChD,IAAMC,EAAU,WAAW,aAAa,QAAQ,KAAK,GAAG,EAExD,GAAKA,EAIL,GAAI,CACF,IAAMC,EAAiC,KAAK,MAAMD,CAAO,EAEzD,GACE,CAACC,GACD,OAAOA,GAAQ,UACf,EAAE,UAAWA,IACb,EAAE,aAAcA,IAChB,OAAOA,EAAI,UAAa,UACxB,EAAE,aAAcA,IAChB,OAAOA,EAAI,UAAa,UACxB,KAAK,IAAI,GAAKA,EAAI,SAClB,CACA,KAAK,OAAO,EACZ,MACF,CAEA,OAAOA,CACT,OAASC,EAAG,CACN,KAAK,UACP,QAAQ,MACN,gCAAgC,KAAK,GAAG,IAAIF,CAAO,IACnDE,CACF,EAEF,KAAK,OAAO,EACZ,MACF,CACF,CAKO,KAAqB,CAC1B,IAAMC,EAAS,KAAK,cAAc,EAElC,OAAOA,IAAW,OAAYA,EAAO,MAAQ,KAAK,YACpD,CAKO,QAAe,CACpB,WAAW,aAAa,WAAW,KAAK,GAAG,CAC7C,CACF","names":["localStorageCache_exports","__export","storeItem","__toCommonJS","durationToMs","duration","daysMs","hoursMs","minsMs","secsMs","msMs","durationOrMsToMs","storeItem","key","expires","logError","defaultValue","expireDeltaMs","durationOrMsToMs","CacheItem","value","expiryDelta","nowMs","toStore","valueStr","jsonStr","obj","e","stored"]}

package/localStorageCache.min.mjs

@@ -0,0 +1,2 @@
+function d(r){let t=(r.days??0)*864e5,o=(r.hours??0)*36e5,e=(r.minutes??0)*6e4,n=(r.seconds??0)*1e3,s=r.milliseconds??0;return t+o+e+n+s}function i(r){return typeof r=="number"?r:d(r)}function h(r,t,o=!0,e){let n=i(t);return new u(r,n,o,e)}var u=class{constructor(t,o,e,n){this.key=t;this.expireDeltaMs=o;this.logError=e;this.defaultValue=n}set(t,o=this.expireDeltaMs){let e=Date.now(),n={value:t,storedMs:e,expiryMs:e+i(o)},s=JSON.stringify(n);globalThis.localStorage.setItem(this.key,s)}getStoredItem(){let t=globalThis.localStorage.getItem(this.key);if(t)try{let o=JSON.parse(t);if(!o||typeof o!="object"||!("value"in o)||!("storedMs"in o)||typeof o.storedMs!="number"||!("expiryMs"in o)||typeof o.expiryMs!="number"||Date.now()>=o.expiryMs){this.remove();return}return o}catch(o){this.logError&&console.error(`Found invalid storage value: ${this.key}=${t}:`,o),this.remove();return}}get(){let t=this.getStoredItem();return t!==void 0?t.value:this.defaultValue}remove(){globalThis.localStorage.removeItem(this.key)}};export{h as storeItem};
+//# sourceMappingURL=localStorageCache.min.mjs.map

package/localStorageCache.min.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/duration.ts","../src/localStorageCache.ts"],"sourcesContent":["/**\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","import { Duration, durationOrMsToMs } from \"./duration\";\n\nexport type StoredItem<T> = { value: T; storedMs: number; expiryMs: number };\n\n/**\n * Simple local storage cache with support for auto-expiration.\n * Note that this works in the browser context only because nodejs does not\n * have local storage.\n *\n * Create a cache item accessor object with auto-expiration. The value will\n * always be stored as a string by applying JSON.stringify(), and will be\n * returned in the same object type by applying JSON.parse().\n *\n * In order to provide proper type-checking, please always specify the T\n * type parameter. E.g. const item = storeItem<string>(\"name\", 10_000);\n *\n * @param key The store key in local storage.\n * @param expires Either a number in milliseconds, or a Duration object\n * @param logError Log an error if we found an invalid object in the store.\n *   The invalid object is usually a string that cannot be parsed as JSON.\n * @param defaultValue Specify a default value to use for the object. Defaults\n *   to undefined.\n */\nexport function storeItem<T>(\n  key: string,\n  expires: number | Duration,\n  logError = true,\n  defaultValue?: T,\n) {\n  const expireDeltaMs = durationOrMsToMs(expires);\n\n  return new CacheItem<T>(key, expireDeltaMs, logError, defaultValue);\n}\n\nclass CacheItem<T> {\n  /**\n   * Create a cache item accessor object with auto-expiration.\n   */\n  public constructor(\n    public readonly key: string,\n    public readonly expireDeltaMs: number,\n    public readonly logError: boolean,\n    public readonly defaultValue: T | undefined,\n  ) {}\n\n  /**\n   * Set the value of this item with auto-expiration.\n   */\n  public set(\n    value: T,\n    expiryDelta: number | Duration = this.expireDeltaMs,\n  ): void {\n    const nowMs = Date.now();\n    const toStore: StoredItem<T> = {\n      value,\n      storedMs: nowMs,\n      expiryMs: nowMs + durationOrMsToMs(expiryDelta),\n    };\n    const valueStr = JSON.stringify(toStore);\n\n    globalThis.localStorage.setItem(this.key, valueStr);\n  }\n\n  /**\n   * Example usage:\n   *\n   *   const { value, storedMs, expiryMs } = await myItem.getStoredItem();\n   */\n  public getStoredItem(): StoredItem<T> | undefined {\n    const jsonStr = globalThis.localStorage.getItem(this.key);\n\n    if (!jsonStr) {\n      return undefined;\n    }\n\n    try {\n      const obj: StoredItem<T> | undefined = JSON.parse(jsonStr);\n\n      if (\n        !obj ||\n        typeof obj !== \"object\" ||\n        !(\"value\" in obj) ||\n        !(\"storedMs\" in obj) ||\n        typeof obj.storedMs !== \"number\" ||\n        !(\"expiryMs\" in obj) ||\n        typeof obj.expiryMs !== \"number\" ||\n        Date.now() >= obj.expiryMs\n      ) {\n        this.remove();\n        return undefined;\n      }\n\n      return obj;\n    } catch (e) {\n      if (this.logError) {\n        console.error(\n          `Found invalid storage value: ${this.key}=${jsonStr}:`,\n          e,\n        );\n      }\n      this.remove();\n      return undefined;\n    }\n  }\n\n  /**\n   * Get the value of this item, or undefined if value is not set or expired.\n   */\n  public get(): T | undefined {\n    const stored = this.getStoredItem();\n\n    return stored !== undefined ? stored.value : this.defaultValue;\n  }\n\n  /**\n   * Remove the value of this item.\n   */\n  public remove(): void {\n    globalThis.localStorage.removeItem(this.key);\n  }\n}\n"],"mappings":"AA0LO,SAASA,EAAaC,EAA4B,CACvD,IAAMC,GAAUD,EAAS,MAAQ,GAAK,MAChCE,GAAWF,EAAS,OAAS,GAAK,KAClCG,GAAUH,EAAS,SAAW,GAAK,IACnCI,GAAUJ,EAAS,SAAW,GAAK,IACnCK,EAAOL,EAAS,cAAgB,EAEtC,OAAOC,EAASC,EAAUC,EAASC,EAASC,CAC9C,CAKO,SAASC,EAAiBN,EAAqC,CACpE,OAAO,OAAOA,GAAa,SAAWA,EAAWD,EAAaC,CAAQ,CACxE,CClLO,SAASO,EACdC,EACAC,EACAC,EAAW,GACXC,EACA,CACA,IAAMC,EAAgBC,EAAiBJ,CAAO,EAE9C,OAAO,IAAIK,EAAaN,EAAKI,EAAeF,EAAUC,CAAY,CACpE,CAEA,IAAMG,EAAN,KAAmB,CAIV,YACWN,EACAI,EACAF,EACAC,EAChB,CAJgB,SAAAH,EACA,mBAAAI,EACA,cAAAF,EACA,kBAAAC,CACf,CAKI,IACLI,EACAC,EAAiC,KAAK,cAChC,CACN,IAAMC,EAAQ,KAAK,IAAI,EACjBC,EAAyB,CAC7B,MAAAH,EACA,SAAUE,EACV,SAAUA,EAAQJ,EAAiBG,CAAW,CAChD,EACMG,EAAW,KAAK,UAAUD,CAAO,EAEvC,WAAW,aAAa,QAAQ,KAAK,IAAKC,CAAQ,CACpD,CAOO,eAA2C,CAChD,IAAMC,EAAU,WAAW,aAAa,QAAQ,KAAK,GAAG,EAExD,GAAKA,EAIL,GAAI,CACF,IAAMC,EAAiC,KAAK,MAAMD,CAAO,EAEzD,GACE,CAACC,GACD,OAAOA,GAAQ,UACf,EAAE,UAAWA,IACb,EAAE,aAAcA,IAChB,OAAOA,EAAI,UAAa,UACxB,EAAE,aAAcA,IAChB,OAAOA,EAAI,UAAa,UACxB,KAAK,IAAI,GAAKA,EAAI,SAClB,CACA,KAAK,OAAO,EACZ,MACF,CAEA,OAAOA,CACT,OAASC,EAAG,CACN,KAAK,UACP,QAAQ,MACN,gCAAgC,KAAK,GAAG,IAAIF,CAAO,IACnDE,CACF,EAEF,KAAK,OAAO,EACZ,MACF,CACF,CAKO,KAAqB,CAC1B,IAAMC,EAAS,KAAK,cAAc,EAElC,OAAOA,IAAW,OAAYA,EAAO,MAAQ,KAAK,YACpD,CAKO,QAAe,CACpB,WAAW,aAAa,WAAW,KAAK,GAAG,CAC7C,CACF","names":["durationToMs","duration","daysMs","hoursMs","minsMs","secsMs","msMs","durationOrMsToMs","storeItem","key","expires","logError","defaultValue","expireDeltaMs","durationOrMsToMs","CacheItem","value","expiryDelta","nowMs","toStore","valueStr","jsonStr","obj","e","stored"]}

package/localStorageCache.mjs

@@ -0,0 +1,92 @@
+// 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/localStorageCache.ts
+function storeItem(key, expires, logError = true, defaultValue) {
+  const expireDeltaMs = durationOrMsToMs(expires);
+  return new CacheItem(key, expireDeltaMs, logError, defaultValue);
+}
+var CacheItem = class {
+  /**
+   * Create a cache item accessor object with auto-expiration.
+   */
+  constructor(key, expireDeltaMs, logError, defaultValue) {
+    this.key = key;
+    this.expireDeltaMs = expireDeltaMs;
+    this.logError = logError;
+    this.defaultValue = defaultValue;
+  }
+  /**
+   * Set the value of this item with auto-expiration.
+   */
+  set(value, expiryDelta = this.expireDeltaMs) {
+    const nowMs = Date.now();
+    const toStore = {
+      value,
+      storedMs: nowMs,
+      expiryMs: nowMs + durationOrMsToMs(expiryDelta)
+    };
+    const valueStr = JSON.stringify(toStore);
+    globalThis.localStorage.setItem(this.key, valueStr);
+  }
+  /**
+   * Example usage:
+   *
+   *   const { value, storedMs, expiryMs } = await myItem.getStoredItem();
+   */
+  getStoredItem() {
+    const jsonStr = globalThis.localStorage.getItem(this.key);
+    if (!jsonStr) {
+      return void 0;
+    }
+    try {
+      const obj = JSON.parse(jsonStr);
+      if (!obj || typeof obj !== "object" || !("value" in obj) || !("storedMs" in obj) || typeof obj.storedMs !== "number" || !("expiryMs" in obj) || typeof obj.expiryMs !== "number" || Date.now() >= obj.expiryMs) {
+        this.remove();
+        return void 0;
+      }
+      return obj;
+    } catch (e) {
+      if (this.logError) {
+        console.error(
+          `Found invalid storage value: ${this.key}=${jsonStr}:`,
+          e
+        );
+      }
+      this.remove();
+      return void 0;
+    }
+  }
+  /**
+   * Get the value of this item, or undefined if value is not set or expired.
+   */
+  get() {
+    const stored = this.getStoredItem();
+    return stored !== void 0 ? stored.value : this.defaultValue;
+  }
+  /**
+   * Remove the value of this item.
+   */
+  remove() {
+    globalThis.localStorage.removeItem(this.key);
+  }
+};
+export {
+  storeItem
+};

package/{logging.js → logging.cjs}

@@ -45,4 +45,3 @@ function capLength(u, maxLength = 400) {
   capLength,
   stringify
 });
-//# sourceMappingURL=logging.js.map

package/logging.d.mts

@@ -0,0 +1,4 @@
+declare function stringify(u: unknown): string;
+declare function capLength(u: unknown, maxLength?: number): string;
+
+export { capLength, stringify };

package/logging.min.cjs

@@ -0,0 +1,2 @@
+"use strict";var o=Object.defineProperty;var g=Object.getOwnPropertyDescriptor;var s=Object.getOwnPropertyNames;var c=Object.prototype.hasOwnProperty;var p=(t,n)=>{for(var r in n)o(t,r,{get:n[r],enumerable:!0})},l=(t,n,r,e)=>{if(n&&typeof n=="object"||typeof n=="function")for(let i of s(n))!c.call(t,i)&&i!==r&&o(t,i,{get:()=>n[i],enumerable:!(e=g(n,i))||e.enumerable});return t};var y=t=>l(o({},"__esModule",{value:!0}),t);var S={};p(S,{capLength:()=>u,stringify:()=>f});module.exports=y(S);function f(t){return typeof t=="string"?t:t!==null&&typeof t=="object"&&t.toString!==Object.prototype.toString?t.toString():JSON.stringify(t)}function u(t,n=400){let r=f(t);return r.length<=n?r:r.slice(0,n)+` ... (${r.length-n} more)`}0&&(module.exports={capLength,stringify});
+//# sourceMappingURL=logging.min.cjs.map

package/logging.min.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/logging.ts"],"sourcesContent":["export function stringify(u: unknown): string {\n  if (typeof u === \"string\") {\n    return u;\n  }\n\n  // If the object has a custom toString(), then use it.\n  if (\n    u !== null &&\n    typeof u === \"object\" &&\n    u.toString !== Object.prototype.toString\n  ) {\n    return u.toString();\n  }\n\n  return JSON.stringify(u);\n}\n\nexport function capLength(u: unknown, maxLength = 400): string {\n  const s = stringify(u);\n\n  if (s.length <= maxLength) {\n    return s;\n  }\n\n  return s.slice(0, maxLength) + ` ... (${s.length - maxLength} more)`;\n}\n"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,eAAAE,EAAA,cAAAC,IAAA,eAAAC,EAAAJ,GAAO,SAASG,EAAUE,EAAoB,CAC5C,OAAI,OAAOA,GAAM,SACRA,EAKPA,IAAM,MACN,OAAOA,GAAM,UACbA,EAAE,WAAa,OAAO,UAAU,SAEzBA,EAAE,SAAS,EAGb,KAAK,UAAUA,CAAC,CACzB,CAEO,SAASH,EAAUG,EAAYC,EAAY,IAAa,CAC7D,IAAMC,EAAIJ,EAAUE,CAAC,EAErB,OAAIE,EAAE,QAAUD,EACPC,EAGFA,EAAE,MAAM,EAAGD,CAAS,EAAI,SAASC,EAAE,OAASD,CAAS,QAC9D","names":["logging_exports","__export","capLength","stringify","__toCommonJS","u","maxLength","s"]}

package/logging.min.mjs

@@ -0,0 +1,2 @@
+function i(t){return typeof t=="string"?t:t!==null&&typeof t=="object"&&t.toString!==Object.prototype.toString?t.toString():JSON.stringify(t)}function o(t,r=400){let n=i(t);return n.length<=r?n:n.slice(0,r)+` ... (${n.length-r} more)`}export{o as capLength,i as stringify};
+//# sourceMappingURL=logging.min.mjs.map

package/{logging.js.map → logging.min.mjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/logging.ts"],"sourcesContent":["export function stringify(u: unknown): string {\n  if (typeof u === \"string\") {\n    return u;\n  }\n\n  // If the object has a custom toString(), then use it.\n  if (\n    u !== null &&\n    typeof u === \"object\" &&\n    u.toString !== Object.prototype.toString\n  ) {\n    return u.toString();\n  }\n\n  return JSON.stringify(u);\n}\n\nexport function capLength(u: unknown, maxLength = 400): string {\n  const s = stringify(u);\n\n  if (s.length <= maxLength) {\n    return s;\n  }\n\n  return s.slice(0, maxLength) + ` ... (${s.length - maxLength} more)`;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAO,SAAS,UAAU,GAAoB;AAC5C,MAAI,OAAO,MAAM,UAAU;AACzB,WAAO;AAAA,EACT;AAGA,MACE,MAAM,QACN,OAAO,MAAM,YACb,EAAE,aAAa,OAAO,UAAU,UAChC;AACA,WAAO,EAAE,SAAS;AAAA,EACpB;AAEA,SAAO,KAAK,UAAU,CAAC;AACzB;AAEO,SAAS,UAAU,GAAY,YAAY,KAAa;AAC7D,QAAM,IAAI,UAAU,CAAC;AAErB,MAAI,EAAE,UAAU,WAAW;AACzB,WAAO;AAAA,EACT;AAEA,SAAO,EAAE,MAAM,GAAG,SAAS,IAAI,SAAS,EAAE,SAAS,SAAS;AAC9D;","names":[]}
+{"version":3,"sources":["../src/logging.ts"],"sourcesContent":["export function stringify(u: unknown): string {\n  if (typeof u === \"string\") {\n    return u;\n  }\n\n  // If the object has a custom toString(), then use it.\n  if (\n    u !== null &&\n    typeof u === \"object\" &&\n    u.toString !== Object.prototype.toString\n  ) {\n    return u.toString();\n  }\n\n  return JSON.stringify(u);\n}\n\nexport function capLength(u: unknown, maxLength = 400): string {\n  const s = stringify(u);\n\n  if (s.length <= maxLength) {\n    return s;\n  }\n\n  return s.slice(0, maxLength) + ` ... (${s.length - maxLength} more)`;\n}\n"],"mappings":"AAAO,SAASA,EAAUC,EAAoB,CAC5C,OAAI,OAAOA,GAAM,SACRA,EAKPA,IAAM,MACN,OAAOA,GAAM,UACbA,EAAE,WAAa,OAAO,UAAU,SAEzBA,EAAE,SAAS,EAGb,KAAK,UAAUA,CAAC,CACzB,CAEO,SAASC,EAAUD,EAAYE,EAAY,IAAa,CAC7D,IAAMC,EAAIJ,EAAUC,CAAC,EAErB,OAAIG,EAAE,QAAUD,EACPC,EAGFA,EAAE,MAAM,EAAGD,CAAS,EAAI,SAASC,EAAE,OAASD,CAAS,QAC9D","names":["stringify","u","capLength","maxLength","s"]}

package/logging.mjs

@@ -0,0 +1,21 @@
+// src/logging.ts
+function stringify(u) {
+  if (typeof u === "string") {
+    return u;
+  }
+  if (u !== null && typeof u === "object" && u.toString !== Object.prototype.toString) {
+    return u.toString();
+  }
+  return JSON.stringify(u);
+}
+function capLength(u, maxLength = 400) {
+  const s = stringify(u);
+  if (s.length <= maxLength) {
+    return s;
+  }
+  return s.slice(0, maxLength) + ` ... (${s.length - maxLength} more)`;
+}
+export {
+  capLength,
+  stringify
+};

package/{nonEmpty.js → nonEmpty.cjs}

@@ -55,4 +55,3 @@ function nonEmpty(t, varName = "value") {
 0 && (module.exports = {
   nonEmpty
 });
-//# sourceMappingURL=nonEmpty.js.map

package/nonEmpty.d.mts

@@ -0,0 +1,10 @@
+/**
+ * Type asserts that `t` is truthy.
+ * Throws an error if `t` is null or undefined.
+ *
+ * @param varName The variable name to include in the error to throw when t is
+ *   empty. Defaults to 'value'.
+ */
+declare function nonEmpty<T>(t: T | null | undefined | "" | 0 | -0 | 0n | false | typeof NaN, varName?: string): T;
+
+export { nonEmpty };

package/nonEmpty.min.cjs

@@ -0,0 +1,2 @@
+"use strict";var t=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var l=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var s=(n,e)=>{for(var o in e)t(n,o,{get:e[o],enumerable:!0})},a=(n,e,o,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of l(e))!p.call(n,r)&&r!==o&&t(n,r,{get:()=>e[r],enumerable:!(i=u(e,r))||i.enumerable});return n};var m=n=>a(t({},"__esModule",{value:!0}),n);var E={};s(E,{nonEmpty:()=>y});module.exports=m(E);function f(n){if(!n)return!0;if(typeof n!="object")return!1;if("length"in n)return n.length===0;if("size"in n)return n.size===0;for(let e in n)return!1;return!0}function y(n,e="value"){if(f(n))throw new Error(`Empty ${e}: ${n}`);return n}0&&(module.exports={nonEmpty});
+//# sourceMappingURL=nonEmpty.min.cjs.map

package/{nonEmpty.js.map → nonEmpty.min.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/nonEmpty.ts","../src/isEmpty.ts"],"sourcesContent":["import { isEmpty } from \"./isEmpty\";\n\n/**\n * Type asserts that `t` is truthy.\n * Throws an error if `t` is null or undefined.\n *\n * @param varName The variable name to include in the error to throw when t is\n *   empty. Defaults to 'value'.\n */\nexport function nonEmpty<T>(\n  t: T | null | undefined | \"\" | 0 | -0 | 0n | false | typeof NaN,\n  varName = \"value\",\n): T {\n  if (isEmpty(t)) {\n    throw new Error(`Empty ${varName}: ${t}`);\n  }\n  return t as T;\n}\n","/**\n * Returns true if `t` is empty.\n */\nexport function isEmpty(t: unknown): boolean {\n  // Anything falsy is considered empty.\n  if (!t) {\n    return true;\n  }\n\n  // Arrays are also of type `object`.\n  if (typeof t !== \"object\") {\n    return false;\n  }\n\n  // `length` includes arrays as well.\n  if (\"length\" in t) {\n    return t.length === 0;\n  }\n\n  // `size` is for Set, Map, Blob etc.\n  if (\"size\" in t) {\n    return t.size === 0;\n  }\n\n  // Super fast check for object emptiness.\n  // https://stackoverflow.com/questions/679915/how-do-i-test-for-an-empty-javascript-object\n  for (const k in t) {\n    return false;\n  }\n\n  return true;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACGO,SAAS,QAAQ,GAAqB;AAE3C,MAAI,CAAC,GAAG;AACN,WAAO;AAAA,EACT;AAGA,MAAI,OAAO,MAAM,UAAU;AACzB,WAAO;AAAA,EACT;AAGA,MAAI,YAAY,GAAG;AACjB,WAAO,EAAE,WAAW;AAAA,EACtB;AAGA,MAAI,UAAU,GAAG;AACf,WAAO,EAAE,SAAS;AAAA,EACpB;AAIA,aAAW,KAAK,GAAG;AACjB,WAAO;AAAA,EACT;AAEA,SAAO;AACT;;;ADtBO,SAAS,SACd,GACA,UAAU,SACP;AACH,MAAI,QAAQ,CAAC,GAAG;AACd,UAAM,IAAI,MAAM,SAAS,OAAO,KAAK,CAAC,EAAE;AAAA,EAC1C;AACA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../src/nonEmpty.ts","../src/isEmpty.ts"],"sourcesContent":["import { isEmpty } from \"./isEmpty\";\n\n/**\n * Type asserts that `t` is truthy.\n * Throws an error if `t` is null or undefined.\n *\n * @param varName The variable name to include in the error to throw when t is\n *   empty. Defaults to 'value'.\n */\nexport function nonEmpty<T>(\n  t: T | null | undefined | \"\" | 0 | -0 | 0n | false | typeof NaN,\n  varName = \"value\",\n): T {\n  if (isEmpty(t)) {\n    throw new Error(`Empty ${varName}: ${t}`);\n  }\n  return t as T;\n}\n","/**\n * Returns true if `t` is empty.\n */\nexport function isEmpty(t: unknown): boolean {\n  // Anything falsy is considered empty.\n  if (!t) {\n    return true;\n  }\n\n  // Arrays are also of type `object`.\n  if (typeof t !== \"object\") {\n    return false;\n  }\n\n  // `length` includes arrays as well.\n  if (\"length\" in t) {\n    return t.length === 0;\n  }\n\n  // `size` is for Set, Map, Blob etc.\n  if (\"size\" in t) {\n    return t.size === 0;\n  }\n\n  // Super fast check for object emptiness.\n  // https://stackoverflow.com/questions/679915/how-do-i-test-for-an-empty-javascript-object\n  for (const k in t) {\n    return false;\n  }\n\n  return true;\n}\n"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,cAAAE,IAAA,eAAAC,EAAAH,GCGO,SAASI,EAAQC,EAAqB,CAE3C,GAAI,CAACA,EACH,MAAO,GAIT,GAAI,OAAOA,GAAM,SACf,MAAO,GAIT,GAAI,WAAYA,EACd,OAAOA,EAAE,SAAW,EAItB,GAAI,SAAUA,EACZ,OAAOA,EAAE,OAAS,EAKpB,QAAWC,KAAKD,EACd,MAAO,GAGT,MAAO,EACT,CDtBO,SAASE,EACdC,EACAC,EAAU,QACP,CACH,GAAIC,EAAQF,CAAC,EACX,MAAM,IAAI,MAAM,SAASC,CAAO,KAAKD,CAAC,EAAE,EAE1C,OAAOA,CACT","names":["nonEmpty_exports","__export","nonEmpty","__toCommonJS","isEmpty","t","k","nonEmpty","t","varName","isEmpty"]}

package/nonEmpty.min.mjs

@@ -0,0 +1,2 @@
+function r(n){if(!n)return!0;if(typeof n!="object")return!1;if("length"in n)return n.length===0;if("size"in n)return n.size===0;for(let e in n)return!1;return!0}function i(n,e="value"){if(r(n))throw new Error(`Empty ${e}: ${n}`);return n}export{i as nonEmpty};
+//# sourceMappingURL=nonEmpty.min.mjs.map

package/nonEmpty.min.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/isEmpty.ts","../src/nonEmpty.ts"],"sourcesContent":["/**\n * Returns true if `t` is empty.\n */\nexport function isEmpty(t: unknown): boolean {\n  // Anything falsy is considered empty.\n  if (!t) {\n    return true;\n  }\n\n  // Arrays are also of type `object`.\n  if (typeof t !== \"object\") {\n    return false;\n  }\n\n  // `length` includes arrays as well.\n  if (\"length\" in t) {\n    return t.length === 0;\n  }\n\n  // `size` is for Set, Map, Blob etc.\n  if (\"size\" in t) {\n    return t.size === 0;\n  }\n\n  // Super fast check for object emptiness.\n  // https://stackoverflow.com/questions/679915/how-do-i-test-for-an-empty-javascript-object\n  for (const k in t) {\n    return false;\n  }\n\n  return true;\n}\n","import { isEmpty } from \"./isEmpty\";\n\n/**\n * Type asserts that `t` is truthy.\n * Throws an error if `t` is null or undefined.\n *\n * @param varName The variable name to include in the error to throw when t is\n *   empty. Defaults to 'value'.\n */\nexport function nonEmpty<T>(\n  t: T | null | undefined | \"\" | 0 | -0 | 0n | false | typeof NaN,\n  varName = \"value\",\n): T {\n  if (isEmpty(t)) {\n    throw new Error(`Empty ${varName}: ${t}`);\n  }\n  return t as T;\n}\n"],"mappings":"AAGO,SAASA,EAAQC,EAAqB,CAE3C,GAAI,CAACA,EACH,MAAO,GAIT,GAAI,OAAOA,GAAM,SACf,MAAO,GAIT,GAAI,WAAYA,EACd,OAAOA,EAAE,SAAW,EAItB,GAAI,SAAUA,EACZ,OAAOA,EAAE,OAAS,EAKpB,QAAWC,KAAKD,EACd,MAAO,GAGT,MAAO,EACT,CCtBO,SAASE,EACdC,EACAC,EAAU,QACP,CACH,GAAIC,EAAQF,CAAC,EACX,MAAM,IAAI,MAAM,SAASC,CAAO,KAAKD,CAAC,EAAE,EAE1C,OAAOA,CACT","names":["isEmpty","t","k","nonEmpty","t","varName","isEmpty"]}