@putkoff/abstract-utilities 1.0.147 → 1.0.156

package/dist/cjs/src/functions/inspect_utils/src/caller_utils.js

@@ -0,0 +1,32 @@
+'use strict';
+
+function getLastCaller(skip = ["debugPrint"]) {
+    const stack = new Error().stack;
+    if (!stack)
+        return null;
+    const lines = stack
+        .split("\n")
+        .map(l => l.trim())
+        .slice(1); // drop "Error"
+    for (const line of lines) {
+        // Example:
+        // at processSingleAddress (/path/file.ts:142:7)
+        const match = line.match(/at (.+?) \((.+?):(\d+):(\d+)\)/) ||
+            line.match(/at (.+?):(\d+):(\d+)/);
+        if (!match)
+            continue;
+        const functionName = match[1] ?? "anonymous";
+        if (skip.includes(functionName))
+            continue;
+        return {
+            functionName,
+            file: match[2],
+            line: Number(match[3]),
+            column: Number(match[4]),
+        };
+    }
+    return null;
+}
+
+exports.getLastCaller = getLastCaller;
+//# sourceMappingURL=caller_utils.js.map

package/dist/cjs/src/functions/inspect_utils/src/caller_utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"caller_utils.js","sources":["../../../../../../src/functions/inspect_utils/src/caller_utils.ts"],"sourcesContent":["\nexport function getLastCaller(skip = [\"debugPrint\"]) {\n  const stack = new Error().stack;\n  if (!stack) return null;\n\n  const lines = stack\n    .split(\"\\n\")\n    .map(l => l.trim())\n    .slice(1); // drop \"Error\"\n\n  for (const line of lines) {\n    // Example:\n    // at processSingleAddress (/path/file.ts:142:7)\n    const match =\n      line.match(/at (.+?) \\((.+?):(\\d+):(\\d+)\\)/) ||\n      line.match(/at (.+?):(\\d+):(\\d+)/);\n\n    if (!match) continue;\n\n    const functionName = match[1] ?? \"anonymous\";\n\n    if (skip.includes(functionName)) continue;\n\n    return {\n      functionName,\n      file: match[2],\n      line: Number(match[3]),\n      column: Number(match[4]),\n    };\n  }\n\n  return null;\n}\n"],"names":[],"mappings":";;SACgB,aAAa,CAAC,IAAI,GAAG,CAAC,YAAY,CAAC,EAAA;AACjD,IAAA,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC,KAAK;AAC/B,IAAA,IAAI,CAAC,KAAK;AAAE,QAAA,OAAO,IAAI;IAEvB,MAAM,KAAK,GAAG;SACX,KAAK,CAAC,IAAI;SACV,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE;AACjB,SAAA,KAAK,CAAC,CAAC,CAAC,CAAC;AAEZ,IAAA,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;;;AAGxB,QAAA,MAAM,KAAK,GACT,IAAI,CAAC,KAAK,CAAC,gCAAgC,CAAC;AAC5C,YAAA,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC;AAEpC,QAAA,IAAI,CAAC,KAAK;YAAE;QAEZ,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,WAAW;AAE5C,QAAA,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;YAAE;QAEjC,OAAO;YACL,YAAY;AACZ,YAAA,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;AACd,YAAA,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACtB,YAAA,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SACzB;IACH;AAEA,IAAA,OAAO,IAAI;AACb;;;;"}

package/dist/cjs/src/functions/math_utils/bigint_utils.js

@@ -0,0 +1,30 @@
+'use strict';
+
+/**
+ * Recursively traverse the object and convert BigInts to numbers or strings.
+ *
+ * @param {object|array} obj - The object to traverse
+ * @param {boolean} convertToNumber - Whether to convert BigInt to Number (default is true)
+ * @returns {object|array} - The transformed object
+ */
+function convertBigInts(obj, convertToNumber = true) {
+    if (obj === null || obj === undefined)
+        return obj;
+    try {
+        if (typeof obj === 'bigint') {
+            return convertToNumber ? Number(obj) : obj.toString();
+        }
+        if (typeof obj === 'object') {
+            if (Array.isArray(obj)) {
+                return obj.map((item) => convertBigInts(item, convertToNumber));
+            }
+            return Object.fromEntries(Object.entries(obj).map(([key, value]) => [key, convertBigInts(value, convertToNumber)]));
+        }
+    }
+    catch (error) {
+    }
+    return obj;
+}
+
+exports.convertBigInts = convertBigInts;
+//# sourceMappingURL=bigint_utils.js.map

package/dist/cjs/src/functions/math_utils/bigint_utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bigint_utils.js","sources":["../../../../../src/functions/math_utils/bigint_utils.ts"],"sourcesContent":["// src/functions/typeUtils/numUtils.ts\nimport {getLogString} from '@putkoff/abstract-logger';\nconst FILE_LOCATION = 'src/functions/typeUtils/numUtils.ts'\n/**\n * Recursively traverse the object and convert BigInts to numbers or strings.\n *\n * @param {object|array} obj - The object to traverse\n * @param {boolean} convertToNumber - Whether to convert BigInt to Number (default is true)\n * @returns {object|array} - The transformed object\n */\nexport function convertBigInts(obj: any, convertToNumber = true): any {\n  if (obj === null || obj === undefined) return obj;\n\n  try {\n    if (typeof obj === 'bigint') {\n      return convertToNumber ? Number(obj) : obj.toString();\n    }\n\n    if (typeof obj === 'object') {\n      if (Array.isArray(obj)) {\n        return obj.map((item) => convertBigInts(item, convertToNumber));\n      }\n      return Object.fromEntries(\n        Object.entries(obj).map(([key, value]) => [key, convertBigInts(value, convertToNumber)])\n      );\n    }\n  } catch (error: any) {\n   \n  }\n  return obj;\n}\n"],"names":[],"mappings":";;AAGA;;;;;;AAMG;SACa,cAAc,CAAC,GAAQ,EAAE,eAAe,GAAG,IAAI,EAAA;AAC7D,IAAA,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS;AAAE,QAAA,OAAO,GAAG;AAEjD,IAAA,IAAI;AACF,QAAA,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE;AAC3B,YAAA,OAAO,eAAe,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,QAAQ,EAAE;QACvD;AAEA,QAAA,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE;AAC3B,YAAA,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;AACtB,gBAAA,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,cAAc,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;YACjE;AACA,YAAA,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,cAAc,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,CACzF;QACH;IACF;IAAE,OAAO,KAAU,EAAE;IAErB;AACA,IAAA,OAAO,GAAG;AACZ;;;;"}

