zeed 1.3.0 → 1.4.0

package/dist/common/time.cjs

@@ -1,2 +1,221 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./data/math.cjs`);let t;function n(e=Date.UTC(2e3,0,1,0,0,0,0)){t=e}function r(){return t??Date.now()}function i(){return Math.floor(r()/1e3)}function a(e){return new Date(e*1e3)}function o(e){return e>999?`${(e/1e3).toFixed(1)} s`:`${e.toFixed(2)} ms`}function s(...e){for(let t of e){if(t instanceof Date)return t;if(typeof t==`string`){let e=null;if(t.includes(`:`))try{e=new Date(t)}catch{}if(!(e instanceof Date)){let n=/(\d\d\d\d)-(\d\d)-(\d\d)/.exec(t);n&&(e=new Date(+n[1],n[2]-1,+n[3],12,0))}if(e instanceof Date)return e}}}function c(){return typeof performance<`u`?performance.now():Date.now()}function l(){let e=c();return function(){return o(c()-e)}}function u(e){return new Date(e.getUTCFullYear(),e.getUTCMonth(),e.getUTCDate(),e.getUTCHours(),e.getUTCMinutes(),e.getUTCSeconds(),e.getUTCMilliseconds())}function d(e){return new Date(Date.UTC(e.getFullYear(),e.getMonth(),e.getDate(),e.getHours(),e.getMinutes(),e.getSeconds(),e.getMilliseconds()))}function f(e,t=!0){return e<=0?0:t&&e<0xe8d4a51000?e:Math.floor(e/1e3)}function p(e,t=!0){return e<=0?0:t&&e>0xe8d4a51000?e:Math.floor(e*1e3)}const m=1735686e3;function h(){return e.numberToBase32(Math.floor((i()-m)/5),6)}function g(t){return m+e.base32ToNumber(t)*5}exports.TIME_DAY_MS=864e5,exports.TIME_DAY_S=86400,exports.TIME_HOUR_MS=36e5,exports.TIME_HOUR_S=3600,exports.TIME_MINUTE_MS=6e4,exports.TIME_MINUTE_S=60,exports.TIME_MONTH_MS=2592e6,exports.TIME_MONTH_S=2592e3,exports.TIME_WEEK_MS=6048e5,exports.TIME_WEEK_S=604800,exports.TIME_YEAR_MS=31536e6,exports.TIME_YEAR_S=31536e3,exports.dateFromSeconds=a,exports.datetimeToLocal=u,exports.datetimeToUTC=d,exports.duration=l,exports.formatMilliseconds=o,exports.getBuildNumber=h,exports.getPerformanceTimestamp=c,exports.getSecondsFromBuildNumber=g,exports.getTimestamp=r,exports.getTimestampInSeconds=i,exports.parseDate=s,exports.setTimestampTest=n,exports.timestampMillisecondsToSeconds=f,exports.timestampSecondsToMilliseconds=p;
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_common_data_math = require('./data/math.cjs');
+
+//#region src/common/time.ts
+let testModeTime;
+/**
+* Set a fixed timestamp (ms since epoch) used by `getTimestamp` for tests.
+*
+* Pass a millisecond timestamp (for example created with Date.UTC) to force
+* time-based helpers to return deterministic values during tests.
+*
+* @param ts - timestamp in milliseconds (defaults to 2000-01-01T00:00:00.000Z)
+*/
+function setTimestampTest(ts = Date.UTC(2e3, 0, 1, 0, 0, 0, 0)) {
+	testModeTime = ts;
+}
+/**
+* Return the current timestamp in milliseconds.
+*
+* In test mode (when `setTimestampTest` was called) the forced value is
+* returned instead of the real current time.
+*
+* @returns timestamp in milliseconds
+*/
+function getTimestamp() {
+	return testModeTime ?? Date.now();
+}
+/**
+* Return the current timestamp in seconds.
+*
+* Uses `getTimestamp()` which can be overridden for tests with
+* `setTimestampTest`.
+*
+* @returns timestamp in whole seconds (integer)
+*/
+function getTimestampInSeconds() {
+	return Math.floor(getTimestamp() / 1e3);
+}
+/**
+* Convert a UNIX timestamp in seconds to a JavaScript Date.
+*
+* @param ts - seconds since epoch
+* @returns Date instance corresponding to the provided seconds
+*/
+function dateFromSeconds(ts) {
+	return /* @__PURE__ */ new Date(ts * 1e3);
+}
+/**
+* Format a millisecond duration into a human readable string.
+*
+* - Values >= 1000ms are shown in seconds with one decimal (e.g. "1.2 s").
+* - Smaller values are shown in milliseconds with two decimals (e.g. "123.45 ms").
+*
+* @param ms - duration in milliseconds
+* @returns formatted duration string
+*/
+function formatMilliseconds(ms) {
+	return ms > 999 ? `${(ms / 1e3).toFixed(1)} s` : `${ms.toFixed(2)} ms`;
+}
+/**
+* Parses the given date candidates and returns the first valid Date object found.
+*
+* @param dateCandidates - The date candidates to parse, which can be either strings or Date objects.
+* @returns The parsed Date object, or undefined if no valid date is found.
+*/
+function parseDate(...dateCandidates) {
+	for (const dateCandidate of dateCandidates) {
+		if (dateCandidate instanceof Date) return dateCandidate;
+		if (typeof dateCandidate === "string") {
+			let date = null;
+			if (dateCandidate.includes(":")) try {
+				date = new Date(dateCandidate);
+			} catch (err) {}
+			if (!(date instanceof Date)) {
+				const m = /(\d\d\d\d)-(\d\d)-(\d\d)/.exec(dateCandidate);
+				if (m) date = new Date(+m[1], +m[2] - 1, +m[3], 12, 0);
+			}
+			if (date instanceof Date) return date;
+		}
+	}
+}
+/**
+* Return a high-resolution timestamp in milliseconds.
+*
+* Uses the `performance.now()` clock when available (monotonic, high
+* resolution), otherwise falls back to `Date.now()`.
+*
+* @returns timestamp in milliseconds (relative for performance.now, epoch for Date.now)
+*/
+function getPerformanceTimestamp() {
+	return typeof performance !== "undefined" ? performance.now() : Date.now();
+}
+/**
+* Create a simple duration reporter.
+*
+* Returns a function that, when called, reports the elapsed time since
+* `duration()` was called. The returned string is formatted via
+* `formatMilliseconds`.
+*
+* Example: const t = duration(); // do work...; console.log(t());
+*
+* @returns a zero-argument function that returns the elapsed time string
+*/
+function duration() {
+	const t0 = getPerformanceTimestamp();
+	return function() {
+		return formatMilliseconds(getPerformanceTimestamp() - t0);
+	};
+}
+/**
+* If you parsed a date string that didn't include a time zone, adjust the
+* naive UTC components into a local Date with the same Y/M/D/H/M/S values.
+*
+* This effectively treats the input as if it already represented local time
+* and builds a corresponding Date using the local timezone.
+*/
+function datetimeToLocal(fromDate) {
+	return new Date(fromDate.getUTCFullYear(), fromDate.getUTCMonth(), fromDate.getUTCDate(), fromDate.getUTCHours(), fromDate.getUTCMinutes(), fromDate.getUTCSeconds(), fromDate.getUTCMilliseconds());
+}
+/**
+* If you parsed a date string that didn't include a time zone, adjust the
+* local date components into a UTC Date with the same Y/M/D/H/M/S values.
+*/
+function datetimeToUTC(fromDate) {
+	return new Date(Date.UTC(fromDate.getFullYear(), fromDate.getMonth(), fromDate.getDate(), fromDate.getHours(), fromDate.getMinutes(), fromDate.getSeconds(), fromDate.getMilliseconds()));
+}
+/**
+* Convert a timestamp in milliseconds to seconds.
+*
+* When `smart` is true the function will try to detect already-second
+* timestamps and return them unchanged (heuristic threshold). For example,
+* small numbers (< 1e12) are likely seconds and are returned as-is.
+*
+* @param ts - timestamp in milliseconds or seconds
+* @param smart - enable heuristic detection (default: true)
+* @returns timestamp in seconds
+*/
+function timestampMillisecondsToSeconds(ts, smart = true) {
+	if (ts <= 0) return 0;
+	if (smart && ts < 0xe8d4a51000) return ts;
+	return Math.floor(ts / 1e3);
+}
+/**
+* Convert a timestamp in seconds to milliseconds.
+*
+* When `smart` is true the function tries to detect already-millisecond
+* values and returns them unchanged (heuristic threshold). Very large
+* numbers (> 1e12) are assumed to already be milliseconds.
+*
+* @param ts - timestamp in seconds or milliseconds
+* @param smart - enable heuristic detection (default: true)
+* @returns timestamp in milliseconds
+*/
+function timestampSecondsToMilliseconds(ts, smart = true) {
+	if (ts <= 0) return 0;
+	if (smart && ts > 0xe8d4a51000) return ts;
+	return Math.floor(ts * 1e3);
+}
+/** Number of milliseconds in (approx.) one year (365 days). */
+const TIME_YEAR_MS = 31536e6;
+/** Number of seconds in (approx.) one year (365 days). */
+const TIME_YEAR_S = 31536e3;
+/** Number of milliseconds in (approx.) one month (30 days). */
+const TIME_MONTH_MS = 2592e6;
+/** Number of seconds in (approx.) one month (30 days). */
+const TIME_MONTH_S = 2592e3;
+/** Number of milliseconds in one week (7 days). */
+const TIME_WEEK_MS = 6048e5;
+/** Number of seconds in one week (7 days). */
+const TIME_WEEK_S = 604800;
+/** Number of milliseconds in one day (24 hours). */
+const TIME_DAY_MS = 864e5;
+/** Number of seconds in one day (24 hours). */
+const TIME_DAY_S = 86400;
+/** Number of milliseconds in one hour (60 minutes). */
+const TIME_HOUR_MS = 36e5;
+/** Number of seconds in one hour (60 minutes). */
+const TIME_HOUR_S = 3600;
+/** Number of milliseconds in one minute (60 seconds). */
+const TIME_MINUTE_MS = 6e4;
+/** Number of seconds in one minute (60 seconds). */
+const TIME_MINUTE_S = 60;
+const buildNumberSeconds = 5;
+const buildNumberPadding = 6;
+const buildStartSeconds = 1735686e3;
+/** Build number is minutes since 2025-01-01 in base32 "agnoster" encoded format */
+function getBuildNumber() {
+	return require_common_data_math.numberToBase32(Math.floor((getTimestampInSeconds() - buildStartSeconds) / buildNumberSeconds), buildNumberPadding);
+}
+function getSecondsFromBuildNumber(buildNumber) {
+	return buildStartSeconds + require_common_data_math.base32ToNumber(buildNumber) * buildNumberSeconds;
+}
+
+//#endregion
+exports.TIME_DAY_MS = TIME_DAY_MS;
+exports.TIME_DAY_S = TIME_DAY_S;
+exports.TIME_HOUR_MS = TIME_HOUR_MS;
+exports.TIME_HOUR_S = TIME_HOUR_S;
+exports.TIME_MINUTE_MS = TIME_MINUTE_MS;
+exports.TIME_MINUTE_S = TIME_MINUTE_S;
+exports.TIME_MONTH_MS = TIME_MONTH_MS;
+exports.TIME_MONTH_S = TIME_MONTH_S;
+exports.TIME_WEEK_MS = TIME_WEEK_MS;
+exports.TIME_WEEK_S = TIME_WEEK_S;
+exports.TIME_YEAR_MS = TIME_YEAR_MS;
+exports.TIME_YEAR_S = TIME_YEAR_S;
+exports.dateFromSeconds = dateFromSeconds;
+exports.datetimeToLocal = datetimeToLocal;
+exports.datetimeToUTC = datetimeToUTC;
+exports.duration = duration;
+exports.formatMilliseconds = formatMilliseconds;
+exports.getBuildNumber = getBuildNumber;
+exports.getPerformanceTimestamp = getPerformanceTimestamp;
+exports.getSecondsFromBuildNumber = getSecondsFromBuildNumber;
+exports.getTimestamp = getTimestamp;
+exports.getTimestampInSeconds = getTimestampInSeconds;
+exports.parseDate = parseDate;
+exports.setTimestampTest = setTimestampTest;
+exports.timestampMillisecondsToSeconds = timestampMillisecondsToSeconds;
+exports.timestampSecondsToMilliseconds = timestampSecondsToMilliseconds;
 //# sourceMappingURL=time.cjs.map

package/dist/common/time.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"time.cjs","names":["numberToBase32","base32ToNumber"],"sources":["../../src/common/time.ts"],"sourcesContent":["import { base32ToNumber, numberToBase32 } from './data/math'\n\nlet testModeTime: number | undefined\n\n/**\n * Set a fixed timestamp (ms since epoch) used by `getTimestamp` for tests.\n *\n * Pass a millisecond timestamp (for example created with Date.UTC) to force\n * time-based helpers to return deterministic values during tests.\n *\n * @param ts - timestamp in milliseconds (defaults to 2000-01-01T00:00:00.000Z)\n */\nexport function setTimestampTest(ts = Date.UTC(2000, 0, 1, 0, 0, 0, 0)) {\n  testModeTime = ts\n}\n\n/**\n * Return the current timestamp in milliseconds.\n *\n * In test mode (when `setTimestampTest` was called) the forced value is\n * returned instead of the real current time.\n *\n * @returns timestamp in milliseconds\n */\nexport function getTimestamp(): number {\n  return testModeTime ?? Date.now()\n}\n\n/**\n * Return the current timestamp in seconds.\n *\n * Uses `getTimestamp()` which can be overridden for tests with\n * `setTimestampTest`.\n *\n * @returns timestamp in whole seconds (integer)\n */\nexport function getTimestampInSeconds(): number {\n  return Math.floor(getTimestamp() / 1000)\n}\n\n/**\n * Convert a UNIX timestamp in seconds to a JavaScript Date.\n *\n * @param ts - seconds since epoch\n * @returns Date instance corresponding to the provided seconds\n */\nexport function dateFromSeconds(ts: number): Date {\n  return new Date(ts * 1000)\n}\n\n// typeof performance !== \"undefined\" ? performance.now() : new Date().getTime()\n\n/**\n * Format a millisecond duration into a human readable string.\n *\n * - Values >= 1000ms are shown in seconds with one decimal (e.g. \"1.2 s\").\n * - Smaller values are shown in milliseconds with two decimals (e.g. \"123.45 ms\").\n *\n * @param ms - duration in milliseconds\n * @returns formatted duration string\n */\nexport function formatMilliseconds(ms: number): string {\n  return ms > 999 ? `${(ms / 1000).toFixed(1)} s` : `${ms.toFixed(2)} ms`\n}\n\n/**\n * Parses the given date candidates and returns the first valid Date object found.\n *\n * @param dateCandidates - The date candidates to parse, which can be either strings or Date objects.\n * @returns The parsed Date object, or undefined if no valid date is found.\n */\nexport function parseDate(\n  ...dateCandidates: (string | Date)[]\n): Date | undefined {\n  for (const dateCandidate of dateCandidates) {\n    if (dateCandidate instanceof Date)\n      return dateCandidate\n\n    if (typeof dateCandidate === 'string') {\n      let date = null\n      if (dateCandidate.includes(':')) {\n        try {\n          date = new Date(dateCandidate)\n        }\n        catch (err) {}\n      }\n      if (!(date instanceof Date)) {\n        const m = /(\\d\\d\\d\\d)-(\\d\\d)-(\\d\\d)/.exec(dateCandidate)\n        if (m)\n          date = new Date(+m[1], +m[2] - 1, +m[3], 12, 0)\n      }\n      if (date instanceof Date)\n        return date\n    }\n  }\n}\n\n/**\n * Return a high-resolution timestamp in milliseconds.\n *\n * Uses the `performance.now()` clock when available (monotonic, high\n * resolution), otherwise falls back to `Date.now()`.\n *\n * @returns timestamp in milliseconds (relative for performance.now, epoch for Date.now)\n */\nexport function getPerformanceTimestamp(): number {\n  return typeof performance !== 'undefined' ? performance.now() : Date.now()\n}\n\n/**\n * Create a simple duration reporter.\n *\n * Returns a function that, when called, reports the elapsed time since\n * `duration()` was called. The returned string is formatted via\n * `formatMilliseconds`.\n *\n * Example: const t = duration(); // do work...; console.log(t());\n *\n * @returns a zero-argument function that returns the elapsed time string\n */\nexport function duration(): () => string {\n  const t0 = getPerformanceTimestamp()\n\n  return function (): string {\n    const duration = getPerformanceTimestamp() - t0\n    return formatMilliseconds(duration)\n\n    // if (duration > 500)\n    //   return `${(duration / 1000).toFixed(4)}s`\n\n    // // https://elijahmanor.com/format-js-numbers\n    // // https://tc39.es/proposal-unified-intl-numberformat/section6/locales-currencies-tz_proposed_out.html#sec-issanctionedsimpleunitidentifier\n    // return duration.toLocaleString('en-US', {\n    //   style: 'unit',\n    //   unit: 'millisecond',\n    //   notation: 'compact',\n    //   compactDisplay: 'long',\n    // })\n  }\n}\n\n/**\n * If you parsed a date string that didn't include a time zone, adjust the\n * naive UTC components into a local Date with the same Y/M/D/H/M/S values.\n *\n * This effectively treats the input as if it already represented local time\n * and builds a corresponding Date using the local timezone.\n */\nexport function datetimeToLocal(fromDate: Date): Date {\n  return new Date(\n    fromDate.getUTCFullYear(),\n    fromDate.getUTCMonth(),\n    fromDate.getUTCDate(),\n    fromDate.getUTCHours(),\n    fromDate.getUTCMinutes(),\n    fromDate.getUTCSeconds(),\n    fromDate.getUTCMilliseconds(),\n  )\n}\n\n/**\n * If you parsed a date string that didn't include a time zone, adjust the\n * local date components into a UTC Date with the same Y/M/D/H/M/S values.\n */\nexport function datetimeToUTC(fromDate: Date): Date {\n  return new Date(Date.UTC(\n    fromDate.getFullYear(),\n    fromDate.getMonth(),\n    fromDate.getDate(),\n    fromDate.getHours(),\n    fromDate.getMinutes(),\n    fromDate.getSeconds(),\n    fromDate.getMilliseconds(),\n  ))\n}\n\n// const tsMs2000 = 946684800000   // same as Jan 11 1970 in ms\n// const tsMs2500 = 16725225600000 // same as Jul 13 1970 in ms\n//               1000000000000\n\n/**\n * Convert a timestamp in milliseconds to seconds.\n *\n * When `smart` is true the function will try to detect already-second\n * timestamps and return them unchanged (heuristic threshold). For example,\n * small numbers (< 1e12) are likely seconds and are returned as-is.\n *\n * @param ts - timestamp in milliseconds or seconds\n * @param smart - enable heuristic detection (default: true)\n * @returns timestamp in seconds\n */\nexport function timestampMillisecondsToSeconds(ts: number, smart = true): number {\n  if (ts <= 0)\n    return 0\n  if (smart && ts < 1000000000000) { // TODO find a better threshold and add tests\n    return ts\n    // log.warn('Timestamp might already be in seconds?', ts)\n  }\n  return Math.floor(ts / 1000)\n}\n\n/**\n * Convert a timestamp in seconds to milliseconds.\n *\n * When `smart` is true the function tries to detect already-millisecond\n * values and returns them unchanged (heuristic threshold). Very large\n * numbers (> 1e12) are assumed to already be milliseconds.\n *\n * @param ts - timestamp in seconds or milliseconds\n * @param smart - enable heuristic detection (default: true)\n * @returns timestamp in milliseconds\n */\nexport function timestampSecondsToMilliseconds(ts: number, smart = true): number {\n  if (ts <= 0)\n    return 0\n  if (smart && ts > 1000000000000) { // TODO find a better threshold and add tests\n    return ts\n    // log.warn('Timestamp might already be in milliseconds?', ts)\n  }\n  return Math.floor(ts * 1000)\n}\n\n/** Number of milliseconds in (approx.) one year (365 days). */\nexport const TIME_YEAR_MS = 31536000000 // 365 * 24 * 60 * 60 * 1000\n/** Number of seconds in (approx.) one year (365 days). */\nexport const TIME_YEAR_S = 31536000 // 365 * 24 * 60 * 60\n/** Number of milliseconds in (approx.) one month (30 days). */\nexport const TIME_MONTH_MS = 2592000000 // 30 * 24 * 60 * 60 * 1000\n/** Number of seconds in (approx.) one month (30 days). */\nexport const TIME_MONTH_S = 2592000 // 30 * 24 * 60 * 60\n/** Number of milliseconds in one week (7 days). */\nexport const TIME_WEEK_MS = 604800000 // 7 * 24 * 60 * 60 * 1000\n/** Number of seconds in one week (7 days). */\nexport const TIME_WEEK_S = 604800 // 7 * 24 * 60 * 60\n/** Number of milliseconds in one day (24 hours). */\nexport const TIME_DAY_MS = 86400000 // 24 * 60 * 60 * 1000\n/** Number of seconds in one day (24 hours). */\nexport const TIME_DAY_S = 86400 // 24 * 60 * 60\n/** Number of milliseconds in one hour (60 minutes). */\nexport const TIME_HOUR_MS = 3600000 // 60 * 60 * 1000\n/** Number of seconds in one hour (60 minutes). */\nexport const TIME_HOUR_S = 3600 // 60 * 60\n/** Number of milliseconds in one minute (60 seconds). */\nexport const TIME_MINUTE_MS = 60000 // 60 * 1000\n/** Number of seconds in one minute (60 seconds). */\nexport const TIME_MINUTE_S = 60 // 60\n\n// BUILD NUMBER\n\nconst buildNumberSeconds = 5\nconst buildNumberPadding = 6\nconst buildStartSeconds = 1735686000 // 2025-01-01\n\n/** Build number is minutes since 2025-01-01 in base32 \"agnoster\" encoded format */\nexport function getBuildNumber(): string {\n  const buildNumber = Math.floor((getTimestampInSeconds() - buildStartSeconds) / buildNumberSeconds)\n  return numberToBase32(buildNumber, buildNumberPadding)\n}\n\nexport function getSecondsFromBuildNumber(buildNumber: string): number {\n  return buildStartSeconds + (base32ToNumber(buildNumber) * buildNumberSeconds)\n}\n"],"mappings":"sGAEA,IAAI,EAUJ,SAAgB,EAAiB,EAAK,KAAK,IAAI,IAAM,EAAG,EAAG,EAAG,EAAG,EAAG,EAAE,CAAE,CACtE,EAAe,EAWjB,SAAgB,GAAuB,CACrC,OAAO,GAAgB,KAAK,KAAK,CAWnC,SAAgB,GAAgC,CAC9C,OAAO,KAAK,MAAM,GAAc,CAAG,IAAK,CAS1C,SAAgB,EAAgB,EAAkB,CAChD,OAAO,IAAI,KAAK,EAAK,IAAK,CAc5B,SAAgB,EAAmB,EAAoB,CACrD,OAAO,EAAK,IAAM,IAAI,EAAK,KAAM,QAAQ,EAAE,CAAC,IAAM,GAAG,EAAG,QAAQ,EAAE,CAAC,KASrE,SAAgB,EACd,GAAG,EACe,CAClB,IAAK,IAAM,KAAiB,EAAgB,CAC1C,GAAI,aAAyB,KAC3B,OAAO,EAET,GAAI,OAAO,GAAkB,SAAU,CACrC,IAAI,EAAO,KACX,GAAI,EAAc,SAAS,IAAI,CAC7B,GAAI,CACF,EAAO,IAAI,KAAK,EAAc,MAEpB,EAEd,GAAI,EAAE,aAAgB,MAAO,CAC3B,IAAM,EAAI,2BAA2B,KAAK,EAAc,CACpD,IACF,EAAO,IAAI,KAAK,CAAC,EAAE,GAAK,EAAE,GAAK,EAAG,CAAC,EAAE,GAAI,GAAI,EAAE,EAEnD,GAAI,aAAgB,KAClB,OAAO,IAaf,SAAgB,GAAkC,CAChD,OAAO,OAAO,YAAgB,IAAc,YAAY,KAAK,CAAG,KAAK,KAAK,CAc5E,SAAgB,GAAyB,CACvC,IAAM,EAAK,GAAyB,CAEpC,OAAO,UAAoB,CAEzB,OAAO,EADU,GAAyB,CAAG,EACV,EAuBvC,SAAgB,EAAgB,EAAsB,CACpD,OAAO,IAAI,KACT,EAAS,gBAAgB,CACzB,EAAS,aAAa,CACtB,EAAS,YAAY,CACrB,EAAS,aAAa,CACtB,EAAS,eAAe,CACxB,EAAS,eAAe,CACxB,EAAS,oBAAoB,CAC9B,CAOH,SAAgB,EAAc,EAAsB,CAClD,OAAO,IAAI,KAAK,KAAK,IACnB,EAAS,aAAa,CACtB,EAAS,UAAU,CACnB,EAAS,SAAS,CAClB,EAAS,UAAU,CACnB,EAAS,YAAY,CACrB,EAAS,YAAY,CACrB,EAAS,iBAAiB,CAC3B,CAAC,CAkBJ,SAAgB,EAA+B,EAAY,EAAQ,GAAc,CAO/E,OANI,GAAM,EACD,EACL,GAAS,EAAK,aACT,EAGF,KAAK,MAAM,EAAK,IAAK,CAc9B,SAAgB,EAA+B,EAAY,EAAQ,GAAc,CAO/E,OANI,GAAM,EACD,EACL,GAAS,EAAK,aACT,EAGF,KAAK,MAAM,EAAK,IAAK,CAI9B,MA4BM,EAAoB,UAG1B,SAAgB,GAAyB,CAEvC,OAAOA,EAAAA,eADa,KAAK,OAAO,GAAuB,CAAG,GAAqB,EAAmB,CAC/D,EAAmB,CAGxD,SAAgB,EAA0B,EAA6B,CACrE,OAAO,EAAqBC,EAAAA,eAAe,EAAY,CAAG"}
+{"version":3,"file":"time.cjs","names":["numberToBase32","base32ToNumber"],"sources":["../../src/common/time.ts"],"sourcesContent":["import { base32ToNumber, numberToBase32 } from './data/math'\n\nlet testModeTime: number | undefined\n\n/**\n * Set a fixed timestamp (ms since epoch) used by `getTimestamp` for tests.\n *\n * Pass a millisecond timestamp (for example created with Date.UTC) to force\n * time-based helpers to return deterministic values during tests.\n *\n * @param ts - timestamp in milliseconds (defaults to 2000-01-01T00:00:00.000Z)\n */\nexport function setTimestampTest(ts = Date.UTC(2000, 0, 1, 0, 0, 0, 0)) {\n  testModeTime = ts\n}\n\n/**\n * Return the current timestamp in milliseconds.\n *\n * In test mode (when `setTimestampTest` was called) the forced value is\n * returned instead of the real current time.\n *\n * @returns timestamp in milliseconds\n */\nexport function getTimestamp(): number {\n  return testModeTime ?? Date.now()\n}\n\n/**\n * Return the current timestamp in seconds.\n *\n * Uses `getTimestamp()` which can be overridden for tests with\n * `setTimestampTest`.\n *\n * @returns timestamp in whole seconds (integer)\n */\nexport function getTimestampInSeconds(): number {\n  return Math.floor(getTimestamp() / 1000)\n}\n\n/**\n * Convert a UNIX timestamp in seconds to a JavaScript Date.\n *\n * @param ts - seconds since epoch\n * @returns Date instance corresponding to the provided seconds\n */\nexport function dateFromSeconds(ts: number): Date {\n  return new Date(ts * 1000)\n}\n\n// typeof performance !== \"undefined\" ? performance.now() : new Date().getTime()\n\n/**\n * Format a millisecond duration into a human readable string.\n *\n * - Values >= 1000ms are shown in seconds with one decimal (e.g. \"1.2 s\").\n * - Smaller values are shown in milliseconds with two decimals (e.g. \"123.45 ms\").\n *\n * @param ms - duration in milliseconds\n * @returns formatted duration string\n */\nexport function formatMilliseconds(ms: number): string {\n  return ms > 999 ? `${(ms / 1000).toFixed(1)} s` : `${ms.toFixed(2)} ms`\n}\n\n/**\n * Parses the given date candidates and returns the first valid Date object found.\n *\n * @param dateCandidates - The date candidates to parse, which can be either strings or Date objects.\n * @returns The parsed Date object, or undefined if no valid date is found.\n */\nexport function parseDate(\n  ...dateCandidates: (string | Date)[]\n): Date | undefined {\n  for (const dateCandidate of dateCandidates) {\n    if (dateCandidate instanceof Date)\n      return dateCandidate\n\n    if (typeof dateCandidate === 'string') {\n      let date = null\n      if (dateCandidate.includes(':')) {\n        try {\n          date = new Date(dateCandidate)\n        }\n        catch (err) {}\n      }\n      if (!(date instanceof Date)) {\n        const m = /(\\d\\d\\d\\d)-(\\d\\d)-(\\d\\d)/.exec(dateCandidate)\n        if (m)\n          date = new Date(+m[1], +m[2] - 1, +m[3], 12, 0)\n      }\n      if (date instanceof Date)\n        return date\n    }\n  }\n}\n\n/**\n * Return a high-resolution timestamp in milliseconds.\n *\n * Uses the `performance.now()` clock when available (monotonic, high\n * resolution), otherwise falls back to `Date.now()`.\n *\n * @returns timestamp in milliseconds (relative for performance.now, epoch for Date.now)\n */\nexport function getPerformanceTimestamp(): number {\n  return typeof performance !== 'undefined' ? performance.now() : Date.now()\n}\n\n/**\n * Create a simple duration reporter.\n *\n * Returns a function that, when called, reports the elapsed time since\n * `duration()` was called. The returned string is formatted via\n * `formatMilliseconds`.\n *\n * Example: const t = duration(); // do work...; console.log(t());\n *\n * @returns a zero-argument function that returns the elapsed time string\n */\nexport function duration(): () => string {\n  const t0 = getPerformanceTimestamp()\n\n  return function (): string {\n    const duration = getPerformanceTimestamp() - t0\n    return formatMilliseconds(duration)\n\n    // if (duration > 500)\n    //   return `${(duration / 1000).toFixed(4)}s`\n\n    // // https://elijahmanor.com/format-js-numbers\n    // // https://tc39.es/proposal-unified-intl-numberformat/section6/locales-currencies-tz_proposed_out.html#sec-issanctionedsimpleunitidentifier\n    // return duration.toLocaleString('en-US', {\n    //   style: 'unit',\n    //   unit: 'millisecond',\n    //   notation: 'compact',\n    //   compactDisplay: 'long',\n    // })\n  }\n}\n\n/**\n * If you parsed a date string that didn't include a time zone, adjust the\n * naive UTC components into a local Date with the same Y/M/D/H/M/S values.\n *\n * This effectively treats the input as if it already represented local time\n * and builds a corresponding Date using the local timezone.\n */\nexport function datetimeToLocal(fromDate: Date): Date {\n  return new Date(\n    fromDate.getUTCFullYear(),\n    fromDate.getUTCMonth(),\n    fromDate.getUTCDate(),\n    fromDate.getUTCHours(),\n    fromDate.getUTCMinutes(),\n    fromDate.getUTCSeconds(),\n    fromDate.getUTCMilliseconds(),\n  )\n}\n\n/**\n * If you parsed a date string that didn't include a time zone, adjust the\n * local date components into a UTC Date with the same Y/M/D/H/M/S values.\n */\nexport function datetimeToUTC(fromDate: Date): Date {\n  return new Date(Date.UTC(\n    fromDate.getFullYear(),\n    fromDate.getMonth(),\n    fromDate.getDate(),\n    fromDate.getHours(),\n    fromDate.getMinutes(),\n    fromDate.getSeconds(),\n    fromDate.getMilliseconds(),\n  ))\n}\n\n// const tsMs2000 = 946684800000   // same as Jan 11 1970 in ms\n// const tsMs2500 = 16725225600000 // same as Jul 13 1970 in ms\n//               1000000000000\n\n/**\n * Convert a timestamp in milliseconds to seconds.\n *\n * When `smart` is true the function will try to detect already-second\n * timestamps and return them unchanged (heuristic threshold). For example,\n * small numbers (< 1e12) are likely seconds and are returned as-is.\n *\n * @param ts - timestamp in milliseconds or seconds\n * @param smart - enable heuristic detection (default: true)\n * @returns timestamp in seconds\n */\nexport function timestampMillisecondsToSeconds(ts: number, smart = true): number {\n  if (ts <= 0)\n    return 0\n  if (smart && ts < 1000000000000) { // TODO find a better threshold and add tests\n    return ts\n    // log.warn('Timestamp might already be in seconds?', ts)\n  }\n  return Math.floor(ts / 1000)\n}\n\n/**\n * Convert a timestamp in seconds to milliseconds.\n *\n * When `smart` is true the function tries to detect already-millisecond\n * values and returns them unchanged (heuristic threshold). Very large\n * numbers (> 1e12) are assumed to already be milliseconds.\n *\n * @param ts - timestamp in seconds or milliseconds\n * @param smart - enable heuristic detection (default: true)\n * @returns timestamp in milliseconds\n */\nexport function timestampSecondsToMilliseconds(ts: number, smart = true): number {\n  if (ts <= 0)\n    return 0\n  if (smart && ts > 1000000000000) { // TODO find a better threshold and add tests\n    return ts\n    // log.warn('Timestamp might already be in milliseconds?', ts)\n  }\n  return Math.floor(ts * 1000)\n}\n\n/** Number of milliseconds in (approx.) one year (365 days). */\nexport const TIME_YEAR_MS = 31536000000 // 365 * 24 * 60 * 60 * 1000\n/** Number of seconds in (approx.) one year (365 days). */\nexport const TIME_YEAR_S = 31536000 // 365 * 24 * 60 * 60\n/** Number of milliseconds in (approx.) one month (30 days). */\nexport const TIME_MONTH_MS = 2592000000 // 30 * 24 * 60 * 60 * 1000\n/** Number of seconds in (approx.) one month (30 days). */\nexport const TIME_MONTH_S = 2592000 // 30 * 24 * 60 * 60\n/** Number of milliseconds in one week (7 days). */\nexport const TIME_WEEK_MS = 604800000 // 7 * 24 * 60 * 60 * 1000\n/** Number of seconds in one week (7 days). */\nexport const TIME_WEEK_S = 604800 // 7 * 24 * 60 * 60\n/** Number of milliseconds in one day (24 hours). */\nexport const TIME_DAY_MS = 86400000 // 24 * 60 * 60 * 1000\n/** Number of seconds in one day (24 hours). */\nexport const TIME_DAY_S = 86400 // 24 * 60 * 60\n/** Number of milliseconds in one hour (60 minutes). */\nexport const TIME_HOUR_MS = 3600000 // 60 * 60 * 1000\n/** Number of seconds in one hour (60 minutes). */\nexport const TIME_HOUR_S = 3600 // 60 * 60\n/** Number of milliseconds in one minute (60 seconds). */\nexport const TIME_MINUTE_MS = 60000 // 60 * 1000\n/** Number of seconds in one minute (60 seconds). */\nexport const TIME_MINUTE_S = 60 // 60\n\n// BUILD NUMBER\n\nconst buildNumberSeconds = 5\nconst buildNumberPadding = 6\nconst buildStartSeconds = 1735686000 // 2025-01-01\n\n/** Build number is minutes since 2025-01-01 in base32 \"agnoster\" encoded format */\nexport function getBuildNumber(): string {\n  const buildNumber = Math.floor((getTimestampInSeconds() - buildStartSeconds) / buildNumberSeconds)\n  return numberToBase32(buildNumber, buildNumberPadding)\n}\n\nexport function getSecondsFromBuildNumber(buildNumber: string): number {\n  return buildStartSeconds + (base32ToNumber(buildNumber) * buildNumberSeconds)\n}\n"],"mappings":"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"}

package/dist/common/time.mjs

@@ -1,2 +1,195 @@
-import{base32ToNumber as e,numberToBase32 as t}from"./data/math.mjs";let n;function r(e=Date.UTC(2e3,0,1,0,0,0,0)){n=e}function i(){return n??Date.now()}function a(){return Math.floor(i()/1e3)}function o(e){return new Date(e*1e3)}function s(e){return e>999?`${(e/1e3).toFixed(1)} s`:`${e.toFixed(2)} ms`}function c(...e){for(let t of e){if(t instanceof Date)return t;if(typeof t==`string`){let e=null;if(t.includes(`:`))try{e=new Date(t)}catch{}if(!(e instanceof Date)){let n=/(\d\d\d\d)-(\d\d)-(\d\d)/.exec(t);n&&(e=new Date(+n[1],n[2]-1,+n[3],12,0))}if(e instanceof Date)return e}}}function l(){return typeof performance<`u`?performance.now():Date.now()}function u(){let e=l();return function(){return s(l()-e)}}function d(e){return new Date(e.getUTCFullYear(),e.getUTCMonth(),e.getUTCDate(),e.getUTCHours(),e.getUTCMinutes(),e.getUTCSeconds(),e.getUTCMilliseconds())}function f(e){return new Date(Date.UTC(e.getFullYear(),e.getMonth(),e.getDate(),e.getHours(),e.getMinutes(),e.getSeconds(),e.getMilliseconds()))}function p(e,t=!0){return e<=0?0:t&&e<0xe8d4a51000?e:Math.floor(e/1e3)}function m(e,t=!0){return e<=0?0:t&&e>0xe8d4a51000?e:Math.floor(e*1e3)}const h=31536e6,g=31536e3,_=2592e6,v=2592e3,y=6048e5,b=604800,x=864e5,S=86400,C=36e5,w=3600,T=6e4,E=60,D=1735686e3;function O(){return t(Math.floor((a()-D)/5),6)}function k(t){return D+e(t)*5}export{x as TIME_DAY_MS,S as TIME_DAY_S,C as TIME_HOUR_MS,w as TIME_HOUR_S,T as TIME_MINUTE_MS,E as TIME_MINUTE_S,_ as TIME_MONTH_MS,v as TIME_MONTH_S,y as TIME_WEEK_MS,b as TIME_WEEK_S,h as TIME_YEAR_MS,g as TIME_YEAR_S,o as dateFromSeconds,d as datetimeToLocal,f as datetimeToUTC,u as duration,s as formatMilliseconds,O as getBuildNumber,l as getPerformanceTimestamp,k as getSecondsFromBuildNumber,i as getTimestamp,a as getTimestampInSeconds,c as parseDate,r as setTimestampTest,p as timestampMillisecondsToSeconds,m as timestampSecondsToMilliseconds};
+import { base32ToNumber, numberToBase32 } from "./data/math.mjs";
+
+//#region src/common/time.ts
+let testModeTime;
+/**
+* Set a fixed timestamp (ms since epoch) used by `getTimestamp` for tests.
+*
+* Pass a millisecond timestamp (for example created with Date.UTC) to force
+* time-based helpers to return deterministic values during tests.
+*
+* @param ts - timestamp in milliseconds (defaults to 2000-01-01T00:00:00.000Z)
+*/
+function setTimestampTest(ts = Date.UTC(2e3, 0, 1, 0, 0, 0, 0)) {
+	testModeTime = ts;
+}
+/**
+* Return the current timestamp in milliseconds.
+*
+* In test mode (when `setTimestampTest` was called) the forced value is
+* returned instead of the real current time.
+*
+* @returns timestamp in milliseconds
+*/
+function getTimestamp() {
+	return testModeTime ?? Date.now();
+}
+/**
+* Return the current timestamp in seconds.
+*
+* Uses `getTimestamp()` which can be overridden for tests with
+* `setTimestampTest`.
+*
+* @returns timestamp in whole seconds (integer)
+*/
+function getTimestampInSeconds() {
+	return Math.floor(getTimestamp() / 1e3);
+}
+/**
+* Convert a UNIX timestamp in seconds to a JavaScript Date.
+*
+* @param ts - seconds since epoch
+* @returns Date instance corresponding to the provided seconds
+*/
+function dateFromSeconds(ts) {
+	return /* @__PURE__ */ new Date(ts * 1e3);
+}
+/**
+* Format a millisecond duration into a human readable string.
+*
+* - Values >= 1000ms are shown in seconds with one decimal (e.g. "1.2 s").
+* - Smaller values are shown in milliseconds with two decimals (e.g. "123.45 ms").
+*
+* @param ms - duration in milliseconds
+* @returns formatted duration string
+*/
+function formatMilliseconds(ms) {
+	return ms > 999 ? `${(ms / 1e3).toFixed(1)} s` : `${ms.toFixed(2)} ms`;
+}
+/**
+* Parses the given date candidates and returns the first valid Date object found.
+*
+* @param dateCandidates - The date candidates to parse, which can be either strings or Date objects.
+* @returns The parsed Date object, or undefined if no valid date is found.
+*/
+function parseDate(...dateCandidates) {
+	for (const dateCandidate of dateCandidates) {
+		if (dateCandidate instanceof Date) return dateCandidate;
+		if (typeof dateCandidate === "string") {
+			let date = null;
+			if (dateCandidate.includes(":")) try {
+				date = new Date(dateCandidate);
+			} catch (err) {}
+			if (!(date instanceof Date)) {
+				const m = /(\d\d\d\d)-(\d\d)-(\d\d)/.exec(dateCandidate);
+				if (m) date = new Date(+m[1], +m[2] - 1, +m[3], 12, 0);
+			}
+			if (date instanceof Date) return date;
+		}
+	}
+}
+/**
+* Return a high-resolution timestamp in milliseconds.
+*
+* Uses the `performance.now()` clock when available (monotonic, high
+* resolution), otherwise falls back to `Date.now()`.
+*
+* @returns timestamp in milliseconds (relative for performance.now, epoch for Date.now)
+*/
+function getPerformanceTimestamp() {
+	return typeof performance !== "undefined" ? performance.now() : Date.now();
+}
+/**
+* Create a simple duration reporter.
+*
+* Returns a function that, when called, reports the elapsed time since
+* `duration()` was called. The returned string is formatted via
+* `formatMilliseconds`.
+*
+* Example: const t = duration(); // do work...; console.log(t());
+*
+* @returns a zero-argument function that returns the elapsed time string
+*/
+function duration() {
+	const t0 = getPerformanceTimestamp();
+	return function() {
+		return formatMilliseconds(getPerformanceTimestamp() - t0);
+	};
+}
+/**
+* If you parsed a date string that didn't include a time zone, adjust the
+* naive UTC components into a local Date with the same Y/M/D/H/M/S values.
+*
+* This effectively treats the input as if it already represented local time
+* and builds a corresponding Date using the local timezone.
+*/
+function datetimeToLocal(fromDate) {
+	return new Date(fromDate.getUTCFullYear(), fromDate.getUTCMonth(), fromDate.getUTCDate(), fromDate.getUTCHours(), fromDate.getUTCMinutes(), fromDate.getUTCSeconds(), fromDate.getUTCMilliseconds());
+}
+/**
+* If you parsed a date string that didn't include a time zone, adjust the
+* local date components into a UTC Date with the same Y/M/D/H/M/S values.
+*/
+function datetimeToUTC(fromDate) {
+	return new Date(Date.UTC(fromDate.getFullYear(), fromDate.getMonth(), fromDate.getDate(), fromDate.getHours(), fromDate.getMinutes(), fromDate.getSeconds(), fromDate.getMilliseconds()));
+}
+/**
+* Convert a timestamp in milliseconds to seconds.
+*
+* When `smart` is true the function will try to detect already-second
+* timestamps and return them unchanged (heuristic threshold). For example,
+* small numbers (< 1e12) are likely seconds and are returned as-is.
+*
+* @param ts - timestamp in milliseconds or seconds
+* @param smart - enable heuristic detection (default: true)
+* @returns timestamp in seconds
+*/
+function timestampMillisecondsToSeconds(ts, smart = true) {
+	if (ts <= 0) return 0;
+	if (smart && ts < 0xe8d4a51000) return ts;
+	return Math.floor(ts / 1e3);
+}
+/**
+* Convert a timestamp in seconds to milliseconds.
+*
+* When `smart` is true the function tries to detect already-millisecond
+* values and returns them unchanged (heuristic threshold). Very large
+* numbers (> 1e12) are assumed to already be milliseconds.
+*
+* @param ts - timestamp in seconds or milliseconds
+* @param smart - enable heuristic detection (default: true)
+* @returns timestamp in milliseconds
+*/
+function timestampSecondsToMilliseconds(ts, smart = true) {
+	if (ts <= 0) return 0;
+	if (smart && ts > 0xe8d4a51000) return ts;
+	return Math.floor(ts * 1e3);
+}
+/** Number of milliseconds in (approx.) one year (365 days). */
+const TIME_YEAR_MS = 31536e6;
+/** Number of seconds in (approx.) one year (365 days). */
+const TIME_YEAR_S = 31536e3;
+/** Number of milliseconds in (approx.) one month (30 days). */
+const TIME_MONTH_MS = 2592e6;
+/** Number of seconds in (approx.) one month (30 days). */
+const TIME_MONTH_S = 2592e3;
+/** Number of milliseconds in one week (7 days). */
+const TIME_WEEK_MS = 6048e5;
+/** Number of seconds in one week (7 days). */
+const TIME_WEEK_S = 604800;
+/** Number of milliseconds in one day (24 hours). */
+const TIME_DAY_MS = 864e5;
+/** Number of seconds in one day (24 hours). */
+const TIME_DAY_S = 86400;
+/** Number of milliseconds in one hour (60 minutes). */
+const TIME_HOUR_MS = 36e5;
+/** Number of seconds in one hour (60 minutes). */
+const TIME_HOUR_S = 3600;
+/** Number of milliseconds in one minute (60 seconds). */
+const TIME_MINUTE_MS = 6e4;
+/** Number of seconds in one minute (60 seconds). */
+const TIME_MINUTE_S = 60;
+const buildNumberSeconds = 5;
+const buildNumberPadding = 6;
+const buildStartSeconds = 1735686e3;
+/** Build number is minutes since 2025-01-01 in base32 "agnoster" encoded format */
+function getBuildNumber() {
+	return numberToBase32(Math.floor((getTimestampInSeconds() - buildStartSeconds) / buildNumberSeconds), buildNumberPadding);
+}
+function getSecondsFromBuildNumber(buildNumber) {
+	return buildStartSeconds + base32ToNumber(buildNumber) * buildNumberSeconds;
+}
+
+//#endregion
+export { TIME_DAY_MS, TIME_DAY_S, TIME_HOUR_MS, TIME_HOUR_S, TIME_MINUTE_MS, TIME_MINUTE_S, TIME_MONTH_MS, TIME_MONTH_S, TIME_WEEK_MS, TIME_WEEK_S, TIME_YEAR_MS, TIME_YEAR_S, dateFromSeconds, datetimeToLocal, datetimeToUTC, duration, formatMilliseconds, getBuildNumber, getPerformanceTimestamp, getSecondsFromBuildNumber, getTimestamp, getTimestampInSeconds, parseDate, setTimestampTest, timestampMillisecondsToSeconds, timestampSecondsToMilliseconds };
 //# sourceMappingURL=time.mjs.map

package/dist/common/time.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"time.mjs","names":[],"sources":["../../src/common/time.ts"],"sourcesContent":["import { base32ToNumber, numberToBase32 } from './data/math'\n\nlet testModeTime: number | undefined\n\n/**\n * Set a fixed timestamp (ms since epoch) used by `getTimestamp` for tests.\n *\n * Pass a millisecond timestamp (for example created with Date.UTC) to force\n * time-based helpers to return deterministic values during tests.\n *\n * @param ts - timestamp in milliseconds (defaults to 2000-01-01T00:00:00.000Z)\n */\nexport function setTimestampTest(ts = Date.UTC(2000, 0, 1, 0, 0, 0, 0)) {\n  testModeTime = ts\n}\n\n/**\n * Return the current timestamp in milliseconds.\n *\n * In test mode (when `setTimestampTest` was called) the forced value is\n * returned instead of the real current time.\n *\n * @returns timestamp in milliseconds\n */\nexport function getTimestamp(): number {\n  return testModeTime ?? Date.now()\n}\n\n/**\n * Return the current timestamp in seconds.\n *\n * Uses `getTimestamp()` which can be overridden for tests with\n * `setTimestampTest`.\n *\n * @returns timestamp in whole seconds (integer)\n */\nexport function getTimestampInSeconds(): number {\n  return Math.floor(getTimestamp() / 1000)\n}\n\n/**\n * Convert a UNIX timestamp in seconds to a JavaScript Date.\n *\n * @param ts - seconds since epoch\n * @returns Date instance corresponding to the provided seconds\n */\nexport function dateFromSeconds(ts: number): Date {\n  return new Date(ts * 1000)\n}\n\n// typeof performance !== \"undefined\" ? performance.now() : new Date().getTime()\n\n/**\n * Format a millisecond duration into a human readable string.\n *\n * - Values >= 1000ms are shown in seconds with one decimal (e.g. \"1.2 s\").\n * - Smaller values are shown in milliseconds with two decimals (e.g. \"123.45 ms\").\n *\n * @param ms - duration in milliseconds\n * @returns formatted duration string\n */\nexport function formatMilliseconds(ms: number): string {\n  return ms > 999 ? `${(ms / 1000).toFixed(1)} s` : `${ms.toFixed(2)} ms`\n}\n\n/**\n * Parses the given date candidates and returns the first valid Date object found.\n *\n * @param dateCandidates - The date candidates to parse, which can be either strings or Date objects.\n * @returns The parsed Date object, or undefined if no valid date is found.\n */\nexport function parseDate(\n  ...dateCandidates: (string | Date)[]\n): Date | undefined {\n  for (const dateCandidate of dateCandidates) {\n    if (dateCandidate instanceof Date)\n      return dateCandidate\n\n    if (typeof dateCandidate === 'string') {\n      let date = null\n      if (dateCandidate.includes(':')) {\n        try {\n          date = new Date(dateCandidate)\n        }\n        catch (err) {}\n      }\n      if (!(date instanceof Date)) {\n        const m = /(\\d\\d\\d\\d)-(\\d\\d)-(\\d\\d)/.exec(dateCandidate)\n        if (m)\n          date = new Date(+m[1], +m[2] - 1, +m[3], 12, 0)\n      }\n      if (date instanceof Date)\n        return date\n    }\n  }\n}\n\n/**\n * Return a high-resolution timestamp in milliseconds.\n *\n * Uses the `performance.now()` clock when available (monotonic, high\n * resolution), otherwise falls back to `Date.now()`.\n *\n * @returns timestamp in milliseconds (relative for performance.now, epoch for Date.now)\n */\nexport function getPerformanceTimestamp(): number {\n  return typeof performance !== 'undefined' ? performance.now() : Date.now()\n}\n\n/**\n * Create a simple duration reporter.\n *\n * Returns a function that, when called, reports the elapsed time since\n * `duration()` was called. The returned string is formatted via\n * `formatMilliseconds`.\n *\n * Example: const t = duration(); // do work...; console.log(t());\n *\n * @returns a zero-argument function that returns the elapsed time string\n */\nexport function duration(): () => string {\n  const t0 = getPerformanceTimestamp()\n\n  return function (): string {\n    const duration = getPerformanceTimestamp() - t0\n    return formatMilliseconds(duration)\n\n    // if (duration > 500)\n    //   return `${(duration / 1000).toFixed(4)}s`\n\n    // // https://elijahmanor.com/format-js-numbers\n    // // https://tc39.es/proposal-unified-intl-numberformat/section6/locales-currencies-tz_proposed_out.html#sec-issanctionedsimpleunitidentifier\n    // return duration.toLocaleString('en-US', {\n    //   style: 'unit',\n    //   unit: 'millisecond',\n    //   notation: 'compact',\n    //   compactDisplay: 'long',\n    // })\n  }\n}\n\n/**\n * If you parsed a date string that didn't include a time zone, adjust the\n * naive UTC components into a local Date with the same Y/M/D/H/M/S values.\n *\n * This effectively treats the input as if it already represented local time\n * and builds a corresponding Date using the local timezone.\n */\nexport function datetimeToLocal(fromDate: Date): Date {\n  return new Date(\n    fromDate.getUTCFullYear(),\n    fromDate.getUTCMonth(),\n    fromDate.getUTCDate(),\n    fromDate.getUTCHours(),\n    fromDate.getUTCMinutes(),\n    fromDate.getUTCSeconds(),\n    fromDate.getUTCMilliseconds(),\n  )\n}\n\n/**\n * If you parsed a date string that didn't include a time zone, adjust the\n * local date components into a UTC Date with the same Y/M/D/H/M/S values.\n */\nexport function datetimeToUTC(fromDate: Date): Date {\n  return new Date(Date.UTC(\n    fromDate.getFullYear(),\n    fromDate.getMonth(),\n    fromDate.getDate(),\n    fromDate.getHours(),\n    fromDate.getMinutes(),\n    fromDate.getSeconds(),\n    fromDate.getMilliseconds(),\n  ))\n}\n\n// const tsMs2000 = 946684800000   // same as Jan 11 1970 in ms\n// const tsMs2500 = 16725225600000 // same as Jul 13 1970 in ms\n//               1000000000000\n\n/**\n * Convert a timestamp in milliseconds to seconds.\n *\n * When `smart` is true the function will try to detect already-second\n * timestamps and return them unchanged (heuristic threshold). For example,\n * small numbers (< 1e12) are likely seconds and are returned as-is.\n *\n * @param ts - timestamp in milliseconds or seconds\n * @param smart - enable heuristic detection (default: true)\n * @returns timestamp in seconds\n */\nexport function timestampMillisecondsToSeconds(ts: number, smart = true): number {\n  if (ts <= 0)\n    return 0\n  if (smart && ts < 1000000000000) { // TODO find a better threshold and add tests\n    return ts\n    // log.warn('Timestamp might already be in seconds?', ts)\n  }\n  return Math.floor(ts / 1000)\n}\n\n/**\n * Convert a timestamp in seconds to milliseconds.\n *\n * When `smart` is true the function tries to detect already-millisecond\n * values and returns them unchanged (heuristic threshold). Very large\n * numbers (> 1e12) are assumed to already be milliseconds.\n *\n * @param ts - timestamp in seconds or milliseconds\n * @param smart - enable heuristic detection (default: true)\n * @returns timestamp in milliseconds\n */\nexport function timestampSecondsToMilliseconds(ts: number, smart = true): number {\n  if (ts <= 0)\n    return 0\n  if (smart && ts > 1000000000000) { // TODO find a better threshold and add tests\n    return ts\n    // log.warn('Timestamp might already be in milliseconds?', ts)\n  }\n  return Math.floor(ts * 1000)\n}\n\n/** Number of milliseconds in (approx.) one year (365 days). */\nexport const TIME_YEAR_MS = 31536000000 // 365 * 24 * 60 * 60 * 1000\n/** Number of seconds in (approx.) one year (365 days). */\nexport const TIME_YEAR_S = 31536000 // 365 * 24 * 60 * 60\n/** Number of milliseconds in (approx.) one month (30 days). */\nexport const TIME_MONTH_MS = 2592000000 // 30 * 24 * 60 * 60 * 1000\n/** Number of seconds in (approx.) one month (30 days). */\nexport const TIME_MONTH_S = 2592000 // 30 * 24 * 60 * 60\n/** Number of milliseconds in one week (7 days). */\nexport const TIME_WEEK_MS = 604800000 // 7 * 24 * 60 * 60 * 1000\n/** Number of seconds in one week (7 days). */\nexport const TIME_WEEK_S = 604800 // 7 * 24 * 60 * 60\n/** Number of milliseconds in one day (24 hours). */\nexport const TIME_DAY_MS = 86400000 // 24 * 60 * 60 * 1000\n/** Number of seconds in one day (24 hours). */\nexport const TIME_DAY_S = 86400 // 24 * 60 * 60\n/** Number of milliseconds in one hour (60 minutes). */\nexport const TIME_HOUR_MS = 3600000 // 60 * 60 * 1000\n/** Number of seconds in one hour (60 minutes). */\nexport const TIME_HOUR_S = 3600 // 60 * 60\n/** Number of milliseconds in one minute (60 seconds). */\nexport const TIME_MINUTE_MS = 60000 // 60 * 1000\n/** Number of seconds in one minute (60 seconds). */\nexport const TIME_MINUTE_S = 60 // 60\n\n// BUILD NUMBER\n\nconst buildNumberSeconds = 5\nconst buildNumberPadding = 6\nconst buildStartSeconds = 1735686000 // 2025-01-01\n\n/** Build number is minutes since 2025-01-01 in base32 \"agnoster\" encoded format */\nexport function getBuildNumber(): string {\n  const buildNumber = Math.floor((getTimestampInSeconds() - buildStartSeconds) / buildNumberSeconds)\n  return numberToBase32(buildNumber, buildNumberPadding)\n}\n\nexport function getSecondsFromBuildNumber(buildNumber: string): number {\n  return buildStartSeconds + (base32ToNumber(buildNumber) * buildNumberSeconds)\n}\n"],"mappings":"qEAEA,IAAI,EAUJ,SAAgB,EAAiB,EAAK,KAAK,IAAI,IAAM,EAAG,EAAG,EAAG,EAAG,EAAG,EAAE,CAAE,CACtE,EAAe,EAWjB,SAAgB,GAAuB,CACrC,OAAO,GAAgB,KAAK,KAAK,CAWnC,SAAgB,GAAgC,CAC9C,OAAO,KAAK,MAAM,GAAc,CAAG,IAAK,CAS1C,SAAgB,EAAgB,EAAkB,CAChD,OAAO,IAAI,KAAK,EAAK,IAAK,CAc5B,SAAgB,EAAmB,EAAoB,CACrD,OAAO,EAAK,IAAM,IAAI,EAAK,KAAM,QAAQ,EAAE,CAAC,IAAM,GAAG,EAAG,QAAQ,EAAE,CAAC,KASrE,SAAgB,EACd,GAAG,EACe,CAClB,IAAK,IAAM,KAAiB,EAAgB,CAC1C,GAAI,aAAyB,KAC3B,OAAO,EAET,GAAI,OAAO,GAAkB,SAAU,CACrC,IAAI,EAAO,KACX,GAAI,EAAc,SAAS,IAAI,CAC7B,GAAI,CACF,EAAO,IAAI,KAAK,EAAc,MAEpB,EAEd,GAAI,EAAE,aAAgB,MAAO,CAC3B,IAAM,EAAI,2BAA2B,KAAK,EAAc,CACpD,IACF,EAAO,IAAI,KAAK,CAAC,EAAE,GAAK,EAAE,GAAK,EAAG,CAAC,EAAE,GAAI,GAAI,EAAE,EAEnD,GAAI,aAAgB,KAClB,OAAO,IAaf,SAAgB,GAAkC,CAChD,OAAO,OAAO,YAAgB,IAAc,YAAY,KAAK,CAAG,KAAK,KAAK,CAc5E,SAAgB,GAAyB,CACvC,IAAM,EAAK,GAAyB,CAEpC,OAAO,UAAoB,CAEzB,OAAO,EADU,GAAyB,CAAG,EACV,EAuBvC,SAAgB,EAAgB,EAAsB,CACpD,OAAO,IAAI,KACT,EAAS,gBAAgB,CACzB,EAAS,aAAa,CACtB,EAAS,YAAY,CACrB,EAAS,aAAa,CACtB,EAAS,eAAe,CACxB,EAAS,eAAe,CACxB,EAAS,oBAAoB,CAC9B,CAOH,SAAgB,EAAc,EAAsB,CAClD,OAAO,IAAI,KAAK,KAAK,IACnB,EAAS,aAAa,CACtB,EAAS,UAAU,CACnB,EAAS,SAAS,CAClB,EAAS,UAAU,CACnB,EAAS,YAAY,CACrB,EAAS,YAAY,CACrB,EAAS,iBAAiB,CAC3B,CAAC,CAkBJ,SAAgB,EAA+B,EAAY,EAAQ,GAAc,CAO/E,OANI,GAAM,EACD,EACL,GAAS,EAAK,aACT,EAGF,KAAK,MAAM,EAAK,IAAK,CAc9B,SAAgB,EAA+B,EAAY,EAAQ,GAAc,CAO/E,OANI,GAAM,EACD,EACL,GAAS,EAAK,aACT,EAGF,KAAK,MAAM,EAAK,IAAK,CAI9B,MAAa,EAAe,QAEf,EAAc,QAEd,EAAgB,OAEhB,EAAe,OAEf,EAAe,OAEf,EAAc,OAEd,EAAc,MAEd,EAAa,MAEb,EAAe,KAEf,EAAc,KAEd,EAAiB,IAEjB,EAAgB,GAMvB,EAAoB,UAG1B,SAAgB,GAAyB,CAEvC,OAAO,EADa,KAAK,OAAO,GAAuB,CAAG,GAAqB,EAAmB,CAC/D,EAAmB,CAGxD,SAAgB,EAA0B,EAA6B,CACrE,OAAO,EAAqB,EAAe,EAAY,CAAG"}
+{"version":3,"file":"time.mjs","names":[],"sources":["../../src/common/time.ts"],"sourcesContent":["import { base32ToNumber, numberToBase32 } from './data/math'\n\nlet testModeTime: number | undefined\n\n/**\n * Set a fixed timestamp (ms since epoch) used by `getTimestamp` for tests.\n *\n * Pass a millisecond timestamp (for example created with Date.UTC) to force\n * time-based helpers to return deterministic values during tests.\n *\n * @param ts - timestamp in milliseconds (defaults to 2000-01-01T00:00:00.000Z)\n */\nexport function setTimestampTest(ts = Date.UTC(2000, 0, 1, 0, 0, 0, 0)) {\n  testModeTime = ts\n}\n\n/**\n * Return the current timestamp in milliseconds.\n *\n * In test mode (when `setTimestampTest` was called) the forced value is\n * returned instead of the real current time.\n *\n * @returns timestamp in milliseconds\n */\nexport function getTimestamp(): number {\n  return testModeTime ?? Date.now()\n}\n\n/**\n * Return the current timestamp in seconds.\n *\n * Uses `getTimestamp()` which can be overridden for tests with\n * `setTimestampTest`.\n *\n * @returns timestamp in whole seconds (integer)\n */\nexport function getTimestampInSeconds(): number {\n  return Math.floor(getTimestamp() / 1000)\n}\n\n/**\n * Convert a UNIX timestamp in seconds to a JavaScript Date.\n *\n * @param ts - seconds since epoch\n * @returns Date instance corresponding to the provided seconds\n */\nexport function dateFromSeconds(ts: number): Date {\n  return new Date(ts * 1000)\n}\n\n// typeof performance !== \"undefined\" ? performance.now() : new Date().getTime()\n\n/**\n * Format a millisecond duration into a human readable string.\n *\n * - Values >= 1000ms are shown in seconds with one decimal (e.g. \"1.2 s\").\n * - Smaller values are shown in milliseconds with two decimals (e.g. \"123.45 ms\").\n *\n * @param ms - duration in milliseconds\n * @returns formatted duration string\n */\nexport function formatMilliseconds(ms: number): string {\n  return ms > 999 ? `${(ms / 1000).toFixed(1)} s` : `${ms.toFixed(2)} ms`\n}\n\n/**\n * Parses the given date candidates and returns the first valid Date object found.\n *\n * @param dateCandidates - The date candidates to parse, which can be either strings or Date objects.\n * @returns The parsed Date object, or undefined if no valid date is found.\n */\nexport function parseDate(\n  ...dateCandidates: (string | Date)[]\n): Date | undefined {\n  for (const dateCandidate of dateCandidates) {\n    if (dateCandidate instanceof Date)\n      return dateCandidate\n\n    if (typeof dateCandidate === 'string') {\n      let date = null\n      if (dateCandidate.includes(':')) {\n        try {\n          date = new Date(dateCandidate)\n        }\n        catch (err) {}\n      }\n      if (!(date instanceof Date)) {\n        const m = /(\\d\\d\\d\\d)-(\\d\\d)-(\\d\\d)/.exec(dateCandidate)\n        if (m)\n          date = new Date(+m[1], +m[2] - 1, +m[3], 12, 0)\n      }\n      if (date instanceof Date)\n        return date\n    }\n  }\n}\n\n/**\n * Return a high-resolution timestamp in milliseconds.\n *\n * Uses the `performance.now()` clock when available (monotonic, high\n * resolution), otherwise falls back to `Date.now()`.\n *\n * @returns timestamp in milliseconds (relative for performance.now, epoch for Date.now)\n */\nexport function getPerformanceTimestamp(): number {\n  return typeof performance !== 'undefined' ? performance.now() : Date.now()\n}\n\n/**\n * Create a simple duration reporter.\n *\n * Returns a function that, when called, reports the elapsed time since\n * `duration()` was called. The returned string is formatted via\n * `formatMilliseconds`.\n *\n * Example: const t = duration(); // do work...; console.log(t());\n *\n * @returns a zero-argument function that returns the elapsed time string\n */\nexport function duration(): () => string {\n  const t0 = getPerformanceTimestamp()\n\n  return function (): string {\n    const duration = getPerformanceTimestamp() - t0\n    return formatMilliseconds(duration)\n\n    // if (duration > 500)\n    //   return `${(duration / 1000).toFixed(4)}s`\n\n    // // https://elijahmanor.com/format-js-numbers\n    // // https://tc39.es/proposal-unified-intl-numberformat/section6/locales-currencies-tz_proposed_out.html#sec-issanctionedsimpleunitidentifier\n    // return duration.toLocaleString('en-US', {\n    //   style: 'unit',\n    //   unit: 'millisecond',\n    //   notation: 'compact',\n    //   compactDisplay: 'long',\n    // })\n  }\n}\n\n/**\n * If you parsed a date string that didn't include a time zone, adjust the\n * naive UTC components into a local Date with the same Y/M/D/H/M/S values.\n *\n * This effectively treats the input as if it already represented local time\n * and builds a corresponding Date using the local timezone.\n */\nexport function datetimeToLocal(fromDate: Date): Date {\n  return new Date(\n    fromDate.getUTCFullYear(),\n    fromDate.getUTCMonth(),\n    fromDate.getUTCDate(),\n    fromDate.getUTCHours(),\n    fromDate.getUTCMinutes(),\n    fromDate.getUTCSeconds(),\n    fromDate.getUTCMilliseconds(),\n  )\n}\n\n/**\n * If you parsed a date string that didn't include a time zone, adjust the\n * local date components into a UTC Date with the same Y/M/D/H/M/S values.\n */\nexport function datetimeToUTC(fromDate: Date): Date {\n  return new Date(Date.UTC(\n    fromDate.getFullYear(),\n    fromDate.getMonth(),\n    fromDate.getDate(),\n    fromDate.getHours(),\n    fromDate.getMinutes(),\n    fromDate.getSeconds(),\n    fromDate.getMilliseconds(),\n  ))\n}\n\n// const tsMs2000 = 946684800000   // same as Jan 11 1970 in ms\n// const tsMs2500 = 16725225600000 // same as Jul 13 1970 in ms\n//               1000000000000\n\n/**\n * Convert a timestamp in milliseconds to seconds.\n *\n * When `smart` is true the function will try to detect already-second\n * timestamps and return them unchanged (heuristic threshold). For example,\n * small numbers (< 1e12) are likely seconds and are returned as-is.\n *\n * @param ts - timestamp in milliseconds or seconds\n * @param smart - enable heuristic detection (default: true)\n * @returns timestamp in seconds\n */\nexport function timestampMillisecondsToSeconds(ts: number, smart = true): number {\n  if (ts <= 0)\n    return 0\n  if (smart && ts < 1000000000000) { // TODO find a better threshold and add tests\n    return ts\n    // log.warn('Timestamp might already be in seconds?', ts)\n  }\n  return Math.floor(ts / 1000)\n}\n\n/**\n * Convert a timestamp in seconds to milliseconds.\n *\n * When `smart` is true the function tries to detect already-millisecond\n * values and returns them unchanged (heuristic threshold). Very large\n * numbers (> 1e12) are assumed to already be milliseconds.\n *\n * @param ts - timestamp in seconds or milliseconds\n * @param smart - enable heuristic detection (default: true)\n * @returns timestamp in milliseconds\n */\nexport function timestampSecondsToMilliseconds(ts: number, smart = true): number {\n  if (ts <= 0)\n    return 0\n  if (smart && ts > 1000000000000) { // TODO find a better threshold and add tests\n    return ts\n    // log.warn('Timestamp might already be in milliseconds?', ts)\n  }\n  return Math.floor(ts * 1000)\n}\n\n/** Number of milliseconds in (approx.) one year (365 days). */\nexport const TIME_YEAR_MS = 31536000000 // 365 * 24 * 60 * 60 * 1000\n/** Number of seconds in (approx.) one year (365 days). */\nexport const TIME_YEAR_S = 31536000 // 365 * 24 * 60 * 60\n/** Number of milliseconds in (approx.) one month (30 days). */\nexport const TIME_MONTH_MS = 2592000000 // 30 * 24 * 60 * 60 * 1000\n/** Number of seconds in (approx.) one month (30 days). */\nexport const TIME_MONTH_S = 2592000 // 30 * 24 * 60 * 60\n/** Number of milliseconds in one week (7 days). */\nexport const TIME_WEEK_MS = 604800000 // 7 * 24 * 60 * 60 * 1000\n/** Number of seconds in one week (7 days). */\nexport const TIME_WEEK_S = 604800 // 7 * 24 * 60 * 60\n/** Number of milliseconds in one day (24 hours). */\nexport const TIME_DAY_MS = 86400000 // 24 * 60 * 60 * 1000\n/** Number of seconds in one day (24 hours). */\nexport const TIME_DAY_S = 86400 // 24 * 60 * 60\n/** Number of milliseconds in one hour (60 minutes). */\nexport const TIME_HOUR_MS = 3600000 // 60 * 60 * 1000\n/** Number of seconds in one hour (60 minutes). */\nexport const TIME_HOUR_S = 3600 // 60 * 60\n/** Number of milliseconds in one minute (60 seconds). */\nexport const TIME_MINUTE_MS = 60000 // 60 * 1000\n/** Number of seconds in one minute (60 seconds). */\nexport const TIME_MINUTE_S = 60 // 60\n\n// BUILD NUMBER\n\nconst buildNumberSeconds = 5\nconst buildNumberPadding = 6\nconst buildStartSeconds = 1735686000 // 2025-01-01\n\n/** Build number is minutes since 2025-01-01 in base32 \"agnoster\" encoded format */\nexport function getBuildNumber(): string {\n  const buildNumber = Math.floor((getTimestampInSeconds() - buildStartSeconds) / buildNumberSeconds)\n  return numberToBase32(buildNumber, buildNumberPadding)\n}\n\nexport function getSecondsFromBuildNumber(buildNumber: string): number {\n  return buildStartSeconds + (base32ToNumber(buildNumber) * buildNumberSeconds)\n}\n"],"mappings":"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"}

package/dist/common/timeout.cjs

@@ -1,2 +1,28 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});function e(e,t=0,n=!1){let r,i=()=>{clearTimeout(r),r=void 0};return r=setTimeout(()=>{e(),i()},t),n&&r.unref?.(),i}exports.safeTimeout=e;
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/common/timeout.ts
+/**
+* Slightliy enhanced setTimeout to avoid garbage collection issues.
+* Returns a dispose function.
+*
+* Discussion see
+* https://jakearchibald.com/2024/garbage-collection-and-closures/
+* https://news.ycombinator.com/item?id=41111062
+*/
+function safeTimeout(fn, delay = 0, unref = false) {
+	let timerId;
+	const disposeTimer = () => {
+		clearTimeout(timerId);
+		timerId = void 0;
+	};
+	timerId = setTimeout(() => {
+		fn();
+		disposeTimer();
+	}, delay);
+	if (unref) timerId.unref?.();
+	return disposeTimer;
+}
+
+//#endregion
+exports.safeTimeout = safeTimeout;
 //# sourceMappingURL=timeout.cjs.map

package/dist/common/timeout.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"timeout.cjs","names":[],"sources":["../../src/common/timeout.ts"],"sourcesContent":["/**\n * Slightliy enhanced setTimeout to avoid garbage collection issues.\n * Returns a dispose function.\n *\n * Discussion see\n * https://jakearchibald.com/2024/garbage-collection-and-closures/\n * https://news.ycombinator.com/item?id=41111062\n */\nexport function safeTimeout(fn: () => void, delay = 0, unref = false): () => void {\n  let timerId: any\n\n  const disposeTimer = () => {\n    clearTimeout(timerId)\n    timerId = undefined\n  }\n\n  timerId = setTimeout(() => {\n    fn()\n    disposeTimer()\n  }, delay)\n\n  if (unref)\n    timerId.unref?.()\n\n  return disposeTimer\n}\n"],"mappings":"mEAQA,SAAgB,EAAY,EAAgB,EAAQ,EAAG,EAAQ,GAAmB,CAChF,IAAI,EAEE,MAAqB,CACzB,aAAa,EAAQ,CACrB,EAAU,IAAA,IAWZ,MARA,GAAU,eAAiB,CACzB,GAAI,CACJ,GAAc,EACb,EAAM,CAEL,GACF,EAAQ,SAAS,CAEZ"}
+{"version":3,"file":"timeout.cjs","names":[],"sources":["../../src/common/timeout.ts"],"sourcesContent":["/**\n * Slightliy enhanced setTimeout to avoid garbage collection issues.\n * Returns a dispose function.\n *\n * Discussion see\n * https://jakearchibald.com/2024/garbage-collection-and-closures/\n * https://news.ycombinator.com/item?id=41111062\n */\nexport function safeTimeout(fn: () => void, delay = 0, unref = false): () => void {\n  let timerId: any\n\n  const disposeTimer = () => {\n    clearTimeout(timerId)\n    timerId = undefined\n  }\n\n  timerId = setTimeout(() => {\n    fn()\n    disposeTimer()\n  }, delay)\n\n  if (unref)\n    timerId.unref?.()\n\n  return disposeTimer\n}\n"],"mappings":";;;;;;;;;;;AAQA,SAAgB,YAAY,IAAgB,QAAQ,GAAG,QAAQ,OAAmB;CAChF,IAAI;CAEJ,MAAM,qBAAqB;AACzB,eAAa,QAAQ;AACrB,YAAU;;AAGZ,WAAU,iBAAiB;AACzB,MAAI;AACJ,gBAAc;IACb,MAAM;AAET,KAAI,MACF,SAAQ,SAAS;AAEnB,QAAO"}

package/dist/common/timeout.mjs

@@ -1,2 +1,26 @@
-function e(e,t=0,n=!1){let r,i=()=>{clearTimeout(r),r=void 0};return r=setTimeout(()=>{e(),i()},t),n&&r.unref?.(),i}export{e as safeTimeout};
+//#region src/common/timeout.ts
+/**
+* Slightliy enhanced setTimeout to avoid garbage collection issues.
+* Returns a dispose function.
+*
+* Discussion see
+* https://jakearchibald.com/2024/garbage-collection-and-closures/
+* https://news.ycombinator.com/item?id=41111062
+*/
+function safeTimeout(fn, delay = 0, unref = false) {
+	let timerId;
+	const disposeTimer = () => {
+		clearTimeout(timerId);
+		timerId = void 0;
+	};
+	timerId = setTimeout(() => {
+		fn();
+		disposeTimer();
+	}, delay);
+	if (unref) timerId.unref?.();
+	return disposeTimer;
+}
+
+//#endregion
+export { safeTimeout };
 //# sourceMappingURL=timeout.mjs.map

package/dist/common/timeout.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"timeout.mjs","names":[],"sources":["../../src/common/timeout.ts"],"sourcesContent":["/**\n * Slightliy enhanced setTimeout to avoid garbage collection issues.\n * Returns a dispose function.\n *\n * Discussion see\n * https://jakearchibald.com/2024/garbage-collection-and-closures/\n * https://news.ycombinator.com/item?id=41111062\n */\nexport function safeTimeout(fn: () => void, delay = 0, unref = false): () => void {\n  let timerId: any\n\n  const disposeTimer = () => {\n    clearTimeout(timerId)\n    timerId = undefined\n  }\n\n  timerId = setTimeout(() => {\n    fn()\n    disposeTimer()\n  }, delay)\n\n  if (unref)\n    timerId.unref?.()\n\n  return disposeTimer\n}\n"],"mappings":"AAQA,SAAgB,EAAY,EAAgB,EAAQ,EAAG,EAAQ,GAAmB,CAChF,IAAI,EAEE,MAAqB,CACzB,aAAa,EAAQ,CACrB,EAAU,IAAA,IAWZ,MARA,GAAU,eAAiB,CACzB,GAAI,CACJ,GAAc,EACb,EAAM,CAEL,GACF,EAAQ,SAAS,CAEZ"}
+{"version":3,"file":"timeout.mjs","names":[],"sources":["../../src/common/timeout.ts"],"sourcesContent":["/**\n * Slightliy enhanced setTimeout to avoid garbage collection issues.\n * Returns a dispose function.\n *\n * Discussion see\n * https://jakearchibald.com/2024/garbage-collection-and-closures/\n * https://news.ycombinator.com/item?id=41111062\n */\nexport function safeTimeout(fn: () => void, delay = 0, unref = false): () => void {\n  let timerId: any\n\n  const disposeTimer = () => {\n    clearTimeout(timerId)\n    timerId = undefined\n  }\n\n  timerId = setTimeout(() => {\n    fn()\n    disposeTimer()\n  }, delay)\n\n  if (unref)\n    timerId.unref?.()\n\n  return disposeTimer\n}\n"],"mappings":";;;;;;;;;AAQA,SAAgB,YAAY,IAAgB,QAAQ,GAAG,QAAQ,OAAmB;CAChF,IAAI;CAEJ,MAAM,qBAAqB;AACzB,eAAa,QAAQ;AACrB,YAAU;;AAGZ,WAAU,iBAAiB;AACzB,MAAI;AACJ,gBAAc;IACb,MAAM;AAET,KAAI,MACF,SAAQ,SAAS;AAEnB,QAAO"}

package/dist/common/types.mjs

@@ -1 +1 @@
-export{};
+export {  };

package/dist/common/utils.cjs

@@ -1,2 +1,8 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});function e(){}exports.noop=e;
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/common/utils.ts
+function noop() {}
+
+//#endregion
+exports.noop = noop;
 //# sourceMappingURL=utils.cjs.map

package/dist/common/utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"utils.cjs","names":[],"sources":["../../src/common/utils.ts"],"sourcesContent":["export function noop() { }\n"],"mappings":"mEAAA,SAAgB,GAAO"}
+{"version":3,"file":"utils.cjs","names":[],"sources":["../../src/common/utils.ts"],"sourcesContent":["export function noop() { }\n"],"mappings":";;;AAAA,SAAgB,OAAO"}

package/dist/common/utils.mjs

@@ -1,2 +1,6 @@
-function e(){}export{e as noop};
+//#region src/common/utils.ts
+function noop() {}
+
+//#endregion
+export { noop };
 //# sourceMappingURL=utils.mjs.map

package/dist/common/utils.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"utils.mjs","names":[],"sources":["../../src/common/utils.ts"],"sourcesContent":["export function noop() { }\n"],"mappings":"AAAA,SAAgB,GAAO"}
+{"version":3,"file":"utils.mjs","names":[],"sources":["../../src/common/utils.ts"],"sourcesContent":["export function noop() { }\n"],"mappings":";AAAA,SAAgB,OAAO"}