@choksheak/ts-utils 0.3.4 → 0.3.6

package/chunk-3EBQ2GO2.min.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkQNNJNLGKmincjs = require('./chunk-QNNJNLGK.min.cjs');async function c(r){let e=new TextEncoder().encode(r);return await crypto.subtle.digest("SHA-256",e)}var t=_chunkQNNJNLGKmincjs.a.call(void 0, ()=>{});exports.a = c; exports.b = t;
+//# sourceMappingURL=chunk-3EBQ2GO2.min.cjs.map

package/chunk-3EBQ2GO2.min.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/choksheaklau/src/ts-utils/dist/chunk-3EBQ2GO2.min.cjs","../src/sha256.ts"],"names":["sha256","input","uint8Array","init_sha256","__esmMin"],"mappings":"AAAA,wIAA4C,MCG5C,SAAsBA,CAAAA,CAAOC,CAAAA,CAAqC,CAGhE,IAAMC,CAAAA,CADU,IAAI,WAAA,CAAY,CAAA,CACL,MAAA,CAAOD,CAAK,CAAA,CAKvC,OAFoB,MAAM,MAAA,CAAO,MAAA,CAAO,MAAA,CAAO,SAAA,CAAWC,CAAU,CAGtE,CAZA,IAAAC,CAAAA,CAAAC,oCAAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,6BAAA","file":"/Users/choksheaklau/src/ts-utils/dist/chunk-3EBQ2GO2.min.cjs","sourcesContent":[null,"/**\n * SHA-256 hash an input string into an ArrayBuffer.\n */\nexport async function sha256(input: string): Promise<ArrayBuffer> {\n  // Encode the input string as a Uint8Array\n  const encoder = new TextEncoder();\n  const uint8Array = encoder.encode(input);\n\n  // Compute the SHA-256 hash using the SubtleCrypto API\n  const arrayBuffer = await crypto.subtle.digest(\"SHA-256\", uint8Array);\n\n  return arrayBuffer;\n}\n"]}

package/chunk-4GLOLTJ5.cjs

@@ -0,0 +1,167 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+
+
+
+
+
+
+
+var _chunkY7MC73BZcjs = require('./chunk-Y7MC73BZ.cjs');
+
+
+var _chunkILGTU46Tcjs = require('./chunk-ILGTU46T.cjs');
+
+// src/duration.ts
+function getDurationStyleForPlural(style) {
+  return style == "short" ? "shorts" : style === "long" ? "longs" : style;
+}
+function getValueAndUnitSeparator(style) {
+  return style === "narrow" ? "" : " ";
+}
+function getDurationTypeSeparator(style) {
+  return style === "narrow" ? " " : ", ";
+}
+function msToDuration(ms, durationTypeForZero) {
+  if (ms === 0) {
+    durationTypeForZero = _nullishCoalesce(durationTypeForZero, () => ( "milliseconds"));
+    return { [durationTypeForZero]: 0 };
+  }
+  const duration = {};
+  for (let i = 0; i < 1; i++) {
+    let seconds = Math.floor(ms / _chunkY7MC73BZcjs.MS_PER_SECOND);
+    const millis = ms - seconds * _chunkY7MC73BZcjs.MS_PER_SECOND;
+    if (millis > 0) {
+      duration["milliseconds"] = millis;
+    }
+    if (seconds === 0) {
+      break;
+    }
+    let minutes = Math.floor(seconds / _chunkY7MC73BZcjs.SECONDS_PER_MINUTE);
+    seconds -= minutes * _chunkY7MC73BZcjs.SECONDS_PER_MINUTE;
+    if (seconds > 0) {
+      duration["seconds"] = seconds;
+    }
+    if (minutes === 0) {
+      break;
+    }
+    let hours = Math.floor(minutes / _chunkY7MC73BZcjs.MINUTES_PER_HOUR);
+    minutes -= hours * _chunkY7MC73BZcjs.MINUTES_PER_HOUR;
+    if (minutes > 0) {
+      duration["minutes"] = minutes;
+    }
+    if (hours === 0) {
+      break;
+    }
+    const days = Math.floor(hours / _chunkY7MC73BZcjs.HOURS_PER_DAY);
+    hours -= days * _chunkY7MC73BZcjs.HOURS_PER_DAY;
+    if (hours > 0) {
+      duration["hours"] = hours;
+    }
+    if (days > 0) {
+      duration["days"] = days;
+    }
+  }
+  return duration;
+}
+function durationToMs(duration) {
+  const daysMs = (_nullishCoalesce(duration.days, () => ( 0))) * _chunkY7MC73BZcjs.MS_PER_DAY;
+  const hoursMs = (_nullishCoalesce(duration.hours, () => ( 0))) * _chunkY7MC73BZcjs.MS_PER_HOUR;
+  const minsMs = (_nullishCoalesce(duration.minutes, () => ( 0))) * _chunkY7MC73BZcjs.MS_PER_MINUTE;
+  const secsMs = (_nullishCoalesce(duration.seconds, () => ( 0))) * _chunkY7MC73BZcjs.MS_PER_SECOND;
+  const msMs = _nullishCoalesce(duration.milliseconds, () => ( 0));
+  return daysMs + hoursMs + minsMs + secsMs + msMs;
+}
+function durationOrMsToMs(duration) {
+  return typeof duration === "number" ? duration : durationToMs(duration);
+}
+function formatDuration(duration, style) {
+  style = _nullishCoalesce(style, () => ( "short"));
+  const stylePlural = getDurationStyleForPlural(style);
+  const space = getValueAndUnitSeparator(style);
+  const a = [];
+  for (const unit of DURATION_TYPE_SEQUENCE) {
+    const value = duration[unit];
+    if (value === void 0) continue;
+    const suffixMap = DURATION_STYLE_SUFFIX_MAP[unit];
+    const suffix = value === 1 ? suffixMap[style] : suffixMap[stylePlural];
+    a.push(value + space + suffix);
+  }
+  const separator = getDurationTypeSeparator(style);
+  return a.join(separator);
+}
+function readableDuration(ms, options) {
+  const duration = msToDuration(ms, _optionalChain([options, 'optionalAccess', _ => _.durationTypeForZero]));
+  return formatDuration(duration, _optionalChain([options, 'optionalAccess', _2 => _2.style]));
+}
+function elapsed(ms) {
+  if (ms > _chunkY7MC73BZcjs.MS_PER_MINUTE) {
+    return readableDuration(ms);
+  }
+  if (ms > 100) {
+    return `${(ms / 1e3).toFixed(3)}s`;
+  }
+  return ms + "ms";
+}
+var DURATION_TYPE_SEQUENCE, DURATION_STYLE_SUFFIX_MAP;
+var init_duration = _chunkILGTU46Tcjs.__esm.call(void 0, {
+  "src/duration.ts"() {
+    _chunkY7MC73BZcjs.init_timeConstants.call(void 0, );
+    DURATION_TYPE_SEQUENCE = exports.DURATION_TYPE_SEQUENCE = [
+      "days",
+      "hours",
+      "minutes",
+      "seconds",
+      "milliseconds"
+    ];
+    DURATION_STYLE_SUFFIX_MAP = exports.DURATION_STYLE_SUFFIX_MAP = {
+      days: {
+        short: "day",
+        shorts: "days",
+        long: "day",
+        longs: "days",
+        narrow: "d"
+      },
+      hours: {
+        short: "hr",
+        shorts: "hrs",
+        long: "hour",
+        longs: "hours",
+        narrow: "h"
+      },
+      minutes: {
+        short: "min",
+        shorts: "mins",
+        long: "minute",
+        longs: "minutes",
+        narrow: "m"
+      },
+      seconds: {
+        short: "sec",
+        shorts: "secs",
+        long: "second",
+        longs: "seconds",
+        narrow: "s"
+      },
+      milliseconds: {
+        short: "ms",
+        shorts: "ms",
+        long: "millisecond",
+        longs: "milliseconds",
+        narrow: "ms"
+      }
+    };
+  }
+});
+
+
+
+
+
+
+
+
+
+
+
+exports.DURATION_TYPE_SEQUENCE = DURATION_TYPE_SEQUENCE; exports.DURATION_STYLE_SUFFIX_MAP = DURATION_STYLE_SUFFIX_MAP; exports.msToDuration = msToDuration; exports.durationToMs = durationToMs; exports.durationOrMsToMs = durationOrMsToMs; exports.formatDuration = formatDuration; exports.readableDuration = readableDuration; exports.elapsed = elapsed; exports.init_duration = init_duration;

package/chunk-6TQBMXTL.min.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkQNNJNLGKmincjs = require('./chunk-QNNJNLGK.min.cjs');function t(e){if(!e)return!0;if(typeof e!="object")return!1;if("length"in e)return e.length===0;if("size"in e)return e.size===0;for(let i in e)return!1;return!0}var r=_chunkQNNJNLGKmincjs.a.call(void 0, ()=>{});exports.a = t; exports.b = r;
+//# sourceMappingURL=chunk-6TQBMXTL.min.cjs.map

package/chunk-6TQBMXTL.min.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/choksheaklau/src/ts-utils/dist/chunk-6TQBMXTL.min.cjs","../src/isEmpty.ts"],"names":["isEmpty","t","k","init_isEmpty","__esmMin"],"mappings":"AAAA,wIAA4C,SCG5BA,CAAAA,CAAQC,CAAAA,CAAqB,CAE3C,EAAA,CAAI,CAACA,CAAAA,CACH,MAAO,CAAA,CAAA,CAIT,EAAA,CAAI,OAAOA,CAAAA,EAAM,QAAA,CACf,MAAO,CAAA,CAAA,CAIT,EAAA,CAAI,QAAA,GAAYA,CAAAA,CACd,OAAOA,CAAAA,CAAE,MAAA,GAAW,CAAA,CAItB,EAAA,CAAI,MAAA,GAAUA,CAAAA,CACZ,OAAOA,CAAAA,CAAE,IAAA,GAAS,CAAA,CAKpB,GAAA,CAAA,IAAWC,EAAAA,GAAKD,CAAAA,CACd,MAAO,CAAA,CAAA,CAGT,MAAO,CAAA,CACT,CA/BA,IAAAE,CAAAA,CAAAC,oCAAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,6BAAA","file":"/Users/choksheaklau/src/ts-utils/dist/chunk-6TQBMXTL.min.cjs","sourcesContent":[null,"/**\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"]}

package/chunk-AWZBCFMG.min.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});function e(n,r=0){return typeof n=="number"?isFinite(n)?n:r:(n=Number(n),typeof n=="number"&&isFinite(n)?n:r)}exports.a = e;
+//# sourceMappingURL=chunk-AWZBCFMG.min.cjs.map

package/chunk-AWZBCFMG.min.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/asNumber.ts"],"names":["asNumber","u","defaultValue"],"mappings":"AAGO,kFAASA,CAAAA,CAASC,CAAAA,CAAYC,CAAAA,CAAe,CAAA,CAAW,CAE7D,OAAI,OAAOD,CAAAA,EAAM,QAAA,CACR,QAAA,CAASA,CAAC,CAAA,CAAIA,CAAAA,CAAIC,CAAAA,CAAAA,CAI3BD,CAAAA,CAAI,MAAA,CAAOA,CAAC,CAAA,CAGR,OAAOA,CAAAA,EAAM,QAAA,EAAY,QAAA,CAASA,CAAC,CAAA,CAC9BA,CAAAA,CAKFC,CAAAA,CACT,CAAA,cAAA","file":"/Users/choksheaklau/src/ts-utils/dist/chunk-AWZBCFMG.min.cjs","sourcesContent":["/**\n * Coerce `u` into a number if possible, otherwise just return 0.\n */\nexport function asNumber(u: unknown, defaultValue = 0): number {\n  // If u is a valid number, return it.\n  if (typeof u === \"number\") {\n    return isFinite(u) ? u : defaultValue;\n  }\n\n  // Try to make into a number if not already a number.\n  u = Number(u);\n\n  // If u is a valid number, return it.\n  if (typeof u === \"number\" && isFinite(u)) {\n    return u;\n  }\n\n  // Return `defaultValue` for everything else. This is usually ok if want to\n  // just ignore all other noise.\n  return defaultValue;\n}\n"]}

package/chunk-AXNETZET.cjs

@@ -0,0 +1,20 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkILGTU46Tcjs = require('./chunk-ILGTU46T.cjs');
+
+// src/sha256.ts
+async function sha256(input) {
+  const encoder = new TextEncoder();
+  const uint8Array = encoder.encode(input);
+  const arrayBuffer = await crypto.subtle.digest("SHA-256", uint8Array);
+  return arrayBuffer;
+}
+var init_sha256 = _chunkILGTU46Tcjs.__esm.call(void 0, {
+  "src/sha256.ts"() {
+  }
+});
+
+
+
+
+exports.sha256 = sha256; exports.init_sha256 = init_sha256;

package/chunk-BKZM6NWX.min.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});function u(r,t=0){let n=Math.pow(10,t);return Math.round(r*n)/n}exports.a = u;
+//# sourceMappingURL=chunk-BKZM6NWX.min.cjs.map