package/dist/cjs/src/functions/math_utils/constants.js

@@ -0,0 +1,75 @@
+'use strict';
+
+var safe_math = require('./safe_math.js');
+
+const SECOND = 1;
+const ZEPTOSECOND = safe_math.exponential(SECOND, -21);
+const ATTOSECOND = safe_math.exponential(SECOND, -18);
+const FEMTOSECOND = safe_math.exponential(SECOND, -15);
+const PICOSECOND = safe_math.exponential(SECOND, -12);
+const NANOSECOND = safe_math.exponential(SECOND, -9);
+const MICROSECOND = safe_math.exponential(SECOND, -6);
+const MILISECOND = safe_math.exponential(SECOND, -3);
+const CENTISECOND = safe_math.exponential(SECOND, -2);
+const DECISECOND = safe_math.exponential(SECOND, -1);
+const MINUTE = 60 * SECOND;
+const HOUR = 60 * MINUTE;
+const DAY = 24 * HOUR;
+const YEAR = 365 * DAY;
+const MONTH = YEAR / 12;
+// Derived: explicit names
+const SECONDS_PER_MINUTE = MINUTE;
+const SECONDS_PER_HOUR = HOUR;
+const SECONDS_PER_DAY = DAY;
+//math
+const PI = Math.PI;
+const PI2 = 2 * PI;
+// Distance
+const METERS_PER_KM = 1000;
+const METERS_PER_MILE = 1609.34;
+const METERS_PER_FOOT = 0.3048;
+const KMS_PER_METER = 1 / METERS_PER_KM;
+const MILES_PER_METER = 1 / METERS_PER_MILE;
+const FEET_PER_METER = 1 / METERS_PER_FOOT;
+const MIN_IN_S = 1 / MINUTE;
+const HOUR_IN_S = 1 / HOUR;
+const DAY_IN_S = 1 / DAY;
+const YEAR_IN_S = 1 / YEAR;
+const MONTH_IN_S = 1 / MONTH;
+const MiPerH_TO_MPerS = METERS_PER_MILE * HOUR_IN_S;
+const MPerS_TO_MiPerH = 1 / MiPerH_TO_MPerS;
+
+exports.ATTOSECOND = ATTOSECOND;
+exports.CENTISECOND = CENTISECOND;
+exports.DAY = DAY;
+exports.DAY_IN_S = DAY_IN_S;
+exports.DECISECOND = DECISECOND;
+exports.FEET_PER_METER = FEET_PER_METER;
+exports.FEMTOSECOND = FEMTOSECOND;
+exports.HOUR = HOUR;
+exports.HOUR_IN_S = HOUR_IN_S;
+exports.KMS_PER_METER = KMS_PER_METER;
+exports.METERS_PER_FOOT = METERS_PER_FOOT;
+exports.METERS_PER_KM = METERS_PER_KM;
+exports.METERS_PER_MILE = METERS_PER_MILE;
+exports.MICROSECOND = MICROSECOND;
+exports.MILES_PER_METER = MILES_PER_METER;
+exports.MILISECOND = MILISECOND;
+exports.MINUTE = MINUTE;
+exports.MIN_IN_S = MIN_IN_S;
+exports.MONTH = MONTH;
+exports.MONTH_IN_S = MONTH_IN_S;
+exports.MPerS_TO_MiPerH = MPerS_TO_MiPerH;
+exports.MiPerH_TO_MPerS = MiPerH_TO_MPerS;
+exports.NANOSECOND = NANOSECOND;
+exports.PI = PI;
+exports.PI2 = PI2;
+exports.PICOSECOND = PICOSECOND;
+exports.SECOND = SECOND;
+exports.SECONDS_PER_DAY = SECONDS_PER_DAY;
+exports.SECONDS_PER_HOUR = SECONDS_PER_HOUR;
+exports.SECONDS_PER_MINUTE = SECONDS_PER_MINUTE;
+exports.YEAR = YEAR;
+exports.YEAR_IN_S = YEAR_IN_S;
+exports.ZEPTOSECOND = ZEPTOSECOND;
+//# sourceMappingURL=constants.js.map

