@putkoff/abstract-utilities 1.0.113 → 1.0.124

package/dist/types/functions/fetch_utils/src/url_utils.js

@@ -1,86 +0,0 @@
-import path from 'path';
-export function urlJoin(...parts) {
-    var _a;
-    const s = (parts.length === 1 && Array.isArray(parts[0]) ? parts[0] : parts);
-    let r = "";
-    for (let i = 0; i < s.length; i++) {
-        let d = ((_a = s[i]) !== null && _a !== void 0 ? _a : "").toString();
-        if (!d)
-            continue;
-        if (i === 0)
-            r = d;
-        else {
-            d = d.replace(/^\/+/, "");
-            r = r.replace(/\/+$/, "");
-            r = `${r}/${d}`;
-        }
-    }
-    return r;
-}
-/**
- * Returns a full URL.
- * If partial_url is already absolute (starts with http), it is returned as is.
- * Otherwise, it is combined with the base URL.
- */
-export function get_full_url(partial_url, domain = null) {
-    if (typeof partial_url !== 'string') {
-        throw new Error('partial_url must be a string');
-    }
-    // If it already starts with http, assume it is absolute.
-    if (partial_url.startsWith('http')) {
-        return partial_url;
-    }
-    return urlJoin(domain, partial_url);
-}
-/**
- * Returns a full file system path.
- * If partial_path is already absolute, it is returned as is.
- * Otherwise, it is joined with the base directory.
- */
-export function get_full_path(partial_path, parent_dir = null) {
-    if (typeof partial_path !== 'string') {
-        throw new Error('partial_path must be a string');
-    }
-    if (path.isAbsolute(partial_path)) {
-        return partial_path;
-    }
-    return urlJoin(parent_dir, partial_path);
-}
-/**
- * Converts a local file system path into its corresponding URL.
- * It checks against the known directories in all_paths and replaces the matching base.
- */
-export function path_to_url(filePath, all_paths) {
-    if (typeof filePath !== 'string') {
-        throw new Error('filePath must be a string');
-    }
-    for (const key in all_paths) {
-        const mapping = all_paths[key];
-        const normalizedBase = path.normalize(mapping.path);
-        if (filePath.startsWith(normalizedBase)) {
-            const relativePath = filePath.substring(normalizedBase.length);
-            return urlJoin(mapping.url, relativePath.replace(/\\/g, '/'));
-        }
-    }
-    return null;
-}
-/**
- * Converts a URL into its corresponding local file system path.
- * It checks against the known URL prefixes in all_paths and replaces the matching base.
- */
-export function url_to_path(urlStr, all_paths) {
-    if (typeof urlStr !== 'string') {
-        throw new Error('urlStr must be a string');
-    }
-    for (const key in all_paths) {
-        const mapping = all_paths[key];
-        if (urlStr.startsWith(mapping.url)) {
-            const relativeUrl = urlStr.substring(mapping.url.length);
-            return urlJoin(mapping.path, relativeUrl);
-        }
-    }
-    return null;
-}
-export function urljoin(...parts) {
-    return urlJoin(...parts);
-}

package/dist/types/functions/fetch_utils/src/utils.js

@@ -1,102 +0,0 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-/**
- * Unwraps nested { result } fields until you hit a non-object or no more "result" keys.
- */
-export function getResult(obj) {
-    let current = obj;
-    while (current &&
-        typeof current === "object" &&
-        Object.prototype.hasOwnProperty.call(current, "result")) {
-        current = current.result;
-    }
-    return current;
-}
-// Determines HTTP method, defaults to GET or POST based on body
-export function getMethod(method = null, body = null) {
-    const validMethods = ['GET', 'POST', 'PUT', 'PATCH', 'PULL'];
-    method = (method || '').toUpperCase();
-    if (!validMethods.includes(method)) {
-        method = body ? 'POST' : 'GET';
-    }
-    return method;
-}
-// Gets headers, skips JSON headers when body is FormData
-export function getHeaders(headers = {}, method = null, body = null) {
-    const result = Object.assign({}, headers);
-    // let browser set boundary
-    if (body instanceof FormData) {
-        return result;
-    }
-    const upper = method === null || method === void 0 ? void 0 : method.toUpperCase();
-    if (['POST', 'PUT', 'PATCH'].includes(upper !== null && upper !== void 0 ? upper : '') &&
-        !result['Content-Type']) {
-        result['Content-Type'] = 'application/json';
-    }
-    return result;
-}
-// Prepares request body, serializes to JSON for non-GET requests
-export function getBody(body = null, method = null) {
-    method = getMethod(method, body);
-    if (method === 'GET') {
-        return undefined;
-    }
-    if (body) {
-        try {
-            return JSON.stringify(body);
-        }
-        catch (err) {
-            return body;
-        }
-    }
-    return undefined;
-}
-// Prepares fetch variables, passes FormData intact
-export function getFetchVars(headers = null, method = null, body = null) {
-    method = getMethod(method, body);
-    headers = getHeaders(headers || {}, method, body);
-    // only JSON-stringify non-FormData bodies
-    if (!(body instanceof FormData)) {
-        body = getBody(body, method);
-    }
-    return { method, headers, body };
-}
-/*
- * parseResult no longer needs to worry about JSON vs HTML redirect errors;
- * all 401/403 have already been handled above.
- */
-export function parseResult(res) {
-    return __awaiter(this, void 0, void 0, function* () {
-        // runs checkResponse first, will throw if session is expired
-        res = checkResponse(res);
-        if (!res.ok) {
-            // for any other non-401 errors, you can still surface them
-            const errorText = yield res.text();
-            throw new Error(errorText || res.statusText);
-        }
-        // now safely parse JSON
-        return res.json();
-    });
-}
-/**
- * Intercept 401/403 and force a clean redirect to login
- * without ever showing an alert.
- */
-export function checkResponse(res) {
-    if (res.status === 401 || res.status === 403) {
-        // 1) clear out the stale token
-        localStorage.removeItem("token");
-        // 2) replace history so "back" doesn’t re-trigger the protected route
-        window.history.replaceState({}, "", "/secure-files");
-        // 3) short-circuit all further fetch logic
-        throw new Error("SessionExpired");
-    }
-    return res;
-}

