@putkoff/abstract-utilities 1.0.147 → 1.0.156

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

@@ -0,0 +1,192 @@
+'use strict';
+
+var index = require('../../../../node_modules/path-browserify/index.js');
+var string_utils = require('../../string_utils/src/string_utils.js');
+var ensure_utils = require('../../type_utils/src/ensure_utils.js');
+require('../../type_utils/src/mime_utils.js');
+
+function get_dirname(filePath) {
+    if (!filePath)
+        return '';
+    return index.default.dirname(filePath);
+}
+function get_basename(filePath) {
+    if (!filePath)
+        return '';
+    return index.default.basename(filePath);
+}
+function get_filename(filePath) {
+    if (!filePath)
+        return '';
+    const ext = index.default.extname(filePath);
+    return index.default.basename(filePath, ext);
+}
+function get_extname(filePath) {
+    if (!filePath)
+        return '';
+    return index.default.extname(filePath);
+}
+function get_splitext(filePath) {
+    if (!filePath)
+        return { filename: '', extname: '' };
+    const ext = index.default.extname(filePath);
+    // Get the basename without the extension
+    const filename = index.default.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").
+ */
+function get_relative_path(basePath, targetPath) {
+    try {
+        // Compute the relative path using Node's native path.relative
+        let rel = index.default.relative(basePath, targetPath);
+        // Normalize to POSIX-style slashes for consistency (especially on Windows)
+        rel = rel.split(index.default.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.
+ */
+function make_path(...parts) {
+    // Normalize incoming segments into a flat list
+    const segments = ensure_utils.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 = string_utils.eatOuter(seg, "/"); // trim trailing slashes
+        if (!cleaned)
+            continue;
+        if (out === "") {
+            out = cleaned;
+        }
+        else {
+            cleaned = string_utils.eatInner(cleaned, "/"); // trim leading slashes
+            out = `${out}/${cleaned}`;
+        }
+    }
+    return out;
+}
+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
+}
+function make_sanitized_path(...paths) {
+    let real_path = '';
+    for (let i = 0; i < paths.length; i++) {
+        const sanitized = sanitizeFilename(string_utils.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 || '';
+}
+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/');
+}
+function pathjoin(...parts) {
+    return make_path(...parts);
+}
+function pathJoin(...parts) {
+    return make_path(...parts);
+}
+function makepath(...parts) {
+    return make_path(...parts);
+}
+function makePath(...parts) {
+    return make_path(...parts);
+}
+function path_join(...parts) {
+    return make_path(...parts);
+}
+function getSplitext(filePath) {
+    return get_splitext(filePath);
+}
+function getsplitext(filePath) {
+    return get_splitext(filePath);
+}
+function getextname(filePath) {
+    return get_extname(filePath);
+}
+function getExtname(filePath) {
+    return get_extname(filePath);
+}
+function getfilename(filePath) {
+    return get_filename(filePath);
+}
+function getFilename(filePath) {
+    return get_filename(filePath);
+}
+function getbasename(filePath) {
+    return get_basename(filePath);
+}
+function getBasename(filePath) {
+    return get_basename(filePath);
+}
+function getdirname(filePath) {
+    return get_dirname(filePath);
+}
+function getDirname(filePath) {
+    return get_dirname(filePath);
+}
+
+exports.getBasename = getBasename;
+exports.getDirname = getDirname;
+exports.getExtname = getExtname;
+exports.getFilename = getFilename;
+exports.getSplitext = getSplitext;
+exports.get_basename = get_basename;
+exports.get_dirname = get_dirname;
+exports.get_extname = get_extname;
+exports.get_filename = get_filename;
+exports.get_relative_path = get_relative_path;
+exports.get_splitext = get_splitext;
+exports.getbasename = getbasename;
+exports.getdirname = getdirname;
+exports.getextname = getextname;
+exports.getfilename = getfilename;
+exports.getsplitext = getsplitext;
+exports.makePath = makePath;
+exports.make_path = make_path;
+exports.make_sanitized_path = make_sanitized_path;
+exports.makepath = makepath;
+exports.normalizeUrl = normalizeUrl;
+exports.pathJoin = pathJoin;
+exports.path_join = path_join;
+exports.pathjoin = pathjoin;
+exports.sanitizeFilename = sanitizeFilename;
+//# sourceMappingURL=path_utils.js.map

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

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

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

@@ -0,0 +1,18 @@
+'use strict';
+
+var imports = require('../imports.js');
+var path_utils = require('./path_utils.js');
+
+/**
+ * Returns the absolute path of the current file.
+ */
+function getAbsDir() {
+    return path_utils.get_dirname(imports.getAbsolutePath());
+}
+function getAbsPath(subPath) {
+    return path_utils.make_path(getAbsDir(), subPath);
+}
+
+exports.getAbsDir = getAbsDir;
+exports.getAbsPath = getAbsPath;
+//# sourceMappingURL=paths.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sources":["../../../../../../src/functions/path_utils/src/paths.ts"],"sourcesContent":["import {getAbsolutePath} from './../imports.js';\nimport {get_dirname,make_path} from './path_utils.js';\n/**\n * Returns the absolute path of the current file.\n */\nexport function getAbsDir(): string {\n    return get_dirname(getAbsolutePath());\n};\nexport function getAbsPath(subPath: string): string {\n    return make_path(getAbsDir(), subPath);\n}\n\n\n\n"],"names":["get_dirname","getAbsolutePath","make_path"],"mappings":";;;;;AAEA;;AAEG;SACa,SAAS,GAAA;AACrB,IAAA,OAAOA,sBAAW,CAACC,uBAAe,EAAE,CAAC;AACzC;AACM,SAAU,UAAU,CAAC,OAAe,EAAA;AACtC,IAAA,OAAOC,oBAAS,CAAC,SAAS,EAAE,EAAE,OAAO,CAAC;AAC1C;;;;;"}

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

@@ -0,0 +1,31 @@
+'use strict';
+
+var path_utils = require('./path_utils.js');
+var function_dirs = require('./function_dirs.js');
+
+function getSrcDir() {
+    return path_utils.get_dirname(function_dirs.getFunctionsDir());
+}
+function geStaticDirectory() {
+    return path_utils.make_path(getSrcDir(), 'static');
+}
+function getLibUtilsDirectory() {
+    return path_utils.make_path(getSrcDir(), 'lib');
+}
+function getHooksUtilsDirectory() {
+    return path_utils.make_path(getSrcDir(), 'hooks');
+}
+function getFunctionsUtilsDirectory() {
+    return path_utils.make_path(getSrcDir(), 'functions');
+}
+function getComponentsUtilsDirectory() {
+    return path_utils.make_path(getSrcDir(), 'components');
+}
+
+exports.geStaticDirectory = geStaticDirectory;
+exports.getComponentsUtilsDirectory = getComponentsUtilsDirectory;
+exports.getFunctionsUtilsDirectory = getFunctionsUtilsDirectory;
+exports.getHooksUtilsDirectory = getHooksUtilsDirectory;
+exports.getLibUtilsDirectory = getLibUtilsDirectory;
+exports.getSrcDir = getSrcDir;
+//# sourceMappingURL=src_dirs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"src_dirs.js","sources":["../../../../../../src/functions/path_utils/src/src_dirs.ts"],"sourcesContent":["import {make_path,get_dirname} from './path_utils.js';\nimport {getFunctionsDir} from './function_dirs.js';\nexport function getSrcDir(): string {\n    return get_dirname(getFunctionsDir());\n};\nexport function geStaticDirectory():string{\n    return make_path(getSrcDir(), 'static');\n};\nexport function getLibUtilsDirectory():string{\n    return make_path(getSrcDir(), 'lib');\n}\nexport function getHooksUtilsDirectory():string{\n    return make_path(getSrcDir(), 'hooks');\n};\nexport function getFunctionsUtilsDirectory():string{\n    return make_path(getSrcDir(), 'functions');\n};\nexport function getComponentsUtilsDirectory():string{\n    return make_path(getSrcDir(), 'components');\n};"],"names":["get_dirname","getFunctionsDir","make_path"],"mappings":";;;;;SAEgB,SAAS,GAAA;AACrB,IAAA,OAAOA,sBAAW,CAACC,6BAAe,EAAE,CAAC;AACzC;SACgB,iBAAiB,GAAA;AAC7B,IAAA,OAAOC,oBAAS,CAAC,SAAS,EAAE,EAAE,QAAQ,CAAC;AAC3C;SACgB,oBAAoB,GAAA;AAChC,IAAA,OAAOA,oBAAS,CAAC,SAAS,EAAE,EAAE,KAAK,CAAC;AACxC;SACgB,sBAAsB,GAAA;AAClC,IAAA,OAAOA,oBAAS,CAAC,SAAS,EAAE,EAAE,OAAO,CAAC;AAC1C;SACgB,0BAA0B,GAAA;AACtC,IAAA,OAAOA,oBAAS,CAAC,SAAS,EAAE,EAAE,WAAW,CAAC;AAC9C;SACgB,2BAA2B,GAAA;AACvC,IAAA,OAAOA,oBAAS,CAAC,SAAS,EAAE,EAAE,YAAY,CAAC;AAC/C;;;;;;;;;"}

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

@@ -0,0 +1,22 @@
+'use strict';
+
+var caller_utils = require('../../inspect_utils/src/caller_utils.js');
+var util = require('util');
+
+function debugPrint(value, label = null) {
+    const caller = caller_utils.getLastCaller();
+    const header = label ??
+        (caller
+            ? `${caller.functionName} @ ${caller.file}:${caller.line}`
+            : "object");
+    console.log(`\n🔍 ${header}`);
+    console.log(util.inspect(value, {
+        depth: null,
+        colors: true,
+        compact: false,
+        maxArrayLength: null,
+    }));
+}
+
+exports.debugPrint = debugPrint;
+//# sourceMappingURL=print_utils.js.map

package/dist/cjs/src/functions/print_utils/src/print_utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"print_utils.js","sources":["../../../../../../src/functions/print_utils/src/print_utils.ts"],"sourcesContent":["import {getLastCaller,inspect} from './../imports.js';\nexport function debugPrint(\n  value: unknown,\n  label: string | null = null\n) {\n  const caller = getLastCaller();\n\n  const header =\n    label ??\n    (caller\n      ? `${caller.functionName} @ ${caller.file}:${caller.line}`\n      : \"object\");\n\n  console.log(`\\n🔍 ${header}`);\n  console.log(\n    inspect(value, {\n      depth: null,\n      colors: true,\n      compact: false,\n      maxArrayLength: null,\n    })\n  );\n}\n"],"names":["getLastCaller","inspect"],"mappings":";;;;;SACgB,UAAU,CACxB,KAAc,EACd,QAAuB,IAAI,EAAA;AAE3B,IAAA,MAAM,MAAM,GAAGA,0BAAa,EAAE;IAE9B,MAAM,MAAM,GACV,KAAK;AACL,SAAC;AACC,cAAE,CAAA,EAAG,MAAM,CAAC,YAAY,CAAA,GAAA,EAAM,MAAM,CAAC,IAAI,CAAA,CAAA,EAAI,MAAM,CAAC,IAAI,CAAA;cACtD,QAAQ,CAAC;AAEf,IAAA,OAAO,CAAC,GAAG,CAAC,QAAQ,MAAM,CAAA,CAAE,CAAC;AAC7B,IAAA,OAAO,CAAC,GAAG,CACTC,YAAO,CAAC,KAAK,EAAE;AACb,QAAA,KAAK,EAAE,IAAI;AACX,QAAA,MAAM,EAAE,IAAI;AACZ,QAAA,OAAO,EAAE,KAAK;AACd,QAAA,cAAc,EAAE,IAAI;AACrB,KAAA,CAAC,CACH;AACH;;;;"}

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

@@ -0,0 +1,29 @@
+'use strict';
+
+// Browser-only implementation — server consumers use src/server/read_utils
+async function readJsonFile(url) {
+    const fetchFn = typeof fetch === "function" ? fetch : undefined;
+    if (!fetchFn)
+        return null;
+    try {
+        const res = await fetchFn(url);
+        if (!res.ok)
+            return null;
+        return (await res.json());
+    }
+    catch {
+        return null;
+    }
+}
+async function getConfigContent() {
+    try {
+        return await readJsonFile("./config.json");
+    }
+    catch {
+        return null;
+    }
+}
+
+exports.getConfigContent = getConfigContent;
+exports.readJsonFile = readJsonFile;
+//# sourceMappingURL=readJsonFile.js.map

package/dist/cjs/src/functions/read_utils/src/readJsonFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readJsonFile.js","sources":["../../../../../../src/functions/read_utils/src/readJsonFile.ts"],"sourcesContent":["// Browser-only implementation — server consumers use src/server/read_utils\nexport async function readJsonFile<T = any>(url: string): Promise<T | null> {\n  const fetchFn = typeof fetch === \"function\" ? fetch : undefined;\n  if (!fetchFn) return null;\n  try {\n    const res = await fetchFn(url);\n    if (!res.ok) return null;\n    return (await res.json()) as T;\n  } catch {\n    return null;\n  }\n}\n\nexport async function getConfigContent<T = Record<string, any>>(): Promise<T | null> {\n  try {\n    return await readJsonFile<T>(\"./config.json\");\n  } catch {\n    return null;\n  }\n}"],"names":[],"mappings":";;AAAA;AACO,eAAe,YAAY,CAAU,GAAW,EAAA;AACrD,IAAA,MAAM,OAAO,GAAG,OAAO,KAAK,KAAK,UAAU,GAAG,KAAK,GAAG,SAAS;AAC/D,IAAA,IAAI,CAAC,OAAO;AAAE,QAAA,OAAO,IAAI;AACzB,IAAA,IAAI;AACF,QAAA,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC9B,IAAI,CAAC,GAAG,CAAC,EAAE;AAAE,YAAA,OAAO,IAAI;AACxB,QAAA,QAAQ,MAAM,GAAG,CAAC,IAAI,EAAE;IAC1B;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,IAAI;IACb;AACF;AAEO,eAAe,gBAAgB,GAAA;AACpC,IAAA,IAAI;AACF,QAAA,OAAO,MAAM,YAAY,CAAI,eAAe,CAAC;IAC/C;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,IAAI;IACb;AACF;;;;;"}

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

@@ -0,0 +1,17 @@
+'use strict';
+
+// src/functions/rndm_utils/utils.ts
+function alertit(obj = null) {
+    let msg;
+    try {
+        msg = JSON.stringify(obj);
+    }
+    catch {
+        // If JSON.stringify fails (circular refs, etc.), fall back to a simple string
+        msg = String(obj);
+    }
+    alert(msg);
+}
+
+exports.alertit = alertit;
+//# sourceMappingURL=utils.js.map

package/dist/cjs/src/functions/rndm_utils/src/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sources":["../../../../../../src/functions/rndm_utils/src/utils.ts"],"sourcesContent":["// src/functions/rndm_utils/utils.ts\nexport function alertit(obj: any = null) {\n  let msg: string;\n  try {\n    msg = JSON.stringify(obj);\n  } catch {\n    // If JSON.stringify fails (circular refs, etc.), fall back to a simple string\n    msg = String(obj);\n  }\n  alert(msg);\n}"],"names":[],"mappings":";;AAAA;AACM,SAAU,OAAO,CAAC,GAAA,GAAW,IAAI,EAAA;AACrC,IAAA,IAAI,GAAW;AACf,IAAA,IAAI;AACF,QAAA,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;IAC3B;AAAE,IAAA,MAAM;;AAEN,QAAA,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;IACnB;IACA,KAAK,CAAC,GAAG,CAAC;AACZ;;;;"}

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

@@ -0,0 +1,18 @@
+'use strict';
+
+function getSafeDocument() {
+    return typeof document !== 'undefined' ? document : undefined;
+}
+function getDocumentProp(...keys) {
+    let obj = getSafeDocument();
+    for (const k of keys) {
+        if (obj == null || typeof obj !== 'object')
+            return undefined;
+        obj = obj[k];
+    }
+    return obj;
+}
+
+exports.getDocumentProp = getDocumentProp;
+exports.getSafeDocument = getSafeDocument;
+//# sourceMappingURL=safe_document.js.map

package/dist/cjs/src/functions/safe_utils/src/safe_document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe_document.js","sources":["../../../../../../src/functions/safe_utils/src/safe_document.ts"],"sourcesContent":["export function getSafeDocument(): Document | undefined {\n  return typeof document !== 'undefined' ? document : undefined;\n}\n\n// 3) Overloads for 1- and 2-level deep props on Document\nexport function getDocumentProp<K1 extends keyof Document>(\n  prop1: K1\n): Document[K1] | undefined;\nexport function getDocumentProp<\n  K1 extends keyof Document,\n  K2 extends keyof NonNullable<Document[K1]>\n>(\n  prop1: K1,\n  prop2: K2\n): NonNullable<Document[K1]>[K2] | undefined;\nexport function getDocumentProp(...keys: string[]) {\n  let obj: any = getSafeDocument();\n  for (const k of keys) {\n    if (obj == null || typeof obj !== 'object') return undefined;\n    obj = obj[k];\n  }\n  return obj;\n}\n"],"names":[],"mappings":";;SAAgB,eAAe,GAAA;AAC7B,IAAA,OAAO,OAAO,QAAQ,KAAK,WAAW,GAAG,QAAQ,GAAG,SAAS;AAC/D;AAaM,SAAU,eAAe,CAAC,GAAG,IAAc,EAAA;AAC/C,IAAA,IAAI,GAAG,GAAQ,eAAe,EAAE;AAChC,IAAA,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE;AACpB,QAAA,IAAI,GAAG,IAAI,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;AAAE,YAAA,OAAO,SAAS;AAC5D,QAAA,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC;IACd;AACA,IAAA,OAAO,GAAG;AACZ;;;;;"}

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

@@ -0,0 +1,19 @@
+'use strict';
+
+/**
+ * Safely walk `globalThis` (or window/document) by a chain of property names.
+ * Returns `undefined` if any step is missing.
+ */
+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;
+}
+
+exports.safeGlobalProp = safeGlobalProp;
+//# sourceMappingURL=safe_globals.js.map

package/dist/cjs/src/functions/safe_utils/src/safe_globals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe_globals.js","sources":["../../../../../../src/functions/safe_utils/src/safe_globals.ts"],"sourcesContent":["/** \n * Safely walk `globalThis` (or window/document) by a chain of property names.\n * Returns `undefined` if any step is missing.\n */\nexport function safeGlobalProp<T = any>(...path: string[]): T | undefined {\n  let obj: any = globalThis;\n  for (const key of path) {\n    if (obj == null || typeof obj !== \"object\" || !(key in obj)) {\n      return undefined;\n    }\n    obj = obj[key];\n  }\n  return obj as T;\n}\n"],"names":[],"mappings":";;AAAA;;;AAGG;AACG,SAAU,cAAc,CAAU,GAAG,IAAc,EAAA;IACvD,IAAI,GAAG,GAAQ,UAAU;AACzB,IAAA,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE;AACtB,QAAA,IAAI,GAAG,IAAI,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,EAAE,GAAG,IAAI,GAAG,CAAC,EAAE;AAC3D,YAAA,OAAO,SAAS;QAClB;AACA,QAAA,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;IAChB;AACA,IAAA,OAAO,GAAQ;AACjB;;;;"}

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

@@ -0,0 +1,58 @@
+'use strict';
+
+var safe_globals = require('./safe_globals.js');
+
+/**
+ * Returns `window` if running in a browser, otherwise `undefined`.
+ */
+function getSafeLocalStorage() {
+    if (typeof window === 'undefined')
+        return undefined;
+    try {
+        return window.localStorage;
+    }
+    catch {
+        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.
+ */
+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 {
+        return undefined;
+    }
+}
+/**
+ * Safely call storage methods (`localStorage` or `sessionStorage`) without blowing up.
+ * Returns `undefined` on any error.
+ */
+function safeStorage(storageName, method, ...args) {
+    try {
+        const store = safe_globals.safeGlobalProp(storageName);
+        if (!store || typeof store[method] !== "function")
+            return undefined;
+        return store[method](...args);
+    }
+    catch {
+        return undefined;
+    }
+}
+
+exports.callStorage = callStorage;
+exports.getSafeLocalStorage = getSafeLocalStorage;
+exports.safeStorage = safeStorage;
+//# sourceMappingURL=safe_storage.js.map

package/dist/cjs/src/functions/safe_utils/src/safe_storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe_storage.js","sources":["../../../../../../src/functions/safe_utils/src/safe_storage.ts"],"sourcesContent":["\nimport {safeGlobalProp} from './safe_globals.js';\n/**\n * Returns `window` if running in a browser, otherwise `undefined`.\n */\n\n\nexport function getSafeLocalStorage(): Storage | undefined {\n  if (typeof window === 'undefined') return undefined;\n  try {\n    return window.localStorage;\n  } catch {\n    return undefined; // e.g. Safari private-mode block\n  }\n}\n\n/**\n * Call a Storage method by name, silencing any errors or missing storage.\n *\n * @param method  One of the keys of the Storage interface: \"getItem\", \"setItem\", etc.\n * @param args    The arguments you’d normally pass to that method.\n * @returns       The method’s return value, or undefined if storage/method isn’t available.\n */\nexport function callStorage<\n  K extends keyof Storage\n>(\n  method: K,\n  ...args: Parameters<Storage[K]>\n): ReturnType<Storage[K]> | undefined {\n  const storage = getSafeLocalStorage();\n  if (!storage) return undefined;\n\n  const fn = storage[method];\n  if (typeof fn !== 'function') return undefined;\n\n  try {\n    return fn.apply(storage, args) as ReturnType<Storage[K]>;\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Safely call storage methods (`localStorage` or `sessionStorage`) without blowing up.\n * Returns `undefined` on any error.\n */\nexport function safeStorage<\n  S extends \"localStorage\" | \"sessionStorage\",\n  K extends keyof Storage\n>(\n  storageName: S,\n  method: K,\n  ...args: Parameters<Storage[K]>\n): ReturnType<Storage[K]> | undefined {\n  try {\n    const store = safeGlobalProp<Storage>(storageName);\n    if (!store || typeof store[method] !== \"function\") return undefined;\n    return store[method](...args);\n  } catch {\n    return undefined;\n  }\n}\n"],"names":["safeGlobalProp"],"mappings":";;;;AAEA;;AAEG;SAGa,mBAAmB,GAAA;IACjC,IAAI,OAAO,MAAM,KAAK,WAAW;AAAE,QAAA,OAAO,SAAS;AACnD,IAAA,IAAI;QACF,OAAO,MAAM,CAAC,YAAY;IAC5B;AAAE,IAAA,MAAM;QACN,OAAO,SAAS,CAAC;IACnB;AACF;AAEA;;;;;;AAMG;SACa,WAAW,CAGzB,MAAS,EACT,GAAG,IAA4B,EAAA;AAE/B,IAAA,MAAM,OAAO,GAAG,mBAAmB,EAAE;AACrC,IAAA,IAAI,CAAC,OAAO;AAAE,QAAA,OAAO,SAAS;AAE9B,IAAA,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAC1B,IAAI,OAAO,EAAE,KAAK,UAAU;AAAE,QAAA,OAAO,SAAS;AAE9C,IAAA,IAAI;QACF,OAAO,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAA2B;IAC1D;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,SAAS;IAClB;AACF;AAEA;;;AAGG;AACG,SAAU,WAAW,CAIzB,WAAc,EACd,MAAS,EACT,GAAG,IAA4B,EAAA;AAE/B,IAAA,IAAI;AACF,QAAA,MAAM,KAAK,GAAGA,2BAAc,CAAU,WAAW,CAAC;QAClD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,UAAU;AAAE,YAAA,OAAO,SAAS;QACnE,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC;IAC/B;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,SAAS;IAClB;AACF;;;;;;"}

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

@@ -0,0 +1,50 @@
+'use strict';
+
+/**
+ * Returns the global window object if it exists, otherwise undefined.
+ */
+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.
+ */
+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 {
+        return undefined;
+    }
+}
+/** implementation */
+function getWindowProp(...keys) {
+    let obj = getSafeWindow();
+    for (const k of keys) {
+        if (obj == null || typeof obj !== 'object')
+            return undefined;
+        obj = obj[k];
+    }
+    return obj;
+}
+function getWindowHost() {
+    return getWindowProp('location', 'host');
+}
+
+exports.callWindowMethod = callWindowMethod;
+exports.getSafeWindow = getSafeWindow;
+exports.getWindowHost = getWindowHost;
+exports.getWindowProp = getWindowProp;
+//# sourceMappingURL=safe_window.js.map

package/dist/cjs/src/functions/safe_utils/src/safe_window.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe_window.js","sources":["../../../../../../src/functions/safe_utils/src/safe_window.ts"],"sourcesContent":["/**\n * Returns the global window object if it exists, otherwise undefined.\n */\nexport function getSafeWindow(): Window | undefined {\n  return typeof window !== 'undefined' ? window : undefined;\n}\n\n/**\n * Safely call a method on window by name.\n *\n * @param method  The Window method to call (e.g. \"alert\", \"open\", etc.).\n * @param args    Arguments to pass to that method.\n * @returns       The method’s return value, or undefined if\n *                 window/method isn’t available or throws.\n */\nexport function callWindowMethod<\n  K extends keyof Window,\n  F extends Window[K] = Window[K],\n  Args extends any[] = F extends (...a: infer P) => any ? P : never,\n  R = F extends (...a: any) => infer U ? U : void\n>(\n  method: K,\n  ...args: Args\n): R | undefined {\n  const w = getSafeWindow();\n  if (!w) return undefined;\n\n  const fn = w[method];\n  if (typeof fn !== 'function') return undefined;\n\n  try {\n    // cast to any so TS doesn’t complain about apply/invoke\n    return (fn as any)(...args) as R;\n  } catch {\n    return undefined;\n  }\n}\n\n\n\n/** overloads for 1‐ and 2‐level deep props */\nexport function getWindowProp<K1 extends keyof Window>(\n  prop1: K1\n): Window[K1] | undefined;\nexport function getWindowProp<\n  K1 extends keyof Window,\n  K2 extends keyof NonNullable<Window[K1]>\n>(\n  prop1: K1,\n  prop2: K2\n): NonNullable<Window[K1]>[K2] | undefined;\n\n/** implementation */\nexport function getWindowProp(...keys: string[]) {\n  let obj: any = getSafeWindow();\n  for (const k of keys) {\n    if (obj == null || typeof obj !== 'object') return undefined;\n    obj = obj[k];\n  }\n  return obj;\n}\n\nexport function getWindowHost(){\n  return getWindowProp('location','host');\n}"],"names":[],"mappings":";;AAAA;;AAEG;SACa,aAAa,GAAA;AAC3B,IAAA,OAAO,OAAO,MAAM,KAAK,WAAW,GAAG,MAAM,GAAG,SAAS;AAC3D;AAEA;;;;;;;AAOG;SACa,gBAAgB,CAM9B,MAAS,EACT,GAAG,IAAU,EAAA;AAEb,IAAA,MAAM,CAAC,GAAG,aAAa,EAAE;AACzB,IAAA,IAAI,CAAC,CAAC;AAAE,QAAA,OAAO,SAAS;AAExB,IAAA,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC;IACpB,IAAI,OAAO,EAAE,KAAK,UAAU;AAAE,QAAA,OAAO,SAAS;AAE9C,IAAA,IAAI;;AAEF,QAAA,OAAQ,EAAU,CAAC,GAAG,IAAI,CAAM;IAClC;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,SAAS;IAClB;AACF;AAgBA;AACM,SAAU,aAAa,CAAC,GAAG,IAAc,EAAA;AAC7C,IAAA,IAAI,GAAG,GAAQ,aAAa,EAAE;AAC9B,IAAA,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE;AACpB,QAAA,IAAI,GAAG,IAAI,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;AAAE,YAAA,OAAO,SAAS;AAC5D,QAAA,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC;IACd;AACA,IAAA,OAAO,GAAG;AACZ;SAEgB,aAAa,GAAA;AAC3B,IAAA,OAAO,aAAa,CAAC,UAAU,EAAC,MAAM,CAAC;AACzC;;;;;;;"}

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

@@ -0,0 +1,29 @@
+'use strict';
+
+function safeJsonSizeInMb(value) {
+    const json = JSON.stringify(value, (_, v) => {
+        if (typeof v === "bigint")
+            return v.toString();
+        return v;
+    });
+    return new Blob([json]).size / (1024 * 1024);
+}
+function dataSizeInMb(data) {
+    const str = typeof data === "string" ? data : JSON.stringify(data);
+    return new Blob([str]).size / (1024 * 1024);
+}
+function getJsonSizeInMb(json) {
+    return new Blob([JSON.stringify(json)]).size / (1024 * 1024);
+}
+function dataSize(data) {
+    const str = typeof data === "string" ? data :
+        typeof data === "object" ? JSON.stringify(data) :
+            String(data);
+    return new Blob([str]).size / 1000;
+}
+
+exports.dataSize = dataSize;
+exports.dataSizeInMb = dataSizeInMb;
+exports.getJsonSizeInMb = getJsonSizeInMb;
+exports.safeJsonSizeInMb = safeJsonSizeInMb;
+//# sourceMappingURL=sizeUtils.js.map

package/dist/cjs/src/functions/size_utils/src/sizeUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sizeUtils.js","sources":["../../../../../../src/functions/size_utils/src/sizeUtils.ts"],"sourcesContent":["export function safeJsonSizeInMb(value: unknown): number {\n  const json = JSON.stringify(value, (_, v) => {\n    if (typeof v === \"bigint\") return v.toString();\n    return v;\n  });\n  return new Blob([json]).size / (1024 * 1024);\n}\n\nexport function dataSizeInMb(data: unknown): number {\n  const str = typeof data === \"string\" ? data : JSON.stringify(data);\n  return new Blob([str]).size / (1024 * 1024);\n}\n\nexport function getJsonSizeInMb(json: unknown): number {\n  return new Blob([JSON.stringify(json)]).size / (1024 * 1024);\n}\n\nexport function dataSize(data: any): number {\n  const str =\n    typeof data === \"string\" ? data :\n    typeof data === \"object\" ? JSON.stringify(data) :\n    String(data);\n  return new Blob([str]).size / 1000;\n}"],"names":[],"mappings":";;AAAM,SAAU,gBAAgB,CAAC,KAAc,EAAA;AAC7C,IAAA,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,KAAI;QAC1C,IAAI,OAAO,CAAC,KAAK,QAAQ;AAAE,YAAA,OAAO,CAAC,CAAC,QAAQ,EAAE;AAC9C,QAAA,OAAO,CAAC;AACV,IAAA,CAAC,CAAC;AACF,IAAA,OAAO,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,GAAG,IAAI,CAAC;AAC9C;AAEM,SAAU,YAAY,CAAC,IAAa,EAAA;AACxC,IAAA,MAAM,GAAG,GAAG,OAAO,IAAI,KAAK,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;AAClE,IAAA,OAAO,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,GAAG,IAAI,CAAC;AAC7C;AAEM,SAAU,eAAe,CAAC,IAAa,EAAA;IAC3C,OAAO,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,GAAG,IAAI,CAAC;AAC9D;AAEM,SAAU,QAAQ,CAAC,IAAS,EAAA;IAChC,MAAM,GAAG,GACP,OAAO,IAAI,KAAK,QAAQ,GAAG,IAAI;AAC/B,QAAA,OAAO,IAAI,KAAK,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAC/C,MAAM,CAAC,IAAI,CAAC;IACd,OAAO,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI;AACpC;;;;;;;"}

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

@@ -0,0 +1,23 @@
+'use strict';
+
+/**
+ * Checks if a value is enclosed in quotes.
+ */
+function ends_in_quotes(value) {
+    if (typeof value === 'string') {
+        if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+            return true;
+        }
+    }
+    return false;
+}
+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
+}
+
+exports.ends_in_quotes = ends_in_quotes;
+exports.stripQuotes = stripQuotes;
+//# sourceMappingURL=quote_utils.js.map

package/dist/cjs/src/functions/string_utils/src/quote_utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote_utils.js","sources":["../../../../../../src/functions/string_utils/src/quote_utils.ts"],"sourcesContent":["/**\n * Checks if a value is enclosed in quotes.\n */\n\nexport function ends_in_quotes(value:any){\n  if (typeof value === 'string'){\n    if ((value.startsWith('\"') && value.endsWith('\"')) || (value.startsWith(\"'\") && value.endsWith(\"'\"))){\n      return true\n    }\n  }\n  return false\n}\nexport function stripQuotes(value: any): any {\n    if (ends_in_quotes(value)) {\n      return value.slice(1, -1); // Remove the first and last characters\n    }\n    return value; // Return the input unchanged for all other cases\n}\n"],"names":[],"mappings":";;AAAA;;AAEG;AAEG,SAAU,cAAc,CAAC,KAAS,EAAA;AACtC,IAAA,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAC;AAC5B,QAAA,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAC;AACnG,YAAA,OAAO,IAAI;QACb;IACF;AACA,IAAA,OAAO,KAAK;AACd;AACM,SAAU,WAAW,CAAC,KAAU,EAAA;AAClC,IAAA,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE;QACzB,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC5B;IACA,OAAO,KAAK,CAAC;AACjB;;;;;"}