@putkoff/abstract-utilities 1.0.113 → 1.0.124

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

@@ -1,160 +0,0 @@
-import * as path from 'path-browserify';
-import { eatOuter, eatInner, ensure_list } from './../imports';
-export function get_dirname(filePath) {
-    if (!filePath)
-        return '';
-    return path.dirname(filePath);
-}
-export function get_basename(filePath) {
-    if (!filePath)
-        return '';
-    return path.basename(filePath);
-}
-export function get_filename(filePath) {
-    if (!filePath)
-        return '';
-    const ext = path.extname(filePath);
-    return path.basename(filePath, ext);
-}
-export function get_extname(filePath) {
-    if (!filePath)
-        return '';
-    return path.extname(filePath);
-}
-export function get_splitext(filePath) {
-    if (!filePath)
-        return { filename: '', extname: '' };
-    const ext = path.extname(filePath);
-    // Get the basename without the extension
-    const filename = path.basename(filePath, ext);
-    return { filename, ext };
-}
-/**
- * Returns the path of `targetPath` relative to `basePath`.
- * Normalizes separators for consistent web and server environments.
- *
- * @param basePath - The base directory you want to compare from.
- * @param targetPath - The full path of the file/directory.
- * @returns A normalized relative path (e.g., "subdir/file.txt").
- */
-export function get_relative_path(basePath, targetPath) {
-    try {
-        // Compute the relative path using Node's native path.relative
-        let rel = path.relative(basePath, targetPath);
-        // Normalize to POSIX-style slashes for consistency (especially on Windows)
-        rel = rel.split(path.sep).join('/');
-        // Avoid empty string (happens if both paths are identical)
-        return rel || '.';
-    }
-    catch (err) {
-        console.error(`[get_relative_path] Error computing relative path`, err);
-        return targetPath;
-    }
-}
-/**
- * Join multiple path segments — clean, predictable, bulletproof.
- *
- * Accepts ANYTHING that ensure_list can handle:
- *   • 'a,b,c'
- *   • ['a', 'b,c']
- *   • 'a/b/c'
- *   • '/a/', 'b//c'
- *   • mixed arrays, comma strings, whatever
- *
- * Always returns a clean POSIX path string. Never a list.
- */
-export function make_path(...parts) {
-    // Normalize incoming segments into a flat list
-    const segments = ensure_list(parts).map(x => String(x));
-    let out = "";
-    for (let i = 0; i < segments.length; i++) {
-        const seg = segments[i];
-        // Normalize a segment:
-        let cleaned = eatOuter(seg, "/"); // trim trailing slashes
-        if (!cleaned)
-            continue;
-        if (out === "") {
-            out = cleaned;
-        }
-        else {
-            cleaned = eatInner(cleaned, "/"); // trim leading slashes
-            out = `${out}/${cleaned}`;
-        }
-    }
-    return out;
-}
-export function sanitizeFilename(filename) {
-    return filename
-        .toLowerCase()
-        .replace(/\s+|-/g, '-') // Replace spaces and hyphens with single hyphen
-        .replace(/_/g, '-') // Replace underscores with hyphens
-        .replace(/[^a-z0-9-.]/g, '') // Remove all non-alphanumeric chars except hyphen and dot
-        .replace(/-+/g, '-') // Collapse multiple hyphens into one
-        .replace(/^-|-$/, ''); // Remove leading/trailing hyphens
-}
-export function make_sanitized_path(...paths) {
-    let real_path = '';
-    for (let i = 0; i < paths.length; i++) {
-        const sanitized = sanitizeFilename(eatOuter(paths[i], '/'));
-        if (i === 0) {
-            real_path = sanitized;
-        }
-        else if (sanitized) { // Only append if there's a non-empty segment
-            real_path = `${real_path}/${sanitized}`;
-        }
-    }
-    return real_path || '';
-}
-export function normalizeUrl(base, p) {
-    if (!p)
-        return base;
-    const cleanBase = base.replace(/\/+$/, ''); // regex literal
-    const cleanPath = p.replace(/^\/+/, '');
-    // collapse multiple “//” into one, but keep the “://” after protocol
-    return `${cleanBase}/${cleanPath}`.replace(/([^:])\/{2,}/g, '$1/');
-}
-export function pathjoin(...parts) {
-    return make_path(...parts);
-}
-export function pathJoin(...parts) {
-    return make_path(...parts);
-}
-export function makepath(...parts) {
-    return make_path(...parts);
-}
-export function makePath(...parts) {
-    return make_path(...parts);
-}
-export function path_join(...parts) {
-    return make_path(...parts);
-}
-export function getSplitext(filePath) {
-    return get_splitext(filePath);
-}
-export function getsplitext(filePath) {
-    return get_splitext(filePath);
-}
-export function getextname(filePath) {
-    return get_extname(filePath);
-}
-export function getExtname(filePath) {
-    return get_extname(filePath);
-}
-export function getfilename(filePath) {
-    return get_filename(filePath);
-}
-export function getFilename(filePath) {
-    return get_filename(filePath);
-}
-export function getbasename(filePath) {
-    return get_basename(filePath);
-}
-export function getBasename(filePath) {
-    return get_basename(filePath);
-}
-export function getdirname(filePath) {
-    return get_dirname(filePath);
-}
-export function getDirname(filePath) {
-    return get_dirname(filePath);
-}

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

