@choksheak/ts-utils 0.3.0 → 0.3.1

package/localStore.cjs

@@ -0,0 +1,267 @@
+"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, {
+  LocalStore: () => LocalStore,
+  LocalStoreConfig: () => LocalStoreConfig,
+  LocalStoreItem: () => LocalStoreItem,
+  configureLocalStore: () => configureLocalStore,
+  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);
+}
+
+// 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;
+}
+var LocalStore = class {
+  constructor(storeName, options) {
+    this.storeName = storeName;
+    this.keyPrefix = storeName + ":";
+    this.defaultExpiryMs = options?.defaultExpiryMs ? durationOrMsToMs(options.defaultExpiryMs) : LocalStoreConfig.expiryMs;
+    this.gcIntervalMs = options?.gcIntervalMs ? durationOrMsToMs(options.gcIntervalMs) : LocalStoreConfig.gcIntervalMs;
+    this.gcMsStorageKey = `__localStore:lastGcMs:${storeName}`;
+  }
+  /**
+   * The prefix string for the local storage key which identifies items
+   * belonging to this namespace.
+   */
+  keyPrefix;
+  /** Local storage key name for the last GC completed timestamp. */
+  gcMsStorageKey;
+  defaultExpiryMs;
+  gcIntervalMs;
+  /** Set a value in the store. */
+  set(key, value, expiryDeltaMs = this.defaultExpiryMs) {
+    const nowMs = Date.now();
+    const obj = {
+      value,
+      storedMs: nowMs,
+      expiryMs: nowMs + durationOrMsToMs(expiryDeltaMs)
+    };
+    localStorage.setItem(this.keyPrefix + key, JSON.stringify(obj));
+    this.gc();
+    return value;
+  }
+  /** Delete one or multiple keys. */
+  delete(key) {
+    if (typeof key === "string") {
+      localStorage.removeItem(this.keyPrefix + key);
+    } else {
+      for (const k of key) {
+        localStorage.removeItem(this.keyPrefix + k);
+      }
+    }
+  }
+  /** Mainly used to get the expiration timestamp of an object. */
+  getStoredObject(key) {
+    const k = this.keyPrefix + key;
+    const stored = localStorage.getItem(k);
+    if (!stored) {
+      return void 0;
+    }
+    try {
+      const parsed = JSON.parse(stored);
+      const obj = validateStoredObject(parsed);
+      if (!obj) {
+        this.delete(k);
+        this.gc();
+        return void 0;
+      }
+      return obj;
+    } catch (e) {
+      console.error(`Invalid local value: ${k}=${stored}:`, e);
+      this.delete(k);
+      this.gc();
+      return void 0;
+    }
+  }
+  /** Get a value by key, or undefined if it does not exist. */
+  get(key) {
+    const obj = this.getStoredObject(key);
+    return obj?.value;
+  }
+  /** Generic way to iterate through all entries. */
+  forEach(callback) {
+    for (const k of Object.keys(localStorage)) {
+      if (!k.startsWith(this.keyPrefix)) continue;
+      const key = k.slice(this.keyPrefix.length);
+      const obj = this.getStoredObject(key);
+      if (!obj) continue;
+      callback(key, obj.value, obj.expiryMs, obj.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;
+    this.forEach(() => {
+      count++;
+    });
+    return count;
+  }
+  /** Remove all items from the store. */
+  clear() {
+    for (const key of Object.keys(localStorage)) {
+      if (key.startsWith(this.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();
+    this.forEach((key, value, expiryMs, storedMs) => {
+      map.set(key, { value, expiryMs, storedMs });
+    });
+    return map;
+  }
+  /** Returns the ms timestamp for the last GC (garbage collection). */
+  get lastGcMs() {
+    const lastGcMsStr = globalThis.localStorage.getItem(this.gcMsStorageKey);
+    if (!lastGcMsStr) return 0;
+    const ms = Number(lastGcMsStr);
+    return isNaN(ms) ? 0 : ms;
+  }
+  /** Set the ms timestamp for the last GC (garbage collection). */
+  set lastGcMs(ms) {
+    globalThis.localStorage.setItem(this.gcMsStorageKey, String(ms));
+  }
+  /** Perform garbage-collection if due, else do nothing. */
+  gc() {
+    const lastGcMs = this.lastGcMs;
+    if (!lastGcMs) {
+      this.lastGcMs = Date.now();
+      return;
+    }
+    if (Date.now() < lastGcMs + this.gcIntervalMs) {
+      return;
+    }
+    this.gcNow();
+  }
+  /**
+   * Perform garbage collection immediately without checking whether we are
+   * due for the next GC or not.
+   */
+  gcNow() {
+    console.log(`Starting localStore GC on ${this.storeName}`);
+    this.lastGcMs = Date.now();
+    let count = 0;
+    this.forEach((key, value, expiryMs) => {
+      if (Date.now() >= expiryMs) {
+        this.delete(key);
+        count++;
+      }
+    });
+    console.log(
+      `Finished localStore GC on ${this.storeName} - deleted ${count} keys`
+    );
+    this.lastGcMs = Date.now();
+  }
+  /** Returns `this` casted into a StorageAdapter<T>. */
+  asStorageAdapter() {
+    return this;
+  }
+};
+var localStore = new LocalStore(LocalStoreConfig.storeName);
+var LocalStoreItem = class {
+  constructor(key, defaultExpiryMs = LocalStoreConfig.expiryMs, store = localStore) {
+    this.key = key;
+    this.store = store;
+    this.defaultExpiryMs = defaultExpiryMs && durationOrMsToMs(defaultExpiryMs);
+  }
+  defaultExpiryMs;
+  /** Set a value in the store. */
+  set(value, expiryDeltaMs = this.defaultExpiryMs) {
+    this.store.set(this.key, value, expiryDeltaMs);
+  }
+  /**
+   * Example usage:
+   *
+   *   const { value, storedMs, expiryMs, storedMs } =
+   *     await myLocalItem.getStoredObject();
+   */
+  getStoredObject() {
+    return this.store.getStoredObject(this.key);
+  }
+  /** Get a value by key, or undefined if it does not exist. */
+  get() {
+    return this.store.get(this.key);
+  }
+  /** Delete this key from the store. */
+  delete() {
+    this.store.delete(this.key);
+  }
+};
+function localStoreItem(key, expiryMs, store = localStore) {
+  expiryMs = expiryMs && durationOrMsToMs(expiryMs);
+  return new LocalStoreItem(key, expiryMs, store);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LocalStore,
+  LocalStoreConfig,
+  LocalStoreItem,
+  configureLocalStore,
+  localStore,
+  localStoreItem
+});

package/localStore.d.mts

@@ -0,0 +1,119 @@
+import { Duration } from './duration.mjs';
+import { FullStorageAdapter, StoredObject, StorageAdapter } from './storageAdapter.mjs';
+
+/**
+ * Local storage key-value store with support for auto-expirations.
+ *
+ * Why use this?
+ * 1. Extremely simple interface to use local storage.
+ * 2. Auto-expirations with GC frees you from worrying about data clean-up.
+ * 3. Any serializable data type can be stored (except undefined).
+ *
+ * How to use?
+ * Just use the `localStore` global constant like the local storage.
+ *
+ * Why not use the localStorage directly?
+ * localStorage does not provide auto-expirations with GC. If you don't need
+ * this (items never expire), then just use localStorage directly.
+ */
+
+/** Global defaults can be updated directly. */
+declare const LocalStoreConfig: {
+    /** All items with the same store name will share the same storage space. */
+    storeName: string;
+    /** 30 days in ms. */
+    expiryMs: number;
+    /** Do GC once per day. */
+    gcIntervalMs: number;
+};
+type LocalStoreConfig = typeof LocalStoreConfig;
+/** Convenience function to update global defaults. */
+declare function configureLocalStore(config: Partial<LocalStoreConfig>): void;
+/**
+ * You can create multiple LocalStores if you want, but most likely you will only
+ * need to use the default `localStore` instance.
+ */
+declare class LocalStore implements FullStorageAdapter<any> {
+    readonly storeName: string;
+    /**
+     * The prefix string for the local storage key which identifies items
+     * belonging to this namespace.
+     */
+    readonly keyPrefix: string;
+    /** Local storage key name for the last GC completed timestamp. */
+    readonly gcMsStorageKey: string;
+    readonly defaultExpiryMs: number;
+    readonly gcIntervalMs: number;
+    constructor(storeName: string, options?: {
+        defaultExpiryMs?: number | Duration;
+        gcIntervalMs?: number | Duration;
+    });
+    /** Set a value in the store. */
+    set<T>(key: string, value: T, expiryDeltaMs?: number | Duration): T;
+    /** Delete one or multiple keys. */
+    delete(key: string | string[]): void;
+    /** Mainly used to get the expiration timestamp of an object. */
+    getStoredObject<T>(key: string): StoredObject<T> | undefined;
+    /** Get a value by key, or undefined if it does not exist. */
+    get<T>(key: string): T | undefined;
+    /** Generic way to iterate through all entries. */
+    forEach<T>(callback: (key: string, value: T, expiryMs: number, storedMs: number) => void): void;
+    /**
+     * 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(): number;
+    /** Remove all items from the store. */
+    clear(): void;
+    /**
+     * 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<T>(): Map<string, StoredObject<T>>;
+    /** Returns the ms timestamp for the last GC (garbage collection). */
+    get lastGcMs(): number;
+    /** Set the ms timestamp for the last GC (garbage collection). */
+    set lastGcMs(ms: number);
+    /** Perform garbage-collection if due, else do nothing. */
+    gc(): void;
+    /**
+     * Perform garbage collection immediately without checking whether we are
+     * due for the next GC or not.
+     */
+    gcNow(): void;
+    /** Returns `this` casted into a StorageAdapter<T>. */
+    asStorageAdapter<T>(): StorageAdapter<T>;
+}
+/**
+ * Default local store ready for immediate use. You can create new instances if
+ * you want, but most likely you will only need one store instance.
+ */
+declare const localStore: LocalStore;
+/**
+ * Class to represent one key in the store with a default expiration.
+ */
+declare class LocalStoreItem<T> {
+    readonly key: string;
+    readonly store: LocalStore;
+    readonly defaultExpiryMs: number;
+    constructor(key: string, defaultExpiryMs?: number | Duration, store?: LocalStore);
+    /** Set a value in the store. */
+    set(value: T, expiryDeltaMs?: number | undefined): void;
+    /**
+     * Example usage:
+     *
+     *   const { value, storedMs, expiryMs, storedMs } =
+     *     await myLocalItem.getStoredObject();
+     */
+    getStoredObject(): StoredObject<T> | undefined;
+    /** Get a value by key, or undefined if it does not exist. */
+    get(): T | undefined;
+    /** Delete this key from the store. */
+    delete(): void;
+}
+/** Create a local store item with a key and a default expiration. */
+declare function localStoreItem<T>(key: string, expiryMs?: number | Duration, store?: LocalStore): LocalStoreItem<T>;
+
+export { LocalStore, LocalStoreConfig, LocalStoreItem, configureLocalStore, localStore, localStoreItem };

package/localStore.d.ts

@@ -0,0 +1,119 @@
+import { Duration } from './duration.js';
+import { FullStorageAdapter, StoredObject, StorageAdapter } from './storageAdapter.js';
+
+/**
+ * Local storage key-value store with support for auto-expirations.
+ *
+ * Why use this?
+ * 1. Extremely simple interface to use local storage.
+ * 2. Auto-expirations with GC frees you from worrying about data clean-up.
+ * 3. Any serializable data type can be stored (except undefined).
+ *
+ * How to use?
+ * Just use the `localStore` global constant like the local storage.
+ *
+ * Why not use the localStorage directly?
+ * localStorage does not provide auto-expirations with GC. If you don't need
+ * this (items never expire), then just use localStorage directly.
+ */
+
+/** Global defaults can be updated directly. */
+declare const LocalStoreConfig: {
+    /** All items with the same store name will share the same storage space. */
+    storeName: string;
+    /** 30 days in ms. */
+    expiryMs: number;
+    /** Do GC once per day. */
+    gcIntervalMs: number;
+};
+type LocalStoreConfig = typeof LocalStoreConfig;
+/** Convenience function to update global defaults. */
+declare function configureLocalStore(config: Partial<LocalStoreConfig>): void;
+/**
+ * You can create multiple LocalStores if you want, but most likely you will only
+ * need to use the default `localStore` instance.
+ */
+declare class LocalStore implements FullStorageAdapter<any> {
+    readonly storeName: string;
+    /**
+     * The prefix string for the local storage key which identifies items
+     * belonging to this namespace.
+     */
+    readonly keyPrefix: string;
+    /** Local storage key name for the last GC completed timestamp. */
+    readonly gcMsStorageKey: string;
+    readonly defaultExpiryMs: number;
+    readonly gcIntervalMs: number;
+    constructor(storeName: string, options?: {
+        defaultExpiryMs?: number | Duration;
+        gcIntervalMs?: number | Duration;
+    });
+    /** Set a value in the store. */
+    set<T>(key: string, value: T, expiryDeltaMs?: number | Duration): T;
+    /** Delete one or multiple keys. */
+    delete(key: string | string[]): void;
+    /** Mainly used to get the expiration timestamp of an object. */
+    getStoredObject<T>(key: string): StoredObject<T> | undefined;
+    /** Get a value by key, or undefined if it does not exist. */
+    get<T>(key: string): T | undefined;
+    /** Generic way to iterate through all entries. */
+    forEach<T>(callback: (key: string, value: T, expiryMs: number, storedMs: number) => void): void;
+    /**
+     * 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(): number;
+    /** Remove all items from the store. */
+    clear(): void;
+    /**
+     * 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<T>(): Map<string, StoredObject<T>>;
+    /** Returns the ms timestamp for the last GC (garbage collection). */
+    get lastGcMs(): number;
+    /** Set the ms timestamp for the last GC (garbage collection). */
+    set lastGcMs(ms: number);
+    /** Perform garbage-collection if due, else do nothing. */
+    gc(): void;
+    /**
+     * Perform garbage collection immediately without checking whether we are
+     * due for the next GC or not.
+     */
+    gcNow(): void;
+    /** Returns `this` casted into a StorageAdapter<T>. */
+    asStorageAdapter<T>(): StorageAdapter<T>;
+}
+/**
+ * Default local store ready for immediate use. You can create new instances if
+ * you want, but most likely you will only need one store instance.
+ */
+declare const localStore: LocalStore;
+/**
+ * Class to represent one key in the store with a default expiration.
+ */
+declare class LocalStoreItem<T> {
+    readonly key: string;
+    readonly store: LocalStore;
+    readonly defaultExpiryMs: number;
+    constructor(key: string, defaultExpiryMs?: number | Duration, store?: LocalStore);
+    /** Set a value in the store. */
+    set(value: T, expiryDeltaMs?: number | undefined): void;
+    /**
+     * Example usage:
+     *
+     *   const { value, storedMs, expiryMs, storedMs } =
+     *     await myLocalItem.getStoredObject();
+     */
+    getStoredObject(): StoredObject<T> | undefined;
+    /** Get a value by key, or undefined if it does not exist. */
+    get(): T | undefined;
+    /** Delete this key from the store. */
+    delete(): void;
+}
+/** Create a local store item with a key and a default expiration. */
+declare function localStoreItem<T>(key: string, expiryMs?: number | Duration, store?: LocalStore): LocalStoreItem<T>;
+
+export { LocalStore, LocalStoreConfig, LocalStoreItem, configureLocalStore, localStore, localStoreItem };

package/localStore.min.cjs

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

package/localStore.min.cjs.map

@@ -0,0 +1 @@
+{"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// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport class LocalStore implements FullStorageAdapter<any> {\n  /**\n   * The prefix string for the local storage key which identifies items\n   * belonging to this namespace.\n   */\n  public readonly keyPrefix: string;\n\n  /** Local storage key name for the last GC completed timestamp. */\n  public readonly gcMsStorageKey: string;\n\n  public readonly defaultExpiryMs: number;\n  public readonly gcIntervalMs: number;\n\n  public constructor(\n    public readonly storeName: string,\n    options?: {\n      defaultExpiryMs?: number | Duration;\n      gcIntervalMs?: number | Duration;\n    },\n  ) {\n    this.keyPrefix = storeName + \":\";\n\n    this.defaultExpiryMs = options?.defaultExpiryMs\n      ? durationOrMsToMs(options.defaultExpiryMs)\n      : LocalStoreConfig.expiryMs;\n\n    this.gcIntervalMs = options?.gcIntervalMs\n      ? durationOrMsToMs(options.gcIntervalMs)\n      : LocalStoreConfig.gcIntervalMs;\n\n    this.gcMsStorageKey = `__localStore:lastGcMs:${storeName}`;\n  }\n\n  /** Set a value in the store. */\n  public set<T>(\n    key: string,\n    value: T,\n    expiryDeltaMs: number | Duration = this.defaultExpiryMs,\n  ): T {\n    const nowMs = Date.now();\n    const obj: StoredObject<T> = {\n      value,\n      storedMs: nowMs,\n      expiryMs: nowMs + durationOrMsToMs(expiryDeltaMs),\n    };\n\n    localStorage.setItem(this.keyPrefix + key, JSON.stringify(obj));\n\n    this.gc(); // check GC on every write\n\n    return value;\n  }\n\n  /** Delete one or multiple keys. */\n  public delete(key: string | string[]): void {\n    if (typeof key === \"string\") {\n      localStorage.removeItem(this.keyPrefix + key);\n    } else {\n      for (const k of key) {\n        localStorage.removeItem(this.keyPrefix + k);\n      }\n    }\n  }\n\n  /** Mainly used to get the expiration timestamp of an object. */\n  public getStoredObject<T>(key: string): StoredObject<T> | undefined {\n    const k = this.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 obj = validateStoredObject(parsed);\n      if (!obj) {\n        this.delete(k);\n\n        this.gc(); // check GC on every read of an expired key\n\n        return undefined;\n      }\n\n      return obj as StoredObject<T>;\n    } catch (e) {\n      console.error(`Invalid local value: ${k}=${stored}:`, e);\n      this.delete(k);\n\n      this.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  public get<T>(key: string): T | undefined {\n    const obj = this.getStoredObject<T>(key);\n\n    return obj?.value;\n  }\n\n  /** Generic way to iterate through all entries. */\n  public 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(this.keyPrefix)) continue;\n\n      const key = k.slice(this.keyPrefix.length);\n      const obj = this.getStoredObject(key);\n\n      if (!obj) continue;\n\n      callback(key, obj.value as T, obj.expiryMs, obj.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  public size(): number {\n    let count = 0;\n    this.forEach(() => {\n      count++;\n    });\n    return count;\n  }\n\n  /** Remove all items from the store. */\n  public clear(): void {\n    // Note that we don't need to use this.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(this.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  public asMap<T>(): Map<string, StoredObject<T>> {\n    const map = new Map<string, StoredObject<T>>();\n    this.forEach((key, value, expiryMs, storedMs) => {\n      map.set(key, { value: value as T, expiryMs, storedMs });\n    });\n    return map;\n  }\n\n  /** Returns the ms timestamp for the last GC (garbage collection). */\n  public get lastGcMs(): number {\n    const lastGcMsStr = globalThis.localStorage.getItem(this.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  public set lastGcMs(ms: number) {\n    globalThis.localStorage.setItem(this.gcMsStorageKey, String(ms));\n  }\n\n  /** Perform garbage-collection if due, else do nothing. */\n  public gc(): void {\n    const lastGcMs = this.lastGcMs;\n\n    // Set initial timestamp - no need GC now.\n    if (!lastGcMs) {\n      this.lastGcMs = Date.now();\n      return;\n    }\n\n    if (Date.now() < lastGcMs + this.gcIntervalMs) {\n      return; // not due for next GC yet\n    }\n\n    // GC is due now, so run it.\n    this.gcNow();\n  }\n\n  /**\n   * Perform garbage collection immediately without checking whether we are\n   * due for the next GC or not.\n   */\n  public gcNow(): void {\n    console.log(`Starting localStore GC on ${this.storeName}`);\n\n    // Prevent concurrent GC runs.\n    this.lastGcMs = Date.now();\n    let count = 0;\n\n    this.forEach((key: string, value: unknown, expiryMs: number) => {\n      if (Date.now() >= expiryMs) {\n        this.delete(key);\n        count++;\n      }\n    });\n\n    console.log(\n      `Finished localStore GC on ${this.storeName} - deleted ${count} keys`,\n    );\n\n    // Mark the end time as last GC time.\n    this.lastGcMs = Date.now();\n  }\n\n  /** Returns `this` casted into a StorageAdapter<T>. */\n  public asStorageAdapter<T>(): StorageAdapter<T> {\n    return this as StorageAdapter<T>;\n  }\n}\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 = new LocalStore(LocalStoreConfig.storeName);\n\n/**\n * Class to represent one key in the store with a default expiration.\n */\nexport class LocalStoreItem<T> {\n  public readonly defaultExpiryMs: number;\n\n  public constructor(\n    public readonly key: string,\n    defaultExpiryMs: number | Duration = LocalStoreConfig.expiryMs,\n    public readonly store = localStore,\n  ) {\n    this.defaultExpiryMs = defaultExpiryMs && durationOrMsToMs(defaultExpiryMs);\n  }\n\n  /** Set a value in the store. */\n  public set(\n    value: T,\n    expiryDeltaMs: number | undefined = this.defaultExpiryMs,\n  ): void {\n    this.store.set(this.key, value, expiryDeltaMs);\n  }\n\n  /**\n   * Example usage:\n   *\n   *   const { value, storedMs, expiryMs, storedMs } =\n   *     await myLocalItem.getStoredObject();\n   */\n  public getStoredObject(): StoredObject<T> | undefined {\n    return this.store.getStoredObject(this.key);\n  }\n\n  /** Get a value by key, or undefined if it does not exist. */\n  public get(): T | undefined {\n    return this.store.get(this.key);\n  }\n\n  /** Delete this key from the store. */\n  public delete(): void {\n    this.store.delete(this.key);\n  }\n}\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,\n): LocalStoreItem<T> {\n  expiryMs = expiryMs && durationOrMsToMs(expiryMs);\n\n  return new LocalStoreItem<T>(key, expiryMs, store);\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":"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","names":["localStore_exports","__export","LocalStore","LocalStoreConfig","LocalStoreItem","configureLocalStore","localStore","localStoreItem","__toCommonJS","durationToMs","duration","daysMs","hoursMs","minsMs","secsMs","msMs","durationOrMsToMs","LocalStoreConfig","configureLocalStore","config","validateStoredObject","obj","LocalStore","storeName","options","durationOrMsToMs","key","value","expiryDeltaMs","nowMs","k","stored","parsed","e","callback","count","map","expiryMs","storedMs","lastGcMsStr","ms","lastGcMs","localStore","LocalStoreItem","defaultExpiryMs","store","localStoreItem"]}

package/localStore.min.mjs

@@ -0,0 +1,2 @@
+function S(r){let t=(r.days??0)*864e5,e=(r.hours??0)*36e5,s=(r.minutes??0)*6e4,o=(r.seconds??0)*1e3,n=r.milliseconds??0;return t+e+s+o+n}function i(r){return typeof r=="number"?r:S(r)}var a={storeName:"ts-utils",expiryMs:864e5*30,gcIntervalMs:864e5};function O(r){Object.assign(a,r)}function h(r){if(!(!r||typeof r!="object"||r.value===void 0||typeof r.storedMs!="number"||typeof r.expiryMs!="number"||Date.now()>=r.expiryMs))return r}var c=class{constructor(t,e){this.storeName=t;this.keyPrefix=t+":",this.defaultExpiryMs=e?.defaultExpiryMs?i(e.defaultExpiryMs):a.expiryMs,this.gcIntervalMs=e?.gcIntervalMs?i(e.gcIntervalMs):a.gcIntervalMs,this.gcMsStorageKey=`__localStore:lastGcMs:${t}`}keyPrefix;gcMsStorageKey;defaultExpiryMs;gcIntervalMs;set(t,e,s=this.defaultExpiryMs){let o=Date.now(),n={value:e,storedMs:o,expiryMs:o+i(s)};return localStorage.setItem(this.keyPrefix+t,JSON.stringify(n)),this.gc(),e}delete(t){if(typeof t=="string")localStorage.removeItem(this.keyPrefix+t);else for(let e of t)localStorage.removeItem(this.keyPrefix+e)}getStoredObject(t){let e=this.keyPrefix+t,s=localStorage.getItem(e);if(s)try{let o=JSON.parse(s),n=h(o);if(!n){this.delete(e),this.gc();return}return n}catch(o){console.error(`Invalid local value: ${e}=${s}:`,o),this.delete(e),this.gc();return}}get(t){return this.getStoredObject(t)?.value}forEach(t){for(let e of Object.keys(localStorage)){if(!e.startsWith(this.keyPrefix))continue;let s=e.slice(this.keyPrefix.length),o=this.getStoredObject(s);o&&t(s,o.value,o.expiryMs,o.storedMs)}}size(){let t=0;return this.forEach(()=>{t++}),t}clear(){for(let t of Object.keys(localStorage))t.startsWith(this.keyPrefix)&&localStorage.removeItem(t)}asMap(){let t=new Map;return this.forEach((e,s,o,n)=>{t.set(e,{value:s,expiryMs:o,storedMs:n})}),t}get lastGcMs(){let t=globalThis.localStorage.getItem(this.gcMsStorageKey);if(!t)return 0;let e=Number(t);return isNaN(e)?0:e}set lastGcMs(t){globalThis.localStorage.setItem(this.gcMsStorageKey,String(t))}gc(){let t=this.lastGcMs;if(!t){this.lastGcMs=Date.now();return}Date.now()<t+this.gcIntervalMs||this.gcNow()}gcNow(){console.log(`Starting localStore GC on ${this.storeName}`),this.lastGcMs=Date.now();let t=0;this.forEach((e,s,o)=>{Date.now()>=o&&(this.delete(e),t++)}),console.log(`Finished localStore GC on ${this.storeName} - deleted ${t} keys`),this.lastGcMs=Date.now()}asStorageAdapter(){return this}},d=new c(a.storeName),l=class{constructor(t,e=a.expiryMs,s=d){this.key=t;this.store=s;this.defaultExpiryMs=e&&i(e)}defaultExpiryMs;set(t,e=this.defaultExpiryMs){this.store.set(this.key,t,e)}getStoredObject(){return this.store.getStoredObject(this.key)}get(){return this.store.get(this.key)}delete(){this.store.delete(this.key)}};function P(r,t,e=d){return t=t&&i(t),new l(r,t,e)}export{c as LocalStore,a as LocalStoreConfig,l as LocalStoreItem,O as configureLocalStore,d as localStore,P as localStoreItem};
+//# sourceMappingURL=localStore.min.mjs.map

package/localStore.min.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/duration.ts","../src/localStore.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","/**\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// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport class LocalStore implements FullStorageAdapter<any> {\n  /**\n   * The prefix string for the local storage key which identifies items\n   * belonging to this namespace.\n   */\n  public readonly keyPrefix: string;\n\n  /** Local storage key name for the last GC completed timestamp. */\n  public readonly gcMsStorageKey: string;\n\n  public readonly defaultExpiryMs: number;\n  public readonly gcIntervalMs: number;\n\n  public constructor(\n    public readonly storeName: string,\n    options?: {\n      defaultExpiryMs?: number | Duration;\n      gcIntervalMs?: number | Duration;\n    },\n  ) {\n    this.keyPrefix = storeName + \":\";\n\n    this.defaultExpiryMs = options?.defaultExpiryMs\n      ? durationOrMsToMs(options.defaultExpiryMs)\n      : LocalStoreConfig.expiryMs;\n\n    this.gcIntervalMs = options?.gcIntervalMs\n      ? durationOrMsToMs(options.gcIntervalMs)\n      : LocalStoreConfig.gcIntervalMs;\n\n    this.gcMsStorageKey = `__localStore:lastGcMs:${storeName}`;\n  }\n\n  /** Set a value in the store. */\n  public set<T>(\n    key: string,\n    value: T,\n    expiryDeltaMs: number | Duration = this.defaultExpiryMs,\n  ): T {\n    const nowMs = Date.now();\n    const obj: StoredObject<T> = {\n      value,\n      storedMs: nowMs,\n      expiryMs: nowMs + durationOrMsToMs(expiryDeltaMs),\n    };\n\n    localStorage.setItem(this.keyPrefix + key, JSON.stringify(obj));\n\n    this.gc(); // check GC on every write\n\n    return value;\n  }\n\n  /** Delete one or multiple keys. */\n  public delete(key: string | string[]): void {\n    if (typeof key === \"string\") {\n      localStorage.removeItem(this.keyPrefix + key);\n    } else {\n      for (const k of key) {\n        localStorage.removeItem(this.keyPrefix + k);\n      }\n    }\n  }\n\n  /** Mainly used to get the expiration timestamp of an object. */\n  public getStoredObject<T>(key: string): StoredObject<T> | undefined {\n    const k = this.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 obj = validateStoredObject(parsed);\n      if (!obj) {\n        this.delete(k);\n\n        this.gc(); // check GC on every read of an expired key\n\n        return undefined;\n      }\n\n      return obj as StoredObject<T>;\n    } catch (e) {\n      console.error(`Invalid local value: ${k}=${stored}:`, e);\n      this.delete(k);\n\n      this.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  public get<T>(key: string): T | undefined {\n    const obj = this.getStoredObject<T>(key);\n\n    return obj?.value;\n  }\n\n  /** Generic way to iterate through all entries. */\n  public 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(this.keyPrefix)) continue;\n\n      const key = k.slice(this.keyPrefix.length);\n      const obj = this.getStoredObject(key);\n\n      if (!obj) continue;\n\n      callback(key, obj.value as T, obj.expiryMs, obj.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  public size(): number {\n    let count = 0;\n    this.forEach(() => {\n      count++;\n    });\n    return count;\n  }\n\n  /** Remove all items from the store. */\n  public clear(): void {\n    // Note that we don't need to use this.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(this.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  public asMap<T>(): Map<string, StoredObject<T>> {\n    const map = new Map<string, StoredObject<T>>();\n    this.forEach((key, value, expiryMs, storedMs) => {\n      map.set(key, { value: value as T, expiryMs, storedMs });\n    });\n    return map;\n  }\n\n  /** Returns the ms timestamp for the last GC (garbage collection). */\n  public get lastGcMs(): number {\n    const lastGcMsStr = globalThis.localStorage.getItem(this.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  public set lastGcMs(ms: number) {\n    globalThis.localStorage.setItem(this.gcMsStorageKey, String(ms));\n  }\n\n  /** Perform garbage-collection if due, else do nothing. */\n  public gc(): void {\n    const lastGcMs = this.lastGcMs;\n\n    // Set initial timestamp - no need GC now.\n    if (!lastGcMs) {\n      this.lastGcMs = Date.now();\n      return;\n    }\n\n    if (Date.now() < lastGcMs + this.gcIntervalMs) {\n      return; // not due for next GC yet\n    }\n\n    // GC is due now, so run it.\n    this.gcNow();\n  }\n\n  /**\n   * Perform garbage collection immediately without checking whether we are\n   * due for the next GC or not.\n   */\n  public gcNow(): void {\n    console.log(`Starting localStore GC on ${this.storeName}`);\n\n    // Prevent concurrent GC runs.\n    this.lastGcMs = Date.now();\n    let count = 0;\n\n    this.forEach((key: string, value: unknown, expiryMs: number) => {\n      if (Date.now() >= expiryMs) {\n        this.delete(key);\n        count++;\n      }\n    });\n\n    console.log(\n      `Finished localStore GC on ${this.storeName} - deleted ${count} keys`,\n    );\n\n    // Mark the end time as last GC time.\n    this.lastGcMs = Date.now();\n  }\n\n  /** Returns `this` casted into a StorageAdapter<T>. */\n  public asStorageAdapter<T>(): StorageAdapter<T> {\n    return this as StorageAdapter<T>;\n  }\n}\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 = new LocalStore(LocalStoreConfig.storeName);\n\n/**\n * Class to represent one key in the store with a default expiration.\n */\nexport class LocalStoreItem<T> {\n  public readonly defaultExpiryMs: number;\n\n  public constructor(\n    public readonly key: string,\n    defaultExpiryMs: number | Duration = LocalStoreConfig.expiryMs,\n    public readonly store = localStore,\n  ) {\n    this.defaultExpiryMs = defaultExpiryMs && durationOrMsToMs(defaultExpiryMs);\n  }\n\n  /** Set a value in the store. */\n  public set(\n    value: T,\n    expiryDeltaMs: number | undefined = this.defaultExpiryMs,\n  ): void {\n    this.store.set(this.key, value, expiryDeltaMs);\n  }\n\n  /**\n   * Example usage:\n   *\n   *   const { value, storedMs, expiryMs, storedMs } =\n   *     await myLocalItem.getStoredObject();\n   */\n  public getStoredObject(): StoredObject<T> | undefined {\n    return this.store.getStoredObject(this.key);\n  }\n\n  /** Get a value by key, or undefined if it does not exist. */\n  public get(): T | undefined {\n    return this.store.get(this.key);\n  }\n\n  /** Delete this key from the store. */\n  public delete(): void {\n    this.store.delete(this.key);\n  }\n}\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,\n): LocalStoreItem<T> {\n  expiryMs = expiryMs && durationOrMsToMs(expiryMs);\n\n  return new LocalStoreItem<T>(key, expiryMs, store);\n}\n"],"mappings":"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","names":["durationToMs","duration","daysMs","hoursMs","minsMs","secsMs","msMs","durationOrMsToMs","LocalStoreConfig","configureLocalStore","config","validateStoredObject","obj","LocalStore","storeName","options","durationOrMsToMs","key","value","expiryDeltaMs","nowMs","k","stored","parsed","e","callback","count","map","expiryMs","storedMs","lastGcMsStr","ms","lastGcMs","localStore","LocalStoreItem","defaultExpiryMs","store","localStoreItem"]}