package/chunk-BKZM6NWX.min.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/round.ts"],"names":["round","n","numDecimalPlaces","multipler"],"mappings":"AAMO,kFAASA,CAAAA,CAAMC,CAAAA,CAAWC,CAAAA,CAAmB,CAAA,CAAW,CAC7D,IAAMC,CAAAA,CAAY,IAAA,CAAK,GAAA,CAAI,EAAA,CAAID,CAAgB,CAAA,CAC/C,OAAO,IAAA,CAAK,KAAA,CAAMD,CAAAA,CAAIE,CAAS,CAAA,CAAIA,CACrC,CAAA,cAAA","file":"/Users/choksheaklau/src/ts-utils/dist/chunk-BKZM6NWX.min.cjs","sourcesContent":["/**\n * Simplifies rounding of floating point numbers. Note that if your number ends\n * with zeros, and you convert the number to string, you will lose the zeroes\n * at the end. To show the exact number of decimal places, you'll need to use\n * roundToString() or toFixed(). E.g. round(1.20, 2).toFixed(2).\n */\nexport function round(n: number, numDecimalPlaces = 0): number {\n  const multipler = Math.pow(10, numDecimalPlaces);\n  return Math.round(n * multipler) / multipler;\n}\n"]}

package/chunk-BZKQXX3A.cjs

