@choksheak/ts-utils 0.3.4 → 0.3.6

package/chunk-SJDJDNDN.min.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkQNNJNLGKmincjs = require('./chunk-QNNJNLGK.min.cjs');function u(e){return/^\d+$/.test(e)}function o(e){return typeof e=="number"?e<1e11?new Date(e*1e3):new Date(e):typeof e=="string"?u(e)?o(Number(e)):new Date(e):e}function s(e=new Date,t="-"){let n=e.getFullYear(),r=e.getMonth()+1;return n+t+(r<10?"0"+r:r)}function l(e=new Date,t="-"){let n=e.getDate();return s(e,t)+t+(n<10?"0"+n:n)}function g(e=new Date,t=":"){let n=e.getHours(),r=e.getMinutes();return(n<10?"0"+n:n)+t+(r<10?"0"+r:r)}function a(e=new Date,t=":"){let n=e.getSeconds();return g(e,t)+t+(n<10?"0"+n:n)}function D(e=new Date,t=":",n="."){let r=e.getMilliseconds();return a(e,t)+n+(r<10?"00"+r:r<100?"0"+r:r)}function h(e=new Date){if(e.getTimezoneOffset()===0)return"Z";let t=e.getTimezoneOffset()/60;return t>=0?"+"+t:String(t)}function c(e,t="default"){return new Date(2024,e,15).toLocaleString(t,{month:"long"})}function x(e,t="default"){return c(e-1,t)}function m(e,t="default"){return new Date(2e3,e,15).toLocaleString(t,{month:"short"})}function y(e,t="default"){return m(e-1,t)}function p(e){return(o(e).toISOString().slice(0,19)+"Z").replace("T"," ")}var f=_chunkQNNJNLGKmincjs.a.call(void 0, ()=>{});exports.a = o; exports.b = s; exports.c = l; exports.d = g; exports.e = a; exports.f = D; exports.g = h; exports.h = c; exports.i = x; exports.j = m; exports.k = y; exports.l = p; exports.m = f;
+//# sourceMappingURL=chunk-SJDJDNDN.min.cjs.map

