upstream-rocketchat/apps/meteor/lib/utils/stringUtils.ts

import { escapeRegExp } from '@rocket.chat/tools';
import DOMPurify from 'dompurify';

export function truncate(str: string, length: number): string {
	return str.length > length ? `${str.slice(0, length - 3)}...` : str;
}

function makeString(object: unknown): string {
	if (!object) return '';
	return String(object);
}

function defaultToWhiteSpace(characters: unknown): string {
	if (!characters) return '\\s';
	if (typeof characters === 'object' && 'source' in characters) return (characters as { source: string }).source;
	return `[${escapeRegExp(makeString(characters))}]`;
}

const nativeTrim = String.prototype.trim;
const nativeTrimLeft = String.prototype.trimLeft;
const nativeTrimRight = String.prototype.trimRight;

export function trim(_str: unknown, _characters?: unknown): string {
	const str = makeString(_str);
	if (!_characters && nativeTrim) return nativeTrim.call(str);
	const characters = defaultToWhiteSpace(_characters);
	return str.replace(new RegExp(`^${characters}+|${characters}+$`, 'g'), '');
}

export function ltrim(_str: unknown, _characters: unknown): string {
	const str = makeString(_str);
	if (!_characters && nativeTrimLeft) return nativeTrimLeft.call(str);
	const characters = defaultToWhiteSpace(_characters);
	return str.replace(new RegExp(`^${characters}+`), '');
}

export function rtrim(_str: unknown, _characters: unknown): string {
	const str = makeString(_str);
	if (!_characters && nativeTrimRight) return nativeTrimRight.call(str);
	const characters = defaultToWhiteSpace(_characters);
	return str.replace(new RegExp(`${characters}+$`), '');
}

export function capitalize(_str: unknown, lowercaseRest: boolean): string {
	const str = makeString(_str);
	const remainingChars = !lowercaseRest ? str.slice(1) : str.slice(1).toLowerCase();

	return str.charAt(0).toUpperCase() + remainingChars;
}

export function stripTags(str: unknown): string {
	return DOMPurify.sanitize(makeString(str)).replace(/<\/?[^>]+>/g, '');
}

export function strLeft(_str: unknown, _sep: unknown): string {
	const str = makeString(_str);
	const sep = makeString(_sep);
	const pos = !sep ? -1 : str.indexOf(sep);
	return ~pos ? str.slice(0, pos) : str;
}

export function strRight(_str: unknown, _sep: unknown): string {
	const str = makeString(_str);
	const sep = makeString(_sep);
	const pos = !sep ? -1 : str.indexOf(sep);
	return ~pos ? str.slice(pos + sep.length, str.length) : str;
}

export function strRightBack(_str: unknown, _sep: unknown): string {
	const str = makeString(_str);
	const sep = makeString(_sep);
	const pos = !sep ? -1 : str.lastIndexOf(sep);
	return ~pos ? str.slice(pos + sep.length, str.length) : str;
}

export function numberFormat(_number: number, dec: number, dsep?: string, tsep?: string): string {
	if (isNaN(_number) || _number === null || _number === undefined) return '';

	const number = _number.toFixed(~~dec);
	tsep = typeof tsep === 'string' ? tsep : ',';

	const parts = number.split('.');
	const fnums = parts[0];
	const decimals = parts[1] ? (dsep || '.') + parts[1] : '';

	return fnums.replace(/(\d)(?=(?:\d{3})+$)/g, `$1${tsep}`) + decimals;
}

export function pad(_str: unknown, _length: number, padStr?: string, type: 'right' | 'left' | 'both' = 'right') {
	const str = makeString(_str);
	const length = ~~_length;

	let padlen = 0;

	if (!padStr) padStr = ' ';
	else if (padStr.length > 1) padStr = padStr.charAt(0);

	switch (type) {
		case 'right':
			padlen = length - str.length;
			return str + padStr.repeat(padlen);
		case 'both':
			padlen = length - str.length;
			return padStr.repeat(Math.ceil(padlen / 2)) + str + padStr.repeat(Math.floor(padlen / 2));
		default: // 'left'
			padlen = length - str.length;
			return padStr.repeat(padlen) + str;
	}
}

export function lrpad(str: unknown, length: number, padStr?: string): string {
	return pad(str, length, padStr, 'both');
}