@ls-stack/utils 3.65.0 → 3.66.0

package/dist/createThrottleController.cjs

@@ -1,193 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/createThrottleController.ts
-var createThrottleController_exports = {};
-__export(createThrottleController_exports, {
-  createThrottleController: () => createThrottleController
-});
-module.exports = __toCommonJS(createThrottleController_exports);
-
-// src/typeGuards.ts
-function isFunction(value) {
-  return typeof value === "function";
-}
-
-// src/assertions.ts
-var isFunction2 = isFunction;
-
-// src/enhancedMap.ts
-var enhancedMapReject = Symbol();
-var EnhancedMap = class _EnhancedMap extends Map {
-  find(predicate) {
-    for (const [key, value] of this) {
-      if (predicate(value, key)) {
-        return { key, value };
-      }
-    }
-    return void 0;
-  }
-  setMultiple(...values) {
-    if (Array.isArray(values[0])) {
-      for (const [key, value] of values) {
-        this.set(key, value);
-      }
-    } else {
-      for (const [key, value] of Object.entries(values[0])) {
-        this.set(key, value);
-      }
-    }
-    return this;
-  }
-  getOrThrow(key) {
-    const value = this.get(key);
-    if (value === void 0) {
-      throw new Error(`Key ${key} not found in EnhancedMap`);
-    }
-    return value;
-  }
-  getOrInsert(key, fallback) {
-    if (!this.has(key)) {
-      this.set(key, fallback());
-    }
-    return this.getOrThrow(key);
-  }
-  toFilteredValues(predicate) {
-    const values = [];
-    for (const [key, value] of this) {
-      if (predicate(value, key)) {
-        values.push(value);
-      }
-    }
-    return values;
-  }
-  toMap(mapFunction) {
-    const values = [];
-    for (const [key, value] of this) {
-      const result = mapFunction(value, key, enhancedMapReject);
-      if (result !== enhancedMapReject) {
-        values.push(result);
-      }
-    }
-    return values;
-  }
-  toObjMap(mapFunction) {
-    const values = {};
-    for (const [key, value] of this) {
-      const result = mapFunction(value, key);
-      if (result) {
-        values[result[0]] = result[1];
-      }
-    }
-    return values;
-  }
-  toValues() {
-    return [...this.values()];
-  }
-  toKeys() {
-    return [...this.keys()];
-  }
-  static from(array, mapFunction) {
-    const map = new _EnhancedMap();
-    if (!array) return map;
-    const isFn = isFunction2(mapFunction);
-    for (const item of array) {
-      if (isFn) {
-        const result = mapFunction(item);
-        if (result) {
-          map.set(result[0], result[1]);
-        }
-      } else {
-        const key = item[mapFunction];
-        if (key !== void 0) {
-          map.set(key, item);
-        }
-      }
-    }
-    return map;
-  }
-};
-
-// src/time.ts
-var MINUTE_AS_MS = 60 * 1e3;
-var HOUR_AS_MS = 60 * MINUTE_AS_MS;
-var DAY_AS_MS = 24 * HOUR_AS_MS;
-var WEEK_AS_MS = 7 * DAY_AS_MS;
-var MONTH_AS_MS = 30 * DAY_AS_MS;
-var YEAR_AS_MS = 365 * DAY_AS_MS;
-var HOUR_AS_SECS = 60 * 60;
-var DAY_AS_SECS = 24 * HOUR_AS_SECS;
-var WEEK_AS_SECS = 7 * DAY_AS_SECS;
-var MONTH_AS_SECS = 30 * DAY_AS_SECS;
-var YEAR_AS_SECS = 365 * DAY_AS_SECS;
-function durationObjToMs(durationObj) {
-  return (durationObj.hours ?? 0) * HOUR_AS_MS + (durationObj.minutes ?? 0) * MINUTE_AS_MS + (durationObj.seconds ?? 0) * 1e3 + (durationObj.ms ?? 0) + (durationObj.days ?? 0) * DAY_AS_MS;
-}
-
-// src/createThrottleController.ts
-function createThrottleController({
-  maxCalls,
-  per,
-  cleanupCheckSecsInterval = 60 * 30
-}) {
-  const msInterval = durationObjToMs(per);
-  if (msInterval === 0) {
-    throw new Error("Invalid interval");
-  }
-  let lastCleanupCheck = Date.now();
-  const windows = new EnhancedMap();
-  function cleanup(checkTime) {
-    const shouldCleanup = checkTime - lastCleanupCheck > cleanupCheckSecsInterval * 1e3;
-    if (!shouldCleanup) return;
-    setTimeout(() => {
-      const now = Date.now();
-      lastCleanupCheck = now;
-      for (const [key, value] of windows) {
-        if (now - value.windowStartTime > msInterval) {
-          windows.delete(key);
-        }
-      }
-    }, 2);
-  }
-  return {
-    shouldSkip(callId = "") {
-      const now = Date.now();
-      const serializedCallId = String(callId);
-      const window = windows.getOrInsert(serializedCallId, () => ({
-        windowStartTime: now,
-        calls: 0
-      }));
-      if (now - window.windowStartTime > msInterval) {
-        window.windowStartTime = now;
-        window.calls = 0;
-      }
-      window.calls++;
-      cleanup(now);
-      if (window.calls > maxCalls) {
-        return true;
-      }
-      return false;
-    },
-    _currentWindows: windows
-  };
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  createThrottleController
-});