package/dist/cjs/src/functions/math_utils/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sources":["../../../../../src/functions/math_utils/constants.ts"],"sourcesContent":["import { exponential } from './safe_math.js';\n\nexport const SECOND: number = 1\nexport const ZEPTOSECOND: number = exponential(SECOND, -21);\nexport const ATTOSECOND: number = exponential(SECOND, -18);\nexport const FEMTOSECOND: number = exponential(SECOND, -15);\nexport const PICOSECOND: number = exponential(SECOND, -12);\nexport const NANOSECOND: number = exponential(SECOND, -9);\nexport const MICROSECOND: number = exponential(SECOND, -6);\nexport const MILISECOND: number = exponential(SECOND, -3);\nexport const CENTISECOND: number = exponential(SECOND, -2);\nexport const DECISECOND: number = exponential(SECOND, -1);\n\n\nexport const MINUTE = 60 * SECOND;\nexport const HOUR = 60 * MINUTE;\nexport const DAY = 24 * HOUR;\nexport const YEAR = 365 * DAY;\nexport const MONTH = YEAR / 12;\n\n// Derived: explicit names\nexport const SECONDS_PER_MINUTE = MINUTE;\nexport const SECONDS_PER_HOUR = HOUR;\nexport const SECONDS_PER_DAY = DAY;\n//math\nexport const PI = Math.PI\nexport const PI2 = 2 * PI\n\n\n// Distance\nexport const METERS_PER_KM = 1000;\nexport const METERS_PER_MILE = 1609.34;\nexport const METERS_PER_FOOT = 0.3048;\n\nexport const KMS_PER_METER = 1 / METERS_PER_KM;\nexport const MILES_PER_METER = 1 / METERS_PER_MILE;\nexport const FEET_PER_METER = 1 / METERS_PER_FOOT;\n\nexport const MIN_IN_S = 1 / MINUTE;\nexport const HOUR_IN_S = 1 / HOUR;\nexport const DAY_IN_S = 1 / DAY;\nexport const YEAR_IN_S = 1 / YEAR;\nexport const MONTH_IN_S = 1 / MONTH;\nexport const MiPerH_TO_MPerS = METERS_PER_MILE * HOUR_IN_S;\nexport const MPerS_TO_MiPerH = 1 / MiPerH_TO_MPerS;\n\n\n"],"names":["exponential"],"mappings":";;;;AAEO,MAAM,MAAM,GAAW;AACvB,MAAM,WAAW,GAAWA,qBAAW,CAAC,MAAM,EAAE,GAAG;AACnD,MAAM,UAAU,GAAWA,qBAAW,CAAC,MAAM,EAAE,GAAG;AAClD,MAAM,WAAW,GAAWA,qBAAW,CAAC,MAAM,EAAE,GAAG;AACnD,MAAM,UAAU,GAAWA,qBAAW,CAAC,MAAM,EAAE,GAAG;AAClD,MAAM,UAAU,GAAWA,qBAAW,CAAC,MAAM,EAAE,EAAE;AACjD,MAAM,WAAW,GAAWA,qBAAW,CAAC,MAAM,EAAE,EAAE;AAClD,MAAM,UAAU,GAAWA,qBAAW,CAAC,MAAM,EAAE,EAAE;AACjD,MAAM,WAAW,GAAWA,qBAAW,CAAC,MAAM,EAAE,EAAE;AAClD,MAAM,UAAU,GAAWA,qBAAW,CAAC,MAAM,EAAE,EAAE;AAGjD,MAAM,MAAM,GAAG,EAAE,GAAG;AACpB,MAAM,IAAI,GAAG,EAAE,GAAG;AAClB,MAAM,GAAG,GAAG,EAAE,GAAG;AACjB,MAAM,IAAI,GAAG,GAAG,GAAG;AACnB,MAAM,KAAK,GAAG,IAAI,GAAG;AAE5B;AACO,MAAM,kBAAkB,GAAG;AAC3B,MAAM,gBAAgB,GAAG;AACzB,MAAM,eAAe,GAAG;AAC/B;AACO,MAAM,EAAE,GAAG,IAAI,CAAC;AAChB,MAAM,GAAG,GAAG,CAAC,GAAG;AAGvB;AACO,MAAM,aAAa,GAAG;AACtB,MAAM,eAAe,GAAG;AACxB,MAAM,eAAe,GAAG;AAExB,MAAM,aAAa,GAAG,CAAC,GAAG;AAC1B,MAAM,eAAe,GAAG,CAAC,GAAG;AAC5B,MAAM,cAAc,GAAG,CAAC,GAAG;AAE3B,MAAM,QAAQ,GAAG,CAAC,GAAG;AACrB,MAAM,SAAS,GAAG,CAAC,GAAG;AACtB,MAAM,QAAQ,GAAG,CAAC,GAAG;AACrB,MAAM,SAAS,GAAG,CAAC,GAAG;AACtB,MAAM,UAAU,GAAG,CAAC,GAAG;AACvB,MAAM,eAAe,GAAG,eAAe,GAAG;AAC1C,MAAM,eAAe,GAAG,CAAC,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/cjs/src/functions/math_utils/conversions.js

@@ -0,0 +1,161 @@
+'use strict';
+
+var constants = require('./constants.js');
+var safe_math = require('./safe_math.js');
+
+// conversions.ts
+/*───────────────────────────────────────────────────────────────
+  🧭 CANONICAL MAPPINGS
+───────────────────────────────────────────────────────────────*/
+const DIST_ALIASES = {
+    m: "m", meter: "m", meters: "m",
+    km: "km", kms: "km", kilometer: "km", kilometers: "km",
+    mi: "mi", mile: "mi", miles: "mi",
+    ft: "ft", f: "ft", foot: "ft", feet: "ft",
+};
+const TIME_ALIASES = {
+    s: "s", sec: "s", second: "s", seconds: "s",
+    min: "min", m: "min", minute: "min", minutes: "min",
+    h: "h", hr: "h", hour: "h", hours: "h",
+    day: "day", d: "day", days: "day",
+};
+const DIST_FACTORS = {
+    m: 1,
+    km: constants.METERS_PER_KM,
+    mi: constants.METERS_PER_MILE,
+    ft: constants.METERS_PER_FOOT,
+};
+const TIME_FACTORS = {
+    s: 1,
+    min: constants.MINUTE,
+    h: constants.HOUR,
+    day: constants.DAY,
+};
+/*───────────────────────────────────────────────────────────────
+  🔍 CANONICALIZATION HELPERS
+───────────────────────────────────────────────────────────────*/
+function canonDist(u) {
+    const key = (u ?? "m").toString().toLowerCase();
+    const canon = DIST_ALIASES[key];
+    if (!canon)
+        throw new Error(`Unknown distance unit: ${u}`);
+    return canon;
+}
+function canonTime(u) {
+    const key = (u ?? "s").toString().toLowerCase();
+    const canon = TIME_ALIASES[key];
+    if (!canon)
+        throw new Error(`Unknown time unit: ${u}`);
+    return canon;
+}
+/*───────────────────────────────────────────────────────────────
+  ⚖️ NORMALIZATION HELPERS
+───────────────────────────────────────────────────────────────*/
+function distanceToMeters(d, unit) {
+    const u = canonDist(unit);
+    return safe_math.safeMultiply(d, DIST_FACTORS[u]);
+}
+function metersToDistance(v, unit) {
+    const u = canonDist(unit);
+    return safe_math.safeDivide(v, DIST_FACTORS[u]);
+}
+function timeToSeconds(t, unit) {
+    const u = canonTime(unit);
+    return safe_math.safeMultiply(t, TIME_FACTORS[u]);
+}
+function secondsToTime(v, unit) {
+    const u = canonTime(unit);
+    return safe_math.safeDivide(v, TIME_FACTORS[u]);
+}
+/*───────────────────────────────────────────────────────────────
+  🚀 SPEED CONVERSIONS (normalize / unnormalize)
+───────────────────────────────────────────────────────────────*/
+function speedToMps(v, distUnit, timeUnit) {
+    const du = canonDist(distUnit);
+    const tu = canonTime(timeUnit);
+    return v * (DIST_FACTORS[du] / TIME_FACTORS[tu]);
+}
+function mpsToSpeed(vMps, distUnit, timeUnit) {
+    const du = canonDist(distUnit);
+    const tu = canonTime(timeUnit);
+    return vMps * (TIME_FACTORS[tu] / DIST_FACTORS[du]);
+}
+/*───────────────────────────────────────────────────────────────
+  🎯 UNIVERSAL CONVERTERS
+───────────────────────────────────────────────────────────────*/
+function convertDistance({ d, fromDist, toDist, vOnly = true, }) {
+    const m = distanceToMeters(d, fromDist);
+    const D = canonDist(toDist ?? "m");
+    const out = metersToDistance(m, D);
+    return vOnly ? out : { d: out, D };
+}
+function convertTime({ t, fromTime, toTime, vOnly = true, }) {
+    const sec = timeToSeconds(t, fromTime);
+    const T = canonTime(toTime ?? "s");
+    const out = secondsToTime(sec, T);
+    return vOnly ? out : { t: out, T };
+}
+function convertSpeed({ v, fromDist, fromTime, toDist, toTime, vOnly = true, }) {
+    const mps = speedToMps(v, fromDist, fromTime);
+    const d = canonDist(toDist ?? "m");
+    const t = canonTime(toTime ?? "s");
+    const out = mpsToSpeed(mps, d, t);
+    return vOnly ? out : { v: out, d, t };
+}
+const DistanceConverter = {
+    normalize: distanceToMeters,
+    unnormalize: metersToDistance,
+};
+const TimeConverter = {
+    normalize: timeToSeconds,
+    unnormalize: secondsToTime,
+};
+const SpeedConverter = {
+    normalize: (v, [du, tu]) => speedToMps(v, du, tu),
+    unnormalize: (v, [du, tu]) => mpsToSpeed(v, du, tu),
+};
+/*───────────────────────────────────────────────────────────────
+  🧩 COMPATIBILITY WRAPPERS (legacy aliases)
+───────────────────────────────────────────────────────────────*/
+const toMeters = distanceToMeters;
+const fromMeters = metersToDistance;
+const toSeconds = timeToSeconds;
+const fromSeconds = secondsToTime;
+const velocityToMs = (value, unit) => speedToMps(value, unit, "s");
+const velocityFromMs = (value, unit) => mpsToSpeed(value, unit, "s");
+/** Non-canonical helper for arbitrary rate conversion, e.g. ft/day → m/s */
+const fromMps = (v, dist_unit, time_unit) => mpsToSpeed(v, dist_unit, time_unit);
+/*───────────────────────────────────────────────────────────────
+  📊 UTILITIES
+───────────────────────────────────────────────────────────────*/
+const isFiniteNum = (x) => Number.isFinite(x);
+const fmt = (n, digits = 2) => isFiniteNum(n) ? n.toFixed(digits) : "N/A";
+
+exports.DIST_ALIASES = DIST_ALIASES;
+exports.DIST_FACTORS = DIST_FACTORS;
+exports.DistanceConverter = DistanceConverter;
+exports.SpeedConverter = SpeedConverter;
+exports.TIME_ALIASES = TIME_ALIASES;
+exports.TIME_FACTORS = TIME_FACTORS;
+exports.TimeConverter = TimeConverter;
+exports.canonDist = canonDist;
+exports.canonTime = canonTime;
+exports.convertDistance = convertDistance;
+exports.convertSpeed = convertSpeed;
+exports.convertTime = convertTime;
+exports.distanceToMeters = distanceToMeters;
+exports.fmt = fmt;
+exports.fromMeters = fromMeters;
+exports.fromMps = fromMps;
+exports.fromSeconds = fromSeconds;
+exports.isFiniteNum = isFiniteNum;
+exports.metersToDistance = metersToDistance;
+exports.mpsToSpeed = mpsToSpeed;
+exports.secondsToTime = secondsToTime;
+exports.speedToMps = speedToMps;
+exports.timeToSeconds = timeToSeconds;
+exports.toMeters = toMeters;
+exports.toSeconds = toSeconds;
+exports.velocityFromMs = velocityFromMs;
+exports.velocityToMs = velocityToMs;
+//# sourceMappingURL=conversions.js.map

