@putkoff/abstract-utilities 1.0.70 → 1.0.93

package/dist/index.d.ts

@@ -1,813 +0,0 @@
-interface FileItem {
-    id: number | string;
-    filename: string;
-    uploader_id: string;
-    filepath: string;
-    created_at: string;
-    download_count: number;
-    download_limit: number | null;
-    shareable: boolean;
-    needsPassword: boolean;
-    share_password: string | null;
-}
-interface ApiRow {
-    id: number | string;
-    filename: string;
-    uploader_id: string;
-    filepath: string;
-    created_at: string;
-    download_count: number;
-    download_limit: number | null;
-    shareable: boolean;
-    needsPassword: boolean;
-    share_password: string;
-}
-interface FileListResponse {
-    files?: ApiRow[];
-}
-
-interface AppConfig {
-    BASE_API_URL: string;
-    BASE_OTHER_URL: string;
-    FEATURE_FLAG?: boolean;
-    SOME_NUMBER?: number;
-}
-interface Promise$1<AppConfig> {
-    BASE_URL: string;
-    BASE_API_URL: string;
-    FEATURE_FLAG?: boolean;
-    SOME_NUMBER?: number;
-}
-interface InputProps {
-    label?: any;
-    type?: any;
-    value?: any;
-    onChange?: any;
-    disabled?: any;
-    placeholder?: any;
-    error?: string;
-}
-type UrlKey = Extract<keyof AppConfig, `BASE_${string}_URL`>;
-interface FetchVariables {
-    method: string;
-    headers: Record<string, string>;
-    body?: string | FormData;
-}
-/**
- * Helpers for dealing with the JWT stored in localStorage.
- */
-interface JwtPayload {
-    /** UNIX-epoch seconds (standard exp claim) */
-    exp: number;
-    /** Your backend also stores the username here */
-    username?: string;
-    /** Any other claims are allowed */
-    [key: string]: unknown;
-}
-
-interface LogoutButtonProps {
-    /** Fired after the user is fully logged out so you can redirect to /login */
-    onLoggedOut?: () => void;
-}
-
-interface LoginProps {
-    onSuccess?: () => void;
-}
-interface LoginFormProps {
-    username: string;
-    setUsername: (value: string) => void;
-    password: string;
-    setPassword: (value: string) => void;
-    error: string | null;
-    busy: boolean;
-    onSubmit: (e: React.FormEvent) => void;
-}
-
-declare function getSafeDocument(): Document | undefined;
-declare function getDocumentProp<K1 extends keyof Document>(prop1: K1): Document[K1] | undefined;
-declare function getDocumentProp<K1 extends keyof Document, K2 extends keyof NonNullable<Document[K1]>>(prop1: K1, prop2: K2): NonNullable<Document[K1]>[K2] | undefined;
-
-/**
- * Returns `window` if running in a browser, otherwise `undefined`.
- */
-declare function getSafeLocalStorage(): Storage | undefined;
-/**
- * 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.
- */
-declare function callStorage<K extends keyof Storage>(method: K, ...args: Parameters<Storage[K]>): ReturnType<Storage[K]> | undefined;
-/**
- * Safely call storage methods (`localStorage` or `sessionStorage`) without blowing up.
- * Returns `undefined` on any error.
- */
-declare function safeStorage<S extends "localStorage" | "sessionStorage", K extends keyof Storage>(storageName: S, method: K, ...args: Parameters<Storage[K]>): ReturnType<Storage[K]> | undefined;
-
-/**
- * Safely walk `globalThis` (or window/document) by a chain of property names.
- * Returns `undefined` if any step is missing.
- */
-declare function safeGlobalProp<T = any>(...path: string[]): T | undefined;
-
-/**
- * Returns the global window object if it exists, otherwise undefined.
- */
-declare function getSafeWindow(): 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.
- */
-declare function callWindowMethod<K extends keyof Window, F extends Window[K] = Window[K], Args extends any[] = F extends (...a: infer P) => any ? P : never, R = F extends (...a: any) => infer U ? U : void>(method: K, ...args: Args): R | undefined;
-/** overloads for 1‐ and 2‐level deep props */
-declare function getWindowProp<K1 extends keyof Window>(prop1: K1): Window[K1] | undefined;
-declare function getWindowProp<K1 extends keyof Window, K2 extends keyof NonNullable<Window[K1]>>(prop1: K1, prop2: K2): NonNullable<Window[K1]>[K2] | undefined;
-declare function getWindowHost(): string | undefined;
-
-/**
- * Helpers for dealing with the JWT stored in localStorage.
- */
-
-/** True if token is structurally bad or its exp ≤ now. */
-declare function isTokenExpired(token: string): boolean;
-declare function decodeJwt(token: string): JwtPayload;
-
-declare const PROTOCOL = "https://";
-declare const DOMAIN_NAME = "abstractendeavors";
-declare const BASE_URL = "https://abstractendeavors.com";
-declare const SUB_DIR = "secure-files";
-declare const PROD_PREFIX = "/secure-files/";
-declare const API_PREFIX = "/secure-files/api";
-declare const DEV_PREFIX = "/secure-files-dev/";
-
-declare function get_window(): (Window & typeof globalThis) | null;
-declare function get_window_location(): Location | "https://abstractendeavors.com" | null;
-declare function get_window_pathname(): string | null;
-declare function get_window_parts(): Location | "https://abstractendeavors.com" | null;
-
-declare function fetchIt<T>(url: any, body?: any, method?: any, headers?: Record<string, string> | null, blob?: boolean, configUrl?: boolean, withCredentials?: boolean, returnJson?: boolean, returnReult?: boolean): Promise<T>;
-declare function fetchIt(url: any, body?: any, method?: any, headers?: Record<string, string> | null, blob?: boolean, configUrl?: boolean, withCredentials?: boolean, returnJson?: boolean, returnReult?: boolean): Promise<Blob>;
-declare function getHtmlDirectory(directory: string, filename: string): string;
-declare function fetchIndexHtml(filename: string, directory?: string, base?: string): Promise<string>;
-declare function fetchIndexHtmlContainer(filename: string, doc?: Document, directory?: string): Promise<void>;
-
-/**
- * Reads a JSON file, either via Node’s fs (if available)
- * or via window.fetch in the browser. Never throws — returns
- * the parsed object or null on any error.
- */
-declare function readJsonFile<T = any>(relativeOrAbsolutePath: string): Promise<T | null>;
-declare function getConfigContent<T = Record<string, any>>(): Promise<T | null>;
-declare function getConfigVar<T = any>(key?: any): Promise<T | undefined>;
-
-/**
- * Unwraps nested { result } fields until you hit a non-object or no more "result" keys.
- */
-declare function getResult<T>(obj: unknown): T;
-declare function getMethod(method?: string | null, body?: unknown): string;
-declare function getHeaders(headers?: Record<string, string>, method?: string | null, body?: unknown): Record<string, string>;
-declare function getBody(body?: unknown, method?: string | null): string | undefined;
-declare function getFetchVars(headers?: Record<string, string> | null, method?: string | null, body?: any): FetchVariables;
-declare function parseResult(res: Response): Promise<unknown>;
-/**
- * Intercept 401/403 and force a clean redirect to login
- * without ever showing an alert.
- */
-declare function checkResponse(res: Response): Response;
-
-declare function urlJoin(...parts: (string | undefined | null)[]): string;
-/**
- * Returns a full URL.
- * If partial_url is already absolute (starts with http), it is returned as is.
- * Otherwise, it is combined with the base URL.
- */
-declare function get_full_url(partial_url: any, domain?: any): string;
-/**
- * Returns a full file system path.
- * If partial_path is already absolute, it is returned as is.
- * Otherwise, it is joined with the base directory.
- */
-declare function get_full_path(partial_path: any, parent_dir?: any): string;
-/**
- * Converts a local file system path into its corresponding URL.
- * It checks against the known directories in all_paths and replaces the matching base.
- */
-declare function path_to_url(filePath: string, all_paths: any): string | null;
-/**
- * Converts a URL into its corresponding local file system path.
- * It checks against the known URL prefixes in all_paths and replaces the matching base.
- */
-declare function url_to_path(urlStr: string, all_paths: any): string | null;
-declare function urljoin(...parts: (string | undefined | null)[]): string;
-
-declare function get_dirname(filePath: string | null): string;
-declare function get_basename(filePath: string | null): string;
-declare function get_filename(filePath: string): string;
-declare function get_extname(filePath: string | null): string;
-declare function get_splitext(filePath: string | null): {
-    filename: string;
-    extname: string;
-    ext?: undefined;
-} | {
-    filename: string;
-    ext: string;
-    extname?: undefined;
-};
-/**
- * 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").
- */
-declare function get_relative_path(basePath: string, targetPath: string): string;
-/**
- * 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.
- */
-declare function make_path(...parts: any[]): string;
-declare function sanitizeFilename(filename: string): string;
-declare function make_sanitized_path(...paths: string[]): string;
-declare function normalizeUrl(base: string, p?: string): string;
-declare function pathjoin(...parts: any[]): string;
-declare function pathJoin(...parts: any[]): string;
-declare function makepath(...parts: any[]): string;
-declare function makePath(...parts: any[]): string;
-declare function path_join(...parts: any[]): string;
-declare function getSplitext(filePath: string | null): {
-    filename: string;
-    extname: string;
-    ext?: undefined;
-} | {
-    filename: string;
-    ext: string;
-    extname?: undefined;
-};
-declare function getsplitext(filePath: string | null): {
-    filename: string;
-    extname: string;
-    ext?: undefined;
-} | {
-    filename: string;
-    ext: string;
-    extname?: undefined;
-};
-declare function getextname(filePath: string | null): string;
-declare function getExtname(filePath: string | null): string;
-declare function getfilename(filePath: string): string;
-declare function getFilename(filePath: string): string;
-declare function getbasename(filePath: string | null): string;
-declare function getBasename(filePath: string | null): string;
-declare function getdirname(filePath: string | null): string;
-declare function getDirname(filePath: string | null): string;
-
-/**
- * Returns the absolute path of the current file.
- */
-declare function getAbsDir(): string;
-declare function getAbsPath(subPath: string): string;
-
-declare function getFunctionsDir(): string;
-declare function geAuthsUtilsDirectory(): string;
-declare function geBackupsUtilsDirectory(): string;
-declare function geConstantsUtilsDirectory(): string;
-declare function geEnvUtilsDirectory(): string;
-declare function geFetchUtilsDirectory(): string;
-declare function geFileUtilsDirectory(): string;
-declare function gePathUtilsDirectory(): string;
-declare function geStringUtilsDirectory(): string;
-declare function geTypeUtilsDirectory(): string;
-
-declare function getSrcDir(): string;
-declare function geStaticDirectory(): string;
-declare function getLibUtilsDirectory(): string;
-declare function getHooksUtilsDirectory(): string;
-declare function getFunctionsUtilsDirectory(): string;
-declare function getComponentsUtilsDirectory(): string;
-
-declare function getBaseDir(): string;
-declare function getPublicDir(): string;
-declare function getDistDir(): string;
-declare function getEnvDir(): string;
-
-declare function getEnvPath(string?: string): string;
-declare function getDbConfigsPath(): string;
-declare function getSchemasPath(): string;
-declare function getSchemasDirPath(subPath: string): string;
-
-declare function alertit(obj?: any): void;
-
-declare function getSubstring(obj: string, maxLength?: number | null, minLength?: number | null): string;
-/**
- * Sanitize a string by removing null bytes and trimming whitespace.
- */
-declare function sanitizeString(input: string): string;
-declare function truncateString(obj: string, maxLength?: number): string;
-declare function capitalize_str(string: any): string;
-declare function capitalize(string: any): string;
-declare function stripPrefixes(str: string, bases?: string | string[]): string;
-declare function tryEatPrefix(str: string, length: number, ...objs: any[]): [string, boolean];
-/** Python-equivalent eatInner */
-declare function eatInner(str: any, listObjects: any): string;
-/** Python-equivalent eatOuter */
-declare function eatOuter(str: any, listObjects: any): string;
-/** Python-equivalent eatAll */
-declare function eatAll(str: any, listObjects: any): string;
-/** Python-equivalent eatElse */
-declare function eatElse(stringObj: any, chars?: any, ints?: boolean, alpha?: boolean, lower?: boolean, capitalize?: boolean, string?: boolean, listObj?: boolean): string;
-declare function tryParse(obj: any): any;
-declare function create_list_string(array_obj: any): string;
-declare function eatall(str: any, listObjects: any): string;
-declare function eatinner(str: any, listObjects: any): string;
-declare function eatouter(str: any, listObjects: any): string;
-
-/**
- * Checks if a value is enclosed in quotes.
- */
-declare function ends_in_quotes(value: any): boolean;
-declare function stripQuotes(value: any): any;
-
-declare function safeNums(...args: Array<number | string | null | undefined>): number[];
-declare function safeDivide(...args: Array<number | string | null | undefined>): number;
-declare function safeMultiply(...args: Array<number | string | null | undefined>): number;
-declare function roundPercentage(x: any): number;
-declare function exponential(i: number, k: number): number;
-declare function isZero(obj: any): boolean;
-
-type Second = 'sec' | 's' | 'second';
-type Hour = 'h' | 'hour';
-type Minute = 'm' | 'min' | 'minute';
-type Day = 'day' | 'd';
-type Mile = 'mi' | 'mile';
-type Kilometer = 'km' | 'kilometer';
-type Foot = 'ft' | 'f' | 'foot';
-type Meter = 'm' | 'meter';
-interface TargetAltIn {
-    angleDeg?: number | null;
-    targetAlt: number | null;
-    altUnit: DistanceUnit;
-    targetVel?: number | null;
-    velDistUnit?: DistanceUnit;
-    velTimeUnit?: TimeUnit;
-    startVel?: number | null;
-    startVelDist?: DistanceUnit;
-    startVelTime?: TimeUnit;
-}
-interface TargetVelIn {
-    angleDeg?: number | null;
-    targetAlt?: number | null;
-    altUnit?: DistanceUnit;
-    targetVel: number | null;
-    velDistUnit: DistanceUnit;
-    velTimeUnit: TimeUnit;
-    startVel?: number | null;
-    startVelDist?: DistanceUnit;
-    startVelTime?: TimeUnit;
-}
-interface StartVelIn {
-    angleDeg?: number | null;
-    targetAlt?: number | null;
-    altUnit?: DistanceUnit;
-    targetVel?: number | null;
-    velDistUnit?: DistanceUnit;
-    velTimeUnit?: TimeUnit;
-    startVel: number | null;
-    startVelDist: DistanceUnit;
-    startVelTime: TimeUnit;
-}
-interface OutSpeeds {
-    v: number;
-    d?: DistanceUnit;
-    t?: TimeUnit;
-}
-interface OutTimes {
-    t: number;
-    T?: TimeUnit;
-}
-interface ConvertDistance {
-    d: number;
-    fromDist: DistanceUnit;
-    toDist?: DistanceUnit;
-    vOnly?: boolean;
-}
-interface ConvertDistance {
-    d: number;
-    fromDist: DistanceUnit;
-    toDist?: DistanceUnit;
-    vOnly?: boolean;
-}
-interface ConvertTime {
-    t: number;
-    fromTime: TimeUnit;
-    toTime?: TimeUnit;
-    vOnly?: boolean;
-}
-interface ConvertTime {
-    t: number;
-    fromTime: TimeUnit;
-    toTime?: TimeUnit;
-    vOnly?: boolean;
-}
-interface ConvertSpeed {
-    v: number;
-    fromDist: DistanceUnit;
-    fromTime: TimeUnit;
-    toDist?: DistanceUnit;
-    toTime?: TimeUnit;
-    vOnly?: boolean;
-}
-interface ConvertSpeed {
-    v: number;
-    fromDist: DistanceUnit;
-    fromTime: TimeUnit;
-    toDist?: DistanceUnit;
-    toTime?: TimeUnit;
-    vOnly?: boolean;
-}
-type CanonDist = "m" | "km" | "mi" | "ft";
-type CanonTime = "s" | "min" | "h" | "day";
-type DistanceUnit = "m" | "meter" | "meters" | "km" | "kms" | "kilometer" | "kilometers" | "mi" | "mile" | "miles" | "ft" | "foot" | "feet" | "f";
-type TimeUnit = "s" | "sec" | "second" | "seconds" | "min" | "m" | "minute" | "minutes" | "h" | "hr" | "hour" | "hours" | "day" | "d" | "days";
-interface VelocityUnit {
-    D: DistanceUnit;
-    T: TimeUnit;
-}
-interface OutDistance {
-    d: number;
-    D?: DistanceUnit;
-}
-interface OutDistance {
-    d: number;
-    D?: DistanceUnit;
-}
-interface OutTime {
-    t: number;
-    T?: TimeUnit;
-}
-interface OutSpeed {
-    v: number;
-    d?: DistanceUnit;
-    t?: TimeUnit;
-}
-type OutDist = OutDistance | number | null;
-type OutTimeType = OutTime | number | null;
-type OutSpeedType = OutSpeed | number | null;
-
-declare const DIST_ALIASES: Record<string, CanonDist>;
-declare const TIME_ALIASES: Record<string, CanonTime>;
-declare const DIST_FACTORS: Record<CanonDist, number>;
-declare const TIME_FACTORS: Record<CanonTime, number>;
-declare function canonDist(u: DistanceUnit | string | undefined): CanonDist;
-declare function canonTime(u: TimeUnit | string | undefined): CanonTime;
-declare function distanceToMeters(d: number, unit: DistanceUnit | string): number;
-declare function metersToDistance(v: number, unit: DistanceUnit | string): number;
-declare function timeToSeconds(t: number, unit: TimeUnit | string): number;
-declare function secondsToTime(v: number, unit: TimeUnit | string): number;
-declare function speedToMps(v: number, distUnit: DistanceUnit | string, timeUnit: TimeUnit | string): number;
-declare function mpsToSpeed(vMps: number, distUnit: DistanceUnit | string, timeUnit: TimeUnit | string): number;
-declare function convertDistance({ d, fromDist, toDist, vOnly, }: ConvertDistance): OutDist;
-declare function convertTime({ t, fromTime, toTime, vOnly, }: ConvertTime): OutTimeType;
-declare function convertSpeed({ v, fromDist, fromTime, toDist, toTime, vOnly, }: ConvertSpeed): OutSpeedType;
-interface UnitConverter<T> {
-    normalize: (value: number, unit: T) => number;
-    unnormalize: (value: number, unit: T) => number;
-}
-declare const DistanceConverter: UnitConverter<DistanceUnit>;
-declare const TimeConverter: UnitConverter<TimeUnit>;
-declare const SpeedConverter: UnitConverter<[DistanceUnit, TimeUnit]>;
-declare const toMeters: typeof distanceToMeters;
-declare const fromMeters: typeof metersToDistance;
-declare const toSeconds: typeof timeToSeconds;
-declare const fromSeconds: typeof secondsToTime;
-declare const velocityToMs: (value: number, unit: string) => number;
-declare const velocityFromMs: (value: number, unit: string) => number;
-/** Non-canonical helper for arbitrary rate conversion, e.g. ft/day → m/s */
-declare const fromMps: (v: number, dist_unit: DistanceUnit | string, time_unit: TimeUnit | string) => number;
-declare const isFiniteNum: (x: any) => x is number;
-declare const fmt: (n: number, digits?: number) => string;
-
-declare const SECOND: number;
-declare const ZEPTOSECOND: number;
-declare const ATTOSECOND: number;
-declare const FEMTOSECOND: number;
-declare const PICOSECOND: number;
-declare const NANOSECOND: number;
-declare const MICROSECOND: number;
-declare const MILISECOND: number;
-declare const CENTISECOND: number;
-declare const DECISECOND: number;
-declare const MINUTE: number;
-declare const HOUR: number;
-declare const DAY: number;
-declare const YEAR: number;
-declare const MONTH: number;
-declare const SECONDS_PER_MINUTE: number;
-declare const SECONDS_PER_HOUR: number;
-declare const SECONDS_PER_DAY: number;
-declare const PI: number;
-declare const PI2: number;
-declare const METERS_PER_KM = 1000;
-declare const METERS_PER_MILE = 1609.34;
-declare const METERS_PER_FOOT = 0.3048;
-declare const KMS_PER_METER: number;
-declare const MILES_PER_METER: number;
-declare const FEET_PER_METER: number;
-declare const MIN_IN_S: number;
-declare const HOUR_IN_S: number;
-declare const DAY_IN_S: number;
-declare const YEAR_IN_S: number;
-declare const MONTH_IN_S: number;
-declare const MiPerH_TO_MPerS: number;
-declare const MPerS_TO_MiPerH: number;
-
-declare function isTimeInterval(timeObj: number, interval: number): boolean;
-
-/**
- * Recursively traverse the object and convert BigInts to numbers or strings.
- *
- * @param {object|array} obj - The object to traverse
- * @param {boolean} convertToNumber - Whether to convert BigInt to Number (default is true)
- * @returns {object|array} - The transformed object
- */
-declare function convertBigInts(obj: any, convertToNumber?: boolean): any;
-
-declare function cleanText(input: any): any;
-declare function cleanArray(obj: any): unknown[];
-declare function getCleanArray(obj: any): unknown[];
-declare function formatNumber<T>(value: T): string | T;
-
-declare function ensure_list(obj: any): any[];
-declare function ensure_number(x: any): number;
-declare function ensure_string(obj: any): string;
-declare function ensurelist(obj: any): any[];
-declare function assureList(obj: any): any[];
-declare function assure_list(obj: any): any[];
-declare function ensureList(obj: any): any[];
-declare function assurelist(obj: any): any[];
-declare function ensurenumber(x: any): number;
-declare function assureNumber(x: any): number;
-declare function ensureNumber(x: any): number;
-declare function assurenumber(x: any): number;
-declare function assure_number(x: any): number;
-declare function ensurestring(obj: any): string;
-declare function ensureString(obj: any): string;
-declare function assureString(obj: any): string;
-declare function assurestring(obj: any): string;
-declare function assure_string(obj: any): string;
-declare function assurearray(obj: any): any[];
-declare function ensurearray(obj: any): any[];
-declare function ensure_array(obj: any): any[];
-declare function ensureArray(obj: any): any[];
-declare function assure_array(obj: any): any[];
-declare function assureArray(obj: any): any[];
-
-declare function get_key_value<T extends object>(obj: T, key: string): any;
-declare function get<T extends object>(obj: T | null | undefined, keys: string | string[], defaultValue?: any): any;
-declare function findKeyValue(obj: Record<string, any>, keyToFind: string): any;
-declare function omitKeys<T extends object, K extends keyof T>(obj: T, ...keys: K[]): Omit<T, K>;
-/**
-* Extracts necessary properties from the insertValue to prevent circular references.
-*
-* @param insertValue - The original RPC result.
-* @returns A new object with only the required properties.
-*/
-declare function extractInsertData(insertValue: any): any;
-declare function loadInnerJson(data: any): any;
-
-declare function isType(obj: any, type: string): boolean;
-declare function isStrInString(obj: any, string: any): boolean;
-declare function getChar(i: number, string: any): string | undefined;
-declare function getAlphaNum(obj: any): string | undefined;
-declare function getNums(): string;
-declare function isNum(obj: any): boolean;
-declare function getAlphas(): string;
-
-/** ---- Types ---- */
-type MimeByExt = Record<string, string>;
-type MediaMap = Record<string, MimeByExt>;
-type MediaCategory = keyof typeof MIME_TYPES;
-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 ---- */
-declare const MIME_TYPES: {
-    readonly image: {
-        readonly ".jpg": "image/jpeg";
-        readonly ".jpeg": "image/jpeg";
-        readonly ".png": "image/png";
-        readonly ".gif": "image/gif";
-        readonly ".bmp": "image/bmp";
-        readonly ".tiff": "image/tiff";
-        readonly ".webp": "image/webp";
-        readonly ".svg": "image/svg+xml";
-        readonly ".ico": "image/vnd.microsoft.icon";
-        readonly ".heic": "image/heic";
-        readonly ".psd": "image/vnd.adobe.photoshop";
-        readonly ".raw": "image/x-raw";
-    };
-    readonly video: {
-        readonly ".mp4": "video/mp4";
-        readonly ".webm": "video/webm";
-        readonly ".ogg": "video/ogg";
-        readonly ".mov": "video/quicktime";
-        readonly ".avi": "video/x-msvideo";
-        readonly ".mkv": "video/x-matroska";
-        readonly ".flv": "video/x-flv";
-        readonly ".wmv": "video/x-ms-wmv";
-        readonly ".3gp": "video/3gpp";
-        readonly ".ts": "video/mp2t";
-        readonly ".mpeg": "video/mpeg";
-        readonly ".mpg": "video/mpg";
-    };
-    readonly audio: {
-        readonly ".mp3": "audio/mpeg";
-        readonly ".wav": "audio/wav";
-        readonly ".flac": "audio/flac";
-        readonly ".aac": "audio/aac";
-        readonly ".ogg": "audio/ogg";
-        readonly ".m4a": "audio/mp4";
-        readonly ".opus": "audio/opus";
-    };
-    readonly document: {
-        readonly ".pdf": "application/pdf";
-        readonly ".doc": "application/msword";
-        readonly ".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
-        readonly ".odt": "application/vnd.oasis.opendocument.text";
-        readonly ".txt": "text/plain";
-        readonly ".rtf": "application/rtf";
-        readonly ".md": "text/markdown";
-        readonly ".markdown": "text/markdown";
-        readonly ".tex": "application/x-tex";
-        readonly ".log": "text/plain";
-        readonly ".json": "application/json";
-        readonly ".xml": "application/xml";
-        readonly ".yaml": "application/x-yaml";
-        readonly ".yml": "application/x-yaml";
-        readonly ".ini": "text/plain";
-        readonly ".cfg": "text/plain";
-        readonly ".toml": "application/toml";
-        readonly ".csv": "text/csv";
-        readonly ".tsv": "text/tab-separated-values";
-    };
-    readonly presentation: {
-        readonly ".ppt": "application/vnd.ms-powerpoint";
-        readonly ".pptx": "application/vnd.openxmlformats-officedocument.presentationml.presentation";
-        readonly ".odp": "application/vnd.oasis.opendocument.presentation";
-    };
-    readonly spreadsheet: {
-        readonly ".xls": "application/vnd.ms-excel";
-        readonly ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
-        readonly ".ods": "application/vnd.oasis.opendocument.spreadsheet";
-        readonly ".csv": "text/csv";
-        readonly ".tsv": "text/tab-separated-values";
-    };
-    readonly code: {
-        readonly ".py": "text/x-python";
-        readonly ".java": "text/x-java-source";
-        readonly ".c": "text/x-c";
-        readonly ".cpp": "text/x-c++";
-        readonly ".h": "text/x-c";
-        readonly ".hpp": "text/x-c++";
-        readonly ".js": "application/javascript";
-        readonly ".cjs": "application/javascript";
-        readonly ".mjs": "application/javascript";
-        readonly ".jsx": "application/javascript";
-        readonly ".ts": "application/typescript";
-        readonly ".tsx": "application/typescript";
-        readonly ".rb": "text/x-ruby";
-        readonly ".php": "application/x-php";
-        readonly ".go": "text/x-go";
-        readonly ".rs": "text/rust";
-        readonly ".swift": "text/x-swift";
-        readonly ".kt": "text/x-kotlin";
-        readonly ".sh": "application/x-shellscript";
-        readonly ".bash": "application/x-shellscript";
-        readonly ".ps1": "application/x-powershell";
-        readonly ".sql": "application/sql";
-        readonly ".yml": "application/x-yaml";
-        readonly ".coffee": "text/coffeescript";
-        readonly ".lua": "text/x-lua";
-    };
-    readonly archive: {
-        readonly ".zip": "application/zip";
-        readonly ".tar": "application/x-tar";
-        readonly ".gz": "application/gzip";
-        readonly ".tgz": "application/gzip";
-        readonly ".bz2": "application/x-bzip2";
-        readonly ".xz": "application/x-xz";
-        readonly ".rar": "application/vnd.rar";
-        readonly ".7z": "application/x-7z-compressed";
-        readonly ".iso": "application/x-iso9660-image";
-        readonly ".dmg": "application/x-apple-diskimage";
-        readonly ".jar": "application/java-archive";
-        readonly ".war": "application/java-archive";
-        readonly ".whl": "application/python-wheel";
-        readonly ".egg": "application/python-egg";
-    };
-    readonly font: {
-        readonly ".ttf": "font/ttf";
-        readonly ".otf": "font/otf";
-        readonly ".woff": "font/woff";
-        readonly ".woff2": "font/woff2";
-        readonly ".eot": "application/vnd.ms-fontobject";
-    };
-    readonly executable: {
-        readonly ".exe": "application/vnd.microsoft.portable-executable";
-        readonly ".dll": "application/vnd.microsoft.portable-executable";
-        readonly ".bin": "application/octet-stream";
-        readonly ".deb": "application/vnd.debian.binary-package";
-        readonly ".rpm": "application/x-rpm";
-    };
-};
-/** Mirror of MEDIA_TYPES in Python: category -> Set of extensions */
-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.
- */
-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.
- */
-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.
- */
-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.
- */
-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'.
- */
-declare function getMimeType(pathOrExt: string): string;
-declare function getAllFileTypesSync(directory: string, categories?: Iterable<string> | string[] | null, opts?: MediaOptions): string[];
-declare function getAllFileTypes(directory: string, categories?: Iterable<string> | string[] | null, opts?: MediaOptions): Promise<string[]>;
-/** Optional convenience re-exports that mirror your Python names */
-declare const get_all_file_types: typeof getAllFileTypes;
-declare const get_media_map: typeof getMediaMap;
-declare const get_media_exts: typeof getMediaExts;
-declare const confirm_type: typeof confirmType;
-declare const is_media_type: typeof isMediaType;
-declare const get_mime_type: typeof getMimeType;
-
-declare function getIfNone<T>(obj: T | undefined | null, fallback: T): T;
-/**
- * Merges non-null values from multiple dictionaries.
- */
-declare function mergeNotNullValues<T extends Record<string, any>>(dictA: T, dictB?: Partial<T>, dictC?: Partial<T>, dictD?: Partial<T>, dictE?: Partial<T>): T;
-/**
- * Converts an empty object to null.
- */
-declare function emptyObjectToNull<T>(value: T): T | null;
-
-declare function loadConfig(filePath?: string | null): Promise<AppConfig>;
-/**
- * getConfig(): Promise<AppConfig>
- * getConfig(key): Promise<AppConfig[K]>
- */
-declare function getConfig(): Promise<AppConfig>;
-declare function getConfig<K extends keyof AppConfig>(key: K): Promise<AppConfig[K]>;
-
-/**
- * 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.
- */
-declare function processKeywords(keywords: string | string[]): string[];
-/**
- * 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 '#'.
- */
-declare function get_keyword_string(keywords: any): string;
-
-declare function exceedsMbLimit(limitMb: number, payloadMb: number): boolean;
-declare function safeJsonSizeInMb(value: unknown): number;
-declare function dataSizeInMb(data: unknown): number;
-declare function getJsonSizeInMb(json: unknown): number;
-declare function dataSize(data: any): number;
-
-export { API_PREFIX, ATTOSECOND, BASE_URL, CENTISECOND, DAY, DAY_IN_S, DECISECOND, DEV_PREFIX, DIST_ALIASES, DIST_FACTORS, DOMAIN_NAME, DistanceConverter, FEET_PER_METER, FEMTOSECOND, HOUR, HOUR_IN_S, KMS_PER_METER, MEDIA_TYPES, METERS_PER_FOOT, METERS_PER_KM, METERS_PER_MILE, MICROSECOND, MILES_PER_METER, MILISECOND, MIME_TYPES, MINUTE, MIN_IN_S, MONTH, MONTH_IN_S, MPerS_TO_MiPerH, MiPerH_TO_MPerS, NANOSECOND, PI, PI2, PICOSECOND, PROD_PREFIX, PROTOCOL, SECOND, SECONDS_PER_DAY, SECONDS_PER_HOUR, SECONDS_PER_MINUTE, SUB_DIR, SpeedConverter, TIME_ALIASES, TIME_FACTORS, TimeConverter, YEAR, YEAR_IN_S, ZEPTOSECOND, alertit, assureArray, assureList, assureNumber, assureString, assure_array, assure_list, assure_number, assure_string, assurearray, assurelist, assurenumber, assurestring, callStorage, callWindowMethod, canonDist, canonTime, capitalize, capitalize_str, checkResponse, cleanArray, cleanText, confirmType, confirm_type, convertBigInts, convertDistance, convertSpeed, convertTime, create_list_string, dataSize, dataSizeInMb, decodeJwt, distanceToMeters, eatAll, eatElse, eatInner, eatOuter, eatall, eatinner, eatouter, emptyObjectToNull, ends_in_quotes, ensureArray, ensureList, ensureNumber, ensureString, ensure_array, ensure_list, ensure_number, ensure_string, ensurearray, ensurelist, ensurenumber, ensurestring, exceedsMbLimit, exponential, extractInsertData, fetchIndexHtml, fetchIndexHtmlContainer, fetchIt, findKeyValue, fmt, formatNumber, fromMeters, fromMps, fromSeconds, geAuthsUtilsDirectory, geBackupsUtilsDirectory, geConstantsUtilsDirectory, geEnvUtilsDirectory, geFetchUtilsDirectory, geFileUtilsDirectory, gePathUtilsDirectory, geStaticDirectory, geStringUtilsDirectory, geTypeUtilsDirectory, get, getAbsDir, getAbsPath, getAllFileTypes, getAllFileTypesSync, getAlphaNum, getAlphas, getBaseDir, getBasename, getBody, getChar, getCleanArray, getComponentsUtilsDirectory, getConfig, getConfigContent, getConfigVar, getDbConfigsPath, getDirname, getDistDir, getDocumentProp, getEnvDir, getEnvPath, getExtname, getFetchVars, getFilename, getFunctionsDir, getFunctionsUtilsDirectory, getHeaders, getHooksUtilsDirectory, getHtmlDirectory, getIfNone, getJsonSizeInMb, getLibUtilsDirectory, getMediaExts, getMediaMap, getMethod, getMimeType, getNums, getPublicDir, getResult, getSafeDocument, getSafeLocalStorage, getSafeWindow, getSchemasDirPath, getSchemasPath, getSplitext, getSrcDir, getSubstring, getWindowHost, getWindowProp, get_all_file_types, get_basename, get_dirname, get_extname, get_filename, get_full_path, get_full_url, get_key_value, get_keyword_string, get_media_exts, get_media_map, get_mime_type, get_relative_path, get_splitext, get_window, get_window_location, get_window_parts, get_window_pathname, getbasename, getdirname, getextname, getfilename, getsplitext, isFiniteNum, isMediaType, isNum, isStrInString, isTimeInterval, isTokenExpired, isType, isZero, is_media_type, loadConfig, loadInnerJson, makePath, make_path, make_sanitized_path, makepath, mergeNotNullValues, metersToDistance, mpsToSpeed, normalizeUrl, omitKeys, parseResult, pathJoin, path_join, path_to_url, pathjoin, processKeywords, readJsonFile, roundPercentage, safeDivide, safeGlobalProp, safeJsonSizeInMb, safeMultiply, safeNums, safeStorage, sanitizeFilename, sanitizeString, secondsToTime, speedToMps, stripPrefixes, stripQuotes, timeToSeconds, toMeters, toSeconds, truncateString, tryEatPrefix, tryParse, urlJoin, url_to_path, urljoin, velocityFromMs, velocityToMs };
-export type { ApiRow, AppConfig, CanonDist, CanonTime, ConvertDistance, ConvertSpeed, ConvertTime, Day, DistanceUnit, FetchVariables, FileItem, FileListResponse, Foot, Hour, InputProps, JwtPayload, Kilometer, LoginFormProps, LoginProps, LogoutButtonProps, MediaCategory, MediaMap, MediaOptions, Meter, Mile, MimeByExt, Minute, OutDist, OutDistance, OutSpeed, OutSpeedType, OutSpeeds, OutTime, OutTimeType, OutTimes, Promise$1 as Promise, Second, StartVelIn, TargetAltIn, TargetVelIn, TimeUnit, UnitConverter, UrlKey, VelocityUnit };