package/dist/createThrottleController.d.cts

@@ -1,13 +0,0 @@
-import { DurationObj } from './time.cjs';
-
-type Options = {
-    maxCalls: number;
-    per: DurationObj;
-    cleanupCheckSecsInterval?: number;
-};
-type ThrottleController = {
-    shouldSkip: (callId?: string | number | (string | number)[]) => boolean;
-};
-declare function createThrottleController({ maxCalls, per, cleanupCheckSecsInterval, }: Options): ThrottleController;
-
-export { createThrottleController };

package/dist/createThrottleController.d.ts

@@ -1,13 +0,0 @@
-import { DurationObj } from './time.js';
-
-type Options = {
-    maxCalls: number;
-    per: DurationObj;
-    cleanupCheckSecsInterval?: number;
-};
-type ThrottleController = {
-    shouldSkip: (callId?: string | number | (string | number)[]) => boolean;
-};
-declare function createThrottleController({ maxCalls, per, cleanupCheckSecsInterval, }: Options): ThrottleController;
-
-export { createThrottleController };

package/dist/createThrottleController.js

@@ -1,61 +0,0 @@
-import {
-  EnhancedMap
-} from "./chunk-7CQPOM5I.js";
-import {
-  durationObjToMs
-} from "./chunk-6FBIEPWU.js";
-import "./chunk-DBOWTYR4.js";
-import "./chunk-II4R3VVX.js";
-import "./chunk-C2SVCIWE.js";
-import "./chunk-JF2MDHOJ.js";
-
-// src/createThrottleController.ts
-function createThrottleController({
-  maxCalls,
-  per,
-  cleanupCheckSecsInterval = 60 * 30
-}) {
-  const msInterval = durationObjToMs(per);
-  if (msInterval === 0) {
-    throw new Error("Invalid interval");
-  }
-  let lastCleanupCheck = Date.now();
-  const windows = new EnhancedMap();
-  function cleanup(checkTime) {
-    const shouldCleanup = checkTime - lastCleanupCheck > cleanupCheckSecsInterval * 1e3;
-    if (!shouldCleanup) return;
-    setTimeout(() => {
-      const now = Date.now();
-      lastCleanupCheck = now;
-      for (const [key, value] of windows) {
-        if (now - value.windowStartTime > msInterval) {
-          windows.delete(key);
-        }
-      }
-    }, 2);
-  }
-  return {
-    shouldSkip(callId = "") {
-      const now = Date.now();
-      const serializedCallId = String(callId);
-      const window = windows.getOrInsert(serializedCallId, () => ({
-        windowStartTime: now,
-        calls: 0
-      }));
-      if (now - window.windowStartTime > msInterval) {
-        window.windowStartTime = now;
-        window.calls = 0;
-      }
-      window.calls++;
-      cleanup(now);
-      if (window.calls > maxCalls) {
-        return true;
-      }
-      return false;
-    },
-    _currentWindows: windows
-  };
-}
-export {
-  createThrottleController
-};