package/dist/cjs/src/functions/math_utils/conversions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversions.js","sources":["../../../../../src/functions/math_utils/conversions.ts"],"sourcesContent":["// conversions.ts\nimport {\n    METERS_PER_KM,\n    METERS_PER_MILE,\n    METERS_PER_FOOT,\n    MINUTE,\n    HOUR,\n    DAY,\n\n} from \"./constants.js\";\nimport { safeMultiply, safeDivide } from \"./safe_math.js\";\nimport type { CanonTime, CanonDist, DistanceUnit, TimeUnit, ConvertDistance, ConvertTime, ConvertSpeed, OutDist, OutTimeType, OutSpeedType } from './scaleInterfaces.js';\n/*───────────────────────────────────────────────────────────────\n  🧭 CANONICAL MAPPINGS\n───────────────────────────────────────────────────────────────*/\n\nexport const DIST_ALIASES: Record<string, CanonDist> = {\n    m: \"m\", meter: \"m\", meters: \"m\",\n    km: \"km\", kms: \"km\", kilometer: \"km\", kilometers: \"km\",\n    mi: \"mi\", mile: \"mi\", miles: \"mi\",\n    ft: \"ft\", f: \"ft\", foot: \"ft\", feet: \"ft\",\n};\n\nexport const TIME_ALIASES: Record<string, CanonTime> = {\n    s: \"s\", sec: \"s\", second: \"s\", seconds: \"s\",\n    min: \"min\", m: \"min\", minute: \"min\", minutes: \"min\",\n    h: \"h\", hr: \"h\", hour: \"h\", hours: \"h\",\n    day: \"day\", d: \"day\", days: \"day\",\n};\n\nexport const DIST_FACTORS: Record<CanonDist, number> = {\n    m: 1,\n    km: METERS_PER_KM,\n    mi: METERS_PER_MILE,\n    ft: METERS_PER_FOOT,\n};\n\nexport const TIME_FACTORS: Record<CanonTime, number> = {\n    s: 1,\n    min: MINUTE,\n    h: HOUR,\n    day: DAY,\n};\n\n/*───────────────────────────────────────────────────────────────\n  🔍 CANONICALIZATION HELPERS\n───────────────────────────────────────────────────────────────*/\n\nexport function canonDist(u: DistanceUnit | string | undefined): CanonDist {\n    const key = (u ?? \"m\").toString().toLowerCase();\n    const canon = DIST_ALIASES[key];\n    if (!canon) throw new Error(`Unknown distance unit: ${u}`);\n    return canon;\n}\n\nexport function canonTime(u: TimeUnit | string | undefined): CanonTime {\n    const key = (u ?? \"s\").toString().toLowerCase();\n    const canon = TIME_ALIASES[key];\n    if (!canon) throw new Error(`Unknown time unit: ${u}`);\n    return canon;\n}\n\n/*───────────────────────────────────────────────────────────────\n  ⚖️ NORMALIZATION HELPERS\n───────────────────────────────────────────────────────────────*/\n\nexport function distanceToMeters(d: number, unit: DistanceUnit | string): number {\n    const u = canonDist(unit);\n    return safeMultiply(d, DIST_FACTORS[u]);\n}\nexport function metersToDistance(v: number, unit: DistanceUnit | string): number {\n    const u = canonDist(unit);\n    return safeDivide(v, DIST_FACTORS[u]);\n}\n\nexport function timeToSeconds(t: number, unit: TimeUnit | string): number {\n    const u = canonTime(unit);\n    return safeMultiply(t, TIME_FACTORS[u]);\n}\nexport function secondsToTime(v: number, unit: TimeUnit | string): number {\n    const u = canonTime(unit);\n    return safeDivide(v, TIME_FACTORS[u]);\n}\n\n/*───────────────────────────────────────────────────────────────\n  🚀 SPEED CONVERSIONS (normalize / unnormalize)\n───────────────────────────────────────────────────────────────*/\n\nexport function speedToMps(\n    v: number,\n    distUnit: DistanceUnit | string,\n    timeUnit: TimeUnit | string\n): number {\n    const du = canonDist(distUnit);\n    const tu = canonTime(timeUnit);\n    return v * (DIST_FACTORS[du] / TIME_FACTORS[tu]);\n}\n\nexport function mpsToSpeed(\n    vMps: number,\n    distUnit: DistanceUnit | string,\n    timeUnit: TimeUnit | string\n): number {\n    const du = canonDist(distUnit);\n    const tu = canonTime(timeUnit);\n    return vMps * (TIME_FACTORS[tu] / DIST_FACTORS[du]);\n}\n\n/*───────────────────────────────────────────────────────────────\n  🎯 UNIVERSAL CONVERTERS\n───────────────────────────────────────────────────────────────*/\n\nexport function convertDistance({\n    d,\n    fromDist,\n    toDist,\n    vOnly = true,\n}: ConvertDistance): OutDist {\n    const m = distanceToMeters(d, fromDist);\n    const D = canonDist(toDist ?? \"m\");\n    const out = metersToDistance(m, D);\n    return vOnly ? out : { d: out, D };\n}\n\nexport function convertTime({\n    t,\n    fromTime,\n    toTime,\n    vOnly = true,\n}: ConvertTime): OutTimeType {\n    const sec = timeToSeconds(t, fromTime);\n    const T = canonTime(toTime ?? \"s\");\n    const out = secondsToTime(sec, T);\n    return vOnly ? out : { t: out, T };\n}\n\nexport function convertSpeed({\n    v,\n    fromDist,\n    fromTime,\n    toDist,\n    toTime,\n    vOnly = true,\n}: ConvertSpeed): OutSpeedType {\n    const mps = speedToMps(v, fromDist, fromTime);\n    const d = canonDist(toDist ?? \"m\");\n    const t = canonTime(toTime ?? \"s\");\n    const out = mpsToSpeed(mps, d, t);\n    return vOnly ? out : { v: out, d, t };\n}\n\n/*───────────────────────────────────────────────────────────────\n  🧮 GENERIC “NORMALIZE / UNNORMALIZE” INTERFACES\n───────────────────────────────────────────────────────────────*/\n\nexport interface UnitConverter<T> {\n    normalize: (value: number, unit: T) => number;\n    unnormalize: (value: number, unit: T) => number;\n}\n\nexport const DistanceConverter: UnitConverter<DistanceUnit> = {\n    normalize: distanceToMeters,\n    unnormalize: metersToDistance,\n};\n\nexport const TimeConverter: UnitConverter<TimeUnit> = {\n    normalize: timeToSeconds,\n    unnormalize: secondsToTime,\n};\n\nexport const SpeedConverter: UnitConverter<[DistanceUnit, TimeUnit]> = {\n    normalize: (v: number, [du, tu]) => speedToMps(v, du, tu),\n    unnormalize: (v: number, [du, tu]) => mpsToSpeed(v, du, tu),\n};\n\n/*───────────────────────────────────────────────────────────────\n  🧩 COMPATIBILITY WRAPPERS (legacy aliases)\n───────────────────────────────────────────────────────────────*/\n\nexport const toMeters = distanceToMeters;\nexport const fromMeters = metersToDistance;\nexport const toSeconds = timeToSeconds;\nexport const fromSeconds = secondsToTime;\n\nexport const velocityToMs = (\n    value: number,\n    unit: string\n): number => speedToMps(value, unit, \"s\");\n\nexport const velocityFromMs = (\n    value: number,\n    unit: string\n): number => mpsToSpeed(value, unit, \"s\");\n\n/** Non-canonical helper for arbitrary rate conversion, e.g. ft/day → m/s */\nexport const fromMps = (\n    v: number,\n    dist_unit: DistanceUnit | string,\n    time_unit: TimeUnit | string\n): number => mpsToSpeed(v, dist_unit, time_unit);\n\n/*───────────────────────────────────────────────────────────────\n  📊 UTILITIES\n───────────────────────────────────────────────────────────────*/\n\nexport const isFiniteNum = (x: any): x is number => Number.isFinite(x);\nexport const fmt = (n: number, digits = 2) =>\n    isFiniteNum(n) ? n.toFixed(digits) : \"N/A\";\n\n"],"names":["METERS_PER_KM","METERS_PER_MILE","METERS_PER_FOOT","MINUTE","HOUR","DAY","safeMultiply","safeDivide"],"mappings":"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"}