@@ -0,0 +1,40 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunk4GLOLTJ5cjs = require('./chunk-4GLOLTJ5.cjs');
+
+
+var _chunkILGTU46Tcjs = require('./chunk-ILGTU46T.cjs');
+
+// src/timer.ts
+function timer() {
+  const obj = {
+    startMs: Date.now(),
+    endMs: 0,
+    stop() {
+      obj.endMs = Date.now();
+    },
+    restart() {
+      obj.endMs = 0;
+      obj.startMs = Date.now();
+    },
+    elapsedMs() {
+      const stopMs = obj.endMs || Date.now();
+      return stopMs - obj.startMs;
+    },
+    toString() {
+      return _chunk4GLOLTJ5cjs.elapsed.call(void 0, obj.elapsedMs());
+    }
+  };
+  return obj;
+}
+var init_timer = _chunkILGTU46Tcjs.__esm.call(void 0, {
+  "src/timer.ts"() {
+    _chunk4GLOLTJ5cjs.init_duration.call(void 0, );
+  }
+});
+
+
+
+
+exports.timer = timer; exports.init_timer = init_timer;

package/chunk-CERFUU5I.cjs

@@ -0,0 +1,93 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkILGTU46Tcjs = require('./chunk-ILGTU46T.cjs');
+
+// src/dateTimeStr.ts
+function isAllDigits(str) {
+  return /^\d+$/.test(str);
+}
+function toDate(ts) {
+  if (typeof ts === "number") {
+    if (ts < 1e11) {
+      return new Date(ts * 1e3);
+    }
+    return new Date(ts);
+  }
+  if (typeof ts === "string") {
+    if (isAllDigits(ts)) {
+      return toDate(Number(ts));
+    }
+    return new Date(ts);
+  }
+  return ts;
+}
+function yyyyMm(dt = /* @__PURE__ */ new Date(), separator = "-") {
+  const yr = dt.getFullYear();
+  const mth = dt.getMonth() + 1;
+  return yr + separator + (mth < 10 ? "0" + mth : mth);
+}
+function yyyyMmDd(dt = /* @__PURE__ */ new Date(), separator = "-") {
+  const day = dt.getDate();
+  return yyyyMm(dt, separator) + separator + (day < 10 ? "0" + day : day);
+}
+function hhMm(dt = /* @__PURE__ */ new Date(), separator = ":") {
+  const hr = dt.getHours();
+  const min = dt.getMinutes();
+  return (hr < 10 ? "0" + hr : hr) + separator + (min < 10 ? "0" + min : min);
+}
+function hhMmSs(dt = /* @__PURE__ */ new Date(), separator = ":") {
+  const sec = dt.getSeconds();
+  return hhMm(dt, separator) + separator + (sec < 10 ? "0" + sec : sec);
+}
+function hhMmSsMs(dt = /* @__PURE__ */ new Date(), timeSeparator = ":", msSeparator = ".") {
+  const ms = dt.getMilliseconds();
+  return hhMmSs(dt, timeSeparator) + msSeparator + (ms < 10 ? "00" + ms : ms < 100 ? "0" + ms : ms);
+}
+function tzShort(dt = /* @__PURE__ */ new Date()) {
+  if (dt.getTimezoneOffset() === 0) {
+    return "Z";
+  }
+  const tzHours = dt.getTimezoneOffset() / 60;
+  return tzHours >= 0 ? "+" + tzHours : String(tzHours);
+}
+function getLongMonthNameZeroIndexed(month, locales = "default") {
+  return new Date(2024, month, 15).toLocaleString(locales, {
+    month: "long"
+  });
+}
+function getLongMonthNameOneIndexed(month, locales = "default") {
+  return getLongMonthNameZeroIndexed(month - 1, locales);
+}
+function getShortMonthNameZeroIndexed(month, locales = "default") {
+  return new Date(2e3, month, 15).toLocaleString(locales, {
+    month: "short"
+  });
+}
+function getShortMonthNameOneIndexed(month, locales = "default") {
+  return getShortMonthNameZeroIndexed(month - 1, locales);
+}
+function getDisplayDateTime(ts) {
+  const iso = toDate(ts).toISOString();
+  const noMs = iso.slice(0, 19) + "Z";
+  return noMs.replace("T", " ");
+}
+var init_dateTimeStr = _chunkILGTU46Tcjs.__esm.call(void 0, {
+  "src/dateTimeStr.ts"() {
+  }
+});
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.toDate = toDate; exports.yyyyMm = yyyyMm; exports.yyyyMmDd = yyyyMmDd; exports.hhMm = hhMm; exports.hhMmSs = hhMmSs; exports.hhMmSsMs = hhMmSsMs; exports.tzShort = tzShort; exports.getLongMonthNameZeroIndexed = getLongMonthNameZeroIndexed; exports.getLongMonthNameOneIndexed = getLongMonthNameOneIndexed; exports.getShortMonthNameZeroIndexed = getShortMonthNameZeroIndexed; exports.getShortMonthNameOneIndexed = getShortMonthNameOneIndexed; exports.getDisplayDateTime = getDisplayDateTime; exports.init_dateTimeStr = init_dateTimeStr;