package/dist/types/functions/index.js

@@ -1,17 +0,0 @@
-export * from './auth_utils';
-export * from './constants_utils';
-export * from './env_utils';
-export * from './fetch_utils';
-export * from './path_utils';
-export * from './rndm_utils';
-export * from './string_utils';
-export * from './math_utils';
-export * from './type_utils';
-export * from './config_utils';
-export * from './read_utils';
-export * from './safe_utils';
-export * from './read_utils';
-export * from './variable_utils';
-export * from './size_utils';
-export * from './print_utils';
-export * from './inspect_utils';

package/dist/types/functions/inspect_utils/imports.js

@@ -1 +0,0 @@
-export { inspect } from "util";

package/dist/types/functions/inspect_utils/index.js

@@ -1,2 +0,0 @@
-export * from './src';
-export * from './imports';

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

@@ -1,28 +0,0 @@
-export function getLastCaller(skip = ["debugPrint"]) {
-    var _a;
-    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 = (_a = match[1]) !== null && _a !== void 0 ? _a : "anonymous";
-        if (skip.includes(functionName))
-            continue;
-        return {
-            functionName,
-            file: match[2],
-            line: Number(match[3]),
-            column: Number(match[4]),
-        };
-    }
-    return null;
-}

package/dist/types/functions/inspect_utils/src/index.js

@@ -1 +0,0 @@
-export * from './caller_utils';

package/dist/types/functions/math_utils/bigint_utils.js

@@ -1,36 +0,0 @@
-// src/functions/typeUtils/numUtils.ts
-import { getLogString } from '@putkoff/abstract-logger';
-const FILE_LOCATION = 'src/functions/typeUtils/numUtils.ts';
-/**
- * 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
- */
-export 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) {
-        getLogString({
-            message: 'Error converting BigInt',
-            logType: 'warn',
-            details: error.message,
-            function_name: 'convertBigInts',
-            file_location: FILE_LOCATION
-        });
-        return obj;
-    }
-    return obj;
-}

package/dist/types/functions/math_utils/constants.js

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

package/dist/types/functions/math_utils/conversions.js

