@zelgadis87/utils-core 5.1.2 → 5.1.4

package/package.json

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

package/src/utils/arrays.ts

@@ -162,3 +162,12 @@ export function sumArrayBy<T>( arr: T[], mapFn: TTransformer<T, number> ): numbe
 		return sum + value;
 	}, 0 );
 }
+
+export function shallowArrayEquals( a: unknown[], b: unknown[] ): boolean {
+	if ( a === b ) return true;
+	if ( a.length !== b.length ) return false;
+	for ( let i = 0; i < a.length; i++ ) {
+		if ( a[ i ] !== b[ i ] ) return false;
+	}
+	return true;
+}

package/src/utils/nulls.ts

@@ -1,4 +1,4 @@
-import { TConsumer, TFunction } from "./functions.js";
+import { TConsumer, TFunction, TProducer, TVoidFunction } from "./functions.js";
 
 export type TMaybe<T> = T | null;
 
@@ -27,7 +27,11 @@ export function mapDefined<R, S>( source: TMaybe<R>, mapper: TFunction<R, S> ):
 	return null;
 }
 
-export function ifNullOrUndefined( source: TMaybe<unknown>, callback: TConsumer<void> ): void {
+export function ifNullOrUndefined( source: TMaybe<unknown>, callback: TVoidFunction ): void {
 	if ( isNullOrUndefined( source ) )
 		callback();
 }
+
+export function throwIfNullOrUndefined( source: TMaybe<unknown>, errorProducer: TProducer<Error> = () => new Error( `Unexpected ${source} value` ) ): void {
+	return ifNullOrUndefined( source, () => { throw errorProducer(); } );
+}

package/src/utils/records.ts

@@ -48,3 +48,13 @@ export type TWithExtras<R extends Record<any, any>, T extends Record<any, any> =
  * Types that improves the human readability of a Typescript type.
  */
 export type TPrettify<T> = { [ K in keyof T ]: T[ K ]; } & {};
+
+export function shallowRecordEquals( a: Record<string, unknown>, b: Record<string, unknown> ): boolean {
+	if ( a === b ) return true;
+	const aKeys = Object.keys( a ), bKeys = Object.keys( b );
+	if ( aKeys.length !== bKeys.length ) return false;
+	for ( const key of aKeys ) {
+		if ( a[ key ] !== b[ key ] ) return false;
+	}
+	return true;
+}

package/src/utils/strings.ts

@@ -1,5 +1,5 @@
 import { range } from "./arrays.js";
-import { ensureDefined, isNullOrUndefined } from "./nulls.js";
+import { ensureDefined, isNullOrUndefined, TMaybe } from "./nulls.js";
 
 export * from './strings/StringParts.js';
 
@@ -81,8 +81,19 @@ export function pluralize( n: number, singular: string, plural?: string ): strin
 
 }
 
-export function wrapWithString( str: string, delimiter: string ): string {
-	return delimiter + str + delimiter;
+export function isNullOrUndefinedOrEmpty( source: TMaybe<string> ): boolean {
+	return isNullOrUndefined( source ) || source.length === 0;
 }
 
 
+export function wrapWithString( str: string, delimiter: string ): string;
+export function wrapWithString( str: string, start: string, end: string ): string;
+export function wrapWithString( str: string, start: string, end = start ): string {
+	if ( isNullOrUndefinedOrEmpty( str ) )
+		throw new Error( `Expected string to be non-empty, got: "${str}"` );
+	if ( isNullOrUndefinedOrEmpty( start ) )
+		throw new Error( `Expected start delimiter to be non-empty, got: "${start}"` );
+	if ( isNullOrUndefinedOrEmpty( end ) )
+		throw new Error( `Expected end delimiter to be non-empty, got: "${end}"` );
+	return start + str + end;
+}