package/chunk-CSTKFJ6G.mjs

@@ -0,0 +1,239 @@
+import {
+  durationOrMsToMs,
+  init_duration
+} from "./chunk-VG7VV7J2.mjs";
+import {
+  MS_PER_DAY,
+  init_timeConstants
+} from "./chunk-M5PIM2HB.mjs";
+import {
+  __esm
+} from "./chunk-M6PYQYOX.mjs";
+
+// src/localStore.ts
+function configureLocalStore(config) {
+  Object.assign(LocalStoreConfig, config);
+}
+function validateStoredObject(obj) {
+  if (!obj || typeof obj !== "object" || obj.value === void 0 || typeof obj.storedMs !== "number" || typeof obj.expiryMs !== "number" || Date.now() >= obj.expiryMs) {
+    return void 0;
+  }
+  return obj;
+}
+function createLocalStore(storeName, options) {
+  const keyPrefix = storeName + ":";
+  const defaultExpiryMs = options?.defaultExpiryMs ? durationOrMsToMs(options.defaultExpiryMs) : LocalStoreConfig.expiryMs;
+  const gcIntervalMs = options?.gcIntervalMs ? durationOrMsToMs(options.gcIntervalMs) : LocalStoreConfig.gcIntervalMs;
+  const gcMsStorageKey = `__localStore:lastGcMs:${storeName}`;
+  const obj = {
+    /** Input name for the store. */
+    storeName,
+    /**
+     * The prefix string for the local storage key which identifies items
+     * belonging to this namespace.
+     */
+    keyPrefix,
+    /** Default expiry to use if not specified in set(). */
+    defaultExpiryMs,
+    /** Time interval for when GC's occur. */
+    gcIntervalMs,
+    /** Local storage key name for the last GC completed timestamp. */
+    gcMsStorageKey,
+    /** Set a value in the store. */
+    set(key, value, expiryDeltaMs) {
+      const nowMs = Date.now();
+      const stored = {
+        value,
+        storedMs: nowMs,
+        expiryMs: nowMs + durationOrMsToMs(expiryDeltaMs ?? defaultExpiryMs)
+      };
+      localStorage.setItem(keyPrefix + key, JSON.stringify(stored));
+      obj.gc();
+      return value;
+    },
+    /** Delete one or multiple keys. */
+    delete(key) {
+      if (typeof key === "string") {
+        localStorage.removeItem(keyPrefix + key);
+      } else {
+        for (const k of key) {
+          localStorage.removeItem(keyPrefix + k);
+        }
+      }
+    },
+    /** Mainly used to get the expiration timestamp of an object. */
+    getStoredObject(key) {
+      const k = keyPrefix + key;
+      const stored = localStorage.getItem(k);
+      if (!stored) {
+        return void 0;
+      }
+      try {
+        const parsed = JSON.parse(stored);
+        const valid = validateStoredObject(parsed);
+        if (!valid) {
+          obj.delete(k);
+          obj.gc();
+          return void 0;
+        }
+        return valid;
+      } catch (e) {
+        console.error(`Invalid local value: ${k}=${stored}:`, e);
+        obj.delete(k);
+        obj.gc();
+        return void 0;
+      }
+    },
+    /** Get a value by key, or undefined if it does not exist. */
+    get(key) {
+      const stored = obj.getStoredObject(key);
+      return stored?.value;
+    },
+    /** Generic way to iterate through all entries. */
+    forEach(callback) {
+      for (const k of Object.keys(localStorage)) {
+        if (!k.startsWith(keyPrefix)) continue;
+        const key = k.slice(keyPrefix.length);
+        const stored = obj.getStoredObject(key);
+        if (!stored) continue;
+        callback(key, stored.value, stored.expiryMs, stored.storedMs);
+      }
+    },
+    /**
+     * Returns the number of items in the store. Note that getting the size
+     * requires iterating through the entire store because the items could expire
+     * at any time, and hence the size is a dynamic number.
+     */
+    size() {
+      let count = 0;
+      obj.forEach(() => {
+        count++;
+      });
+      return count;
+    },
+    /** Remove all items from the store. */
+    clear() {
+      for (const key of Object.keys(localStorage)) {
+        if (key.startsWith(keyPrefix)) {
+          localStorage.removeItem(key);
+        }
+      }
+    },
+    /**
+     * Returns all items as map of key to value, mainly used for debugging dumps.
+     * The type T is applied to all values, even though they might not be of type
+     * T (in the case when you store different data types in the same store).
+     */
+    asMap() {
+      const map = /* @__PURE__ */ new Map();
+      obj.forEach(
+        (key, value, expiryMs, storedMs) => {
+          map.set(key, { value, expiryMs, storedMs });
+        }
+      );
+      return map;
+    },
+    /** Returns the ms timestamp for the last GC (garbage collection). */
+    getLastGcMs() {
+      const lastGcMsStr = localStorage.getItem(gcMsStorageKey);
+      if (!lastGcMsStr) return 0;
+      const ms = Number(lastGcMsStr);
+      return isNaN(ms) ? 0 : ms;
+    },
+    /** Set the ms timestamp for the last GC (garbage collection). */
+    setLastGcMs(ms) {
+      localStorage.setItem(gcMsStorageKey, String(ms));
+    },
+    /** Perform garbage-collection if due, else do nothing. */
+    gc() {
+      const lastGcMs = obj.getLastGcMs();
+      if (!lastGcMs) {
+        obj.setLastGcMs(Date.now());
+        return;
+      }
+      if (Date.now() < lastGcMs + gcIntervalMs) {
+        return;
+      }
+      obj.gcNow();
+    },
+    /**
+     * Perform garbage collection immediately without checking whether we are
+     * due for the next GC or not.
+     */
+    gcNow() {
+      console.log(`Starting localStore GC on ${storeName}`);
+      obj.setLastGcMs(Date.now());
+      let count = 0;
+      obj.forEach((key, value, expiryMs) => {
+        if (Date.now() >= expiryMs) {
+          obj.delete(key);
+          count++;
+        }
+      });
+      console.log(
+        `Finished localStore GC on ${storeName} - deleted ${count} keys`
+      );
+      obj.setLastGcMs(Date.now());
+    },
+    /** Returns `this` casted into a StorageAdapter<T>. */
+    asStorageAdapter() {
+      return obj;
+    }
+  };
+  return obj;
+}
+function localStoreItem(key, expiryMs, store = localStore) {
+  const defaultExpiryMs = expiryMs && durationOrMsToMs(expiryMs);
+  const obj = {
+    key,
+    defaultExpiryMs,
+    store,
+    /** Set a value in the store. */
+    set(value, expiryDeltaMs) {
+      store.set(key, value, expiryDeltaMs ?? defaultExpiryMs);
+    },
+    /**
+     * Example usage:
+     *
+     *   const { value, storedMs, expiryMs, storedMs } =
+     *     await myLocalItem.getStoredObject();
+     */
+    getStoredObject() {
+      return store.getStoredObject(key);
+    },
+    /** Get a value by key, or undefined if it does not exist. */
+    get() {
+      return store.get(key);
+    },
+    /** Delete this key from the store. */
+    delete() {
+      store.delete(key);
+    }
+  };
+  return obj;
+}
+var LocalStoreConfig, localStore;
+var init_localStore = __esm({
+  "src/localStore.ts"() {
+    init_duration();
+    init_timeConstants();
+    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
+    };
+    localStore = createLocalStore(LocalStoreConfig.storeName);
+  }
+});
+
+export {
+  LocalStoreConfig,
+  configureLocalStore,
+  createLocalStore,
+  localStore,
+  localStoreItem,
+  init_localStore
+};