@@ -1,129 +0,0 @@
-// conversions.ts
-import { METERS_PER_KM, METERS_PER_MILE, METERS_PER_FOOT, MINUTE, HOUR, DAY, } from "./constants";
-import { safeMultiply, safeDivide } from "./safe_math";
-/*───────────────────────────────────────────────────────────────
-  🧭 CANONICAL MAPPINGS
-───────────────────────────────────────────────────────────────*/
-export 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",
-};
-export 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",
-};
-export const DIST_FACTORS = {
-    m: 1,
-    km: METERS_PER_KM,
-    mi: METERS_PER_MILE,
-    ft: METERS_PER_FOOT,
-};
-export const TIME_FACTORS = {
-    s: 1,
-    min: MINUTE,
-    h: HOUR,
-    day: DAY,
-};
-/*───────────────────────────────────────────────────────────────
-  🔍 CANONICALIZATION HELPERS
-───────────────────────────────────────────────────────────────*/
-export function canonDist(u) {
-    const key = (u !== null && u !== void 0 ? u : "m").toString().toLowerCase();
-    const canon = DIST_ALIASES[key];
-    if (!canon)
-        throw new Error(`Unknown distance unit: ${u}`);
-    return canon;
-}
-export function canonTime(u) {
-    const key = (u !== null && u !== void 0 ? u : "s").toString().toLowerCase();
-    const canon = TIME_ALIASES[key];
-    if (!canon)
-        throw new Error(`Unknown time unit: ${u}`);
-    return canon;
-}
-/*───────────────────────────────────────────────────────────────
-  ⚖️ NORMALIZATION HELPERS
-───────────────────────────────────────────────────────────────*/
-export function distanceToMeters(d, unit) {
-    const u = canonDist(unit);
-    return safeMultiply(d, DIST_FACTORS[u]);
-}
-export function metersToDistance(v, unit) {
-    const u = canonDist(unit);
-    return safeDivide(v, DIST_FACTORS[u]);
-}
-export function timeToSeconds(t, unit) {
-    const u = canonTime(unit);
-    return safeMultiply(t, TIME_FACTORS[u]);
-}
-export function secondsToTime(v, unit) {
-    const u = canonTime(unit);
-    return safeDivide(v, TIME_FACTORS[u]);
-}
-/*───────────────────────────────────────────────────────────────
-  🚀 SPEED CONVERSIONS (normalize / unnormalize)
-───────────────────────────────────────────────────────────────*/
-export function speedToMps(v, distUnit, timeUnit) {
-    const du = canonDist(distUnit);
-    const tu = canonTime(timeUnit);
-    return v * (DIST_FACTORS[du] / TIME_FACTORS[tu]);
-}
-export function mpsToSpeed(vMps, distUnit, timeUnit) {
-    const du = canonDist(distUnit);
-    const tu = canonTime(timeUnit);
-    return vMps * (TIME_FACTORS[tu] / DIST_FACTORS[du]);
-}
-/*───────────────────────────────────────────────────────────────
-  🎯 UNIVERSAL CONVERTERS
-───────────────────────────────────────────────────────────────*/
-export function convertDistance({ d, fromDist, toDist, vOnly = true, }) {
-    const m = distanceToMeters(d, fromDist);
-    const D = canonDist(toDist !== null && toDist !== void 0 ? toDist : "m");
-    const out = metersToDistance(m, D);
-    return vOnly ? out : { d: out, D };
-}
-export function convertTime({ t, fromTime, toTime, vOnly = true, }) {
-    const sec = timeToSeconds(t, fromTime);
-    const T = canonTime(toTime !== null && toTime !== void 0 ? toTime : "s");
-    const out = secondsToTime(sec, T);
-    return vOnly ? out : { t: out, T };
-}
-export function convertSpeed({ v, fromDist, fromTime, toDist, toTime, vOnly = true, }) {
-    const mps = speedToMps(v, fromDist, fromTime);
-    const d = canonDist(toDist !== null && toDist !== void 0 ? toDist : "m");
-    const t = canonTime(toTime !== null && toTime !== void 0 ? toTime : "s");
-    const out = mpsToSpeed(mps, d, t);
-    return vOnly ? out : { v: out, d, t };
-}
-export const DistanceConverter = {
-    normalize: distanceToMeters,
-    unnormalize: metersToDistance,
-};
-export const TimeConverter = {
-    normalize: timeToSeconds,
-    unnormalize: secondsToTime,
-};
-export const SpeedConverter = {
-    normalize: (v, [du, tu]) => speedToMps(v, du, tu),
-    unnormalize: (v, [du, tu]) => mpsToSpeed(v, du, tu),
-};
-/*───────────────────────────────────────────────────────────────
-  🧩 COMPATIBILITY WRAPPERS (legacy aliases)
-───────────────────────────────────────────────────────────────*/
-export const toMeters = distanceToMeters;
-export const fromMeters = metersToDistance;
-export const toSeconds = timeToSeconds;
-export const fromSeconds = secondsToTime;
-export const velocityToMs = (value, unit) => speedToMps(value, unit, "s");
-export const velocityFromMs = (value, unit) => mpsToSpeed(value, unit, "s");
-/** Non-canonical helper for arbitrary rate conversion, e.g. ft/day → m/s */
-export const fromMps = (v, dist_unit, time_unit) => mpsToSpeed(v, dist_unit, time_unit);
-/*───────────────────────────────────────────────────────────────
-  📊 UTILITIES
-───────────────────────────────────────────────────────────────*/
-export const isFiniteNum = (x) => Number.isFinite(x);
-export const fmt = (n, digits = 2) => isFiniteNum(n) ? n.toFixed(digits) : "N/A";

package/dist/types/functions/math_utils/index.js

@@ -1,6 +0,0 @@
-export * from './safe_math';
-export * from './conversions';
-export * from './constants';
-export * from './scaleInterfaces';
-export * from './time_utils';
-export * from './bigint_utils';

package/dist/types/functions/math_utils/safe_math.js