@@ -1,12 +0,0 @@
-import { getAbsolutePath } from './../imports';
-import { get_dirname, make_path } from './path_utils';
-/**
- * Returns the absolute path of the current file.
- */
-export function getAbsDir() {
-    return get_dirname(getAbsolutePath());
-}
-;
-export function getAbsPath(subPath) {
-    return make_path(getAbsDir(), subPath);
-}

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

@@ -1,25 +0,0 @@
-import { make_path, get_dirname } from './path_utils';
-import { getFunctionsDir } from './function_dirs';
-export function getSrcDir() {
-    return get_dirname(getFunctionsDir());
-}
-;
-export function geStaticDirectory() {
-    return make_path(getSrcDir(), 'static');
-}
-;
-export function getLibUtilsDirectory() {
-    return make_path(getSrcDir(), 'lib');
-}
-export function getHooksUtilsDirectory() {
-    return make_path(getSrcDir(), 'hooks');
-}
-;
-export function getFunctionsUtilsDirectory() {
-    return make_path(getSrcDir(), 'functions');
-}
-;
-export function getComponentsUtilsDirectory() {
-    return make_path(getSrcDir(), 'components');
-}
-;

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

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

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

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

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

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

package/dist/types/functions/print_utils/src/print_utils.js

@@ -1,14 +0,0 @@
-import { getLastCaller, inspect } from './../imports';
-export function debugPrint(value, label = null) {
-    const caller = getLastCaller();
-    const header = label !== null && label !== void 0 ? label : (caller
-        ? `${caller.functionName} @ ${caller.file}:${caller.line}`
-        : "object");
-    console.log(`\n🔍 ${header}`);
-    console.log(inspect(value, {
-        depth: null,
-        colors: true,
-        compact: false,
-        maxArrayLength: null,
-    }));
-}

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

@@ -1 +0,0 @@
-export { safeGlobalProp } from './../safe_utils';

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

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

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

@@ -1,3 +0,0 @@
-export * from './readJsonFile.browser';
-export * from './readJsonFile.node';
-export * from './readJsonFile';

package/dist/types/functions/read_utils/src/readJsonFile.browser.js

@@ -1,26 +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());
-    });
-};
-import { safeGlobalProp } from "./../imports";
-export function readJsonFileBrowser(url) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const fetchFn = safeGlobalProp("fetch");
-        if (typeof fetchFn !== "function")
-            return null;
-        try {
-            const res = yield fetchFn(url);
-            if (!res.ok)
-                return null;
-            return (yield res.json());
-        }
-        catch (_a) {
-            return null;
-        }
-    });
-}

package/dist/types/functions/read_utils/src/readJsonFile.js