package/chunk-SJDJDNDN.min.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/choksheaklau/src/ts-utils/dist/chunk-SJDJDNDN.min.cjs","../src/dateTimeStr.ts"],"names":["isAllDigits","str","toDate","ts","yyyyMm","dt","separator","yr","mth","yyyyMmDd","day","hhMm","hr","min","hhMmSs","sec","hhMmSsMs","timeSeparator","msSeparator","ms","tzShort","tzHours","getLongMonthNameZeroIndexed","month","locales","getLongMonthNameOneIndexed","getShortMonthNameZeroIndexed","getShortMonthNameOneIndexed","getDisplayDateTime","init_dateTimeStr","__esmMin"],"mappings":"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","file":"/Users/choksheaklau/src/ts-utils/dist/chunk-SJDJDNDN.min.cjs","sourcesContent":[null,"export type AnyDateTime = number | Date | string;\n\nfunction isAllDigits(str: string): boolean {\n  return /^\\d+$/.test(str);\n}\n\n/**\n * Convert a number (epoch seconds or milliseconds), string (parseable\n * date/time or epoch seconds or milliseconds), or Date object (no conversion)\n * into a Date object.\n */\nexport function toDate(ts: AnyDateTime): Date {\n  if (typeof ts === \"number\") {\n    // Handle timestamp in seconds (less than 12 digits long).\n    if (ts < 1_000_000_000_00) {\n      return new Date(ts * 1000);\n    }\n\n    // Handle timestamp in milliseconds.\n    return new Date(ts);\n  }\n\n  if (typeof ts === \"string\") {\n    if (isAllDigits(ts)) {\n      return toDate(Number(ts));\n    }\n\n    return new Date(ts);\n  }\n\n  return ts;\n}\n\n/**\n * Returns a date in yyyy-MM format. E.g. '2000-01'.\n *\n * @param dt Specify a date object or default to the current date.\n * @param separator Defaults to '-'.\n */\nexport function yyyyMm(dt = new Date(), separator = \"-\"): string {\n  const yr = dt.getFullYear();\n  const mth = dt.getMonth() + 1;\n\n  return yr + separator + (mth < 10 ? \"0\" + mth : mth);\n}\n\n/**\n * Returns a date in yyyy-MM-dd format. E.g. '2000-01-02'.\n *\n * @param dt Specify a date object or default to the current date.\n * @param separator Defaults to '-'.\n */\nexport function yyyyMmDd(dt = new Date(), separator = \"-\"): string {\n  const day = dt.getDate();\n\n  return yyyyMm(dt, separator) + separator + (day < 10 ? \"0\" + day : day);\n}\n\n/**\n * Returns a date in hh:mm format. E.g. '01:02'.\n *\n * @param dt Specify a date object or default to the current date/time.\n * @param separator Defaults to ':'.\n */\nexport function hhMm(dt = new Date(), separator = \":\"): string {\n  const hr = dt.getHours();\n  const min = dt.getMinutes();\n\n  return (hr < 10 ? \"0\" + hr : hr) + separator + (min < 10 ? \"0\" + min : min);\n}\n\n/**\n * Returns a date in hh:mm:ss format. E.g. '01:02:03'.\n *\n * @param dt Specify a date object or default to the current date/time.\n * @param separator Defaults to ':'.\n */\nexport function hhMmSs(dt = new Date(), separator = \":\"): string {\n  const sec = dt.getSeconds();\n\n  return hhMm(dt, separator) + separator + (sec < 10 ? \"0\" + sec : sec);\n}\n\n/**\n * Returns a date in hh:mm:ss.SSS format. E.g. '01:02:03.004'.\n *\n * @param dt Specify a date object or default to the current date/time.\n * @param timeSeparator Separator for hh/mm/ss. Defaults to ':'.\n * @param msSeparator Separator before SSS. Defaults to '.'.\n */\nexport function hhMmSsMs(\n  dt = new Date(),\n  timeSeparator = \":\",\n  msSeparator = \".\",\n): string {\n  const ms = dt.getMilliseconds();\n\n  return (\n    hhMmSs(dt, timeSeparator) +\n    msSeparator +\n    (ms < 10 ? \"00\" + ms : ms < 100 ? \"0\" + ms : ms)\n  );\n}\n\n/**\n * Returns the timezone string for the given date. E.g. '+8', '-3.5'.\n * Returns 'Z' for UTC.\n *\n * @param dt Specify a date object or default to the current date/time.\n */\nexport function tzShort(dt = new Date()): string {\n  if (dt.getTimezoneOffset() === 0) {\n    return \"Z\";\n  }\n\n  const tzHours = dt.getTimezoneOffset() / 60;\n  return tzHours >= 0 ? \"+\" + tzHours : String(tzHours);\n}\n\n/**\n * Returns the long month name, zero-indexed. E.g. 0 for 'January'.\n *\n * @param month Zero-indexed month.\n * @param locales Specify the locale, e.g. 'en-US', new Intl.Locale(\"en-US\").\n */\nexport function getLongMonthNameZeroIndexed(\n  month: number,\n  locales: Intl.LocalesArgument = \"default\",\n): string {\n  return new Date(2024, month, 15).toLocaleString(locales, {\n    month: \"long\",\n  });\n}\n\n/**\n * Returns the long month name, one-indexed. E.g. 1 for 'January'.\n *\n * @param month One-indexed month.\n * @param locales Specify the locale, e.g. 'en-US', new Intl.Locale(\"en-US\").\n */\nexport function getLongMonthNameOneIndexed(\n  month: number,\n  locales: Intl.LocalesArgument = \"default\",\n): string {\n  return getLongMonthNameZeroIndexed(month - 1, locales);\n}\n\n/**\n * Returns the short month name, zero-indexed. E.g. 0 for 'Jan'.\n *\n * @param month Zero-indexed month.\n * @param locales Specify the locale, e.g. 'en-US', new Intl.Locale(\"en-US\").\n */\nexport function getShortMonthNameZeroIndexed(\n  month: number,\n  locales: Intl.LocalesArgument = \"default\",\n): string {\n  return new Date(2000, month, 15).toLocaleString(locales, {\n    month: \"short\",\n  });\n}\n\n/**\n * Returns the short month name, one-indexed. E.g. 1 for 'Jan'.\n *\n * @param month One-indexed month.\n * @param locales Specify the locale, e.g. 'en-US', new Intl.Locale(\"en-US\").\n */\nexport function getShortMonthNameOneIndexed(\n  month: number,\n  locales: Intl.LocalesArgument = \"default\",\n): string {\n  return getShortMonthNameZeroIndexed(month - 1, locales);\n}\n\n/**\n * Returns a human-readable string date/time like '2025-01-01 22:31:16Z'.\n * Excludes the milliseconds assuming it is not necessary for display.\n */\nexport function getDisplayDateTime(ts: AnyDateTime) {\n  const iso = toDate(ts).toISOString();\n  const noMs = iso.slice(0, 19) + \"Z\";\n  return noMs.replace(\"T\", \" \");\n}\n"]}

