@putkoff/abstract-utilities 1.0.135 → 1.0.142

package/dist/esm/server.js

@@ -1,305 +1,18 @@
 import 'server-only';
-import * as fs from 'node:fs';
-import * as fsp from 'node:fs/promises';
-import * as path from 'node:path';
+import { readFileSync } from 'fs';
+import { isAbsolute, resolve } from 'path';
 
-// mediaTypes.ts
-/** ---- Data: large but explicit, mirrors your Python mapping ---- */
-const MIME_TYPES = {
-    image: {
-        ".jpg": "image/jpeg",
-        ".jpeg": "image/jpeg",
-        ".png": "image/png",
-        ".gif": "image/gif",
-        ".bmp": "image/bmp",
-        ".tiff": "image/tiff",
-        ".webp": "image/webp",
-        ".svg": "image/svg+xml",
-        ".ico": "image/vnd.microsoft.icon",
-        ".heic": "image/heic",
-        ".psd": "image/vnd.adobe.photoshop",
-        ".raw": "image/x-raw",
-    },
-    video: {
-        ".mp4": "video/mp4",
-        ".webm": "video/webm",
-        ".ogg": "video/ogg",
-        ".mov": "video/quicktime",
-        ".avi": "video/x-msvideo",
-        ".mkv": "video/x-matroska",
-        ".flv": "video/x-flv",
-        ".wmv": "video/x-ms-wmv",
-        ".3gp": "video/3gpp",
-        ".ts": "video/mp2t",
-        ".mpeg": "video/mpeg",
-        ".mpg": "video/mpg",
-    },
-    audio: {
-        ".mp3": "audio/mpeg",
-        ".wav": "audio/wav",
-        ".flac": "audio/flac",
-        ".aac": "audio/aac",
-        ".ogg": "audio/ogg",
-        ".m4a": "audio/mp4",
-        ".opus": "audio/opus",
-    },
-    document: {
-        ".pdf": "application/pdf",
-        ".doc": "application/msword",
-        ".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
-        ".odt": "application/vnd.oasis.opendocument.text",
-        ".txt": "text/plain",
-        ".rtf": "application/rtf",
-        ".md": "text/markdown",
-        ".markdown": "text/markdown",
-        ".tex": "application/x-tex",
-        ".log": "text/plain",
-        ".json": "application/json",
-        ".xml": "application/xml",
-        ".yaml": "application/x-yaml",
-        ".yml": "application/x-yaml",
-        ".ini": "text/plain",
-        ".cfg": "text/plain",
-        ".toml": "application/toml",
-        ".csv": "text/csv",
-        ".tsv": "text/tab-separated-values",
-    },
-    presentation: {
-        ".ppt": "application/vnd.ms-powerpoint",
-        ".pptx": "application/vnd.openxmlformats-officedocument.presentationml.presentation",
-        ".odp": "application/vnd.oasis.opendocument.presentation",
-    },
-    spreadsheet: {
-        ".xls": "application/vnd.ms-excel",
-        ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
-        ".ods": "application/vnd.oasis.opendocument.spreadsheet",
-        ".csv": "text/csv",
-        ".tsv": "text/tab-separated-values",
-    },
-    code: {
-        ".py": "text/x-python",
-        ".java": "text/x-java-source",
-        ".c": "text/x-c",
-        ".cpp": "text/x-c++",
-        ".h": "text/x-c",
-        ".hpp": "text/x-c++",
-        ".js": "application/javascript",
-        ".cjs": "application/javascript",
-        ".mjs": "application/javascript",
-        ".jsx": "application/javascript",
-        ".ts": "application/typescript",
-        ".tsx": "application/typescript",
-        ".rb": "text/x-ruby",
-        ".php": "application/x-php",
-        ".go": "text/x-go",
-        ".rs": "text/rust",
-        ".swift": "text/x-swift",
-        ".kt": "text/x-kotlin",
-        ".sh": "application/x-shellscript",
-        ".bash": "application/x-shellscript",
-        ".ps1": "application/x-powershell",
-        ".sql": "application/sql",
-        ".yml": "application/x-yaml",
-        ".coffee": "text/coffeescript",
-        ".lua": "text/x-lua",
-    },
-    archive: {
-        ".zip": "application/zip",
-        ".tar": "application/x-tar",
-        ".gz": "application/gzip",
-        ".tgz": "application/gzip",
-        ".bz2": "application/x-bzip2",
-        ".xz": "application/x-xz",
-        ".rar": "application/vnd.rar",
-        ".7z": "application/x-7z-compressed",
-        ".iso": "application/x-iso9660-image",
-        ".dmg": "application/x-apple-diskimage",
-        ".jar": "application/java-archive",
-        ".war": "application/java-archive",
-        ".whl": "application/python-wheel",
-        ".egg": "application/python-egg",
-    },
-    font: {
-        ".ttf": "font/ttf",
-        ".otf": "font/otf",
-        ".woff": "font/woff",
-        ".woff2": "font/woff2",
-        ".eot": "application/vnd.ms-fontobject",
-    },
-    executable: {
-        ".exe": "application/vnd.microsoft.portable-executable",
-        ".dll": "application/vnd.microsoft.portable-executable",
-        ".bin": "application/octet-stream",
-        ".deb": "application/vnd.debian.binary-package",
-        ".rpm": "application/x-rpm",
-    },
-};
-/** Mirror of MEDIA_TYPES in Python: category -> Set of extensions */
-const MEDIA_TYPES = Object.fromEntries(Object.entries(MIME_TYPES).map(([cat, mapping]) => [
-    cat,
-    new Set(Object.keys(mapping)),
-]));
-/** ---- Helpers ---- */
-function toCategorySet(categories) {
-    const allCats = new Set(Object.keys(MIME_TYPES));
-    if (!categories) {
-        // all categories
-        return new Set(allCats);
-    }
-    const out = new Set();
-    for (const c of categories) {
-        const key = String(c);
-        if (allCats.has(key))
-            out.add(key);
-    }
-    return out.size ? out : new Set(allCats);
-}
-function normalizeCategories(categories, opts) {
-    const selected = categories ?? opts?.media_types ?? null;
-    return toCategorySet(selected);
-}
-function extOf(input) {
-    // Behaves like pathlib.Path(...).suffix.lower(): last extension only; lowercased.
-    let ext = path.extname(input || "");
-    if (!ext && input && input.startsWith(".")) {
-        // user passed ".jpg" directly
-        ext = input;
-    }
-    return (ext || "").toLowerCase();
-}
-function unionExts(categories) {
-    const out = new Set();
-    for (const c of categories) {
-        const set = MEDIA_TYPES[c];
-        for (const e of set)
-            out.add(e);
-    }
-    return out;
-}
-/** ---- API (Python parity) ---- */
-/**
- * Return a sub-map of MEDIA_TYPES for the given categories.
- * If categories is falsy, returns all categories.
- */
-function getMediaMap(categories, opts) {
-    const cats = normalizeCategories(categories, opts);
-    const result = {};
-    for (const c of cats)
-        result[c] = new Set(MEDIA_TYPES[c]);
-    return result;
-}
-/**
- * Return a flat, sorted list of all extensions for the given categories.
- */
-function getMediaExts(categories, opts) {
-    const cats = normalizeCategories(categories, opts);
-    return Array.from(unionExts(cats)).sort();
-}
-/**
- * Given a file path or extension, return its media category (e.g. "image") or null.
- * Mirrors Python's confirm_type.
- */
-function confirmType(pathOrExt, categories, opts) {
-    const cats = normalizeCategories(categories, opts);
-    const ext = extOf(pathOrExt);
-    // Preserve object insertion order like Python dict iteration
-    for (const [category, exts] of Object.entries(MEDIA_TYPES)) {
-        if (!cats.has(category))
-            continue;
-        if (ext && exts.has(ext))
-            return category;
-    }
-    return null;
-}
-/**
- * True if the given file path or extension belongs to one of the categories.
- */
-function isMediaType(pathOrExt, categories, opts) {
-    return confirmType(pathOrExt, categories, opts) !== null;
-}
-/**
- * Look up the MIME type by extension; fall back to 'application/octet-stream'.
- */
-function getMimeType(pathOrExt) {
-    const ext = extOf(pathOrExt);
-    for (const mapping of Object.values(MIME_TYPES)) {
-        if (ext && mapping[ext]) {
-            return mapping[ext];
-        }
-    }
-    return "application/octet-stream";
-}
-function getAllFileTypesSync(directory, categories, opts) {
-    // 🧩 Skip entirely if fs isn't available
-    if (!fs || !path)
-        return [];
-    try {
-        const stat = fs.statSync(directory);
-        if (!stat.isDirectory())
-            return [];
-        const cats = normalizeCategories(categories, opts);
-        const wanted = unionExts(cats);
-        const results = [];
-        function walkSync(dir) {
-            const entries = fs.readdirSync(dir, { withFileTypes: true });
-            for (const ent of entries) {
-                const full = path.join(dir, ent.name);
-                if (ent.isDirectory()) {
-                    walkSync(full);
-                }
-                else if (ent.isFile()) {
-                    const ext = path.extname(ent.name).toLowerCase();
-                    if (wanted.has(ext))
-                        results.push(full);
-                }
-            }
-        }
-        walkSync(directory);
-        return results;
-    }
-    catch {
-        return [];
-    }
-}
-async function getAllFileTypes(directory, categories, opts) {
-    // 🧩 Skip entirely if fsp isn't available
-    if (!fsp || !path)
-        return [];
+function readJsonFileNode(relativeOrAbsolutePath) {
     try {
-        const stat = await fsp.stat(directory);
-        if (!stat.isDirectory())
-            return [];
-        const cats = normalizeCategories(categories, opts);
-        const wanted = unionExts(cats);
-        const results = [];
-        async function walkAsync(dir) {
-            const entries = await fsp.readdir(dir, { withFileTypes: true });
-            for (const ent of entries) {
-                const full = path.join(dir, ent.name);
-                if (ent.isDirectory()) {
-                    await walkAsync(full);
-                }
-                else if (ent.isFile()) {
-                    const ext = path.extname(ent.name).toLowerCase();
-                    if (wanted.has(ext))
-                        results.push(full);
-                }
-            }
-        }
-        await walkAsync(directory);
-        return results;
+        const filePath = isAbsolute(relativeOrAbsolutePath)
+            ? relativeOrAbsolutePath
+            : resolve(process.cwd(), relativeOrAbsolutePath);
+        return JSON.parse(readFileSync(filePath, "utf8"));
     }
     catch {
-        return [];
+        return null;
     }
 }
-/** Optional convenience re-exports that mirror your Python names */
-const get_all_file_types = getAllFileTypes;
-const get_media_map = getMediaMap;
-const get_media_exts = getMediaExts;
-const confirm_type = confirmType;
-const is_media_type = isMediaType;
-const get_mime_type = getMimeType;
 
-export { MEDIA_TYPES, MIME_TYPES, confirmType, confirm_type, getAllFileTypes, getAllFileTypesSync, getMediaExts, getMediaMap, getMimeType, get_all_file_types, get_media_exts, get_media_map, get_mime_type, isMediaType, is_media_type };
+export { readJsonFileNode };
 //# sourceMappingURL=server.js.map

package/dist/esm/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sources":["../../src/server/src/mime_utils.ts"],"sourcesContent":["// mediaTypes.ts\nimport * as fs from \"node:fs\";\nimport * as fsp from \"node:fs/promises\";\nimport * as path from \"node:path\";\n\n/** ---- Types ---- */\nexport type MimeByExt = Record<string, string>;\nexport type MediaMap = Record<string, MimeByExt>;\nexport type MediaCategory = keyof typeof MIME_TYPES;\n\nexport interface MediaOptions {\n  /** Alias to mirror the Python **kwargs['media_types'] behavior */\n  media_types?: Iterable<string> | string[] | null;\n}\n\n/** ---- Data: large but explicit, mirrors your Python mapping ---- */\nexport const MIME_TYPES = {\n  image: {\n    \".jpg\": \"image/jpeg\",\n    \".jpeg\": \"image/jpeg\",\n    \".png\": \"image/png\",\n    \".gif\": \"image/gif\",\n    \".bmp\": \"image/bmp\",\n    \".tiff\": \"image/tiff\",\n    \".webp\": \"image/webp\",\n    \".svg\": \"image/svg+xml\",\n    \".ico\": \"image/vnd.microsoft.icon\",\n    \".heic\": \"image/heic\",\n    \".psd\": \"image/vnd.adobe.photoshop\",\n    \".raw\": \"image/x-raw\",\n  },\n  video: {\n    \".mp4\": \"video/mp4\",\n    \".webm\": \"video/webm\",\n    \".ogg\": \"video/ogg\",\n    \".mov\": \"video/quicktime\",\n    \".avi\": \"video/x-msvideo\",\n    \".mkv\": \"video/x-matroska\",\n    \".flv\": \"video/x-flv\",\n    \".wmv\": \"video/x-ms-wmv\",\n    \".3gp\": \"video/3gpp\",\n    \".ts\": \"video/mp2t\",\n    \".mpeg\": \"video/mpeg\",\n    \".mpg\": \"video/mpg\",\n  },\n  audio: {\n    \".mp3\": \"audio/mpeg\",\n    \".wav\": \"audio/wav\",\n    \".flac\": \"audio/flac\",\n    \".aac\": \"audio/aac\",\n    \".ogg\": \"audio/ogg\",\n    \".m4a\": \"audio/mp4\",\n    \".opus\": \"audio/opus\",\n  },\n  document: {\n    \".pdf\": \"application/pdf\",\n    \".doc\": \"application/msword\",\n    \".docx\":\n      \"application/vnd.openxmlformats-officedocument.wordprocessingml.document\",\n    \".odt\": \"application/vnd.oasis.opendocument.text\",\n    \".txt\": \"text/plain\",\n    \".rtf\": \"application/rtf\",\n    \".md\": \"text/markdown\",\n    \".markdown\": \"text/markdown\",\n    \".tex\": \"application/x-tex\",\n    \".log\": \"text/plain\",\n    \".json\": \"application/json\",\n    \".xml\": \"application/xml\",\n    \".yaml\": \"application/x-yaml\",\n    \".yml\": \"application/x-yaml\",\n    \".ini\": \"text/plain\",\n    \".cfg\": \"text/plain\",\n    \".toml\": \"application/toml\",\n    \".csv\": \"text/csv\",\n    \".tsv\": \"text/tab-separated-values\",\n  },\n  presentation: {\n    \".ppt\": \"application/vnd.ms-powerpoint\",\n    \".pptx\":\n      \"application/vnd.openxmlformats-officedocument.presentationml.presentation\",\n    \".odp\": \"application/vnd.oasis.opendocument.presentation\",\n  },\n  spreadsheet: {\n    \".xls\": \"application/vnd.ms-excel\",\n    \".xlsx\":\n      \"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\",\n    \".ods\": \"application/vnd.oasis.opendocument.spreadsheet\",\n    \".csv\": \"text/csv\",\n    \".tsv\": \"text/tab-separated-values\",\n  },\n  code: {\n    \".py\": \"text/x-python\",\n    \".java\": \"text/x-java-source\",\n    \".c\": \"text/x-c\",\n    \".cpp\": \"text/x-c++\",\n    \".h\": \"text/x-c\",\n    \".hpp\": \"text/x-c++\",\n    \".js\": \"application/javascript\",\n    \".cjs\": \"application/javascript\",\n    \".mjs\": \"application/javascript\",\n    \".jsx\": \"application/javascript\",\n    \".ts\": \"application/typescript\",\n    \".tsx\": \"application/typescript\",\n    \".rb\": \"text/x-ruby\",\n    \".php\": \"application/x-php\",\n    \".go\": \"text/x-go\",\n    \".rs\": \"text/rust\",\n    \".swift\": \"text/x-swift\",\n    \".kt\": \"text/x-kotlin\",\n    \".sh\": \"application/x-shellscript\",\n    \".bash\": \"application/x-shellscript\",\n    \".ps1\": \"application/x-powershell\",\n    \".sql\": \"application/sql\",\n    \".yml\": \"application/x-yaml\",\n    \".coffee\": \"text/coffeescript\",\n    \".lua\": \"text/x-lua\",\n  },\n  archive: {\n    \".zip\": \"application/zip\",\n    \".tar\": \"application/x-tar\",\n    \".gz\": \"application/gzip\",\n    \".tgz\": \"application/gzip\",\n    \".bz2\": \"application/x-bzip2\",\n    \".xz\": \"application/x-xz\",\n    \".rar\": \"application/vnd.rar\",\n    \".7z\": \"application/x-7z-compressed\",\n    \".iso\": \"application/x-iso9660-image\",\n    \".dmg\": \"application/x-apple-diskimage\",\n    \".jar\": \"application/java-archive\",\n    \".war\": \"application/java-archive\",\n    \".whl\": \"application/python-wheel\",\n    \".egg\": \"application/python-egg\",\n  },\n  font: {\n    \".ttf\": \"font/ttf\",\n    \".otf\": \"font/otf\",\n    \".woff\": \"font/woff\",\n    \".woff2\": \"font/woff2\",\n    \".eot\": \"application/vnd.ms-fontobject\",\n  },\n  executable: {\n    \".exe\": \"application/vnd.microsoft.portable-executable\",\n    \".dll\": \"application/vnd.microsoft.portable-executable\",\n    \".bin\": \"application/octet-stream\",\n    \".deb\": \"application/vnd.debian.binary-package\",\n    \".rpm\": \"application/x-rpm\",\n  },\n} as const;\n\n/** Mirror of MEDIA_TYPES in Python: category -> Set of extensions */\nexport const MEDIA_TYPES: Record<MediaCategory, Set<string>> = Object.fromEntries(\n  Object.entries(MIME_TYPES).map(([cat, mapping]) => [\n    cat,\n    new Set(Object.keys(mapping)),\n  ])\n) as Record<MediaCategory, Set<string>>;\n\n/** ---- Helpers ---- */\nfunction toCategorySet(\n  categories?: Iterable<string> | string[] | null,\n): Set<MediaCategory> {\n  const allCats = new Set(Object.keys(MIME_TYPES)) as Set<string>;\n  if (!categories) {\n    // all categories\n    return new Set(allCats) as Set<MediaCategory>;\n  }\n  const out = new Set<MediaCategory>();\n  for (const c of categories as Iterable<string>) {\n    const key = String(c) as MediaCategory;\n    if (allCats.has(key)) out.add(key);\n  }\n  return out.size ? out : (new Set(allCats) as Set<MediaCategory>);\n}\n\nfunction normalizeCategories<T extends MediaOptions | undefined>(\n  categories?: Iterable<string> | string[] | null,\n  opts?: T,\n): Set<MediaCategory> {\n  const selected = categories ?? opts?.media_types ?? null;\n  return toCategorySet(selected);\n}\n\nfunction extOf(input: string): string {\n  // Behaves like pathlib.Path(...).suffix.lower(): last extension only; lowercased.\n  let ext = path.extname(input || \"\");\n  if (!ext && input && input.startsWith(\".\")) {\n    // user passed \".jpg\" directly\n    ext = input;\n  }\n  return (ext || \"\").toLowerCase();\n}\n\nfunction unionExts(categories: Set<MediaCategory>): Set<string> {\n  const out = new Set<string>();\n  for (const c of categories) {\n    const set = MEDIA_TYPES[c];\n    for (const e of set) out.add(e);\n  }\n  return out;\n}\n\n/** ---- API (Python parity) ---- */\n\n/**\n * Return a sub-map of MEDIA_TYPES for the given categories.\n * If categories is falsy, returns all categories.\n */\nexport function getMediaMap(\n  categories?: Iterable<string> | string[] | null,\n  opts?: MediaOptions,\n): Partial<Record<MediaCategory, Set<string>>> {\n  const cats = normalizeCategories(categories, opts);\n  const result: Partial<Record<MediaCategory, Set<string>>> = {};\n  for (const c of cats) result[c] = new Set(MEDIA_TYPES[c]);\n  return result;\n}\n\n/**\n * Return a flat, sorted list of all extensions for the given categories.\n */\nexport function getMediaExts(\n  categories?: Iterable<string> | string[] | null,\n  opts?: MediaOptions,\n): string[] {\n  const cats = normalizeCategories(categories, opts);\n  return Array.from(unionExts(cats)).sort();\n}\n\n/**\n * Given a file path or extension, return its media category (e.g. \"image\") or null.\n * Mirrors Python's confirm_type.\n */\nexport function confirmType(\n  pathOrExt: string,\n  categories?: Iterable<string> | string[] | null,\n  opts?: MediaOptions,\n): MediaCategory | null {\n  const cats = normalizeCategories(categories, opts);\n  const ext = extOf(pathOrExt);\n  // Preserve object insertion order like Python dict iteration\n  for (const [category, exts] of Object.entries(MEDIA_TYPES) as [\n    MediaCategory,\n    Set<string>,\n  ][]) {\n    if (!cats.has(category)) continue;\n    if (ext && exts.has(ext)) return category;\n  }\n  return null;\n}\n\n/**\n * True if the given file path or extension belongs to one of the categories.\n */\nexport function isMediaType(\n  pathOrExt: string,\n  categories?: Iterable<string> | string[] | null,\n  opts?: MediaOptions,\n): boolean {\n  return confirmType(pathOrExt, categories, opts) !== null;\n}\n\n/**\n * Look up the MIME type by extension; fall back to 'application/octet-stream'.\n */\nexport function getMimeType(pathOrExt: string): string {\n  const ext = extOf(pathOrExt);\n  for (const mapping of Object.values(MIME_TYPES)) {\n    if (ext && mapping[ext as keyof typeof mapping]) {\n      return mapping[ext as keyof typeof mapping] as string;\n    }\n  }\n  return \"application/octet-stream\";\n}\n\nexport function getAllFileTypesSync(\n  directory: string,\n  categories?: Iterable<string> | string[] | null,\n  opts?: MediaOptions,\n): string[] {\n  // 🧩 Skip entirely if fs isn't available\n  if (!fs || !path) return [];\n\n  try {\n    const stat = fs.statSync(directory);\n    if (!stat.isDirectory()) return [];\n\n    const cats = normalizeCategories(categories, opts);\n    const wanted = unionExts(cats);\n    const results: string[] = [];\n\n    function walkSync(dir: string) {\n      const entries = fs.readdirSync(dir, { withFileTypes: true });\n      for (const ent of entries) {\n        const full = path.join(dir, ent.name);\n        if (ent.isDirectory()) {\n          walkSync(full);\n        } else if (ent.isFile()) {\n          const ext = path.extname(ent.name).toLowerCase();\n          if (wanted.has(ext)) results.push(full);\n        }\n      }\n    }\n\n    walkSync(directory);\n    return results;\n  } catch {\n    return [];\n  }\n}\n\nexport async function getAllFileTypes(\n  directory: string,\n  categories?: Iterable<string> | string[] | null,\n  opts?: MediaOptions,\n): Promise<string[]> {\n  // 🧩 Skip entirely if fsp isn't available\n  if (!fsp || !path) return [];\n\n  try {\n    const stat = await fsp.stat(directory);\n    if (!stat.isDirectory()) return [];\n\n    const cats = normalizeCategories(categories, opts);\n    const wanted = unionExts(cats);\n    const results: string[] = [];\n\n    async function walkAsync(dir: string): Promise<void> {\n      const entries = await fsp.readdir(dir, { withFileTypes: true });\n      for (const ent of entries) {\n        const full = path.join(dir, ent.name);\n        if (ent.isDirectory()) {\n          await walkAsync(full);\n        } else if (ent.isFile()) {\n          const ext = path.extname(ent.name).toLowerCase();\n          if (wanted.has(ext)) results.push(full);\n        }\n      }\n    }\n\n    await walkAsync(directory);\n    return results;\n  } catch {\n    return [];\n  }\n}\n\n\n/** Optional convenience re-exports that mirror your Python names */\nexport const get_all_file_types = getAllFileTypes;\nexport const get_media_map = getMediaMap;\nexport const get_media_exts = getMediaExts;\nexport const confirm_type = confirmType;\nexport const is_media_type = isMediaType;\nexport const get_mime_type = getMimeType;\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.js","sources":["../../src/server/src/read_utils/src/readJsonFile.node.ts"],"sourcesContent":["import { readFileSync } from \"fs\";\nimport { resolve, isAbsolute } from \"path\";\n\nexport function readJsonFileNode<T = any>(\n  relativeOrAbsolutePath: string\n): T | null {\n  try {\n    const filePath = isAbsolute(relativeOrAbsolutePath)\n      ? relativeOrAbsolutePath\n      : resolve(process.cwd(), relativeOrAbsolutePath);\n\n    return JSON.parse(readFileSync(filePath, \"utf8\")) as T;\n  } catch {\n    return null;\n  }\n}\n"],"names":[],"mappings":";;;;AAGM,SAAU,gBAAgB,CAC9B,sBAA8B,EAAA;AAE9B,IAAA,IAAI;AACF,QAAA,MAAM,QAAQ,GAAG,UAAU,CAAC,sBAAsB;AAChD,cAAE;cACA,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,sBAAsB,CAAC;QAElD,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAM;IACxD;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,IAAI;IACb;AACF;;;;"}

package/dist/types/browser/index.d.ts

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

package/dist/types/browser/src/index.d.ts

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

package/dist/types/browser/src/read_utils/index.d.ts

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

package/dist/types/browser/src/read_utils/src/index.d.ts

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

package/dist/types/browser/src/read_utils/src/readJsonFile.browser.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Safely walk `globalThis` (or window/document) by a chain of property names.
+ * Returns `undefined` if any step is missing.
+ */
+export declare function safeGlobalProp<T = any>(...path: string[]): T | undefined;
+export declare function readJsonFileBrowser<T = any>(url: string): Promise<T | null>;

package/dist/types/functions/read_utils/src/index.d.ts

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

package/dist/types/functions/read_utils/src/readJsonFile.browser.d.ts

@@ -1 +1,6 @@
+/**
+ * Safely walk `globalThis` (or window/document) by a chain of property names.
+ * Returns `undefined` if any step is missing.
+ */
+export declare function safeGlobalProp<T = any>(...path: string[]): T | undefined;
 export declare function readJsonFileBrowser<T = any>(url: string): Promise<T | null>;

package/dist/types/functions/type_utils/src/mime_utils.d.ts

@@ -3,10 +3,9 @@ export type MimeByExt = Record<string, string>;
 export type MediaMap = Record<string, MimeByExt>;
 export type MediaCategory = keyof typeof MIME_TYPES;
 export interface MediaOptions {
-    /** Alias to mirror the Python **kwargs['media_types'] behavior */
     media_types?: Iterable<string> | string[] | null;
 }
-/** ---- Data: large but explicit, mirrors your Python mapping ---- */
+/** ---- Data ---- */
 export declare const MIME_TYPES: {
     readonly image: {
         readonly ".jpg": "image/jpeg";
@@ -136,35 +135,15 @@ export declare const MIME_TYPES: {
         readonly ".rpm": "application/x-rpm";
     };
 };
-/** Mirror of MEDIA_TYPES in Python: category -> Set of extensions */
+/** category -> Set of extensions */
 export declare const MEDIA_TYPES: Record<MediaCategory, Set<string>>;
-/** ---- API (Python parity) ---- */
-/**
- * Return a sub-map of MEDIA_TYPES for the given categories.
- * If categories is falsy, returns all categories.
- */
+/** ---- API ---- */
 export declare function getMediaMap(categories?: Iterable<string> | string[] | null, opts?: MediaOptions): Partial<Record<MediaCategory, Set<string>>>;
-/**
- * Return a flat, sorted list of all extensions for the given categories.
- */
 export declare function getMediaExts(categories?: Iterable<string> | string[] | null, opts?: MediaOptions): string[];
-/**
- * Given a file path or extension, return its media category (e.g. "image") or null.
- * Mirrors Python's confirm_type.
- */
 export declare function confirmType(pathOrExt: string, categories?: Iterable<string> | string[] | null, opts?: MediaOptions): MediaCategory | null;
-/**
- * True if the given file path or extension belongs to one of the categories.
- */
 export declare function isMediaType(pathOrExt: string, categories?: Iterable<string> | string[] | null, opts?: MediaOptions): boolean;
-/**
- * Look up the MIME type by extension; fall back to 'application/octet-stream'.
- */
 export declare function getMimeType(pathOrExt: string): string;
-export declare function getAllFileTypesSync(directory: string, categories?: Iterable<string> | string[] | null, opts?: MediaOptions): string[];
-export declare function getAllFileTypes(directory: string, categories?: Iterable<string> | string[] | null, opts?: MediaOptions): Promise<string[]>;
-/** Optional convenience re-exports that mirror your Python names */
-export declare const get_all_file_types: typeof getAllFileTypes;
+/** snake_case aliases */
 export declare const get_media_map: typeof getMediaMap;
 export declare const get_media_exts: typeof getMediaExts;
 export declare const confirm_type: typeof confirmType;

package/dist/types/server/src/index.d.ts

@@ -1,2 +1,2 @@
 import 'server-only';
-export * from './mime_utils';
+export * from './read_utils';

package/dist/types/server/src/mediaTypes.core.d.ts

@@ -0,0 +1,37 @@
+/** ---- Types ---- */
+export type MimeByExt = Record<string, string>;
+export type MediaMap = Record<string, MimeByExt>;
+export type MediaCategory = keyof typeof MIME_TYPES;
+export interface MediaOptions {
+    media_types?: Iterable<string> | string[] | null;
+}
+/** ---- MIME TYPES ---- */
+export declare const MIME_TYPES: {
+    readonly image: {
+        readonly ".jpg": "image/jpeg";
+        readonly ".png": "image/png";
+        readonly ".webp": "image/webp";
+    };
+    readonly video: {
+        readonly ".mp4": "video/mp4";
+        readonly ".webm": "video/webm";
+    };
+    readonly audio: {
+        readonly ".mp3": "audio/mpeg";
+        readonly ".wav": "audio/wav";
+    };
+    readonly document: {
+        readonly ".pdf": "application/pdf";
+        readonly ".txt": "text/plain";
+    };
+    readonly code: {
+        readonly ".ts": "application/typescript";
+        readonly ".js": "application/javascript";
+    };
+};
+/** ---- Derived ---- */
+export declare const MEDIA_TYPES: Record<MediaCategory, Set<string>>;
+/** ---- API ---- */
+export declare function confirmType(pathOrExt: string, categories?: Iterable<string> | string[] | null): MediaCategory | null;
+export declare function isMediaType(pathOrExt: string, categories?: Iterable<string> | string[] | null): boolean;
+export declare function getMimeType(pathOrExt: string): string;

package/dist/types/server/src/mime_utils.d.ts

@@ -3,10 +3,9 @@ export type MimeByExt = Record<string, string>;
 export type MediaMap = Record<string, MimeByExt>;
 export type MediaCategory = keyof typeof MIME_TYPES;
 export interface MediaOptions {
-    /** Alias to mirror the Python **kwargs['media_types'] behavior */
     media_types?: Iterable<string> | string[] | null;
 }
-/** ---- Data: large but explicit, mirrors your Python mapping ---- */
+/** ---- Data ---- */
 export declare const MIME_TYPES: {
     readonly image: {
         readonly ".jpg": "image/jpeg";
@@ -136,35 +135,15 @@ export declare const MIME_TYPES: {
         readonly ".rpm": "application/x-rpm";
     };
 };
-/** Mirror of MEDIA_TYPES in Python: category -> Set of extensions */
+/** category -> Set of extensions */
 export declare const MEDIA_TYPES: Record<MediaCategory, Set<string>>;
-/** ---- API (Python parity) ---- */
-/**
- * Return a sub-map of MEDIA_TYPES for the given categories.
- * If categories is falsy, returns all categories.
- */
+/** ---- API ---- */
 export declare function getMediaMap(categories?: Iterable<string> | string[] | null, opts?: MediaOptions): Partial<Record<MediaCategory, Set<string>>>;
-/**
- * Return a flat, sorted list of all extensions for the given categories.
- */
 export declare function getMediaExts(categories?: Iterable<string> | string[] | null, opts?: MediaOptions): string[];
-/**
- * Given a file path or extension, return its media category (e.g. "image") or null.
- * Mirrors Python's confirm_type.
- */
 export declare function confirmType(pathOrExt: string, categories?: Iterable<string> | string[] | null, opts?: MediaOptions): MediaCategory | null;
-/**
- * True if the given file path or extension belongs to one of the categories.
- */
 export declare function isMediaType(pathOrExt: string, categories?: Iterable<string> | string[] | null, opts?: MediaOptions): boolean;
-/**
- * Look up the MIME type by extension; fall back to 'application/octet-stream'.
- */
 export declare function getMimeType(pathOrExt: string): string;
-export declare function getAllFileTypesSync(directory: string, categories?: Iterable<string> | string[] | null, opts?: MediaOptions): string[];
-export declare function getAllFileTypes(directory: string, categories?: Iterable<string> | string[] | null, opts?: MediaOptions): Promise<string[]>;
-/** Optional convenience re-exports that mirror your Python names */
-export declare const get_all_file_types: typeof getAllFileTypes;
+/** snake_case aliases */
 export declare const get_media_map: typeof getMediaMap;
 export declare const get_media_exts: typeof getMediaExts;
 export declare const confirm_type: typeof confirmType;

package/dist/types/server/src/read_utils/index.d.ts

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

package/dist/types/server/src/read_utils/src/index.d.ts

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

package/dist/types/server/src/read_utils/src/readJsonFile.node.d.ts

@@ -0,0 +1 @@
+export declare function readJsonFileNode<T = any>(relativeOrAbsolutePath: string): T | null;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@putkoff/abstract-utilities",
-    "version": "1.0.135",
+    "version": "1.0.142",
     "type": "module",
     "description": "A reusable React Login component with JWT authentication",
     "main": "dist/cjs/index.js",