package/dist/debounce.cjs

@@ -1,157 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/debounce.ts
-var debounce_exports = {};
-__export(debounce_exports, {
-  debounce: () => debounce,
-  isDebouncedFn: () => isDebouncedFn
-});
-module.exports = __toCommonJS(debounce_exports);
-function debounce(func, wait, options) {
-  let currentCallback = func;
-  let waitMs = wait;
-  let currentOptions = options;
-  let lastArgs;
-  let lastThis;
-  let maxWait;
-  let result;
-  let timerId;
-  let lastCallTime;
-  let lastInvokeTime = 0;
-  let leading = false;
-  let maxing = false;
-  let trailing = true;
-  function applyOptions() {
-    const opts = currentOptions;
-    leading = !!opts?.leading;
-    trailing = opts && "trailing" in opts ? !!opts.trailing : true;
-    maxing = !!(opts && "maxWait" in opts);
-    maxWait = maxing ? Math.max(opts?.maxWait ?? 0, waitMs) : void 0;
-  }
-  applyOptions();
-  function invokeFunc(time) {
-    const args = lastArgs;
-    const thisArg = lastThis;
-    lastArgs = lastThis = void 0;
-    lastInvokeTime = time;
-    result = currentCallback.apply(thisArg, args);
-    return result;
-  }
-  function leadingEdge(time) {
-    lastInvokeTime = time;
-    timerId = setTimeout(timerExpired, waitMs);
-    return leading ? invokeFunc(time) : result;
-  }
-  function remainingWait(time) {
-    const timeSinceLastCall = time - (lastCallTime ?? 0);
-    const timeSinceLastInvoke = time - lastInvokeTime;
-    const timeWaiting = waitMs - timeSinceLastCall;
-    return maxing ? Math.min(timeWaiting, (maxWait ?? 0) - timeSinceLastInvoke) : timeWaiting;
-  }
-  function shouldInvoke(time) {
-    const timeSinceLastCall = time - (lastCallTime ?? 0);
-    const timeSinceLastInvoke = time - lastInvokeTime;
-    return lastCallTime === void 0 || timeSinceLastCall >= waitMs || timeSinceLastCall < 0 || maxing && timeSinceLastInvoke >= (maxWait ?? 0);
-  }
-  function timerExpired() {
-    const time = Date.now();
-    if (shouldInvoke(time)) {
-      return trailingEdge(time);
-    }
-    timerId = setTimeout(timerExpired, remainingWait(time));
-  }
-  function trailingEdge(time) {
-    timerId = void 0;
-    if (trailing && lastArgs) {
-      return invokeFunc(time);
-    }
-    lastArgs = lastThis = void 0;
-    return result;
-  }
-  function cancel() {
-    if (timerId !== void 0) {
-      clearTimeout(timerId);
-    }
-    lastInvokeTime = 0;
-    lastArgs = lastCallTime = lastThis = timerId = void 0;
-  }
-  function flush() {
-    return timerId === void 0 ? result : trailingEdge(Date.now());
-  }
-  function pending() {
-    return timerId !== void 0;
-  }
-  function updateCb(callback) {
-    currentCallback = callback;
-  }
-  function updateParams(newWait, newOptions) {
-    waitMs = newWait;
-    if (newOptions !== void 0) {
-      currentOptions = newOptions;
-    }
-    applyOptions();
-    if (timerId !== void 0) {
-      const time = Date.now();
-      const shouldRun = shouldInvoke(time);
-      clearTimeout(timerId);
-      if (shouldRun) {
-        timerId = setTimeout(timerExpired, 0);
-      } else {
-        const delay = remainingWait(time);
-        timerId = setTimeout(timerExpired, delay > 0 ? delay : 0);
-      }
-    }
-  }
-  function debounced() {
-    const time = Date.now();
-    const isInvoking = shouldInvoke(time);
-    lastArgs = arguments;
-    lastThis = this;
-    lastCallTime = time;
-    if (isInvoking) {
-      if (timerId === void 0) {
-        return leadingEdge(lastCallTime);
-      }
-      if (maxing) {
-        clearTimeout(timerId);
-        timerId = setTimeout(timerExpired, waitMs);
-        return invokeFunc(lastCallTime);
-      }
-    }
-    if (timerId === void 0) {
-      timerId = setTimeout(timerExpired, waitMs);
-    }
-    return result;
-  }
-  debounced.cancel = cancel;
-  debounced.flush = flush;
-  debounced.pending = pending;
-  debounced.updateCb = updateCb;
-  debounced.updateParams = updateParams;
-  return debounced;
-}
-function isDebouncedFn(fn) {
-  return typeof fn === "function" && "cancel" in fn && typeof fn.cancel === "function" && "flush" in fn && typeof fn.flush === "function" && "pending" in fn && typeof fn.pending === "function" && "updateCb" in fn && typeof fn.updateCb === "function" && "updateParams" in fn && typeof fn.updateParams === "function";
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  debounce,
-  isDebouncedFn
-});