package/chunk-SULNMALN.cjs

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

package/chunk-SV35RBZ7.min.mjs

@@ -0,0 +1,2 @@
+import{a as i}from"./chunk-UOU6IP3S.min.mjs";function u(e){return/^\d+$/.test(e)}function o(e){return typeof e=="number"?e<1e11?new Date(e*1e3):new Date(e):typeof e=="string"?u(e)?o(Number(e)):new Date(e):e}function s(e=new Date,t="-"){let n=e.getFullYear(),r=e.getMonth()+1;return n+t+(r<10?"0"+r:r)}function l(e=new Date,t="-"){let n=e.getDate();return s(e,t)+t+(n<10?"0"+n:n)}function g(e=new Date,t=":"){let n=e.getHours(),r=e.getMinutes();return(n<10?"0"+n:n)+t+(r<10?"0"+r:r)}function a(e=new Date,t=":"){let n=e.getSeconds();return g(e,t)+t+(n<10?"0"+n:n)}function D(e=new Date,t=":",n="."){let r=e.getMilliseconds();return a(e,t)+n+(r<10?"00"+r:r<100?"0"+r:r)}function h(e=new Date){if(e.getTimezoneOffset()===0)return"Z";let t=e.getTimezoneOffset()/60;return t>=0?"+"+t:String(t)}function c(e,t="default"){return new Date(2024,e,15).toLocaleString(t,{month:"long"})}function x(e,t="default"){return c(e-1,t)}function m(e,t="default"){return new Date(2e3,e,15).toLocaleString(t,{month:"short"})}function y(e,t="default"){return m(e-1,t)}function p(e){return(o(e).toISOString().slice(0,19)+"Z").replace("T"," ")}var f=i(()=>{});export{o as a,s as b,l as c,g as d,a as e,D as f,h as g,c as h,x as i,m as j,y as k,p as l,f as m};
+//# sourceMappingURL=chunk-SV35RBZ7.min.mjs.map