package/dist/cjs/src/functions/math_utils/safe_math.js

@@ -0,0 +1,61 @@
+'use strict';
+
+var ensure_utils = require('../type_utils/src/ensure_utils.js');
+require('../type_utils/src/mime_utils.js');
+
+// take N args and coerce them all to numbers
+function safeNums(...args) {
+    return args.map(ensure_utils.ensure_number);
+}
+// divide the first value by each of the following
+function safeAdd(...args) {
+    const [head, ...rest] = safeNums(...args);
+    // if we don’t have a head or any divisor is zero, bail
+    return rest.reduce((acc, d) => acc + d, head);
+}
+// divide the first value by each of the following
+function safeSubtract(...args) {
+    const [head, ...rest] = safeNums(...args);
+    // if we don’t have a head or any divisor is zero, bail
+    return rest.reduce((acc, d) => acc - d, head);
+}
+// divide the first value by each of the following
+function safeDivide(...args) {
+    const [head, ...rest] = safeNums(...args);
+    // if we don’t have a head or any divisor is zero, bail
+    if (head === 0 || rest.some((d) => d === 0))
+        return 0;
+    return rest.reduce((acc, d) => acc / d, head);
+}
+// multiply all the values together
+function safeMultiply(...args) {
+    const nums = safeNums(...args);
+    // if any number is zero, result is zero
+    if (nums.includes(0))
+        return 0;
+    return nums.reduce((acc, n) => acc * n, 1);
+}
+// round a value to two decimals by percent
+function roundPercentage(x) {
+    const pct = safeMultiply(ensure_utils.ensure_number(x), 100);
+    return safeDivide(Math.round(pct), 100);
+}
+function exponential(i, k) {
+    return i * (10 ** (k));
+}
+function isZero(obj) {
+    if (obj == 0) {
+        return true;
+    }
+    return false;
+}
+
+exports.exponential = exponential;
+exports.isZero = isZero;
+exports.roundPercentage = roundPercentage;
+exports.safeAdd = safeAdd;
+exports.safeDivide = safeDivide;
+exports.safeMultiply = safeMultiply;
+exports.safeNums = safeNums;
+exports.safeSubtract = safeSubtract;
+//# sourceMappingURL=safe_math.js.map