package/dist/debounce.d.cts

@@ -1,46 +0,0 @@
-type DebounceOptions = {
-    /** @see _.leading */
-    leading?: boolean;
-    /** @see _.maxWait */
-    maxWait?: number;
-    /** @see _.trailing */
-    trailing?: boolean;
-};
-interface DebouncedFunc<T extends (...args: any[]) => void> {
-    /**
-     * Call the original function, but applying the debounce rules.
-     *
-     * If the debounced function can be run immediately, this calls it and returns
-     * its return value.
-     *
-     * Otherwise, it returns the return value of the last invocation, or undefined
-     * if the debounced function was not invoked yet.
-     */
-    (...args: Parameters<T>): ReturnType<T> | undefined;
-    /** Throw away any pending invocation of the debounced function. */
-    cancel: () => void;
-    /**
-     * If there is a pending invocation of the debounced function, invoke it
-     * immediately and return its return value.
-     *
-     * Otherwise, return the value from the last invocation, or undefined if the
-     * debounced function was never invoked.
-     */
-    flush: () => ReturnType<T> | undefined;
-    /** Return true if the debounced function still has a scheduled run. */
-    pending: () => boolean;
-    /** Update the debounced function with a new callback. */
-    updateCb: (callback: T) => void;
-    /** Update the debounce wait and options while keeping scheduled runs. */
-    updateParams: (wait: number, options?: DebounceOptions) => void;
-}
-declare function debounce<T extends (...args: any[]) => void>(func: T, wait: number, options?: DebounceOptions): DebouncedFunc<T>;
-declare function isDebouncedFn<T extends (...args: any[]) => void>(fn: T): fn is T & {
-    cancel: () => void;
-    flush: () => ReturnType<T> | undefined;
-    pending: () => boolean;
-    updateCb: (callback: T) => void;
-    updateParams: (wait: number, options?: DebounceOptions) => void;
-};
-
-export { type DebounceOptions, type DebouncedFunc, debounce, isDebouncedFn };

package/dist/debounce.d.ts