@@ -1,35 +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());
-    });
-};
-export function readJsonFile(relativeOrAbsolutePath) {
-    return __awaiter(this, void 0, void 0, function* () {
-        var _a;
-        if (typeof process !== "undefined" && ((_a = process.versions) === null || _a === void 0 ? void 0 : _a.node)) {
-            const mod = yield import("./readJsonFile.node");
-            return mod.readJsonFileNode(relativeOrAbsolutePath);
-        }
-        else {
-            const mod = yield import("./readJsonFile.browser");
-            return mod.readJsonFileBrowser(relativeOrAbsolutePath);
-        }
-    });
-}
-export function getConfigContent() {
-    return __awaiter(this, void 0, void 0, function* () {
-        try {
-            // `readJsonFile` should throw if the file isn’t there or isn’t valid JSON
-            const cfg = yield readJsonFile('./config.json');
-            return cfg;
-        }
-        catch (_a) {
-            // swallow errors & return null so callers can detect “no config”
-            return null;
-        }
-    });
-}

package/dist/types/functions/read_utils/src/readJsonFile.node.js

@@ -1,13 +0,0 @@
-import { readFileSync } from "node:fs";
-import { resolve, isAbsolute } from "node:path";
-export function readJsonFileNode(relativeOrAbsolutePath) {
-    try {
-        const filePath = isAbsolute(relativeOrAbsolutePath)
-            ? relativeOrAbsolutePath
-            : resolve(process.cwd(), relativeOrAbsolutePath);
-        return JSON.parse(readFileSync(filePath, "utf8"));
-    }
-    catch (_a) {
-        return null;
-    }
-}

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

@@ -1 +0,0 @@
-"use strict";

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

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

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

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

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

@@ -1,12 +0,0 @@
-// src/functions/rndm_utils/utils.ts
-export function alertit(obj = null) {
-    let msg;
-    try {
-        msg = JSON.stringify(obj);
-    }
-    catch (_a) {
-        // If JSON.stringify fails (circular refs, etc.), fall back to a simple string
-        msg = String(obj);
-    }
-    alert(msg);
-}

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

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

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

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

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

@@ -1,4 +0,0 @@
-export * from './safe_document';
-export * from './safe_storage';
-export * from './safe_globals';
-export * from './safe_window';

package/dist/types/functions/safe_utils/src/safe_document.js

@@ -1,12 +0,0 @@
-export function getSafeDocument() {
-    return typeof document !== 'undefined' ? document : undefined;
-}
-export function getDocumentProp(...keys) {
-    let obj = getSafeDocument();
-    for (const k of keys) {
-        if (obj == null || typeof obj !== 'object')
-            return undefined;
-        obj = obj[k];
-    }
-    return obj;
-}

package/dist/types/functions/safe_utils/src/safe_globals.js

@@ -1,14 +0,0 @@
-/**
- * Safely walk `globalThis` (or window/document) by a chain of property names.
- * Returns `undefined` if any step is missing.
- */
-export function safeGlobalProp(...path) {
-    let obj = globalThis;
-    for (const key of path) {
-        if (obj == null || typeof obj !== "object" || !(key in obj)) {
-            return undefined;
-        }
-        obj = obj[key];
-    }
-    return obj;
-}

package/dist/types/functions/safe_utils/src/safe_storage.js

@@ -1,50 +0,0 @@
-import { safeGlobalProp } from './safe_globals';
-/**
- * Returns `window` if running in a browser, otherwise `undefined`.
- */
-export function getSafeLocalStorage() {
-    if (typeof window === 'undefined')
-        return undefined;
-    try {
-        return window.localStorage;
-    }
-    catch (_a) {
-        return undefined; // e.g. Safari private-mode block
-    }
-}
-/**
- * Call a Storage method by name, silencing any errors or missing storage.
- *
- * @param method  One of the keys of the Storage interface: "getItem", "setItem", etc.
- * @param args    The arguments you’d normally pass to that method.
- * @returns       The method’s return value, or undefined if storage/method isn’t available.
- */
-export function callStorage(method, ...args) {
-    const storage = getSafeLocalStorage();
-    if (!storage)
-        return undefined;
-    const fn = storage[method];
-    if (typeof fn !== 'function')
-        return undefined;
-    try {
-        return fn.apply(storage, args);
-    }
-    catch (_a) {
-        return undefined;
-    }
-}
-/**
- * Safely call storage methods (`localStorage` or `sessionStorage`) without blowing up.
- * Returns `undefined` on any error.
- */
-export function safeStorage(storageName, method, ...args) {
-    try {
-        const store = safeGlobalProp(storageName);
-        if (!store || typeof store[method] !== "function")
-            return undefined;
-        return store[method](...args);
-    }
-    catch (_a) {
-        return undefined;
-    }
-}

