Newer
Older
percord / src / util / util / extensions / Array.ts
@MathMan05 MathMan05 on 26 Nov 3 KB actually delete the functions
/*
	Spacebar: A FOSS re-implementation and extension of the Discord.com backend.
	Copyright (C) 2025 Spacebar and Spacebar Contributors
	
	This program is free software: you can redistribute it and/or modify
	it under the terms of the GNU Affero General Public License as published
	by the Free Software Foundation, either version 3 of the License, or
	(at your option) any later version.
	
	This program is distributed in the hope that it will be useful,
	but WITHOUT ANY WARRANTY; without even the implied warranty of
	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
	GNU Affero General Public License for more details.
	
	You should have received a copy of the GNU Affero General Public License
	along with this program.  If not, see <https://www.gnu.org/licenses/>.
*/

declare global {
	interface Array<T> {
		partition(filter: (elem: T) => boolean): [T[], T[]];
		forEachAsync(callback: (elem: T, index: number, array: T[]) => Promise<void>): Promise<void>;
		filterAsync(callback: (elem: T, index: number, array: T[]) => Promise<boolean>): Promise<T[]>;
		remove(item: T): void;
		distinct(): T[];
		distinctBy<K>(key: (elem: T) => K): T[];
	}
}

/* https://stackoverflow.com/a/50636286 */
export function arrayPartition<T>(array: T[], filter: (elem: T) => boolean): [T[], T[]] {
	const pass: T[] = [],
		fail: T[] = [];
	array.forEach((e) => (filter(e) ? pass : fail).push(e));
	return [pass, fail];
}

export async function arrayForEachAsync<T>(array: T[], callback: (elem: T, index: number, array: T[]) => Promise<void>): Promise<void> {
	await Promise.all(array.map(callback));
}

export async function arrayFilterAsync<T>(array: T[], callback: (elem: T, index: number, array: T[]) => Promise<boolean>): Promise<T[]> {
	const results = await Promise.all(array.map(callback));
	return array.filter((_, index) => results[index]);
}

export function arrayRemove<T>(this: T[], item: T): void {
	const index = this.indexOf(item);
	if (index > -1) {
		this.splice(index, 1);
	}
}

export function arrayDistinct<T>(this: T[]): T[] {
	return Array.from(new Set(this));
}

export function arrayDistinctBy<T, K>(this: T[], key: (elem: T) => K): T[] {
	const seen = new Set<K>();
	return this.filter((item) => {
		const k = key(item);
		if (seen.has(k)) {
			return false;
		} else {
			seen.add(k);
			return true;
		}
	});
}

export function arrayIntersect<T>(this: T[], other: T[]): T[] {
	return this.filter((value) => other.includes(value));
}

// register extensions
if (!Array.prototype.partition)
	Array.prototype.partition = function <T>(this: T[], filter: (elem: T) => boolean) {
		return arrayPartition(this, filter);
	};

if (!Array.prototype.forEachAsync)
	Array.prototype.forEachAsync = function <T>(this: T[], callback: (elem: T, index: number, array: T[]) => Promise<void>) {
		return arrayForEachAsync(this, callback);
	};
if (!Array.prototype.filterAsync)
	Array.prototype.filterAsync = function <T>(this: T[], callback: (elem: T, index: number, array: T[]) => Promise<boolean>) {
		return arrayFilterAsync(this, callback);
	};
if (!Array.prototype.remove)
	Array.prototype.remove = function <T>(this: T[], item: T) {
		return arrayRemove.call(this, item);
	};

if (!Array.prototype.distinct)
	Array.prototype.distinct = function <T>(this: T[]) {
		return arrayDistinct.call(this);
	};
if (!Array.prototype.distinctBy)
	Array.prototype.distinctBy = function <T, K>(this: T[], key: (elem: T) => K) {
		return arrayDistinctBy.call(this, key as (elem: unknown) => unknown);
	};