@@ -1,46 +0,0 @@
-type DebounceOptions = {
-    /** @see _.leading */
-    leading?: boolean;
-    /** @see _.maxWait */
-    maxWait?: number;
-    /** @see _.trailing */
-    trailing?: boolean;
-};
-interface DebouncedFunc<T extends (...args: any[]) => void> {
-    /**
-     * Call the original function, but applying the debounce rules.
-     *
-     * If the debounced function can be run immediately, this calls it and returns
-     * its return value.
-     *
-     * Otherwise, it returns the return value of the last invocation, or undefined
-     * if the debounced function was not invoked yet.
-     */
-    (...args: Parameters<T>): ReturnType<T> | undefined;
-    /** Throw away any pending invocation of the debounced function. */
-    cancel: () => void;
-    /**
-     * If there is a pending invocation of the debounced function, invoke it
-     * immediately and return its return value.
-     *
-     * Otherwise, return the value from the last invocation, or undefined if the
-     * debounced function was never invoked.
-     */
-    flush: () => ReturnType<T> | undefined;
-    /** Return true if the debounced function still has a scheduled run. */
-    pending: () => boolean;
-    /** Update the debounced function with a new callback. */
-    updateCb: (callback: T) => void;
-    /** Update the debounce wait and options while keeping scheduled runs. */
-    updateParams: (wait: number, options?: DebounceOptions) => void;
-}
-declare function debounce<T extends (...args: any[]) => void>(func: T, wait: number, options?: DebounceOptions): DebouncedFunc<T>;
-declare function isDebouncedFn<T extends (...args: any[]) => void>(fn: T): fn is T & {
-    cancel: () => void;
-    flush: () => ReturnType<T> | undefined;
-    pending: () => boolean;
-    updateCb: (callback: T) => void;
-    updateParams: (wait: number, options?: DebounceOptions) => void;
-};
-
-export { type DebounceOptions, type DebouncedFunc, debounce, isDebouncedFn };

package/dist/debounce.js

@@ -1,8 +0,0 @@
-import {
-  debounce,
-  isDebouncedFn
-} from "./chunk-CCUPDGSZ.js";
-export {
-  debounce,
-  isDebouncedFn
-};

package/dist/dedent.cjs

@@ -1,104 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/dedent.ts
-var dedent_exports = {};
-__export(dedent_exports, {
-  dedent: () => dedent
-});
-module.exports = __toCommonJS(dedent_exports);
-var dedent = createDedent({
-  identInterpolations: true
-});
-function createDedent(options) {
-  d.withOptions = (newOptions) => createDedent({ ...options, ...newOptions });
-  return d;
-  function d(strings, ...values) {
-    const raw = typeof strings === "string" ? [strings] : strings.raw;
-    const {
-      escapeSpecialCharacters = Array.isArray(strings),
-      trimWhitespace = true,
-      identInterpolations = true,
-      showNullishOrFalseValues = false
-    } = options;
-    let result = "";
-    for (let i = 0; i < raw.length; i++) {
-      let next = raw[i];
-      if (escapeSpecialCharacters) {
-        next = next.replace(/\\\n[ \t]*/g, "").replace(/\\`/g, "`").replace(/\\\$/g, "$").replace(/\\\{/g, "{");
-      }
-      result += next;
-      if (i < values.length) {
-        let val = values[i];
-        if (!showNullishOrFalseValues && (val === false || val === null || val === void 0)) {
-          continue;
-        }
-        val = String(val);
-        if (identInterpolations && val.includes("\n")) {
-          let withIdent = val;
-          const currentIndent = getCurrentIndent(result);
-          if (currentIndent && withIdent) {
-            const lines2 = withIdent.split("\n");
-            withIdent = lines2.map((line, index) => {
-              return index === 0 || line === "" ? line : currentIndent + line;
-            }).join("\n");
-          }
-          result += withIdent;
-        } else {
-          result += val;
-        }
-      }
-    }
-    const lines = result.split("\n");
-    let mindent = null;
-    for (const l of lines) {
-      const m = l.match(/^(\s+)\S+/);
-      if (m) {
-        const indent = m[1].length;
-        if (!mindent) {
-          mindent = indent;
-        } else {
-          mindent = Math.min(mindent, indent);
-        }
-      }
-    }
-    if (mindent !== null) {
-      const m = mindent;
-      result = lines.map((l) => l[0] === " " || l[0] === "	" ? l.slice(m) : l).join("\n");
-    }
-    if (trimWhitespace) {
-      result = result.trim();
-    }
-    if (escapeSpecialCharacters) {
-      result = result.replace(/\\n/g, "\n");
-    }
-    return result;
-  }
-}
-function getCurrentIndent(str) {
-  const lines = str.split("\n");
-  const lastLine = lines[lines.length - 1];
-  if (!lastLine) return "";
-  const match = lastLine.match(/^(\s*)/);
-  return match ? match[1] : "";
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  dedent
-});