@zelgadis87/utils-core 5.0.0 → 5.0.2

package/package.json

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

package/src/lazy/LazyDictionary.ts

@@ -0,0 +1,33 @@
+import type { TFunction } from "../utils/_index.ts";
+
+export class LazyDictionary<K extends string | number | symbol, T> {
+
+	private readonly _dictionary: Partial<Record<K, T>> = {};
+
+	private constructor(
+		private readonly _generator: TFunction<K, T>
+	) { }
+
+	public static of<K extends string | number | symbol, T>( generator: TFunction<K, T> ) {
+		return new LazyDictionary<K, T>( generator );
+	}
+
+	public getOrCreate( key: K ): T {
+		if ( key in this._dictionary ) {
+			return this._dictionary[ key ] as T;
+		}
+
+		const value = this._generator( key );
+		this._dictionary[ key ] = value;
+
+		return value;
+	}
+
+	public getOrThrow( key: K , errorMessage?: "Value not initialized" ): T {
+		if ( key in this._dictionary ) {
+			return this._dictionary[ key ] as T;
+		}
+		throw new Error( errorMessage );
+	}
+
+}

package/src/lazy/_index.ts

@@ -1,3 +1,5 @@
 
 export * from './Lazy.js';
 export * from './LazyAsync.js';
+export * from './LazyDictionary.js';
+

package/src/utils/errors.ts

@@ -17,3 +17,16 @@ export function isError( e: unknown ): e is Error {
 	return e instanceof Error;
 }
 
+export function printErrorMessage( error: Error ): string {
+	const maybeCause = error.cause ? printErrorMessage( asError( error.cause ) ) : null;
+	const cause = maybeCause ? `\ncaused by: ${maybeCause}` : '';
+	return `${error.name}: ${error.message}${cause}`;
+}
+
+export function printErrorStack( error: Error ): string {
+	const maybeCause = error.cause ? printErrorStack( asError( error.cause ) ) : null;
+	const cause = maybeCause ? `\ncaused by: ${maybeCause}` : '';
+	const stack = error.stack && error.stack.includes( error.message ) ? error.stack : error.message + ' ' + ( error.stack ?? '' );
+	return `${error.name}: ${stack}${cause}`;
+}
+

package/src/utils/functions/_index.ts

@@ -0,0 +1,4 @@
+export * from './constant.js';
+export * from './iff.js';
+export * from './predicateBuilder.js';
+

package/src/utils/functions/predicateBuilder.ts

@@ -0,0 +1,25 @@
+
+import { constantTrue, type TPredicate } from "../functions.ts";
+
+export class PredicateBuilder<T> {
+
+	private _currentPredicate: TPredicate<T> = constantTrue;
+
+	public and( predicate: TPredicate<T> ) {
+		const curPredicate = this._currentPredicate.bind( undefined );
+		const newPredicate = ( t: T ) => curPredicate( t ) && predicate( t );
+		this._currentPredicate = newPredicate;
+		return this;
+	}
+
+	public or( predicate: TPredicate<T> ) {
+		const newPredicate = ( t: T ) => this._currentPredicate( t ) || predicate( t );
+		this._currentPredicate = newPredicate;
+		return this;
+	}
+
+	public toPredicate() {
+		return this._currentPredicate;
+	}
+
+}

package/src/utils/functions.ts

@@ -1,8 +1,5 @@
-import { identity } from './_index.js';
-import { constantTrue } from './functions.js';
-
-export * from './functions/constant.js';
-export * from './functions/iff.js';
+import { constantTrue, identity } from './functions/constant.js';
+export * from './functions/_index.js';
 
 export type TFunction<A, R> = ( a: A ) => R;
 export type TTransformer<A, R> = TFunction<A, R>;

package/src/utils/records.ts

@@ -38,3 +38,13 @@ export type TWithRequiredProperty<T, K extends keyof T> = T & {
  * Given a type T, make all fields required instead of optional.
  */
 export type TWithRequiredProperties<T> = Required<T>;
+
+/**
+ * Type that forces a record to contain a few properties, but allows for extraneous properties.
+ */
+export type TWithExtras<R extends Record<any, any>, T extends Record<any, any> = Record<string, unknown>> = R & T;
+
+/**
+ * Types that improves the human readability of a Typescript type.
+ */
+export type TPrettify<T> = { [ K in keyof T ]: T[ K ]; } & {};