@putkoff/abstract-utilities 1.0.113 → 1.0.124

package/dist/types/functions/type_utils/src/mime_utils.js

@@ -1,314 +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());
-    });
-};
-// mediaTypes.ts
-import * as fs from "node:fs";
-import * as fsp from "node:fs/promises";
-import * as path from "node:path";
-/** ---- Data: large but explicit, mirrors your Python mapping ---- */
-export 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 */
-export 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) {
-    var _a;
-    const selected = (_a = categories !== null && categories !== void 0 ? categories : opts === null || opts === void 0 ? void 0 : opts.media_types) !== null && _a !== void 0 ? _a : 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.
- */
-export 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.
- */
-export 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.
- */
-export 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.
- */
-export function isMediaType(pathOrExt, categories, opts) {
-    return confirmType(pathOrExt, categories, opts) !== null;
-}
-/**
- * Look up the MIME type by extension; fall back to 'application/octet-stream'.
- */
-export 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";
-}
-export 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 (_a) {
-        return [];
-    }
-}
-export function getAllFileTypes(directory, categories, opts) {
-    return __awaiter(this, void 0, void 0, function* () {
-        // 🧩 Skip entirely if fsp isn't available
-        if (!fsp || !path)
-            return [];
-        try {
-            const stat = yield fsp.stat(directory);
-            if (!stat.isDirectory())
-                return [];
-            const cats = normalizeCategories(categories, opts);
-            const wanted = unionExts(cats);
-            const results = [];
-            function walkAsync(dir) {
-                return __awaiter(this, void 0, void 0, function* () {
-                    const entries = yield fsp.readdir(dir, { withFileTypes: true });
-                    for (const ent of entries) {
-                        const full = path.join(dir, ent.name);
-                        if (ent.isDirectory()) {
-                            yield walkAsync(full);
-                        }
-                        else if (ent.isFile()) {
-                            const ext = path.extname(ent.name).toLowerCase();
-                            if (wanted.has(ext))
-                                results.push(full);
-                        }
-                    }
-                });
-            }
-            yield walkAsync(directory);
-            return results;
-        }
-        catch (_a) {
-            return [];
-        }
-    });
-}
-/** Optional convenience re-exports that mirror your Python names */
-export const get_all_file_types = getAllFileTypes;
-export const get_media_map = getMediaMap;
-export const get_media_exts = getMediaExts;
-export const confirm_type = confirmType;
-export const is_media_type = isMediaType;
-export const get_mime_type = getMimeType;

package/dist/types/functions/type_utils/src/null_utils.js

@@ -1,21 +0,0 @@
-// Function to handle undefined or null values
-export function getIfNone(obj, fallback) {
-    return obj !== undefined && obj !== null && obj !== '' ? obj : fallback;
-}
-/**
- * Merges non-null values from multiple dictionaries.
- */
-export function mergeNotNullValues(dictA, dictB, dictC, dictD, dictE) {
-    var _a, _b, _c, _d;
-    const result = {};
-    for (const key of Object.keys(dictA)) {
-        result[key] = (_d = (_c = (_b = (_a = dictA[key]) !== null && _a !== void 0 ? _a : dictB === null || dictB === void 0 ? void 0 : dictB[key]) !== null && _b !== void 0 ? _b : dictC === null || dictC === void 0 ? void 0 : dictC[key]) !== null && _c !== void 0 ? _c : dictD === null || dictD === void 0 ? void 0 : dictD[key]) !== null && _d !== void 0 ? _d : dictE === null || dictE === void 0 ? void 0 : dictE[key];
-    }
-    return result;
-}
-/**
- * Converts an empty object to null.
- */
-export function emptyObjectToNull(value) {
-    return value && typeof value === 'object' && !Array.isArray(value) && Object.keys(value).length === 0 ? null : value;
-}

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

@@ -1,39 +0,0 @@
-import { ensure_string } from './ensure_utils';
-export function isType(obj, type) {
-    if (typeof obj === type) {
-        return true;
-    }
-    return false;
-}
-export function isStrInString(obj, string) {
-    const obj_str = ensure_string(obj).toLowerCase;
-    string = ensure_string(string).toLowerCase;
-    if (string.includes(obj_str)) {
-        return true;
-    }
-    return false;
-}
-export function getChar(i, string) {
-    if (string.length >= i) {
-        return ensure_string(string)[i];
-    }
-}
-export function getAlphaNum(obj) {
-    const is_num = isNum(obj);
-    const alphas = getAlphas();
-    if (is_num) {
-        return getChar(obj, alphas);
-    }
-    if (isStrInString(obj, alphas)) {
-        return getChar(obj, alphas);
-    }
-}
-export function getNums() {
-    return '0123456789';
-}
-export function isNum(obj) {
-    return !Number.isNaN(Number(obj));
-}
-export function getAlphas() {
-    return 'abcdefghijklmnopqrstuvwxyz';
-}

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

@@ -1 +0,0 @@
-export { eatAll } from './../string_utils';

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

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

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

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

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

@@ -1,34 +0,0 @@
-import { eatAll } from './../imports';
-/**
- * Processes keywords by checking if keywords is a string and splitting it.
- * Then cleans each keyword using `eatAll` with a set of characters to remove.
- *
- * @param keywords - The keywords as a comma-separated string or as an array.
- * @returns An array of cleaned keywords.
- */
-export function processKeywords(keywords) {
-    let keywordArray;
-    // If keywords is a string, split it on commas
-    if (typeof keywords === "string") {
-        keywordArray = keywords.split(",");
-    }
-    else {
-        keywordArray = keywords;
-    }
-    // Clean each keyword by removing unwanted characters
-    return keywordArray.map(keyword => eatAll(keyword, [",", "\n", "\t", " ", "#"]));
-}
-/**
- * Constructs a keyword string where each keyword is prefixed with a hash (#).
- *
- * @param keywords - An array of keywords.
- * @returns A string with each keyword prefixed by '#'.
- */
-export function get_keyword_string(keywords) {
-    keywords = processKeywords(keywords);
-    let allString = "";
-    for (const keyword of keywords) {
-        allString += ` #${keyword}`;
-    }
-    return allString;
-}

package/dist/types/index.js

@@ -1,2 +0,0 @@
-export * from './functions';
-export * from './types';

package/dist/types/server/index.js

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

package/dist/types/server/src/index.js

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