package/chunk-SV35RBZ7.min.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/dateTimeStr.ts"],"sourcesContent":["export type AnyDateTime = number | Date | string;\n\nfunction isAllDigits(str: string): boolean {\n  return /^\\d+$/.test(str);\n}\n\n/**\n * Convert a number (epoch seconds or milliseconds), string (parseable\n * date/time or epoch seconds or milliseconds), or Date object (no conversion)\n * into a Date object.\n */\nexport function toDate(ts: AnyDateTime): Date {\n  if (typeof ts === \"number\") {\n    // Handle timestamp in seconds (less than 12 digits long).\n    if (ts < 1_000_000_000_00) {\n      return new Date(ts * 1000);\n    }\n\n    // Handle timestamp in milliseconds.\n    return new Date(ts);\n  }\n\n  if (typeof ts === \"string\") {\n    if (isAllDigits(ts)) {\n      return toDate(Number(ts));\n    }\n\n    return new Date(ts);\n  }\n\n  return ts;\n}\n\n/**\n * Returns a date in yyyy-MM format. E.g. '2000-01'.\n *\n * @param dt Specify a date object or default to the current date.\n * @param separator Defaults to '-'.\n */\nexport function yyyyMm(dt = new Date(), separator = \"-\"): string {\n  const yr = dt.getFullYear();\n  const mth = dt.getMonth() + 1;\n\n  return yr + separator + (mth < 10 ? \"0\" + mth : mth);\n}\n\n/**\n * Returns a date in yyyy-MM-dd format. E.g. '2000-01-02'.\n *\n * @param dt Specify a date object or default to the current date.\n * @param separator Defaults to '-'.\n */\nexport function yyyyMmDd(dt = new Date(), separator = \"-\"): string {\n  const day = dt.getDate();\n\n  return yyyyMm(dt, separator) + separator + (day < 10 ? \"0\" + day : day);\n}\n\n/**\n * Returns a date in hh:mm format. E.g. '01:02'.\n *\n * @param dt Specify a date object or default to the current date/time.\n * @param separator Defaults to ':'.\n */\nexport function hhMm(dt = new Date(), separator = \":\"): string {\n  const hr = dt.getHours();\n  const min = dt.getMinutes();\n\n  return (hr < 10 ? \"0\" + hr : hr) + separator + (min < 10 ? \"0\" + min : min);\n}\n\n/**\n * Returns a date in hh:mm:ss format. E.g. '01:02:03'.\n *\n * @param dt Specify a date object or default to the current date/time.\n * @param separator Defaults to ':'.\n */\nexport function hhMmSs(dt = new Date(), separator = \":\"): string {\n  const sec = dt.getSeconds();\n\n  return hhMm(dt, separator) + separator + (sec < 10 ? \"0\" + sec : sec);\n}\n\n/**\n * Returns a date in hh:mm:ss.SSS format. E.g. '01:02:03.004'.\n *\n * @param dt Specify a date object or default to the current date/time.\n * @param timeSeparator Separator for hh/mm/ss. Defaults to ':'.\n * @param msSeparator Separator before SSS. Defaults to '.'.\n */\nexport function hhMmSsMs(\n  dt = new Date(),\n  timeSeparator = \":\",\n  msSeparator = \".\",\n): string {\n  const ms = dt.getMilliseconds();\n\n  return (\n    hhMmSs(dt, timeSeparator) +\n    msSeparator +\n    (ms < 10 ? \"00\" + ms : ms < 100 ? \"0\" + ms : ms)\n  );\n}\n\n/**\n * Returns the timezone string for the given date. E.g. '+8', '-3.5'.\n * Returns 'Z' for UTC.\n *\n * @param dt Specify a date object or default to the current date/time.\n */\nexport function tzShort(dt = new Date()): string {\n  if (dt.getTimezoneOffset() === 0) {\n    return \"Z\";\n  }\n\n  const tzHours = dt.getTimezoneOffset() / 60;\n  return tzHours >= 0 ? \"+\" + tzHours : String(tzHours);\n}\n\n/**\n * Returns the long month name, zero-indexed. E.g. 0 for 'January'.\n *\n * @param month Zero-indexed month.\n * @param locales Specify the locale, e.g. 'en-US', new Intl.Locale(\"en-US\").\n */\nexport function getLongMonthNameZeroIndexed(\n  month: number,\n  locales: Intl.LocalesArgument = \"default\",\n): string {\n  return new Date(2024, month, 15).toLocaleString(locales, {\n    month: \"long\",\n  });\n}\n\n/**\n * Returns the long month name, one-indexed. E.g. 1 for 'January'.\n *\n * @param month One-indexed month.\n * @param locales Specify the locale, e.g. 'en-US', new Intl.Locale(\"en-US\").\n */\nexport function getLongMonthNameOneIndexed(\n  month: number,\n  locales: Intl.LocalesArgument = \"default\",\n): string {\n  return getLongMonthNameZeroIndexed(month - 1, locales);\n}\n\n/**\n * Returns the short month name, zero-indexed. E.g. 0 for 'Jan'.\n *\n * @param month Zero-indexed month.\n * @param locales Specify the locale, e.g. 'en-US', new Intl.Locale(\"en-US\").\n */\nexport function getShortMonthNameZeroIndexed(\n  month: number,\n  locales: Intl.LocalesArgument = \"default\",\n): string {\n  return new Date(2000, month, 15).toLocaleString(locales, {\n    month: \"short\",\n  });\n}\n\n/**\n * Returns the short month name, one-indexed. E.g. 1 for 'Jan'.\n *\n * @param month One-indexed month.\n * @param locales Specify the locale, e.g. 'en-US', new Intl.Locale(\"en-US\").\n */\nexport function getShortMonthNameOneIndexed(\n  month: number,\n  locales: Intl.LocalesArgument = \"default\",\n): string {\n  return getShortMonthNameZeroIndexed(month - 1, locales);\n}\n\n/**\n * Returns a human-readable string date/time like '2025-01-01 22:31:16Z'.\n * Excludes the milliseconds assuming it is not necessary for display.\n */\nexport function getDisplayDateTime(ts: AnyDateTime) {\n  const iso = toDate(ts).toISOString();\n  const noMs = iso.slice(0, 19) + \"Z\";\n  return noMs.replace(\"T\", \" \");\n}\n"],"mappings":"6CAEA,SAASA,EAAYC,EAAsB,CACzC,MAAO,QAAQ,KAAKA,CAAG,CACzB,CAOO,SAASC,EAAOC,EAAuB,CAC5C,OAAI,OAAOA,GAAO,SAEZA,EAAK,KACA,IAAI,KAAKA,EAAK,GAAI,EAIpB,IAAI,KAAKA,CAAE,EAGhB,OAAOA,GAAO,SACZH,EAAYG,CAAE,EACTD,EAAO,OAAOC,CAAE,CAAC,EAGnB,IAAI,KAAKA,CAAE,EAGbA,CACT,CAQO,SAASC,EAAOC,EAAK,IAAI,KAAQC,EAAY,IAAa,CAC/D,IAAMC,EAAKF,EAAG,YAAY,EACpBG,EAAMH,EAAG,SAAS,EAAI,EAE5B,OAAOE,EAAKD,GAAaE,EAAM,GAAK,IAAMA,EAAMA,EAClD,CAQO,SAASC,EAASJ,EAAK,IAAI,KAAQC,EAAY,IAAa,CACjE,IAAMI,EAAML,EAAG,QAAQ,EAEvB,OAAOD,EAAOC,EAAIC,CAAS,EAAIA,GAAaI,EAAM,GAAK,IAAMA,EAAMA,EACrE,CAQO,SAASC,EAAKN,EAAK,IAAI,KAAQC,EAAY,IAAa,CAC7D,IAAMM,EAAKP,EAAG,SAAS,EACjBQ,EAAMR,EAAG,WAAW,EAE1B,OAAQO,EAAK,GAAK,IAAMA,EAAKA,GAAMN,GAAaO,EAAM,GAAK,IAAMA,EAAMA,EACzE,CAQO,SAASC,EAAOT,EAAK,IAAI,KAAQC,EAAY,IAAa,CAC/D,IAAMS,EAAMV,EAAG,WAAW,EAE1B,OAAOM,EAAKN,EAAIC,CAAS,EAAIA,GAAaS,EAAM,GAAK,IAAMA,EAAMA,EACnE,CASO,SAASC,EACdX,EAAK,IAAI,KACTY,EAAgB,IAChBC,EAAc,IACN,CACR,IAAMC,EAAKd,EAAG,gBAAgB,EAE9B,OACES,EAAOT,EAAIY,CAAa,EACxBC,GACCC,EAAK,GAAK,KAAOA,EAAKA,EAAK,IAAM,IAAMA,EAAKA,EAEjD,CAQO,SAASC,EAAQf,EAAK,IAAI,KAAgB,CAC/C,GAAIA,EAAG,kBAAkB,IAAM,EAC7B,MAAO,IAGT,IAAMgB,EAAUhB,EAAG,kBAAkB,EAAI,GACzC,OAAOgB,GAAW,EAAI,IAAMA,EAAU,OAAOA,CAAO,CACtD,CAQO,SAASC,EACdC,EACAC,EAAgC,UACxB,CACR,OAAO,IAAI,KAAK,KAAMD,EAAO,EAAE,EAAE,eAAeC,EAAS,CACvD,MAAO,MACT,CAAC,CACH,CAQO,SAASC,EACdF,EACAC,EAAgC,UACxB,CACR,OAAOF,EAA4BC,EAAQ,EAAGC,CAAO,CACvD,CAQO,SAASE,EACdH,EACAC,EAAgC,UACxB,CACR,OAAO,IAAI,KAAK,IAAMD,EAAO,EAAE,EAAE,eAAeC,EAAS,CACvD,MAAO,OACT,CAAC,CACH,CAQO,SAASG,EACdJ,EACAC,EAAgC,UACxB,CACR,OAAOE,EAA6BH,EAAQ,EAAGC,CAAO,CACxD,CAMO,SAASI,EAAmBzB,EAAiB,CAGlD,OAFYD,EAAOC,CAAE,EAAE,YAAY,EAClB,MAAM,EAAG,EAAE,EAAI,KACpB,QAAQ,IAAK,GAAG,CAC9B,CAvLA,IAAA0B,EAAAC,EAAA","names":["isAllDigits","str","toDate","ts","yyyyMm","dt","separator","yr","mth","yyyyMmDd","day","hhMm","hr","min","hhMmSs","sec","hhMmSsMs","timeSeparator","msSeparator","ms","tzShort","tzHours","getLongMonthNameZeroIndexed","month","locales","getLongMonthNameOneIndexed","getShortMonthNameZeroIndexed","getShortMonthNameOneIndexed","getDisplayDateTime","init_dateTimeStr","__esmMin"]}