@@ -1,35 +0,0 @@
-import { ensure_number } from './../type_utils';
-// take N args and coerce them all to numbers
-export function safeNums(...args) {
-    return args.map(ensure_number);
-}
-// divide the first value by each of the following
-export 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
-export 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
-export function roundPercentage(x) {
-    const pct = safeMultiply(ensure_number(x), 100);
-    return safeDivide(Math.round(pct), 100);
-}
-export function exponential(i, k) {
-    return i * (10 ** (k));
-}
-export function isZero(obj) {
-    if (obj == 0) {
-        return true;
-    }
-    return false;
-}

package/dist/types/functions/math_utils/scaleInterfaces.js

@@ -1,3 +0,0 @@
-// DO NOT import TimeUnit from chart.js
-// import { TimeUnit } from 'chart.js'  // ❌ remove
-export {};

package/dist/types/functions/math_utils/time_utils.js

@@ -1,4 +0,0 @@
-// Function to check time interval
-export function isTimeInterval(timeObj, interval) {
-    return (Date.now() / 1000 - timeObj) < (interval - 1);
-}

package/dist/types/functions/path_utils/imports.js

@@ -1,27 +0,0 @@
-/**
- * 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.
- */
-const _url = typeof window !== 'undefined' ? window.URL : undefined;
-export { _url as url };
-/**
- * Minimal fileURLToPath implementation for browser-side code.
- * If you only ever need to strip off “file://” in development, this is enough.
- */
-export function fileURLToPath(fileUrl) {
-    // e.g. fileUrl = "file:///Users/foo/bar.txt"
-    try {
-        const u = new URL(fileUrl);
-        return u.pathname;
-    }
-    catch (_a) {
-        // fallback: just strip file://
-        return fileUrl.replace(/^file:\/\//, '');
-    }
-}
-export { eatOuter, eatInner } from './../string_utils';
-export { ensure_list } from './../type_utils';
-export function getAbsolutePath() {
-    return fileURLToPath(import.meta.url);
-}
-;

package/dist/types/functions/path_utils/index.js

@@ -1 +0,0 @@
-export * from './src';

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

@@ -1,17 +0,0 @@
-import { make_path, get_dirname } from './path_utils';
-import { getSrcDir } from './src_dirs';
-export function getBaseDir() {
-    return get_dirname(getSrcDir());
-}
-export function getPublicDir() {
-    return make_path(getBaseDir(), 'public');
-}
-;
-export function getDistDir() {
-    return make_path(getBaseDir(), 'dist');
-}
-;
-export function getEnvDir() {
-    return make_path(getBaseDir(), '.env');
-}
-;

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

@@ -1,42 +0,0 @@
-import { make_path, get_dirname } from './path_utils';
-import { getAbsDir } from './paths';
-export function getFunctionsDir() {
-    return get_dirname(getAbsDir());
-}
-;
-export function geAuthsUtilsDirectory() {
-    return make_path(getFunctionsDir(), 'auths');
-}
-;
-export function geBackupsUtilsDirectory() {
-    return make_path(getFunctionsDir(), 'backups');
-}
-;
-export function geConstantsUtilsDirectory() {
-    return make_path(getFunctionsDir(), 'constants');
-}
-;
-export function geEnvUtilsDirectory() {
-    return make_path(getFunctionsDir(), 'env_utils');
-}
-;
-export function geFetchUtilsDirectory() {
-    return make_path(getFunctionsDir(), 'fetch_utils');
-}
-;
-export function geFileUtilsDirectory() {
-    return make_path(getFunctionsDir(), 'file_utils');
-}
-;
-export function gePathUtilsDirectory() {
-    return make_path(getFunctionsDir(), 'path_utils');
-}
-;
-export function geStringUtilsDirectory() {
-    return make_path(getFunctionsDir(), 'string_utils');
-}
-;
-export function geTypeUtilsDirectory() {
-    return make_path(getFunctionsDir(), 'type_utils');
-}
-;

package/dist/types/functions/path_utils/src/index.js

@@ -1,6 +0,0 @@
-export * from './path_utils';
-export * from './paths';
-export * from './function_dirs';
-export * from './src_dirs';
-export * from './base_dirs';
-export * from './misc_dirs';

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

@@ -1,15 +0,0 @@
-import { getBaseDir, getEnvDir } from './base_dirs';
-import { make_path } from './path_utils';
-export function getEnvPath(string = '.env') {
-    return make_path(getEnvDir(), string);
-}
-;
-export function getDbConfigsPath() {
-    return make_path(getBaseDir(), 'dbConfigs');
-}
-export function getSchemasPath() {
-    return make_path(getDbConfigsPath(), 'schemas');
-}
-export function getSchemasDirPath(subPath) {
-    return make_path(getSchemasPath(), subPath);
-}