package/dist/cjs/src/functions/math_utils/safe_math.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe_math.js","sources":["../../../../../src/functions/math_utils/safe_math.ts"],"sourcesContent":["\nimport { ensure_number } from './../type_utils/index.js';\n// take N args and coerce them all to numbers\nexport function safeNums(...args: Array<number | string | null | undefined>): number[] {\n  return args.map(ensure_number);\n}\n\n// divide the first value by each of the following\nexport function safeAdd(...args: Array<number | string | null | undefined>): number {\n  const [head, ...rest] = safeNums(...args);\n  // if we don’t have a head or any divisor is zero, bail\n  return rest.reduce((acc, d) => acc + d, head);\n}\n\n\n// divide the first value by each of the following\nexport function safeSubtract(...args: Array<number | string | null | undefined>): number {\n  const [head, ...rest] = safeNums(...args);\n  // if we don’t have a head or any divisor is zero, bail\n  return rest.reduce((acc, d) => acc - d, head);\n}\n\n// divide the first value by each of the following\nexport function safeDivide(...args: Array<number | string | null | undefined>): number {\n  const [head, ...rest] = safeNums(...args);\n  // if we don’t have a head or any divisor is zero, bail\n  if (head === 0 || rest.some((d) => d === 0)) return 0;\n  return rest.reduce((acc, d) => acc / d, head);\n}\n\n// multiply all the values together\nexport function safeMultiply(...args: Array<number | string | null | undefined>): number {\n  const nums = safeNums(...args);\n  // if any number is zero, result is zero\n  if (nums.includes(0)) return 0;\n  return nums.reduce((acc, n) => acc * n, 1);\n}\n\n// round a value to two decimals by percent\nexport function roundPercentage(x: any): number {\n  const pct = safeMultiply(ensure_number(x), 100);\n  return safeDivide(Math.round(pct), 100);\n}\nexport function exponential(i: number, k: number) {\n  return i * (10 ** (k))\n\n}\n\nexport function isZero(obj:any){\n  if (obj==0){\n    return true\n  }\n  return false\n}\n"],"names":["ensure_number"],"mappings":";;;;;AAEA;AACM,SAAU,QAAQ,CAAC,GAAG,IAA+C,EAAA;AACzE,IAAA,OAAO,IAAI,CAAC,GAAG,CAACA,0BAAa,CAAC;AAChC;AAEA;AACM,SAAU,OAAO,CAAC,GAAG,IAA+C,EAAA;AACxE,IAAA,MAAM,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAC;;AAEzC,IAAA,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,GAAG,GAAG,CAAC,EAAE,IAAI,CAAC;AAC/C;AAGA;AACM,SAAU,YAAY,CAAC,GAAG,IAA+C,EAAA;AAC7E,IAAA,MAAM,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAC;;AAEzC,IAAA,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,GAAG,GAAG,CAAC,EAAE,IAAI,CAAC;AAC/C;AAEA;AACM,SAAU,UAAU,CAAC,GAAG,IAA+C,EAAA;AAC3E,IAAA,MAAM,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAC;;AAEzC,IAAA,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAAE,QAAA,OAAO,CAAC;AACrD,IAAA,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,GAAG,GAAG,CAAC,EAAE,IAAI,CAAC;AAC/C;AAEA;AACM,SAAU,YAAY,CAAC,GAAG,IAA+C,EAAA;AAC7E,IAAA,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAC;;AAE9B,IAAA,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;AAAE,QAAA,OAAO,CAAC;AAC9B,IAAA,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC;AAC5C;AAEA;AACM,SAAU,eAAe,CAAC,CAAM,EAAA;IACpC,MAAM,GAAG,GAAG,YAAY,CAACA,0BAAa,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;IAC/C,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC;AACzC;AACM,SAAU,WAAW,CAAC,CAAS,EAAE,CAAS,EAAA;IAC9C,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;AAExB;AAEM,SAAU,MAAM,CAAC,GAAO,EAAA;AAC5B,IAAA,IAAI,GAAG,IAAE,CAAC,EAAC;AACT,QAAA,OAAO,IAAI;IACb;AACA,IAAA,OAAO,KAAK;AACd;;;;;;;;;;;"}

package/dist/cjs/src/functions/math_utils/time_utils.js

@@ -0,0 +1,9 @@
+'use strict';
+
+// Function to check time interval
+function isTimeInterval(timeObj, interval) {
+    return (Date.now() / 1000 - timeObj) < (interval - 1);
+}
+
+exports.isTimeInterval = isTimeInterval;
+//# sourceMappingURL=time_utils.js.map

package/dist/cjs/src/functions/math_utils/time_utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time_utils.js","sources":["../../../../../src/functions/math_utils/time_utils.ts"],"sourcesContent":["// Function to check time interval\nexport function isTimeInterval(timeObj: number, interval: number): boolean {\n    return (Date.now() / 1000 - timeObj) < (interval - 1);\n}\n"],"names":[],"mappings":";;AAAA;AACM,SAAU,cAAc,CAAC,OAAe,EAAE,QAAgB,EAAA;AAC5D,IAAA,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,OAAO,KAAK,QAAQ,GAAG,CAAC,CAAC;AACzD;;;;"}

package/dist/cjs/src/functions/path_utils/imports.js

