@zelgadis87/utils-core 5.2.3 → 5.2.5

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package",
   "name": "@zelgadis87/utils-core",
-  "version": "5.2.3",
+  "version": "5.2.5",
   "author": "Zelgadis87",
   "license": "ISC",
   "private": false,

package/src/Optional.ts

@@ -153,6 +153,12 @@ export class Optional<T> implements TOptional<T> {
 		return this as TPresentOptional<T>;
 	}
 
+	public throwIfPresent( errorProducer: TFunction<T, Error> ) {
+		if ( this.isEmpty() )
+			return this as TEmptyOptional<T>;
+		throw errorProducer( this.get() );
+	}
+
 	public mapTo<R>( mapper: TFunction<T, R | null | undefined> ) {
 		return this.flatMapTo( t => Optional.ofNullable( mapper( t ) ) );
 	}
@@ -215,6 +221,7 @@ export type TOptional<T> = {
 	ifEmpty: ( callback: TVoidFunction ) => void;
 	ifPresent: ( callback: TConsumer<T> ) => void;
 	apply( callbackIfPresent: TConsumer<T>, callbackIfEmpty: TVoidFunction ): void;
+	throwIfPresent: ( errorGenerator: TFunction<T, Error> ) => TEmptyOptional<T>;
 
 	/** @deprecated[2025.07.25]: Replace with {@link orElseReturn} (drop-in replacement) */
 	orElse: ( newValue: T ) => T;

package/src/utils/arrays.ts

@@ -149,21 +149,6 @@ export function listToDict<T, K extends string, V>( arr: T[], mapFn: TTransforme
 	}, {} satisfies Partial<Record<K, V>> );
 }
 
-export function countArrayBy<T, K extends string>( arr: T[], mapFn: TTransformer<T, K> ): Partial<Record<K, number>> {
-	return arr.reduce( ( dict: Partial<Record<K, number>>, cur: T ) => {
-		const value = mapFn( cur );
-		const count = ( dict[ value ] ?? 0 ) + 1;
-		return { ...dict, [ value ]: count };
-	}, {} satisfies Partial<Record<K, number>> );
-}
-
-export function sumArrayBy<T>( arr: T[], mapFn: TTransformer<T, number> ): number {
-	return arr.reduce( ( sum: number, cur: T ) => {
-		const value = mapFn( cur );
-		return sum + value;
-	}, 0 );
-}
-
 export function shallowArrayEquals( a: unknown[], b: unknown[] ): boolean {
 	if ( a === b ) return true;
 	if ( a.length !== b.length ) return false;
@@ -177,6 +162,11 @@ export function findInArray<T>( arr: T[], predicate: TPredicate<T> ): TOptional<
 	return Optional.ofNullable( arr.find( predicate ) );
 }
 
+export function findIndexInArray<T>( arr: T[], predicate: TPredicate<T> ): TOptional<number> {
+	const idx = arr.findIndex( predicate );
+	return idx === -1 ? Optional.empty() : Optional.of( idx );
+}
+
 export function zip<T, R>( ts: T[], rs: R[] ): [ T, R ][] {
 	if ( ts.length !== rs.length )
 		throw new Error( `Arrays must have the same length. Got ${ts.length} and ${rs.length}` );

package/src/utils/operations.ts

@@ -1,5 +1,5 @@
 
-export type TOperation<T, E extends Error = Error> = {
+export type TOperation<T, E = Error> = {
 	success: false;
 	error: E;
 } | {
@@ -7,13 +7,13 @@ export type TOperation<T, E extends Error = Error> = {
 	data: T;
 };
 
-export type TAsyncOperation<T, E extends Error = Error> = Promise<TOperation<T, E>>;
+export type TAsyncOperation<T, E = Error> = Promise<TOperation<T, E>>;
 
-export type TOperationTuple<T, E extends Error = Error> = [ T, undefined ] | [ undefined, E ];
+export type TOperationTuple<T, E = Error> = [ T, undefined ] | [ undefined, E ];
 
-export type TAsyncOperationTuple<T, E extends Error = Error> = Promise<TOperationTuple<T, E>>;
+export type TAsyncOperationTuple<T, E = Error> = Promise<TOperationTuple<T, E>>;
 
-export type TValidation<T, E extends Error = Error> = {
+export type TValidation<T, E = Error> = {
 	success: false;
 	errors: E[];
 } | {
@@ -21,4 +21,13 @@ export type TValidation<T, E extends Error = Error> = {
 	data: T;
 };
 
-export type TAsyncValidation<T, E extends Error = Error> = Promise<TValidation<T, E>>;
+export type TAsyncValidation<T, E = Error> = Promise<TValidation<T, E>>;
+
+export const Operation = {
+	ok: <const T>( data: T ) => {
+		return { success: true, data } as const satisfies TOperation<T, unknown>;
+	},
+	ko: <const E>( error: E ) => {
+		return { success: false, error } as const satisfies TOperation<unknown, E>;
+	},
+}