package/dist/types/functions/safe_utils/src/safe_window.js

@@ -1,42 +0,0 @@
-/**
- * Returns the global window object if it exists, otherwise undefined.
- */
-export function getSafeWindow() {
-    return typeof window !== 'undefined' ? window : undefined;
-}
-/**
- * Safely call a method on window by name.
- *
- * @param method  The Window method to call (e.g. "alert", "open", etc.).
- * @param args    Arguments to pass to that method.
- * @returns       The method’s return value, or undefined if
- *                 window/method isn’t available or throws.
- */
-export function callWindowMethod(method, ...args) {
-    const w = getSafeWindow();
-    if (!w)
-        return undefined;
-    const fn = w[method];
-    if (typeof fn !== 'function')
-        return undefined;
-    try {
-        // cast to any so TS doesn’t complain about apply/invoke
-        return fn(...args);
-    }
-    catch (_a) {
-        return undefined;
-    }
-}
-/** implementation */
-export function getWindowProp(...keys) {
-    let obj = getSafeWindow();
-    for (const k of keys) {
-        if (obj == null || typeof obj !== 'object')
-            return undefined;
-        obj = obj[k];
-    }
-    return obj;
-}
-export function getWindowHost() {
-    return getWindowProp('location', 'host');
-}

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

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

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

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

package/dist/types/functions/size_utils/src/sizeUtils.js

@@ -1,44 +0,0 @@
-// Function to compare MB
-export function exceedsMbLimit(limitMb, payloadMb) {
-    return payloadMb > limitMb;
-}
-export function safeJsonSizeInMb(value) {
-    const seen = new WeakSet();
-    const json = JSON.stringify(value, (_, v) => {
-        if (typeof v === "bigint")
-            return v.toString();
-        if (typeof v === "object" && v !== null) {
-            if (seen.has(v))
-                return "[Circular]";
-            seen.add(v);
-        }
-        return v;
-    });
-    return Buffer.byteLength(json, "utf8") / (1024 * 1024);
-}
-export function dataSizeInMb(data) {
-    const size = typeof data === "string"
-        ? Buffer.byteLength(data, "utf8")
-        : Buffer.byteLength(JSON.stringify(data), "utf8");
-    return size / (1024 * 1024);
-}
-export function getJsonSizeInMb(json) {
-    return Buffer.byteLength(JSON.stringify(json), "utf8") / (1024 * 1024);
-}
-// Function to calculate data size in KB
-export function dataSize(data) {
-    let size = 0;
-    if (typeof data === 'string') {
-        size = Buffer.byteLength(data, 'utf8');
-    }
-    else if (Buffer.isBuffer(data)) {
-        size = data.length;
-    }
-    else if (typeof data === 'object') {
-        size = Buffer.byteLength(JSON.stringify(data), 'utf8');
-    }
-    else {
-        size = Buffer.byteLength(String(data), 'utf8');
-    }
-    return size / 1000; // Convert to kilobytes
-}

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

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

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

@@ -1,2 +0,0 @@
-export * from './string_utils';
-export * from './quote_utils';

package/dist/types/functions/string_utils/src/quote_utils.js

@@ -1,17 +0,0 @@
-/**
- * Checks if a value is enclosed in quotes.
- */
-export function ends_in_quotes(value) {
-    if (typeof value === 'string') {
-        if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
-            return true;
-        }
-    }
-    return false;
-}
-export function stripQuotes(value) {
-    if (ends_in_quotes(value)) {
-        return value.slice(1, -1); // Remove the first and last characters
-    }
-    return value; // Return the input unchanged for all other cases
-}