@@ -0,0 +1,31 @@
+'use strict';
+
+require('../type_utils/src/mime_utils.js');
+
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+/**
+ * In the browser we already have a WHATWG URL constructor on window.
+ * Here we re-export it as “url” so other modules can import it.
+ */
+/**
+ * Minimal fileURLToPath implementation for browser-side code.
+ * If you only ever need to strip off “file://” in development, this is enough.
+ */
+function fileURLToPath(fileUrl) {
+    // e.g. fileUrl = "file:///Users/foo/bar.txt"
+    try {
+        const u = new URL(fileUrl);
+        return u.pathname;
+    }
+    catch {
+        // fallback: just strip file://
+        return fileUrl.replace(/^file:\/\//, '');
+    }
+}
+function getAbsolutePath() {
+    return fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('src/functions/path_utils/imports.js', document.baseURI).href)));
+}
+
+exports.fileURLToPath = fileURLToPath;
+exports.getAbsolutePath = getAbsolutePath;
+//# sourceMappingURL=imports.js.map

package/dist/cjs/src/functions/path_utils/imports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imports.js","sources":["../../../../../src/functions/path_utils/imports.ts"],"sourcesContent":["\n/** \n * In the browser we already have a WHATWG URL constructor on window.\n * Here we re-export it as “url” so other modules can import it.\n */\nconst _url = typeof window !== 'undefined' ? window.URL : undefined;\nexport { _url as url };\n/**\n * Minimal fileURLToPath implementation for browser-side code.\n * If you only ever need to strip off “file://” in development, this is enough.\n */\nexport function fileURLToPath(fileUrl: string): string {\n  // e.g. fileUrl = \"file:///Users/foo/bar.txt\"\n  try {\n    const u = new URL(fileUrl);\n    return u.pathname;\n  } catch {\n    // fallback: just strip file://\n    return fileUrl.replace(/^file:\\/\\//, '');\n  }\n}\nexport {eatOuter,eatInner} from './../string_utils/index.js';\nexport {ensure_list} from './../type_utils/index.js';\nexport function getAbsolutePath(): string {\n    return fileURLToPath(import.meta.url);\n};"],"names":[],"mappings":";;;;;AACA;;;AAGG;AAGH;;;AAGG;AACG,SAAU,aAAa,CAAC,OAAe,EAAA;;AAE3C,IAAA,IAAI;AACF,QAAA,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC;QAC1B,OAAO,CAAC,CAAC,QAAQ;IACnB;AAAE,IAAA,MAAM;;QAEN,OAAO,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;IAC1C;AACF;SAGgB,eAAe,GAAA;IAC3B,OAAO,aAAa,CAAC,qRAAe,CAAC;AACzC;;;;;"}

package/dist/cjs/src/functions/path_utils/src/base_dirs.js

@@ -0,0 +1,23 @@
+'use strict';
+
+var path_utils = require('./path_utils.js');
+var src_dirs = require('./src_dirs.js');
+
+function getBaseDir() {
+    return path_utils.get_dirname(src_dirs.getSrcDir());
+}
+function getPublicDir() {
+    return path_utils.make_path(getBaseDir(), 'public');
+}
+function getDistDir() {
+    return path_utils.make_path(getBaseDir(), 'dist');
+}
+function getEnvDir() {
+    return path_utils.make_path(getBaseDir(), '.env');
+}
+
+exports.getBaseDir = getBaseDir;
+exports.getDistDir = getDistDir;
+exports.getEnvDir = getEnvDir;
+exports.getPublicDir = getPublicDir;
+//# sourceMappingURL=base_dirs.js.map

package/dist/cjs/src/functions/path_utils/src/base_dirs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base_dirs.js","sources":["../../../../../../src/functions/path_utils/src/base_dirs.ts"],"sourcesContent":["import {make_path,get_dirname} from './path_utils.js';\nimport {getSrcDir} from './src_dirs.js';\nexport function getBaseDir(): string {\n    return get_dirname(getSrcDir());\n}\nexport function getPublicDir():string {\n    return make_path(getBaseDir(), 'public');\n};\nexport function getDistDir():string {\n    return make_path(getBaseDir(), 'dist');\n};\nexport function getEnvDir():string {\n    return make_path(getBaseDir(), '.env');\n};"],"names":["get_dirname","getSrcDir","make_path"],"mappings":";;;;;SAEgB,UAAU,GAAA;AACtB,IAAA,OAAOA,sBAAW,CAACC,kBAAS,EAAE,CAAC;AACnC;SACgB,YAAY,GAAA;AACxB,IAAA,OAAOC,oBAAS,CAAC,UAAU,EAAE,EAAE,QAAQ,CAAC;AAC5C;SACgB,UAAU,GAAA;AACtB,IAAA,OAAOA,oBAAS,CAAC,UAAU,EAAE,EAAE,MAAM,CAAC;AAC1C;SACgB,SAAS,GAAA;AACrB,IAAA,OAAOA,oBAAS,CAAC,UAAU,EAAE,EAAE,MAAM,CAAC;AAC1C;;;;;;;"}

package/dist/cjs/src/functions/path_utils/src/function_dirs.js

@@ -0,0 +1,47 @@
+'use strict';
+
+var path_utils = require('./path_utils.js');
+var paths = require('./paths.js');
+
+function getFunctionsDir() {
+    return path_utils.get_dirname(paths.getAbsDir());
+}
+function geAuthsUtilsDirectory() {
+    return path_utils.make_path(getFunctionsDir(), 'auths');
+}
+function geBackupsUtilsDirectory() {
+    return path_utils.make_path(getFunctionsDir(), 'backups');
+}
+function geConstantsUtilsDirectory() {
+    return path_utils.make_path(getFunctionsDir(), 'constants');
+}
+function geEnvUtilsDirectory() {
+    return path_utils.make_path(getFunctionsDir(), 'env_utils');
+}
+function geFetchUtilsDirectory() {
+    return path_utils.make_path(getFunctionsDir(), 'fetch_utils');
+}
+function geFileUtilsDirectory() {
+    return path_utils.make_path(getFunctionsDir(), 'file_utils');
+}
+function gePathUtilsDirectory() {
+    return path_utils.make_path(getFunctionsDir(), 'path_utils');
+}
+function geStringUtilsDirectory() {
+    return path_utils.make_path(getFunctionsDir(), 'string_utils');
+}
+function geTypeUtilsDirectory() {
+    return path_utils.make_path(getFunctionsDir(), 'type_utils');
+}
+
+exports.geAuthsUtilsDirectory = geAuthsUtilsDirectory;
+exports.geBackupsUtilsDirectory = geBackupsUtilsDirectory;
+exports.geConstantsUtilsDirectory = geConstantsUtilsDirectory;
+exports.geEnvUtilsDirectory = geEnvUtilsDirectory;
+exports.geFetchUtilsDirectory = geFetchUtilsDirectory;
+exports.geFileUtilsDirectory = geFileUtilsDirectory;
+exports.gePathUtilsDirectory = gePathUtilsDirectory;
+exports.geStringUtilsDirectory = geStringUtilsDirectory;
+exports.geTypeUtilsDirectory = geTypeUtilsDirectory;
+exports.getFunctionsDir = getFunctionsDir;
+//# sourceMappingURL=function_dirs.js.map

package/dist/cjs/src/functions/path_utils/src/function_dirs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"function_dirs.js","sources":["../../../../../../src/functions/path_utils/src/function_dirs.ts"],"sourcesContent":["import {make_path,get_dirname} from './path_utils.js';\nimport {getAbsDir} from './paths.js';\nexport function getFunctionsDir(): string {\n    return get_dirname(getAbsDir());\n};\n\n\nexport function geAuthsUtilsDirectory():string{\n    return make_path(getFunctionsDir(), 'auths');\n}; \nexport function geBackupsUtilsDirectory():string{\n    return make_path(getFunctionsDir(), 'backups');\n}; \nexport function geConstantsUtilsDirectory():string{\n    return make_path(getFunctionsDir(), 'constants');\n}; \nexport function geEnvUtilsDirectory():string{\n    return make_path(getFunctionsDir(), 'env_utils');\n}; \nexport function geFetchUtilsDirectory():string{\n    return make_path(getFunctionsDir(), 'fetch_utils');\n}; \nexport function geFileUtilsDirectory():string{\n    return make_path(getFunctionsDir(), 'file_utils');\n};\nexport function gePathUtilsDirectory():string{\n    return make_path(getFunctionsDir(), 'path_utils');\n}; \nexport function geStringUtilsDirectory():string{\n    return make_path(getFunctionsDir(), 'string_utils');\n}; \nexport function geTypeUtilsDirectory():string{\n    return make_path(getFunctionsDir(), 'type_utils');\n};"],"names":["get_dirname","getAbsDir","make_path"],"mappings":";;;;;SAEgB,eAAe,GAAA;AAC3B,IAAA,OAAOA,sBAAW,CAACC,eAAS,EAAE,CAAC;AACnC;SAGgB,qBAAqB,GAAA;AACjC,IAAA,OAAOC,oBAAS,CAAC,eAAe,EAAE,EAAE,OAAO,CAAC;AAChD;SACgB,uBAAuB,GAAA;AACnC,IAAA,OAAOA,oBAAS,CAAC,eAAe,EAAE,EAAE,SAAS,CAAC;AAClD;SACgB,yBAAyB,GAAA;AACrC,IAAA,OAAOA,oBAAS,CAAC,eAAe,EAAE,EAAE,WAAW,CAAC;AACpD;SACgB,mBAAmB,GAAA;AAC/B,IAAA,OAAOA,oBAAS,CAAC,eAAe,EAAE,EAAE,WAAW,CAAC;AACpD;SACgB,qBAAqB,GAAA;AACjC,IAAA,OAAOA,oBAAS,CAAC,eAAe,EAAE,EAAE,aAAa,CAAC;AACtD;SACgB,oBAAoB,GAAA;AAChC,IAAA,OAAOA,oBAAS,CAAC,eAAe,EAAE,EAAE,YAAY,CAAC;AACrD;SACgB,oBAAoB,GAAA;AAChC,IAAA,OAAOA,oBAAS,CAAC,eAAe,EAAE,EAAE,YAAY,CAAC;AACrD;SACgB,sBAAsB,GAAA;AAClC,IAAA,OAAOA,oBAAS,CAAC,eAAe,EAAE,EAAE,cAAc,CAAC;AACvD;SACgB,oBAAoB,GAAA;AAChC,IAAA,OAAOA,oBAAS,CAAC,eAAe,EAAE,EAAE,YAAY,CAAC;AACrD;;;;;;;;;;;;;"}

