@zelgadis87/utils-core 5.2.4 → 5.2.6

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package",
   "name": "@zelgadis87/utils-core",
-  "version": "5.2.4",
+  "version": "5.2.6",
   "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;
@@ -193,3 +178,16 @@ export function unzip<T, R>( arr: [ T, R ][] ): [ T[], R[] ] {
 		return [ [ ...ts, t ], [ ...rs, r ] ];
 	}, [ [], [] ] as [ T[], R[] ] );
 }
+
+/**
+ * Gets the element at the specified index in the array, wrapped in an Optional.
+ * Returns an empty Optional if the index is out of bounds (negative or >= array length).
+ * @param arr - The array to get the element from
+ * @param index - The index of the element to retrieve
+ * @returns An Optional containing the element at the index, or empty if index is out of bounds
+ */
+export function arrayGet<T>( arr: TReadableArray<T>, index: number ) {
+	if ( index < 0 || index >= arr.length )
+		return Optional.empty();
+	return Optional.of( arr[ index ] );
+}

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>;
+	},
+}