130 lines
3.7 KiB
TypeScript
130 lines
3.7 KiB
TypeScript
import { useUserStore } from "../store/UserStore";
|
|
import { extractFileNameFromUrl } from "./url";
|
|
|
|
/**
|
|
* Tests if an object or string is empty.
|
|
* @param {unknown} value The object or string.
|
|
* @returns {boolean} If the object or string is empty.
|
|
*/
|
|
export const isEmpty = (value: unknown): boolean => {
|
|
if (typeof value === "string") {
|
|
return value.trim().length === 0;
|
|
} else if (
|
|
value instanceof File ||
|
|
value instanceof Blob ||
|
|
value instanceof Map ||
|
|
value instanceof Set
|
|
) {
|
|
return value.size === 0;
|
|
} else if (value instanceof FormData) {
|
|
return [...value.entries()].length === 0;
|
|
} else if (typeof value === "object") {
|
|
return !value || Object.keys(value).length === 0;
|
|
}
|
|
|
|
return false;
|
|
};
|
|
|
|
/**
|
|
* Returns the file extension
|
|
* @param {string} fileName The filename with extension.
|
|
* @returns {string} The file extension.
|
|
*/
|
|
export const getFileExtension = (fileName: string): string => {
|
|
if (fileName.includes(".")) {
|
|
return fileName.split(".").pop();
|
|
}
|
|
|
|
return "";
|
|
};
|
|
|
|
/**
|
|
* Returns a url to a file type icon based on file name.
|
|
* @param {string} fileName The filename with extension.
|
|
* @returns {string} The url to the file type icon.
|
|
*/
|
|
export const getFileIconImagePath = (fileName: string): string => {
|
|
const ext = getFileExtension(fileName);
|
|
if (ext.length > 0) {
|
|
return `/assets/fileicons/${ext}.webp`;
|
|
}
|
|
|
|
return "/assets/fileicons/unknown.webp";
|
|
};
|
|
|
|
/**
|
|
* Returns a url to a file preview icon based on file url.
|
|
* @param {string} url The url of the file.
|
|
* @returns {string} The url to the file preview icon.
|
|
*/
|
|
export const getFilePreview = (url: string): string => {
|
|
const ext = getFileExtension(extractFileNameFromUrl(url));
|
|
if (ext.length > 0) {
|
|
if (/(gif|jpe?g|png)/i.test(ext)) {
|
|
return `${url}?size=thumb`;
|
|
}
|
|
|
|
return `/assets/fileicons/${ext}.webp`;
|
|
}
|
|
|
|
return "/assets/fileicons/unknown.webp";
|
|
};
|
|
|
|
/**
|
|
* Clamps a number between 2 numbers.
|
|
* @param {number} n The number to clamp.
|
|
* @param {number} min The minimum allowable number.
|
|
* @param {number} max The maximum allowable number.
|
|
* @returns {number} The clamped number.
|
|
*/
|
|
export const clamp = (n: number, min: number, max: number): number => {
|
|
if (n < min) return min;
|
|
if (n > max) return max;
|
|
return n;
|
|
};
|
|
|
|
/**
|
|
* Generate a random element ID.
|
|
* @param {string} prefix Any prefix to add to the ID.
|
|
* @returns {string} A random string non-existent in the document.
|
|
*/
|
|
export const generateRandomElementId = (prefix: string = ""): string => {
|
|
let randomId = "";
|
|
|
|
do {
|
|
randomId = prefix + Math.random().toString(36).substring(2, 9);
|
|
} while (document.getElementById(randomId));
|
|
|
|
return randomId;
|
|
};
|
|
|
|
/**
|
|
* Return if the current user has a permission.
|
|
* @param {string} permission The permission to check.
|
|
* @returns {boolean} If the user has the permission.
|
|
*/
|
|
export const userHasPermission = (permission: string): boolean => {
|
|
const userStore = useUserStore();
|
|
return userStore.permissions && userStore.permissions.includes(permission);
|
|
};
|
|
|
|
/**
|
|
* Convert File Name to Title
|
|
* @param {string} fileName The filename with extension.
|
|
* @returns {string} The title.
|
|
*/
|
|
export const convertFileNameToTitle = (fileName: string): string => {
|
|
// Remove file extension
|
|
const fileNameWithoutExtension = fileName.replace(/\.[^/.]+$/, "");
|
|
|
|
// Replace dash and underscore with space
|
|
const fileNameWithSpaces = fileNameWithoutExtension.replace(/[-_]/g, " ");
|
|
|
|
// Capitalize the first letter and convert to lowercase
|
|
const capitalizedFileName =
|
|
fileNameWithSpaces.charAt(0).toUpperCase() +
|
|
fileNameWithSpaces.slice(1).toLowerCase();
|
|
|
|
return capitalizedFileName;
|
|
};
|