package/dist/cjs/src/functions/path_utils/src/misc_dirs.js

@@ -0,0 +1,23 @@
+'use strict';
+
+var base_dirs = require('./base_dirs.js');
+var path_utils = require('./path_utils.js');
+
+function getEnvPath(string = '.env') {
+    return path_utils.make_path(base_dirs.getEnvDir(), string);
+}
+function getDbConfigsPath() {
+    return path_utils.make_path(base_dirs.getBaseDir(), 'dbConfigs');
+}
+function getSchemasPath() {
+    return path_utils.make_path(getDbConfigsPath(), 'schemas');
+}
+function getSchemasDirPath(subPath) {
+    return path_utils.make_path(getSchemasPath(), subPath);
+}
+
+exports.getDbConfigsPath = getDbConfigsPath;
+exports.getEnvPath = getEnvPath;
+exports.getSchemasDirPath = getSchemasDirPath;
+exports.getSchemasPath = getSchemasPath;
+//# sourceMappingURL=misc_dirs.js.map

package/dist/cjs/src/functions/path_utils/src/misc_dirs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"misc_dirs.js","sources":["../../../../../../src/functions/path_utils/src/misc_dirs.ts"],"sourcesContent":["import {getBaseDir,getEnvDir} from './base_dirs.js';\nimport {make_path} from './path_utils.js';\nexport function getEnvPath(string:string='.env'):string {\n    return make_path(getEnvDir(),string);\n};\nexport function getDbConfigsPath(): string {\n    return make_path(getBaseDir(),'dbConfigs');\n}\nexport function getSchemasPath(): string {\n    return make_path(getDbConfigsPath(),'schemas');\n}\nexport function getSchemasDirPath(subPath: string): string {\n    return make_path(getSchemasPath(),subPath);\n}\n"],"names":["make_path","getEnvDir","getBaseDir"],"mappings":";;;;;AAEM,SAAU,UAAU,CAAC,MAAA,GAAc,MAAM,EAAA;AAC3C,IAAA,OAAOA,oBAAS,CAACC,mBAAS,EAAE,EAAC,MAAM,CAAC;AACxC;SACgB,gBAAgB,GAAA;AAC5B,IAAA,OAAOD,oBAAS,CAACE,oBAAU,EAAE,EAAC,WAAW,CAAC;AAC9C;SACgB,cAAc,GAAA;AAC1B,IAAA,OAAOF,oBAAS,CAAC,gBAAgB,EAAE,EAAC,SAAS,CAAC;AAClD;AACM,SAAU,iBAAiB,CAAC,OAAe,EAAA;AAC7C,IAAA,OAAOA,oBAAS,CAAC,cAAc,EAAE,EAAC,OAAO,CAAC;AAC9C;;;;;;;"}